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

METHOD Say CLASS TWindow

--------------------------------------------------------------------------------
TWindow:Say( <nRow>, <nCol>, <cText>, <ncClrFore>, <nClrBack>, <oFont>,
             <lPixel> ) --> Nil

Parameters:

<nRow>        The row where <cText> will be written. This row is
              relative to the top of the window. Whether or not this
              parameter represents pixels or 'characters' depends on
              <lPixel>.

<nCol>        The column where <cText> will be written. This column is
              relative to the left side of the window. Whether or not
              this parameter represents pixels or 'characters' depends
              on <lPixel>.

<cText>       The text that has to written in the window.

<ncClrFore>   This parameter can be either a character string(1) or a
              numerical(2).

              1.  If it is a character string it should be a
                  CA-Clipper color-pair, which determines the
                  foreground and the background color used to write
                  <cText> on the window. If it is a CA-Clipper color
                  string <nClrBack> will be ignored.
                  For example when ncClrFore is "R/G" the text will be
                  written on the window in red letters on a green
                  background.

              2.  When <ncClrFore> is a numerical value it is assumed
                  that this is a valid COLOR value that represents a
                  color that can be displayed.

              If <ncClrFore> is omitted the value is used that was
              stored in the instance variable ::nClrText of the
              TWindow() object.

<nClrBack>    This parameter is used whenever a numerical value is
              passed for <ncClrFore>. It then represents the background
              color that should be used when displaying the text on the
              window. If used it should be a Windows COLOR numerical.
              If omitted, and <ncClrFore> is a numerical, then the
              value of the instance variable ::nClrPane is used.

<oFont>       This font object determines the font that will be used
              when <cText> is displayed on the window. It should be a
              valid TFont() object. If it is omitted the ::oFont
              instance variable will be used.

<lPixel>      The <lPixel> parameter determines whether the coordinates
              that were passed on to the Say() method (<nRow> and
              <nCol>) are to be used as pixel coordinates or character
              based coordinates. If <lPixel> is .T. then the
              coordinates are pixel based. The default value is .F. ie
              the coordinates are character based.

Purpose:
This method allows the programmer to write something directly to the
client area of a window. It gives him/her control over the position,
the color and the font used. The Say() method either accepts character
based or pixel based coordinates and can handle either CA-Clipper color
strings or MS windows numerical COLOR pairs. Note however that the text
is 'painted' directly on the window, ie as soon as the window is
redrawn the text will disappear. If you want to place text on a window
that stays there you should use the @ x,y SAY command or the related
TSay() method

seealso: TSay() TFont() @ SAY