NumberingLevelReference Class
Numbering Level Reference.When the object is serialized out as xml, its qualified name is w:ilvl.
Inheritance Hierarchy
System.Object
DocumentFormat.OpenXml.OpenXmlElement
DocumentFormat.OpenXml.OpenXmlLeafElement
DocumentFormat.OpenXml.Wordprocessing.NumberingLevelReference
Namespace: DocumentFormat.OpenXml.Wordprocessing
Assembly: DocumentFormat.OpenXml (in DocumentFormat.OpenXml.dll)
Syntax
'Declaration
Public Class NumberingLevelReference _
Inherits OpenXmlLeafElement
'Usage
Dim instance As NumberingLevelReference
public class NumberingLevelReference : OpenXmlLeafElement
Remarks
[ISO/IEC 29500-1 1st Edition]
17.9.3 ilvl (Numbering Level Reference)
This element specifies the numbering level of the numbering definition instance which shall be applied to the parent paragraph.
This numbering level is specified on either the abstract numbering definition's lvl element (§17.9.7), and can be overridden by a numbering definition instance level override's lvl element (§17.9.6).
[Example: Consider the following numbered paragraphs in a WordprocessingML document:
1. Level one
a. Level two
These numbered paragraphs might be represented using the following WordprocessingML:
<w:p> <w:pPr> <w:numPr> <w:ilvl w:val="0" /> <w:numId w:val="5" /> </w:numPr> </w:pPr> <w:r> <w:t>Level one</w:t> </w:r> </w:p> <w:p> <w:pPr> <w:numPr> <w:ilvl w:val="1" /> <w:numId w:val="5" /> </w:numPr> </w:pPr> <w:r> <w:t>Level two</w:t> </w:r> </w:p>
The WordprocessingML above specifies that the first numbered paragraph references the numbering level of 0, within the numbering definition of the num element (§17.9.16) with a numId attribute equal to 5.
The second numbered paragraph references the numbering of 1, within the same numbering definition instance. The WordprocessingML referenced by the ilvl elements above is given below:
<w:num w:numId="5"> <w:abstractNumId w:val="0" /> </w:num> … <w:abstractNum w:abstractNumId="0"> <w:nsid w:val="FFFFFF7F" /> <w:multiLevelType w:val="singleLevel" /> <w:lvl w:ilvl="0"> … </w:lvl> <w:lvl w:ilvl="1"> … </w:lvl> </w:abstractNum>
In this case, the resulting paragraphs would inherit the properties of the abstract numbering definition levels with ilvl attributes of 0 and 1, respectively. end example]
Parent Elements |
|---|
numPr (§17.3.1.19) |
Attributes |
Description |
|---|---|
val (Decimal Number Value) |
Specifies that the contents of this attribute contains a decimal number. The contents of this decimal number are interpreted based on the context of the parent XML element. [Example: Consider the following numeric WordprocessingML property of simple type ST_DecimalNumber: <… w:val="1512645511" /> The value of the val attribute is a decimal number whose value must be interpreted in the context of the parent element. end example] The possible values for this attribute are defined by the ST_DecimalNumber simple type (§17.18.10). |
[Note: The W3C XML Schema definition of this element’s content model (CT_DecimalNumber) 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.