AutoNumberedBullet class

Office 2013 and later

Auto-Numbered Bullet. When the object is serialized out as xml, its qualified name is a:buAutoNum.

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

public class AutoNumberedBullet : OpenXmlLeafElement

[ISO/IEC 29500-1 1st Edition]

buAutoNum (Auto-Numbered Bullet)

This element specifies that automatic numbered bullet points should be applied to a paragraph. These are not just numbers used as bullet points but instead automatically assigned numbers that are based on both buAutoNum attributes and paragraph level.

[Example: Consider the DrawingML content shown below.

<p:txBody>
  …  <a:p>
    <a:pPr …>
      <a:buAutoNum type="arabicPeriod"/>
    </a:pPr>
    …    <a:t>Bullet 1</a:t>
    …  </a:p>
  <a:p>
    <a:pPr lvl="1"…>
      <a:buAutoNum type="arabicPeriod"/>
    </a:pPr>
    …    <a:t>Bullet 2</a:t>
    …  </a:p>
  <a:p>
    <a:pPr …>
      <a:buAutoNum type="arabicPeriod"/>
    </a:pPr>
    …    <a:t>Bullet 3</a:t>
    …  </a:p>
  …</p:txBody>

For the above text there are a total of three bullet points. Two of which are at lvl="0" and one at lvl="1". Due to this breakdown of levels, the numbering sequence that should be automatically applied is 1, 1, 2 as is shown in the picture above. end example]

Parent Elements

defPPr (§21.1.2.2.2); lvl1pPr (§21.1.2.4.13); lvl2pPr (§21.1.2.4.14); lvl3pPr (§21.1.2.4.15); lvl4pPr (§21.1.2.4.16); lvl5pPr (§21.1.2.4.17); lvl6pPr (§21.1.2.4.18); lvl7pPr (§21.1.2.4.19); lvl8pPr (§21.1.2.4.20); lvl9pPr (§21.1.2.4.21); pPr (§21.1.2.2.7)

Attributes

Description

startAt (Start Numbering At)

Specifies the number that starts a given sequence of automatically numbered bullets. When the numbering is alphabetical, the number should map to the appropriate letter. For instance 1 maps to 'a', 2 to 'b' and so on. If the numbers are larger than 26, then multiple letters should be used. For instance 27 should be represented as 'aa' and similarly 53 should be 'aaa'.

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

type (Bullet Autonumbering Type)

Specifies the numbering scheme that is to be used. This allows for the describing of formats other than strictly numbers. For instance, a set of bullets can be represented by a series of Roman numerals instead of the standard 1,2,3,etc. number set.

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

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

© ISO/IEC29500: 2008.

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