Difference between revisions of "RESTORE SCREEN"
Yvonnemilne (Talk | contribs) |
Yvonnemilne (Talk | contribs) |
||
| Line 1: | Line 1: | ||
| − | |||
| − | |||
| − | |||
==Class== | ==Class== | ||
Screen Forms | Screen Forms | ||
| Line 19: | Line 16: | ||
==See Also== | ==See Also== | ||
| − | [[@...MENU]], [[@...SAY]], [[ | + | [[@...MENU]], [[@...SAY]], [[ACHOICE()]], [[MENU]], [[SAVE SCREEN]], [[SET SCREENMAP]] |
Revision as of 15:42, 26 May 2009
Contents
Class
Screen Forms
Purpose
Restore a previously saved screen to the terminal display
Syntax
RESTORE SCREEN
[AT <expN1>,<expN2> TO <expN3>,<expN4>]
[FROM <memvar>] | [FROM FILE <.img filename> | (<expC>)]
See Also
@...MENU, @...SAY, ACHOICE(), MENU, SAVE SCREEN, SET SCREENMAP
Description
The RESTORE SCREEN command restores a screen that has been saved using the SAVE SCREEN command. Screen imaging must be enabled with SET SCREENMAP ON when using RESTORE SCREEN. All output to the screen except that from the RUN command is stored as part of the screen image. Up to 20 screen images can be saved in succession. Each time RESTORE SCREEN is executed, it restores from the last screen saved. When RESTORE SCREEN is executed, only those parts of the screen that have changed since the SAVE SCREEN was issued are refreshed.
AT <expN1>,<expN2> TO <expN3>,<expN4>]
The optional AT can be used to restrict the area of the screen to be restored by specifying the top row <expN>1 and column <expN2> and bottom row <expN3> and column <expN4> coordinates.
FROM <memvar> | FROM FILE <.img filename> | (<expC>)
The FROM option restores a screen which has been stored to a memory variable or file using the TO option. The filename can be substituted with an <expC>, enclosed in round brackets, which returns a valid filename.
Note: No SCREEN memory variables are saved to the <.mem> file if the command SAVE TO is used. If you require the SCREEN IMAGE to be saved for subsequent recall, use the SAVE SCREEN TO FILE command.
Example
save screen dialog query restore screen
Products
Recital Mirage Server, Recital Terminal Developer
