ReadText

Item Description

Use with:

Terminal Launcher, Windows

SecureLogin version:

All

Type:

Action

Windows Usage:

Terminal Launcher Usage:

ReadText #Ctrl-ID variable

ReadText variable character-number row-number [column number]

Arguments:

#Ctrl-ID

variable

character-number

row number


[column-number]

The control ID number of the text to be read.

The variable that will receive the text that is read.

The number of characters to be read.

The horizontal position number of the first character to be read (for example, row).

Optional. The vertical position number of the first character to be read (for example, column). If you don't specify the column-number, the row-number is used as the number that the reading will start from. If column-number is specified, a row/column conversion is carried out before the reading starts.

Description:

Runs in both Windows and Terminal Launcher scripts. Although the usage and arguments for the use of ReadText with Windows and Terminal Launcher are different, the results of each command are the same.

In a Windows script, the ReadText command reads the text from any given #Ctrl-ID and sends it to the specified variable. For this command to function correctly, the #Ctrl-ID must be valid.

In a Terminal Launcher script, the ReadText command reads a specified number of characters, starting at the row-number, and sends those characters to the specified variable.

The ReadText command won't work with Generic or Advanced Generic emulators. It only works with HLLAPI and some DDE emulators.

Syntax examples:

ReadText #301 ?Text
ReadText ?Text 4 6

Example:

 
Dialog  
 Title "Login" 
 Ctrl #1 
EndDialog 
ReadText #301 ?Text 
MessageBox ?Text