a:buClrScheme (Bullet Scheme Color)

References a scheme color for bullet points, enabling theme-coordinated bullet coloring.

Parent elements

a:pPr (paragraph properties)

Description

a:buClrScheme is the DrawingML bullet scheme color element that applies a scheme color to bullets. It is defined in ECMA-376 Part 1 §20.1.2.1.4.

Bullet scheme colors provide:

Theme-coordinated bullet colors
Automatic color updates with theme changes
Consistency with document color scheme
Single-point control for bullet appearance

Common scheme color values:

dk1/lt1: Dark/Light primary
accent1-accent6: Accent colors
hlink/folHlink: Hyperlink colors

Attributes

Attribute	Type	Possible Values	Description
`val`	SchemeColorValues	dk1, lt1, dk2, lt2, accent1-accent6, hlink, folHlink	Scheme color reference.

Examples

Accent Color 1 for Bullets

<a:pPr>
  <a:buClrScheme val="accent1"/>
</a:pPr>

using DocumentFormat.OpenXml.Drawing;

var pPr = new ParagraphProperties();
var buClrScheme = new BulletColorScheme { Val = SchemeColorValues.Accent1 };
pPr.Append(buClrScheme);

Dark Text Color for Bullets

<a:pPr>
  <a:buClrScheme val="dk1"/>
</a:pPr>

var pPr = new ParagraphProperties();
var buClrScheme = new BulletColorScheme { Val = SchemeColorValues.Dark1 };
pPr.Append(buClrScheme);

Notes

Simpler than buClr when scheme colors are preferred
Updates automatically when document theme changes
Standard scheme colors ensure consistency
Cannot apply modifications (tint, shade) directly
For color-modified bullets, use a:buClr with scheme color child instead