VpeGotoPage

<< Click to Display Table of Contents >>

Navigation:  Layout Functions >

VpeGotoPage

Previous pageReturn to chapter overviewNext page

Moves to the specified page; all further output-calls will insert objects onto this page. This page is independently from the Visual Page shown in the preview  (see "Multipage Documents" in the Programmer's Manual and VpeGotoVisualPage()).

You can move at any time to any page to insert objects.

int VpeGotoPage(

VpeHandle hDoc,

int page

)

VpeHandle hDoc

Document Handle

int page

page number

Returns:

Value

Description

True

success

False

failure

Remarks:

In case of an error, LastError is set.

 

If you want to show the preview and let the user work with it (e.g. scroll and print), while your application is still generating the document, see "Generating a Document while the Preview is open" in the Programmer's Manual for details.

Example:

// moves to page 5

VpeGotoPage(hDoc, 5)

VpePrint(hDoc, 1, 1, "This is page 5")

 

// moves to page 2

VpeGotoPage(hDoc, 2)

VpePrint(hDoc, 1, 1, "This is page 2")