Rendering > VpeRenderBoxRTFFile

[Professional Edition and above]

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

int VpeRenderBoxRTFFile(

VpeHandle hDoc,

VpeCoord x,

VpeCoord y,

VpeCoord x2,

VpeCoord y2,

LPCSTR file_name

)

VpeHandle hDoc

Document Handle

VpeCoord x, y, x2, y2

position and dimensions, y2 may be set to VFREE

LPCSTR file_name

the file with RTF text that is 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)