17.3.3.22 pgNum

This element specifies the presence of a page number block at the current location in the run content. A page number block is a non-editable region of text which shall display the current page using ascending decimal numbers. [Note: The page number block is a legacy construct used for compatibility with older word processors, and should not be produced unless it was consumed while reading a document – it is recommended that the PAGENUM field is used in its place. end note]

A page number block shall be displayed using ascending decimal numbers, regardless of the languages specified in the parent run’s lang property (17.3.2.20).

[Example: Consider a WordprocessingML run with the following run content:

<w:r>
  <w:t xml:space="preserve">This is the current page: </w:t>
  <w:pgNum />
</w:r>

This run specifies that a page number block must be placed after the text string literal This is the current page: in the document. Assuming that this content is on the first page, this run would be displayed as follows:

This is the current page: 1

end example]

[Note: The W3C XML Schema definition of this element’s content model (CT_Empty) is located in A.1. end note]