[<<Previous Entry]
[^^Up^^]
[Next Entry>>]
[Menu]
[About The Guide]
oWin:say( <nRow>, <nCol>, <cText>, <xClrFore>, <nClrBack>,;
<oFont>, <lPixel> ) -> <nil>
------------------------------------------------------------------------------
PARAMETER:
<nRow> The row where <cText> will be written. This row is relative
to the top of the window, and it is measured in 'characters'
if <lPixel> is FALSE ( default )
<nCol> The col where <cText> will be written. This col is relative
to the left side of the window, and it is measured in
'characters' if <lPixel> is FALSE ( default )
<cText> The string that should be written to the window.
<xClrFore> can either be a character string in Clipper's SetColor
Format ( like "R/G" ), or a numerical Windows COLOR value.
If <xClrFore> is skipped the ::nClrText color
is used instead
<nClrBack> This parameter is only relevant if <xClrFore> was a
Color number. It then represents the background color of the
text, and has to be a Windows Color code. This defaults to
::nClrPane
<oFont> Is a font object that will be used to display <cText>
If it is omitted the ::oFont font will be used.
<lPixel> determines whether the <nRow>, <nCol> coordinates are
measured in pixels (TRUE) or in characters (FALSE, default)
DESCRIPTION:
This method allows the programmer to dynamically write text to the client
area of a window, under full control over the position, color and the font
that is used.
The ::Say() method accepts character based or pixel based coordinates
and can handle Clipper color strings as wll as windows numerical COLOR
pairs.
Note however that the text is 'painted' directly on the window, which
means that as soon as the window is repainted the text will disappear.
If you want to place text permanently on a window then you should use
the @ x,y SAY command
!seealso:tsay.eho:"SAY" "nClrText" "nClrPane" "oFont"
This page created by ng2html v1.05, the Norton guide to HTML conversion utility.
Written by Dave Pearson