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

 C_XWINDOW()

 DESCRIPTION

 C_XWINDOW() opens a ClipOn window for the given screen coordinates,
 saving the area of the screen under the window.  The window color,
 box type, shadow, explode option, and title may be specified.
 C_XWINDOW() is similar to the C_WINDOW() function but includes
 additional options for displaying the window.  (Refer to Chapter 3
 for a complete discussion about ClipOn windows.)

 NOTES

 When a shadow is specified, the C_XWINDOW() draws the shadow around
 the window coordinates specified.  The calling program must adjust
 the coordinates to prevent the shadow from being drawn off the
 display screen if the window is too large.

 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_XWINDOW(st_row, st_col, end_row, end_col [,box] [,color] [,shadow]
 [,explode] [,t_color] [,title])

 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 (N) is the box type (0 - 5) to draw.  If box is not specified,
 no box is used.  The box types are as follows:

 BOX TYPE     DESCRIPTION
 --------     -----------
 0            No box
 1            Single top/bottom, single sides
 2            Double top/bottom, double sides
 3            Double top/bottom, single sides
 4            Single top/bottom, double sides
 5            Solid graphics characters

 color (C/N) is the color to draw the window.  The color argument
 can be specified as a dBASE/Clipper color string or a numeric color
 code (see Appendix E).  If color is not specified, the current
 Clipper color is used.

 shadow (N) is the type of shadow to display around the window.  The
 shadow types are as follows: 0 = no shadow, 1 = left side/bottom
 shadow, 2 = right side/bottom shadow.  If shadow is not specified,
 no shadow is displayed.

 explode (N) indicates whether or not the window should display with
 an exploding effect and if so, how fast to display it.  Specify
 negative one (-1) or null ("") for no exploding menu, or 0 through
 99 to have an exploding window (0 = fastest, 99 = slowest).  If
 explode is not specified, the default of (-1) no exploding window
 is used.

 t_color (C/N) is the color to draw the window title (if any).  The
 title_color argument can be specified as a dBASE/Clipper color
 string or a numeric color code (see Appendix E).  If title_color is
 not specified, the current Clipper color is used.

 title (C) is the optional window title to display at the top of the
 window.  The position of the title may be optionally specified by
 setting the first character of the title to a plus (+) or minus (-)
 which will be removed from the string before displaying.  If a
 minus (-) is specified, the title will be left justified.  If a
 plus (+) is specified, the title will be right justified.  If no
 sign is specified, the title will be centered on the window, which
 is the default.

 RETURNS

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

 EXAMPLES

 && Create a window 1,1,10,20, with a single box, white on red, with
 && a right shadow and exploding effect.  The title will be intense white
 && on red and will be displayed in the right corner on the top line.

 w1 = c_xwindow(1,1,10,20,1,"W/R",2,10,"W+/R","+[ Help Information ]")

 c_wsay(w1,2,2,"Display help text")    && Display text in window w1
 c_wsay(w1,3,2,"inside of window")
 inkey(0)

 c_wimplode(w1,10)      && Implode the window

 c_wrelease(w1)         && Release