Product Site

8.63. SysTextScreenRead (Windows only)

Returns characters from a specified console screen buffer location.

Parameters:
row

The row from which to start reading. Console screen buffer rows are numbered from top to bottom starting with 0.
col

The column from which to start reading. Console screen buffer columns are numbered from left to right starting with 0.
len

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

Limitation

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.

Note

The Windows API used by function is not recommended any more.
Example 8.45. RexxUtil — SysTextScreenRead
-- read the entire console screen buffer
screen = SysTextScreenRead(0, 0)

-- read one screen buffer line
parse value SysTextScreenSize() with rows columns
line = SysTextScreenRead(2, 0, columns)