Difference between revisions of "SAVE SCREEN"

From Recital Documentation Wiki
Jump to: navigation, search
(Class)
 
Line 1: Line 1:
 
 
 
==Purpose==
 
==Purpose==
 
Save the currently displayed screen in a memory variable or file
 
Save the currently displayed screen in a memory variable or file
Line 39: Line 37:
  
 
==Products==
 
==Products==
Recital Mirage Server, Recital Terminal Developer
+
Recital  
 
[[Category:Documentation]]
 
[[Category:Documentation]]
 
[[Category:Commands]]
 
[[Category:Commands]]
 
[[Category:Screen Forms]]
 
[[Category:Screen Forms]]
 
[[Category:Screen Forms Commands]]
 
[[Category:Screen Forms Commands]]

Latest revision as of 16:38, 12 November 2009

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