SysTextScreenRead (Windows only)


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



The row from which to start reading.


The column from which to start reading.


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.


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

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