Share via


LevelRestart Class

Restart Numbering Level Symbol.When the object is serialized out as xml, its qualified name is w:lvlRestart.

Inheritance Hierarchy

System.Object
  DocumentFormat.OpenXml.OpenXmlElement
    DocumentFormat.OpenXml.OpenXmlLeafElement
      DocumentFormat.OpenXml.Wordprocessing.DecimalNumberType
        DocumentFormat.OpenXml.Wordprocessing.LevelRestart

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

Syntax

'Declaration
Public Class LevelRestart _
    Inherits DecimalNumberType
'Usage
Dim instance As LevelRestart
public class LevelRestart : DecimalNumberType

Remarks

[ISO/IEC 29500-1 1st Edition]

17.9.11 lvlRestart (Restart Numbering Level Symbol)

This element specifies a one-based index which determines when a numbering level should restart to its start value (§17.9.26). A numbering level restarts when an instance of the specified numbering level, which shall be higher (earlier than the this level) is used in the given document's contents.

If this element is omitted, the numbering level shall restart each time the previous numbering level is used. If the specified level is higher than the current level, then this element shall be ignored. As well, a value of 0 shall specify that this level shall never restart.

[Example: Consider a set of numbered paragraphs in a WordprocessingML document where numbering level with ilvl of 2 is set to never restart:

<w:lvl w:ilvl="0">
  <w:start w:val="1" />
  <w:lvlText w:val="%1)" />
  <w:lvlJc w:val="left" />
   <w:pPr>
    <w:ind w:left="360" w:hanging="360" />
  </w:pPr>
   <w:rPr>
    <w:rFonts w:hint="default" />
  </w:rPr>
</w:lvl>
 <w:lvl w:ilvl="1">
  <w:start w:val="1" />
  <w:numFmt w:val="upperLetter" />
  <w:lvlText w:val="%2)" />
  <w:lvlJc w:val="left" />
   <w:pPr>
    <w:ind w:left="720" w:hanging="360" />
  </w:pPr>
   <w:rPr>
    <w:rFonts w:hint="default" />
  </w:rPr>
</w:lvl>
<w:lvl w:ilvl="2">
  <w:start w:val="1" />
  <w:numFmt w:val="lowerRoman" />
  <w:lvlRestart w:val="0">
  <w:lvlText w:val="%3)" />
  <w:lvlJc w:val="left" />
   <w:pPr>
    <w:ind w:left="1080" w:hanging="360" />
  </w:pPr>
   <w:rPr>
    <w:rFonts w:hint="default" />
  </w:rPr>
</w:lvl>

Since the lvlRestart element is omitted in numbering level 1 (a,b,…), the numbering level restarts after numbering level 0 (1,2,…) is used. Numbering level two (i, ii, iii …) never restarts as lvlRestart has a val equal to 0. An example of the resulting content would be as follows:

1)Level one

a)Level two

i)Level three

ii)Level three

2)Level one

a)Level two

iii)Level three

iv)Level four

The resulting set of paragraphs has level two restarting to its start value after each level one (after 2), the next level two is again a)), but level three never restarts and continues at iii) even after the use of a level two and one. end example]

Parent Elements

lvl (§17.9.6); lvl (§17.9.7)

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.

See Also

Reference

LevelRestart Members

DocumentFormat.OpenXml.Wordprocessing Namespace