__XSAVESCREEN()
Save whole screen image and coordinate to an internal buffer
- Syntax
- __XSaveScreen() --> NIL
- Arguments
- none.
- Returns
- __XSaveScreen() always return NIL.
- Description
- __XSaveScreen() save the image of the whole screen into an internal buffer, it also save current cursor position. The information could later be restored by __XRestScreen(). Each call to __XSaveScreen() overwrite the internal buffer.
- SAVE SCREEN command is preprocessed into __XSaveScreen() function during compile time. Note that SAVE SCREEN TO is preprocessed into SAVESCREEN() function.
- __XSaveScreen() is a compatibility function, it is superseded by SAVESCREEN() which allow you to save part or all the screen into a variable.
- Examples
- // save the screen, display list of files than restore the screen
- SAVE SCREEN
- DIR *.*
- WAIT
- RESTORE SCREEN
- Status
Ready
- Compliance
- __XSaveScreen() works exactly like CA-Clipper's __XSaveScreen()
- Platforms
- __XSaveScreen() is part of the GT API, and supported only by some platforms.
- Files
- Library is rtl
- See Also