Kernel 8.0 APIs Banner [skip navigation]
Office of Information & Technology (OIT) Banner

RESTORE^XGF(): Screen Restore

Reference Type: Supported, Category: XGF Function Library, Integration Agreement: 3173


This API restores a previously saved screen region. You can save screen regions using the WIN^XGF(): Screen Text Window and SAVE^XGF(): Screen Save APIs. RESTORE^XGF restores the saved screen region in the same screen position as the screen region was saved from.

A call to the PREP^XGF(): Screen/Keyboard Setup API must be made at some point prior to calling RESTORE^XGF.

Specify the array node under which to save the overlaid screen region in closed root and fully resolved form (i.e., closed right parenthesis and with variable references such as $J fully resolved). Using M $NAME function is a quick way to pass fully resolved node specifications.



Input Parameters


(required) Global/local array node, closed root form.

Output Parameters

$x and $y:

Set to the bottom right coordinate of the restored window.

NOTE: See also: CLEAR^XGF(): Screen Clear Region, SAVE^XGF(): Screen Save, and WIN^XGF(): Screen Text Window APIs.


To restore the screen contents saved to the local array SELECT to their original position, do the following:



VA (Internet) / VA(Intranet) / OI / PD / Site Map / Terms of Use / VA Privacy Policy / Accessibility

Reviewed/Updated: August 26, 2011

If you have questions, need more information, or are having accessibility problems with this website, please contact us by E-Mail: Webmasters, Phone: 510-768-6800, or FAX: 510-768-6850.