PSTextOut() |
|
Syntax
Function PSTextOut(nTop, nLeft, xValue, cPicture, nJustify, cFontName, nFontSize, nFontStyle, nFontFColor, nFontBColor, nAngle)
TPageScript:TextOut(nTop, nLeft, xValue, cPicture, nJustify, cFontName, nFontSize, nFontStyle, nFontFColor, nFontBColor, nAngle)
Returns
Nothing.
Description
Use PSTextOut() to print text on your document. PSTextOut() is probably the mostly used function of PageScript 32. The text is painted using the provided parameters. If both nTop and nLeft are NIL, the text is printed at the current cursor position, no matter the unit in use, based on the last call to PSTextOut(). This feature allows one to change the font size, style or face, without worrying where the text will be printed.
Note that the parameter order for nFontSize and nFontStyle may be inverted, depending on the "Clipper compatibility flag" (See PSSetClipperComp() ). This applies only to the procedural call (PSTextOut() ) and not for the OO call. |
Arguments
nTop, nLeft | Top, left coordinates of the text, expressed in the currently set unit. |
xValue | A value of any type supported by @SAY.. PICTURE. |
cPicture | The picture to be used to format the value passed in xValue. |
nJustify | Text justification to use. You have the choice of APS_LEFT, APS_CENTER, APS_RIGHT and APS_DECIMAL. |
cFontName | A string with the font name. Any available font name is valid. |
nFontStyle | The style to apply to the font; like bold, italic... See SetFontStyle() for the list of supported styles. |
nFontSize | Size of the font in points. |
nFontFColor | Foreground color of the text. You may use one of the predefined color or a RGB color. |
nFontBColor | Background color if applicable. You may use one of the predefined color or a RGB color. If you do not want a background color, pass APS_NONE. |
nAngle | Angle, in degrees to apply to the text. 0 = no rotation. |
When Angle is used, the output result may differ between the PDF and print output. |