How To: Create New Linked Style

• Apr 23, 2019
• 2 minutes to read

This example explains how to create a linked style – a style that can be applied both to the character and paragraph, depending on the range to which it is applied.

To create such a style, perform the following steps:

1. Create new paragraph style;
2. Create new character style;
3. Set the CharacterStyle.LinkedStyle to the newly created paragraph style, or set the ParagraphStyle.LinkedStyle property to the corresponding CharacterStyle object. It is sufficient to set only one of these properties.

Note

All the actions should be performed using the SubDocument.BeginUpdate - SubDocument.EndUpdate paired methods. Otherwise, flickering might occur when starting the application.

Note

A complete sample project is available at https://github.com/DevExpress-Examples/word-processing-document-api-examples-t418535

StylesActions.cs

Document document = server.Document;
document.BeginUpdate();
document.AppendText("Line One\nLine Two\nLine Three");
document.EndUpdate();
ParagraphStyle lstyle = document.ParagraphStyles["MyLinkedStyle"];
if (lstyle == null)
{
    document.BeginUpdate();
    lstyle = document.ParagraphStyles.CreateNew();
    lstyle.Name = "MyLinkedStyle";
    lstyle.LineSpacingType = ParagraphLineSpacing.Double;
    lstyle.Alignment = ParagraphAlignment.Center;
    document.ParagraphStyles.Add(lstyle);

    CharacterStyle lcstyle = document.CharacterStyles.CreateNew();
    lcstyle.Name = "MyLinkedCStyle";
    document.CharacterStyles.Add(lcstyle);
    lcstyle.LinkedStyle = lstyle;

    lcstyle.ForeColor = System.Drawing.Color.DarkGreen;
    lcstyle.Strikeout = StrikeoutType.Single;
    lcstyle.FontSize = 24;
    document.EndUpdate();
    document.SaveDocument("LinkedStyleSample.docx", DevExpress.XtraRichEdit.DocumentFormat.OpenXml);
    System.Diagnostics.Process.Start("explorer.exe", "/select," + "LinkedStyleSample.docx");
}

StylesActions.vb

Dim document As Document = server.Document
document.BeginUpdate()
document.AppendText("Line One" & vbLf & "Line Two" & vbLf & "Line Three")
document.EndUpdate()
Dim lstyle As ParagraphStyle = document.ParagraphStyles("MyLinkedStyle")
If lstyle Is Nothing Then
    document.BeginUpdate()
    lstyle = document.ParagraphStyles.CreateNew()
    lstyle.Name = "MyLinkedStyle"
    lstyle.LineSpacingType = ParagraphLineSpacing.Double
    lstyle.Alignment = ParagraphAlignment.Center
    document.ParagraphStyles.Add(lstyle)

    Dim lcstyle As CharacterStyle = document.CharacterStyles.CreateNew()
    lcstyle.Name = "MyLinkedCStyle"
    document.CharacterStyles.Add(lcstyle)
    lcstyle.LinkedStyle = lstyle

    lcstyle.ForeColor = System.Drawing.Color.DarkGreen
    lcstyle.Strikeout = StrikeoutType.Single
    lcstyle.FontSize = 24
    document.EndUpdate()
    document.SaveDocument("LinkedStyleSample.docx", DevExpress.XtraRichEdit.DocumentFormat.OpenXml)
    System.Diagnostics.Process.Start("explorer.exe", "/select," & "LinkedStyleSample.docx")
End If