RESTSCREEN()

From Recital Documentation Wiki
Jump to: navigation, search

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