getText method

Top  Previous  Next

The getText method returns the text of the specified position and length on the screen.

 

There are two ways to invoke this method:

 

getText(position, length)

getText(row, column, length)

 

 

Call Parameters

 

Parameter name

Explanation

position

Numeric value which represents the position of the first character to be retrieved on the host screen. If the "row, column, length" option is used, this value will be calculated automatically, using (row - 1) * screen.rowWidth + col formula.

length

The length of the screen text to be retrieved.

row

Screen row coordenate of the first character to retrieve. The base number is 1.

column

Screen column coordenate of the first character to retrieve. The base number is 1.

 

 

Return Object

 

getText returns a string object corresponding to the screen text, as determined by the coordinates and length parameters.