SAVE SCREEN

Class

Screen Forms

Purpose

Save the currently displayed screen in a memory variable or file

Syntax

SAVE SCREEN

[AT <expN1>,<expN2> TO <expN3>,<expN4>]

[TO <memvar>] | [TO FILE <.img filename> | (<expC>)]

See Also

@...MENU@...SAY, , APPEND, BROWSE, CHANGE, EDIT, MENU, QUERY, RESTORE SCREEN, SET SCREENMAP

Description

When SCREENMAP is ON, the SAVE SCREEN command allows an image of the current terminal display to be saved. All screen output except that from the RUN command is stored as part of the screen image. The screen image can be restored with the RESTORE SCREEN command. Up to 20 screen images can be saved at any one time. 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. These commands are particularly useful when used in conjunction with pop-up menus from within forms.

AT <expN1>,<expN2> TO <expN3>,<expN4>

The optional AT clause will save a screen image of the screen from top row <expN1> and column <expN2> to bottom row <expN3> and column <expN4>.

TO <memvar>

The optional TO clause can be used to save the screen image to a <memvar>.

TO FILE <.img filename> | (<expC>)

The optional TO FILE clause can be used to save the screen image to an <.img filename>. The file name can be substituted with an <expC>, enclosed in round brackets, which returns a valid filename.

Example

save screen
...
restore screen

Products

Recital Mirage Server, Recital Terminal Developer