Rendering > VpeRenderBoxRTF

[Professional Edition and above]

Computes the dimensions of a given RTF text, based on the method VpeWriteBoxRTF(). The dimensions are computed including the surrounding frame, if PenSize is <> 0.

int VpeRenderBoxRTF(

VpeHandle hDoc,

VpeCoord x,

VpeCoord y,

VpeCoord x2,

VpeCoord y2,

LPCSTR s

)

VpeHandle hDoc

Document Handle

VpeCoord x, y, x2, y2

position and dimensions, y2 may be set to VFREE

LPCSTR s

the RTF text to be rendered

Returns:

The method returns one of the following values, indicating the AutoBreak status:

Constant Name	Value	Comment
RENDER_NO_BREAK	0	NO Auto Break will occur
RENDER_BREAK	1	Auto Break will occur
RENDER_SKIP_BREAK	2	Auto Break will occur, but no text will be placed on the current page, all text will be skipped to the next page (VRENDERWIDTH and VRENDERHEIGHT are not set)

Remarks:

VFREE: only the y2 coordinate may be set to VFREE, not x2.

In case of an error, LastError is set.

The computed dimensions can be retrieved with

VpeGet(hDoc, VRENDERWIDTH)

VpeGet(hDoc, VRENDERHEIGHT)