RESTORE.SCREEN

RESTORE.SCREEN

Top  Previous  Next

 

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 with terminal definitions that have the -at suffix).

 

 

Format

 

RESTORE.SCREEN image, restore.state

 

where

 

imageis the screen image data to be restored.

 

restore.stateis a Boolean value indicating whether the cursor position, pagination mode and current display attributes are to be restored from the saved data.

 

 

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:

SAVE.SCREEN