a:buClr (Bullet Color)

Description

a:buClr is the DrawingML bullet color element that defines the color for bullet points or numbering in a paragraph. It is defined in ECMA-376 Part 1 §20.1.2.1.3.

Bullet colors:

• Apply to bullet characters and numbers
• Override text color for bullets
• Enable visual distinction between bullets and text
• Support all color models (RGB, scheme, system, preset)

Typical uses:

• Matching bullets to theme accent colors
• Creating visual hierarchy in lists
• Emphasizing bullet points
• Consistent brand color application

Attributes

Examples

Bullet with RGB Color

<a:pPr>
  <a:buClr>
    <a:srgbClr val="FF0000"/>
  </a:buClr>
</a:pPr>

using DocumentFormat.OpenXml.Drawing;

var pPr = new ParagraphProperties();
var buClr = new BulletColor();
var srgbClr = new RgbColorModelHex { Val = "FF0000" }; // Red
buClr.Append(srgbClr);
pPr.Append(buClr);

Bullet with Scheme Color

<a:buClr>
  <a:schemeClr val="accent1">
    <a:shade val="40000"/>
  </a:schemeClr>
</a:buClr>

var buClr = new BulletColor();
var schemeClr = new SchemeColor { Val = SchemeColorValues.Accent1 };
var shade = new Shade { Val = 40000 }; // 40% darker
schemeClr.Append(shade);
buClr.Append(schemeClr);

Notes

• Bullet color applies only to bullet character/number, not the text
• If not specified, bullets use text color
• Supports all color models: RGB, scheme, system, preset
• Color modifications (tint, shade, alpha) can be applied
• Useful for creating visual emphasis in bulleted lists
• Works with both character bullets and automatic numbering