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: Consider the WordprocessingML below which specifies that the paragraph style with styleId example, when applied to paragraphs in the document, shall also apply the first numbering level of the abstract numbering definition with an abstractNumId equal to 1, as follows:

<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>

end example]

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: Consider the following WordprocessingML fragment:

<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. end example]

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>