Click above to get retro games delivered to your door ever month!

 C_WRESTORE()

 DESCRIPTION

 C_WRESTORE() restores the contents of the screen, prior to the
 ClipOn window being saved, using the window reference variable
 returned by a ClipOn window function.  It also releases the window
 and the memory it is using, however, this feature can be overridden
 to keep the window.  (Refer to Chapter 3 for a complete discussion
 about ClipOn windows.)

 NOTES

 The numeric reference for the ClipOn window is a pointer to the
 window in memory.  Be careful not to change the value of this
 pointer, or the window will be unaccessible.

 SYNTAX

 C_WRESTORE(window [,keep_window])

 PARAMETERS

 window (N) is the numeric reference variable for the ClipOn window.

 keep_window (L) indicates whether the window should be kept or
 released.  Specify true (.T.) if the window and memory should be
 released after the screen is restored, or false (.F.) to restore
 the screen but keep the window for later use.  If keep_window is
 not specified, the window and memory will be released.

 RETURNS

 There is no return value.

 EXAMPLES

 w1 = c_wsave(10,10,20,70)   && Creates window with no box
 ...
 c_wrestore(w1)              && Restores previous screen and releases window
 ...
 w1 = c_wsave(10,10,20,70)   && Creates window with no box
 ...
 c_wrestore(w1,.f.)          && Restores previous screen and keeps window
 ...                         && Do screen routine
 c_wrestore(w1)              && Restore previous screen again, release window