SAVESCREEN()

SAVESCREEN()

Class

Screen Forms

Purpose

Function to save a screen region to a memory variable

Syntax

SAVESCREEN(<expN1>,<expN2>,<expN3>,expN4>)

See Also

SET SCREENMAP, RESTSCREEN(), CHANGE, EDIT, QUERY, APPEND, BROWSE, @...SAY, @...MENU, MENU, SAVE SCREEN, RESTORE SCREEN

Description

The SAVESCREEN() function allows you to save a portion of a screen for redisplay later. The coordinates of the screen portion are specified in the numeric expressions <expN1-4> . The numeric expressions represent numbers for the beginning row, beginning column, ending row and ending column, respectively. When SCREENMAP is on, the SAVESCREEN() function allows an image of all or part of the current terminal display to be saved to a memory variable. All Recital output to the screen is stored as part of the screen image. No output from the RUN command is stored.

Example

// Clear area for pop-up window
save_win = savescreen(1,5,10,20)
// Pop up a window
// Restore screen area
restscreen(1,5,10,20,save_win)

Products

Recital Mirage Server, Recital Terminal Developer