Share via


CharacterBullet Class

Inheritance Hierarchy

System.Object
  DocumentFormat.OpenXml.OpenXmlElement
    DocumentFormat.OpenXml.OpenXmlLeafElement
      DocumentFormat.OpenXml.Drawing.CharacterBullet

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

Syntax

'Declaration
Public Class CharacterBullet _
    Inherits OpenXmlLeafElement
'Usage
Dim instance As CharacterBullet
public class CharacterBullet : OpenXmlLeafElement

Remarks

[ISO/IEC 29500-1 1st Edition]

21.1.2.4.3 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.

DocumentFormat.OpenXml.Drawing.CharacterBullet-ima

<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.

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

CharacterBullet Members

DocumentFormat.OpenXml.Drawing Namespace