<< Click to Display Table of Contents >> Navigation:  Text Functions > VpePrintBox

The same as VpeWriteBox() with the parameters (x, y, VFREE, VFREE).

If the right border of the page (VRIGHTMARGIN, the x2 coordinate of the Ouput Rectangle) is reached, the text is automatically broken to the next line; the new starting coordinate is then again x. This function does a lot of calculations and is time-consuming in relation to VpeWrite() or VpeWriteBox() not using VFREE.

VpeCoord VpePrintBox(

VpeHandle hDoc,

VpeCoord x,

VpeCoord y,

LPCSTR text

)

VpeHandle hDoc

Document Handle

VpeCoord x, y

position

LPCSTR text

the text to output

Returns:

the bottom y-coordinate generated by the output

Remarks:

It is not possible to change font styles within one string. For such need, you should use the Professional Edition, which can interpret and display Rich Text Format (RTF).

 

VPE offers several methods to attach an object's position to margins and relative to the position of previously inserted objects. In addition Text, Rich Text and Picture objects are able to compute their dimensions automatically depending on their visual content.

For details please see "Dynamic Positioning" in the Programmer's Manual.

 

If the very first character of the output string is a '[' (square bracket), VPE expects a sequence of Embedded Flags. In order to print a square bracket as the very first character, output two consecutive square brackets, i.e. '[['. For details, see "Embedded Flag-Setting" in the Programmer's Manual.