<< Click to Display Table of Contents >> Navigation:  Layout Functions > InsertPage

[Professional Edition and above]

Inserts a new blank page at the position of the current page in the document.
The previously current page becomes the successor of the newly inserted page.
The new blank page becomes the current page.

method void VPE.InsertPage(

)

Remarks:

Pages numbered with the @PAGE macro or the $(Page) field are not renumbered after calling this method. We recommend to use the "<page> of <total pages>" technique explained in the Programmer's Manual.

 

The preview will refresh automatically after calling this function.

 

Enterprise Edition and above:
As you insert by code the page numbers as text objects into the document, obtain the VPE Object handles of those text objects by using the property LastInsertedObject and store these object references in a list. If there is a requirement for renumbering the document, first delete all objects in this list and then start the numbering process again.