SysTextScreenRead (Windows only)

>>-SysTextScreenRead(-row,column--+------+--)------------------><
                                  +-,len-+

Reads characters from a specified screen location. These include any carriage return and linefeed characters if the number of character reads spans multiple lines.

Parameters:

row

The row from which to start reading.

col

The column from which to start reading.

len

The number of characters to read. The default is to read to the end of the screen.

Note that, on error, a Windows System Error code is returned.

Limitations: This function reads in only screen characters and does not consider the color attributes of each character read. When restoring a character string to the screen with SAY or the CHAROUT built-in function, the previous color settings are lost.

Examples:

/* Reading the entire screen */
screen = SysTextScreenRead(0, 0)

/* Reading one line */
line = SysTextScreenRead(2, 0, 80)