VpeRenderBoxRTFFile

<< Click to Display Table of Contents >>

Navigation:  Rendering >

VpeRenderBoxRTFFile

Previous pageReturn to chapter overviewNext page

[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)

 

See also:

"Rendering Objects" in the Programmer's Manual