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

@ PIXEL ... SAY
Display data at a specified screen pixel position
------------------------------------------------------------------------------

Syntax
#include "say.ch"
@ PIXEL <nX>, <nY>  SAY <xpr>
                    [ PICTURE <cPicture> ]
                    [ COLOR <cColour> ]
                    [ TEXTCOLOR <nTextRGB> ]
                    [ BKCOLOR <nBkRGB> ]
                    [ STYLE <nStyle> ]
                    [ WIDTH <nW> ]
                    [ HEIGHT <nH> ]
                    [ FONT <hFont> ]
                    [ IN [ WINDOW ] <hWnd> ]

Arguments
<nX>, <nY> are the x, y co-ordinates where the data is to be
displayed.

<xpr> is the data to be displayed.

<cPicture> is an optional formatting string.

<cColour> is an optional Clipper colour string.

<nTextRGB> is an optional Windows colour value (e.g. from RGB()),
specifying the colour of the characters that are displayed.

<nBkRGB> is an optional Windows colour value (e.g. from RGB()),
specifying the background colour of the characters that are displayed.

<nStyle> is an optional numeric value used to control the way
the data is displayed.  This is reserved for future use.

<nW>, <nH> are optional numeric values specifying the width
and height of the rectangle in which the data gets displayed.
<nW> defaults to the length of the text multiplied by 8.  <nH>
defaults to 12.

<hFont> is an optional handle of a font to be used.  The
default can be set by SET DEFAULT SAY FONT.  The initial default
is the default Windows font.

<hWnd> is an optional handle of a window in which the data is
displayed.  The default is the window returned by SelectWindow().

Description
This command can be used to output data in a window, with
control over the font type and size, as well as the colour(s)
used.  The characters output are re-drawn automatically, as
needed (there is no need to handle EVENT_REDRAW for the data).

This command adds information to the SayList variable, which
should be initialised to an empty array (and is usually declared
as a LOCAL).

Example
#include "say.ch"
#define  C_GREEN  RGB( 0, 255, 0 )
#define  C_RED    RGB( 255, 0, 0 )
local     SayList := { }      // NOTE: need to initialise like this

@ PIXEL 10, 50 SAY "Some sample text" TEXTCOLOR C_RED
@ PIXEL 10, 70 SAY "Some more text"   TEXTCOLOR C_GREEN