CharacterBullet class

Office 2013 and later

Character Bullet. When the object is serialized out as xml, its qualified name is a:buChar.

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

public class CharacterBullet : OpenXmlLeafElement

[ISO/IEC 29500-1 1st Edition]

buChar (Character Bullet)

This element specifies that a character be applied to a set of bullets. These bullets are allowed to be any character in any font that the system is able to support. If no bullet font is specified along with this element then the paragraph font is used.

[Example: Consider the DrawingML shown below.

<p:txBody>
  …  <a:p>
    <a:pPr …>
      <a:buFont typeface="Calibri"/>
      <a:buChar char="g"/>
    </a:pPr>
    …    <a:t>
Bullet 1</a:t>
    …  </a:p>
  <a:p>
    <a:pPr lvl="1"…>
      <a:buFont typeface="Calibri"/>
      <a:buChar char="g"/>
    </a:pPr>
    …    <a:t>
Bullet 2</a:t>
    …  </a:p>
  <a:p>
    <a:pPr …>
      <a:buFont typeface="Calibri"/>
      <a:buChar char="g"/>
    </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". Because the same character is specified for each bullet the levels do not stand out here. The only difference is the indentation as 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

char (Bullet Character)

Specifies the character to be used in place of the standard bullet point. This character can be any character for the specified font that is supported by the system upon which this document is being viewed.

The possible values for this attribute are defined by the W3C XML Schema string datatype.

[Note: The W3C XML Schema definition of this element’s content model (CT_TextCharBullet) 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: