8.73. 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 (Section 8.1, “A Note on Error Codes”) 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.

Example 8.42. RexxUtil - SysTextscreenread

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

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