Adds a page to the current document.
The AddPage method returns the Object ID of the newly added Page
object. Typically, you will want to assign this return value to the
document Page property using code of the form.
theDoc.Page = theDoc.AddPage()
Pages are added at the end of the document. However, you can use
the PageNum parameter to insert pages at other locations. The
following code inserts a page at the start of a document.
theDoc.Page = theDoc.AddPage(1)
Any existing page and all subsequent pages will be shifted
towards the end of the document to make room for the insertion.