Product SiteDocumentation Site

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)