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.