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

 C_WSAY()

 DESCRIPTION

 C_WSAY() allows texts to be displayed directly to a ClipOn window
 using the window reference variable.  Relative window coordinates
 are used instead of the normal screen coordinates allowing the
 window's location not to effect the coordinates of the text
 display.  (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_WSAY(window, row, column, string [,color])

 PARAMETERS

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

 row (N) is the relative starting row to begin the display.  If (-1)
 is passed to C_WSAY(), the text is automatically centered in the
 window by row.

 column (N) is the relative starting column to begin the display.
 If (-1) is passed to C_WSAY(), the text is automatically centered
 in the window by column.

 Both row and column use the relative window coordinates rather than
 the screen coordinates.  The relative window coordinates always
 start with 0,0 as the starting row and column and end with as many
 rows and columns as there are in the window.  For example, if a
 window was defined with the screen coordinates 10,10,20,70, where
 10 and 10 are the starting row and column, then the relative
 starting row and column would be 0,0, the relative ending row would
 be 10 (there are 10 rows in the window), and the relative ending
 column would be 60 (there are 60 columns in the window).

 string (C) is the character string to display in the window.

 color (C/N) is the color to fill in 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
 window color is used.

 RETURNS

 There is no return value.

 EXAMPLES

 s1 = "Display Text for Window"
 s2 = "WINDOW TITLE"

 w1 = c_wsave(10,10,20,70)   && Creates window

 c_wsay(w1,2,2,s1)           && Displays string at window coordinates 2,2
                             && (screen coordinates 12,12)

 c_wsay(w1,0,-1,s2)          && Displays title, centered, at the top
 ...                         && row of the window. (screen coord. 10,34)
 ...
 ...
 c_wsay(w1,4,9,s1,31)        && Displays string s1 at window coordinates
                             && 4,9 (screen coordinates 14,19) in high
                             && intensity white on blue.