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 page 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.