Difference between revisions of "RESTORE SCREEN"
Yvonnemilne (Talk | contribs) |
Helengeorge (Talk | contribs) |
||
| (2 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
| − | |||
| − | |||
| − | |||
| − | |||
==Purpose== | ==Purpose== | ||
Restore a previously saved screen to the terminal display | Restore a previously saved screen to the terminal display | ||
| Line 40: | Line 36: | ||
==Products== | ==Products== | ||
| − | Recital | + | Recital |
[[Category:Documentation]] | [[Category:Documentation]] | ||
[[Category:Commands]] | [[Category:Commands]] | ||
| + | [[Category:Screen Forms]] | ||
| + | [[Category:Screen Forms Commands]] | ||
Latest revision as of 16:24, 12 November 2009
Contents
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
