<pStyle> (Paragraph Style's Associated Numbering Level)

This element specifies the name of a paragraph style which shall automatically this numbering level when applied to the contents of the document. When a paragraph style is defined to include a numbering definition, any numbering level defined by the <numPr> element (§2.3.1.19) shall be ignored, and instead this element shall specify the numbering level associated with that paragraph style.

If this element references a style which does not exist, or is not a paragraph style, then it may be ignored.

example:
<w:abstractNum w:abstractNumId="1">
  ...
  <w:lvl w:ilvl="0">
    ...
    <w:pStyle w:val="example" />
    <w:pPr>
      <w:tabs>
        <w:tab w:val="num" w:pos="720" />
      </w:tabs>
      <w:ind w:left="720" w:hanging="360" />
    </w:pPr>
    ...
  </w:lvl>
</w:abstractNum>

The style definition for the paragraph style would only include the @numId of the numbering definition instance, and not its level:

<w:style w:styleId="example" w:type="paragraph"><w:pPr>
    <w:numPr>
      <w:numId w:val="0" />
    </w:numPr>
  </w:pPr>
</w:style>

Parent Elements

<lvl>2.9.6); <lvl>2.9.7)

Attributes

Description

<val> (String Value)

Specifies that its contents will contain a string.

The contents of this string are interpreted based on the context of the parent XML element.

example:
<w:pPr>
  <w:pStyle w:val="heading1" /> 
</w:pPr>

The value of the @val attribute is the ID of the associated paragraph style's styleId.

However, consider the following fragment:

<w:sdtPr>
  <w:alias w:val="SDT Title Example" />
  ...
</w:sdtPr>

In this case, the decimal number in the @val attribute is the caption of the parent structured document tag. In each case, the value is interpreted in the context of the parent element. ]

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

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

<complexType name="CT_String">
	<attribute name="val" type="ST_String" use="required"/>
</complexType>