Skip to main content

How to: Specify Default Document Formatting in the Rich Text Editor

  • 2 minutes to read

You can use one of the following approaches to specify default document formatting.

Set Default Formatting to the RichEditControl

The static RichEditControlCompatibility.DefaultFontSize and RichEditControlCompatibility.DefaultFontName properties set the default font settings for all RichEditControl instances in the application. Specify these properties before initialization of all controls, in the Main method, as illustrated in the following code.


The RichEditControl uses document themes to retrieve default document font information. As such, the RichEditControlCompatibility.DefaultFontName property longer affects the default document font.

Set the RichEditControlCompatibility.UseThemeFonts property to false when starting the application to restore the previous behavior in all instances of the RichEdit components. Set the RichEditBehaviorOptions.UseThemeFonts property to false before loading a new document to disable themes for a specific component.

View Example

using DevExpress.XtraRichEdit;

static void Main()
    RichEditControlCompatibility.DefaultFontSize = 8;
    RichEditControlCompatibility.DefaultFontName = "Tahoma";
    Application.Run(new Form1());

Set Default Formatting to the Specific Document

For the document loaded in the RichEditControl, you can specify default formatting characteristics individually using the Document.DefaultCharacterProperties and Document.DefaultParagraphProperties settings. These settings override the RichEditControlCompatibility settings.

View Example

using DevExpress.XtraBars.Ribbon;
using DevExpress.XtraRichEdit.API.Native;
using System;
using System.Drawing;

private void RichEditControl_EmptyDocumentCreated(object sender, EventArgs e) {

    Document document = richEditControl.Document;
    document.DefaultCharacterProperties.ForeColor = Color.Red;
    document.DefaultParagraphProperties.Alignment = ParagraphAlignment.Center;
    document.AppendText("Document created at " + DateTime.Now.ToLongTimeString());

To copy default document formatting from one document to another, use the Assign method.

The code snippet below copies default document formatting characteristics from the document loaded in the richEditControl2 control to the document contained in the richEditControl1 :