RESTSCREEN()

Class

Screen Forms

Purpose

Function to display a screen region, previously saved with SAVESCREEN(), to a specified screen area

Syntax

RESTSCREEN(<expN1>, <expN2>, <expN3>, <expN4>, <expC>)

See Also

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

Description

The RESTSCREEN() function displays a screen region previously saved with SAVESCREEN(). The numerical expressions <expN1-4> represents the coordinates of the screen, and must be at the same location that the memory variable <expC> was saved at with the SAVESCREEN() function. The RESTSCREEN() function refreshes only those portions of the screen which have changed since the screen was last saved. The character expression <expC> specifies a memory variable that contains the screen image saved with the SAVESCREEN() function. The command SET SCREENMAP must be ON for this function to work.

Example

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

Products

Recital Mirage Server, Recital Terminal Developer