How to: Create New Character Style

Sep 19, 2023

The following example illustrates how to create a character style in code.

To achieve the required result, do the following:

Create a new style using the CharacterStyleCollection.CreateNew method;
Specify the style settings with the use of corresponding CharacterStyle object properties;
Add the style to the collection of character styles, represented by the CharacterStyleCollection object. To do that, use the CharacterStyleCollection.Add method. The collection is accessible through the Document.CharacterStyles property.

StylesActions.cs
StylesActions.vb

csharp

Document document = server.Document;
server.LoadDocument("Documents\\Grimm.docx", DocumentFormat.Docx);
CharacterStyle cstyle = document.CharacterStyles["MyCStyle"];
if (cstyle == null)
{
    cstyle = document.CharacterStyles.CreateNew();
    cstyle.Name = "MyCStyle";
    cstyle.Parent = document.CharacterStyles["Default Paragraph Font"];
    cstyle.ForeColor = System.Drawing.Color.DarkOrange;
    cstyle.Strikeout = StrikeoutType.Double;
    cstyle.FontName = "Verdana";
    document.CharacterStyles.Add(cstyle);
}
DocumentRange myRange = document.Paragraphs[0].Range;
CharacterProperties charProps =
    document.BeginUpdateCharacters(myRange);
charProps.Style = cstyle;
document.EndUpdateCharacters(charProps);

Dim document As Document = server.Document
server.LoadDocument("Documents\Grimm.docx", DocumentFormat.Docx)
Dim cstyle As CharacterStyle = document.CharacterStyles("MyCStyle")
If cstyle Is Nothing Then
    cstyle = document.CharacterStyles.CreateNew()
    cstyle.Name = "MyCStyle"
    cstyle.Parent = document.CharacterStyles("Default Paragraph Font")
    cstyle.ForeColor = System.Drawing.Color.DarkOrange
    cstyle.Strikeout = StrikeoutType.Double
    cstyle.FontName = "Verdana"
    document.CharacterStyles.Add(cstyle)
End If
Dim myRange As DocumentRange = document.Paragraphs(0).Range
Dim charProps As CharacterProperties = document.BeginUpdateCharacters(myRange)
charProps.Style = cstyle
document.EndUpdateCharacters(charProps)