Rendering > VpeRenderWriteBox

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

int VpeRenderWriteBox(

VpeHandle hDoc,

VpeCoord x,

VpeCoord y,

VpeCoord x2,

VpeCoord y2,

LPCSTR s

)

VpeHandle hDoc

Document Handle

VpeCoord x, y, x2, y2

position and dimensions, x2 and / or y2 may be set to VFREE

LPCSTR s

the 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:

The computed dimensions can be retrieved with

VpeGet(hDoc, VRENDERWIDTH)

VpeGet(hDoc, VRENDERHEIGHT)