Share via


ParagraphStyleIdInLevel Class

Paragraph Style's Associated Numbering Level.When the object is serialized out as xml, its qualified name is w:pStyle.

Inheritance Hierarchy

System.Object
  DocumentFormat.OpenXml.OpenXmlElement
    DocumentFormat.OpenXml.OpenXmlLeafElement
      DocumentFormat.OpenXml.Wordprocessing.String253Type
        DocumentFormat.OpenXml.Wordprocessing.ParagraphStyleIdInLevel

Namespace:  DocumentFormat.OpenXml.Wordprocessing
Assembly:  DocumentFormat.OpenXml (in DocumentFormat.OpenXml.dll)

Syntax

'Declaration
Public Class ParagraphStyleIdInLevel _
    Inherits String253Type
'Usage
Dim instance As ParagraphStyleIdInLevel
public class ParagraphStyleIdInLevel : String253Type

Remarks

[ISO/IEC 29500-1 1st Edition]

17.9.24 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 (§17.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 can be ignored.

[Example: Consider the WordprocessingML below which specifies that the paragraph style with styleId example, when applied to paragraphs in the document, must 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 (§17.9.6); lvl (§17.9.7)

Attributes

Description

val (String Value)

Specifies that its contents 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 (§22.9.2.13).

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

© ISO/IEC29500: 2008.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

See Also

Reference

ParagraphStyleIdInLevel Members

DocumentFormat.OpenXml.Wordprocessing Namespace