<pgBorders> (Page Borders)

This element specifies the page borders for each page in this section. Each child element of the <pgBorders> element specifies a specific of border (<left>, <right>, <bottom>, or <top>).

example:

This page border setting would be specified using the following WordprocessingML:

<w:pgBorders w:offsetFrom="page">
  <w:top w:val="dashed" w:sz="4" w:space="24" w:color="auto" /> 
  <w:left w:val="dashed" w:sz="4" w:space="24" w:color="auto" /> 
  <w:bottom w:val="dashed" w:sz="4" w:space="24" w:color="auto" /> 
  <w:right w:val="dashed" w:sz="4" w:space="24" w:color="auto" /> 
</w:pgBorders>

The four page borders are each uniquely defined by the <top>, <left>, <bottom>, and <right> elements, respectively. Global settings that define the placement of all page borders are stored on the <pgBorders> element directly. ]

Parent Elements

<sectPr> (§2.6.17); <sectPr> (§2.6.18); <sectPr> (§2.6.19)

Child Elements

Subclause

<bottom> (Bottom Border)

§2.6.2

<left> (Left Border)

§2.6.7

<right> (Right Border)

§2.6.15

<top> (Top Border)

§2.6.21

Attributes

Description

<display> (Pages to Display Page Borders)

Specifies the pages in this section on which the page border shall be printed.

If this attribute is omitted, then the page borders shall be displayed on all pages in this section (equivalent to a value of allPages).

<w:pgBorders w:display="firstPage">
  …
</w:pgBorders>

The @display attribute specifies that only the first page shall display the page border defined for this section. ]

The possible values for this attribute are defined by the ST_PageBorderDisplay simple type (§2.18.68).

<offsetFrom> (Page Border Positioning)

Specifies how the relative positioning of the page borders shall be calculated.

If the value of this attribute is page, then the @space attribute on each page border shall be interpreted as the distance from the edge of the page that shall be left before the page border.

If the value of this attribute is text, then the @space attribute on each page border shall be interpreted as the distance from the text margins that shall be left before the page border.

<w:pgBorders w:offsetFrom="page">
  <w:top w:val="dashed" w:space="24" />
  <w:left w:val="dashed" w:space="24" />
  <w:bottom w:val="dashed" w:space="24"/>
  <w:right w:val="dashed" w:space="24"/>
</w:pgBorders>

This fragment specifies that the page borders shall be indented 24 points from the page extents.

This is distinct from the following fragment with identical @space attribute values:

<w:pgBorders w:offsetFrom="text">
  <w:top w:val="dashed" w:space="24" />
  <w:left w:val="dashed" w:space="24" />
  <w:bottom w:val="dashed" w:space="24"/>
  <w:right w:val="dashed" w:space="24"/>
</w:pgBorders>

In this case, the page borders will be offset by 24 points, but in this case, that offset will be calculated relative to the text margins. ]

The possible values for this attribute are defined by the ST_PageBorderOffset simple type (§2.18.69).

<zOrder> (Z-Ordering of Page Border)

Specifies whether the page border is positioned above or below intersecting texts and objects in this document.

This setting is specified by setting the @zOrder attribute to back, which specifies that the page border shall be display behind all intersecting text and objects. ]

The possible values for this attribute are defined by the ST_PageBorderZOrder simple type (§2.18.70).

The following XML Schema fragment defines the contents of this element:

<complexType name="CT_PageBorders">
	<sequence>
	<element name="top" type="CT_Border" minOccurs="0"/>
	<element name="left" type="CT_Border" minOccurs="0"/>
	<element name="bottom" type="CT_Border" minOccurs="0"/>
	<element name="right" type="CT_Border" minOccurs="0"/>
	</sequence>
	<attribute name="zOrder" type="ST_PageBorderZOrder" use="optional"/>
	<attribute name="display" type="ST_PageBorderDisplay" use="optional"/>
	<attribute name="offsetFrom" type="ST_PageBorderOffset" use="optional"/>
</complexType>