VpeWriteBox

<< Click to Display Table of Contents >>

Navigation:  Text Functions >

VpeWriteBox

Previous pageReturn to chapter overviewNext page

The same as VpeWrite(), but pen- and box-settings are used. Outputs text formatted with the current alignment settings within a rectangle at position x, y, with the right border at x2 and the bottom border at y2.

VpeCoord VpeWriteBox(

VpeHandle hDoc,

VpeCoord x,

VpeCoord y,

VpeCoord x2,

VpeCoord y2,

LPCSTR text

)

VpeHandle hDoc

Document Handle

VpeCoord x, y, x2, y2

position and dimensions

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.