Win32Prn() > Print output methods

oWin32Prn:textOutAt()

Prints text at the specified X/Y position.

Syntax

:textOutAt([<nPosX>]      , ;
           [<nPosY>]      , ;
            <cString>     , ;
           [<lNewLine>]   , ;
           [<lUpdatePosX>], ;
           [<nTextAlign>]   ) --> lSuccess

Arguments

<nPosX> and <nPosY>

These two numeric values are the X and Y coordinates where <cString> is output. They default to the current X and Y coordinate of the print position.

<cString>

This is a character string holding the text to print.

<lNewLine>

This parameter defaults to .F. (false). When set to .T. (true), the print position is moved to the beginning of the next line after <cString> is output.

<lUpdatePosX>

This parameter defaults to .T. (true) which changes the X coordinate of the print position to the end of <cString> after printing. Subsequent print output appears to the right of <cString>. Passing .F. (false), leaves the X coordinate unchanged.

<nTextAlign>

This is an optional numeric value specifying the text alignment at the current print position. The following values can be used:

Values for text alignment

Value	Description
0 *)	Text is printed left aligned to the current print position
1	Text is printed right aligned to the current print position
2	Text is printed centered on the current print position
*) default

Description

Method :textOutAt() works exactly like method :textOut(). The only difference are the first two parameters allowing to change the current print position before text is output.

The method returns a logical value indicating success of the operation.