VpeRenderWriteBox

<< Click to Display Table of Contents >>

Navigation:  Rendering >

VpeRenderWriteBox

Previous pageReturn to chapter overviewNext page

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)

 

See also:

"Rendering Objects" in the Programmer's Manual