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

 C_WSAVE()

 DESCRIPTION

 C_WSAVE() opens a ClipOn window for the given screen coordinates,
 saving the area of the screen under 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_WSAVE(st_row, st_col, end_row, end_col [,box])

 PARAMETERS

 st_row (N), st_col (N), end_row (N), and end_col (N) define the
 upper left and lower right coordinates of the window.

 box (L) indicates whether or not the window will have a box around
 the outer region.  This will allow other window functions such as
 C_WFILL() to identify a box around the window and not overwrite it.
 Specify true (.T.) if the window will have a box around the outer
 region, otherwise false (.F.).  If box is not specified, the
 default of false (.F.) is used.

 RETURNS

 C_WSAVE() returns a numeric reference variable for the ClipOn
 window.

 EXAMPLES

 w1 = c_wsave(10,10,20,70)   && Creates window indicating no box
 ...
 c_wfill(w1,"W+/R")          && Fills window w/ high intensity white on red
 ...
 c_wrestore(w1)              && Restores previous screen / releases window
 ...
 ...
 w1 = c_wsave(10,10,20,70,.t.)     && Creates window indicating a box
 c_box(10,10,20,70)                && Draws a single box around window
 ...
 c_wfill(w1,"W+/R",chr(177))       && Fills window w/ high intensity
 ...                               && white on red and graphics
 ...                               && character, wo/ overwriting box
 c_wrestore(w1,.f.)          && Restores previous screen and keeps window