RichEditControlCompatibility.DefaultFontName Property

Gets or sets the name of the font which is the default font for Rich Edit controls in the application.

Namespace: DevExpress.XtraRichEdit

Assembly: DevExpress.RichEdit.v20.2.Core.dll

NuGet Package: DevExpress.RichEdit.Core

NuGet Packages: DevExpress.RichEdit.Core, DevExpress.WindowsDesktop.RichEdit.Core

Declaration

C#

[DefaultValue("Calibri")]
public static string DefaultFontName { get; set; }

VB.NET

<DefaultValue("Calibri")>
Public Shared Property DefaultFontName As String

Property Value

Type	Default	Description
String	"Calibri"	A string that is the font name.

Remarks

Important

Starting with v19.2, the RichEditDocumentServer and RichEditControl use document themes to retrieve default document font information. As such, the RichEditControlCompatibility.DefaultFontName property will no longer affect 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 (or DXRichEditBehaviorOptions.UseThemeFonts for WPF) to false before loading a new document to disable themes for a specific component.

Example

The static RichEditControlCompatibility.DefaultFontSize and RichEditControlCompatibility.DefaultFontName properties set the default font settings for all RichEditControl instances in the application. It is recommended to place them before initialization of all controls, in the Main method, as illustrated in the following code.

View Example

Program.cs

static void Main() {
    Application.EnableVisualStyles();
    Application.SetCompatibleTextRenderingDefault(false);
    DevExpress.XtraRichEdit.RichEditControlCompatibility.DefaultFontSize = 8;
    DevExpress.XtraRichEdit.RichEditControlCompatibility.DefaultFontName = "Tahoma";
    Application.Run(new Form1());
}

Program.vb

<STAThread> _
Shared Sub Main()
    Application.EnableVisualStyles()
    Application.SetCompatibleTextRenderingDefault(False)
    DevExpress.XtraRichEdit.RichEditControlCompatibility.DefaultFontSize = 8
    DevExpress.XtraRichEdit.RichEditControlCompatibility.DefaultFontName = "Tahoma"
    Application.Run(New Form1())
End Sub

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the DefaultFontName property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

how-to-specify-default-font-name-and-size/CS/DefaultDocumentSettingsExample/Form1.cs#L22

RichEditControlCompatibility.DefaultFontSize = 12;
RichEditControlCompatibility.DefaultFontName = "Times New Roman";
InitializeComponent();

VB.NET

how-to-specify-default-font-name-and-size/VB/DefaultDocumentSettingsExample/Form1.vb#L16

DevExpress.XtraRichEdit.RichEditControlCompatibility.DefaultFontSize = 12
DevExpress.XtraRichEdit.RichEditControlCompatibility.DefaultFontName = "Times New Roman"
InitializeComponent()