[<<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