PageNumbers.Add Method

  • Article
Word Developer Reference

Returns a PageNumber object that represents page numbers added to a header or footer in a section.

Syntax

expression.Add(PageNumberAlignment, FirstPage)

expression   Required. A variable that represents a PageNumbers collection.

Parameters

Name Required/Optional Data Type Description
PageNumberAlignment Optional Variant Can be any WdPageNumberAlignment constant.
FirstPage Optional Variant False to make the first-page header and the first-page footer different from the headers and footers on all subsequent pages in the document. If FirstPage is set to False, a page number isn't added to the first page. If this argument is omitted, the setting is controlled by the DifferentFirstPageHeaderFooter property.

Remarks

If the LinkToPrevious property for the HeaderFooter object is set to True, the page numbers will continue sequentially from one section to next throughout the document.

Example

This example adds a page number to the primary footer in the first section of the active document.

Visual Basic for Applications 
  With ActiveDocument.Sections(1)
    .Footers(wdHeaderFooterPrimary).PageNumbers.Add _
        PageNumberAlignment:=wdAlignPageNumberLeft, _
        FirstPage:=True
End With

This example creates and formats page numbers in the header for the active document.

Visual Basic for Applications 
  Set myPgNum = ActiveDocument.Sections(1) _
    .Headers(wdHeaderFooterPrimary) _
    .PageNumbers.Add(PageNumberAlignment:= _
    wdAlignPageNumberCenter, FirstPage:= True)
myPgNum.Select
With Selection.Range
    .Italic = True
    .Bold = True
End With

See Also