Adds a page to the current document.
The AddPage function 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.