Class
CharacterProperties

Manages character-level formatting (font, size, color, underline, shading) for inline text. Apply to Run elements or character styles to control text appearance with support for theme-aware colors and fonts.

Definition

Properties

BackgroundColor

Gets or sets the solid background color behind text, which combines with shading patterns when both are applied.

Declaration

cs-api-definition
public IStyleProperty<ThemableColor> BackgroundColor { get; }

Property Value

IStyleProperty<ThemableColor>

The color of the background.

Implements IPropertiesWithShading.BackgroundColor

BaselineAlignment

Gets or sets the vertical alignment of text relative to the baseline, controlling superscript and subscript positioning.

Declaration

cs-api-definition
public IStyleProperty<BaselineAlignment?> BaselineAlignment { get; }

Property Value

IStyleProperty<BaselineAlignment?>

The default value is Baseline.

FlowDirection

Gets or sets the text flow direction, controlling whether text reads left-to-right or right-to-left for multilingual document support.

Declaration

cs-api-definition
public IStyleProperty<FlowDirection?> FlowDirection { get; }

Property Value

IStyleProperty<FlowDirection?>

The default value is LeftToRight

FontFamily

Gets or sets the font family applied to text, supporting both explicit font names and theme-aware font references that adapt to the document's theme.

Declaration

cs-api-definition
public IStyleProperty<ThemableFontFamily> FontFamily { get; }

Property Value

IStyleProperty<ThemableFontFamily>

The font family.

FontSize

Gets or sets the font size in device-independent pixels (1/96 inch), controlling text height in the rendered document.

Declaration

cs-api-definition
public IStyleProperty<double?> FontSize { get; }

Property Value

IStyleProperty<double?>

The size of the font.

FontStyle

Gets or sets the font style (normal or italic) applied to text, determining the slant or posture of characters.

Declaration

cs-api-definition
public IStyleProperty<FontStyle?> FontStyle { get; }

Property Value

IStyleProperty<FontStyle?>

The default value is Normal.

FontWeight

Gets or sets the font weight (boldness) applied to text, controlling the thickness of character strokes.

Declaration

cs-api-definition
public IStyleProperty<FontWeight?> FontWeight { get; }

Property Value

IStyleProperty<FontWeight?>

The default value is Normal.

ForegroundColor

Gets or sets the foreground (text) color, supporting both explicit color values and theme-aware colors that adapt to the document's color scheme.

Declaration

cs-api-definition
public IStyleProperty<ThemableColor> ForegroundColor { get; }

Property Value

IStyleProperty<ThemableColor>

The default value is black.

HighlightColor

Gets or sets the highlight color applied behind text, simulating a text marker or highlighter pen effect.

Declaration

cs-api-definition
public IStyleProperty<Color?> HighlightColor { get; }

Property Value

IStyleProperty<Color?>

The default value is Transparent.

ShadingPattern

Gets or sets the pattern style used to combine the shading pattern color with the background color, enabling effects like diagonal stripes or dots.

Declaration

cs-api-definition
public IStyleProperty<ShadingPattern?> ShadingPattern { get; }

Property Value

IStyleProperty<ShadingPattern?>

The default value is Clear

Implements IPropertiesWithShading.ShadingPattern

ShadingPatternColor

Gets or sets the foreground color for shading patterns, which is layered over the background color according to the specified pattern style.

Declaration

cs-api-definition
public IStyleProperty<ThemableColor> ShadingPatternColor { get; }

Property Value

IStyleProperty<ThemableColor>

The color of the pattern.

Implements IPropertiesWithShading.ShadingPatternColor

Strikethrough

Gets or sets whether a horizontal line is drawn through the middle of the text, indicating deletion or emphasis.

Declaration

cs-api-definition
public IStyleProperty<bool?> Strikethrough { get; }

Property Value

IStyleProperty<bool?>

The default value is false.

UnderlineColor

Gets or sets the color of the underline decoration, which can differ from the text foreground color.

Declaration

cs-api-definition
public IStyleProperty<ThemableColor> UnderlineColor { get; }

Property Value

IStyleProperty<ThemableColor>

The color.

UnderlinePattern

Gets or sets the underline pattern style (single, double, dashed, wavy, etc.) applied beneath the text.

Declaration

cs-api-definition
public IStyleProperty<UnderlinePattern?> UnderlinePattern { get; }

Property Value

IStyleProperty<UnderlinePattern?>

The default value is None

Methods

EnumerateStyleProperties()

Enumerates the style properties.

Declaration

cs-api-definition
protected override IEnumerable<IStyleProperty> EnumerateStyleProperties()

Returns

IEnumerable<IStyleProperty>

The style properties.

Overrides DocumentElementPropertiesBase.EnumerateStyleProperties()

GetStylePropertyOverride(IStylePropertyDefinition)

Gets specific style property or null.

Declaration

cs-api-definition
protected override IStyleProperty GetStylePropertyOverride(IStylePropertyDefinition propertyDefinition)

Parameters

propertyDefinition

IStylePropertyDefinition

The property definition.

Returns

IStyleProperty

Overrides DocumentElementPropertiesBase.GetStylePropertyOverride(IStylePropertyDefinition)