RESTORE.SCREEN |
![]() ![]() ![]() |
The RESTORE.SCREEN statement restores a rectangular portion of the display screen image previously saved using SAVE.SCREEN().
This statement can only be used with QMConsole and QMTerm sessions and with terminals that support the save and restore screen region functions (e.g. AccuTerm 5.2b upwards).
Format
RESTORE.SCREEN image, restore.state
where
The RESTORE.SCREEN statement restores the data previously saved in image using SAVE.SCREEN(). The data cannot be restored to a different screen position from which it was saved. If the restore.state expression evaluates to a non-zero value, the pagination mode will also be restored.
Example
IMAGE = SAVE.SCREEN(0, 0, 80, 25) EXECUTE COMMAND.STRING RESTORE.SCREEN IMAGE, @TRUE
The above code fragment saves the screen image, executes the command in variable COMMAND.STRING and then restores the screen image.
See also: |