RESTORE SCREEN

RESTORE SCREEN

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, MENU, SAVE SCREEN, SET SCREENMAP, ACHOICE()

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