Table of contents
TOC
Collapse the table of content
Expand the table of content

Pages.Add Method (Publisher)

office 365 dev account|Last Updated: 8/24/2017
|
3 Contributors

Adds a new Page object to the specified Pages object and returns the new Page object.

Syntax

expression. Add( Count, After, DuplicateObjectsOnPage, AddHyperlinkToWebNavBar)

_expression_A variable that represents a Pages object.

Parameters

NameRequired/OptionalData TypeDescription
CountRequiredLongThe number of new pages to add.
AfterRequiredLongThe page index of the page after which to add the new pages. A zero for this argument adds new pages at the beginning of the publication.
DuplicateObjectsOnPageOptionalLongThe page index of the page from which objects should be copied to the new pages. If this argument is omitted, the new pages will be blank. The default is -1: do not duplicate pages.
AddHyperlinkToWebNavBarOptionalBooleanSpecifies whether links to the new pages will be added to the automatic navigation bars of existing pages. If True, links to the new pages will be added to the automatic navigation bars of existing pages only. If False, links to the new pages will not be added to the automatic navigation bars of existing pages or new pages added in the future. Default is False.

Return Value

Page

Example

The following example adds four new pages after the first page in the publication and copies all the objects from the first page to the new pages.

Dim pgNew As Page 

Set pgNew = ActiveDocument.Pages _ 
 .Add(Count:=4, After:=1, DuplicateObjectsOnPage:=1)

The following example demonstrates adding two new pages to the publication and setting the AddHyperlinkToWebNavBar parameter to True for these two pages. This specifies that links to these two new pages be added to the automatic navigation bars of existing pages and those added in the future.

Another page is then added to the publication, and the AddHyperlinkToWebNavBar is omitted. This means that the IncludePageOnNewWebNavigationBars property is False for the newly added page, and links to this page will not be included in the automatic navigation bars of existing pages.

Dim thePage As page 
Dim thePage2 As page 

Set thePage = ActiveDocument.Pages.Add(Count:=2, _ 
 After:=4, AddHyperlinkToWebNavBar:=True) 

Set thePage2 = ActiveDocument.Pages.Add(Count:=1, After:=6)
© 2017 Microsoft