Document.DefaultCharacterProperties Property

Provides access to default character formatting for the current document.

Namespace: DevExpress.XtraRichEdit.API.Native

Assembly: DevExpress.RichEdit.v24.1.Core.dll

NuGet Packages: DevExpress.RichEdit.Core, DevExpress.Win.Navigation

Declaration

C#

CharacterPropertiesBase DefaultCharacterProperties { get; }

VB.NET

ReadOnly Property DefaultCharacterProperties As CharacterPropertiesBase

Property Value

Type	Description
CharacterPropertiesBase	A CharacterPropertiesBase interface that enables you to specify character properties.

Remarks

The DefaultCharacterProperties property enables you to specify default character formatting for a loaded or newly created document. These settings override the RichEditControlCompatibility.DefaultFontName and RichEditControlCompatibility.DefaultFontSize property values.

When formatting is reset by executing the ClearFormattingCommand, character properties are set to default values specified via the DefaultCharacterProperties property.

Example

The following code snippet illustrates how to apply default character formatting to a just loaded document. The RichEditControl.DocumentLoaded event is handled and the Document.DefaultCharacterProperties settings are modified.

View Example

Form1.vb

Private Sub RichEditControl1_DocumentLoaded(ByVal sender As Object, ByVal e As EventArgs)
    richEditControl1.Document.DefaultCharacterProperties.FontName = "Arial"
    richEditControl1.Document.DefaultCharacterProperties.FontSize = 16
End Sub

Form1.cs

private void RichEditControl1_DocumentLoaded(object sender, EventArgs e) {
    richEditControl1.Document.DefaultCharacterProperties.FontName = "Arial";
    richEditControl1.Document.DefaultCharacterProperties.FontSize = 16;
}