newPage

Syntax: newPage(document)

Returns: the page number of the newly created page

The newPage function adds a page to the document object and makes it the current page. It returns the page number of the newly created page.

NOTE: If you want your document to print, it must have at least one page. A common mistake is inadvertently add a number of elements to the master page — instead of page 1 — of a document by forgetting to call newPage beforehand. The resulting document will not print because it contains no body pages.