.NET Framework 4.5.2+
.NET Framework 4.5.2+
.NET Standard 2.0+

RichEditBehaviorOptions.UseFontSubstitution Property

Specifies whether or not to use a font substitution for displaying characters that are missing in the current font.

Namespace: DevExpress.XtraRichEdit

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

Declaration

[DefaultValue(true)]
public virtual bool UseFontSubstitution { get; set; }
<DefaultValue(True)>
Public Overridable Property UseFontSubstitution As Boolean

Property Value

Type Description
Boolean

true, to enable displaying substitution characters; otherwise, false.

Property Paths

You can access this nested property as listed below:

Show 18 property paths
Library Object Type Path to UseFontSubstitution
WinForms Controls SnapControl
.Options.Behavior.UseFontSubstitution
SnapControl
.Options.Behavior.UseFontSubstitution
SnapControlOptions
.Behavior.UseFontSubstitution
RepositoryItemRichTextEdit
.OptionsBehavior.UseFontSubstitution
RichEditControl
.Options.Behavior.UseFontSubstitution
RichEditControlOptions
.Behavior.UseFontSubstitution
WPF Controls RichEditControl
.Options.Behavior.UseFontSubstitution
RichEditControlOptions
.Behavior.UseFontSubstitution
ASP.NET Controls and MVC Extensions ASPxRichEdit
.Settings.Behavior.UseFontSubstitution
ASPxRichEditSettings
.Behavior.UseFontSubstitution
MVCxRichEdit
.Settings.Behavior.UseFontSubstitution
RichEditSettings
.Settings.Behavior.UseFontSubstitution
ASP.NET Bootstrap Controls BootstrapRichEdit
.Settings.Behavior.UseFontSubstitution
Office File API SnapDocumentServer
.Options.Behavior.UseFontSubstitution
IRichEditDocumentServer
.Options.Behavior.UseFontSubstitution
RichEditControlOptionsBase
.Behavior.UseFontSubstitution
RichEditDocumentServer
.Options.Behavior.UseFontSubstitution
Reporting SyntaxEditor
.Options.Behavior.UseFontSubstitution

Remarks

When the UseFontSubstitution property is enabled, the characters are selected among the fonts available in a font cache.

The substitution font must satisfy the following requirements.

  • It contains a symbol mapped to the missing character.
  • Its PANOSE distance (i.e., a measure of visual difference) is minimal.

The following image illustrates the UseFontSubstitution property in action (the UseFontSubstitution property is disabled for the RichEditControl displayed at the top).

usefontsubstitution

In the image above, the font has been changed from Arial to Arial Black. Because the Arial Black font has no symbol for representing the Object Replacement Character, the control displayed at the bottom substitutes this character by using the Arial font.

The plain text streams that are generated at runtime (e.g., application logs) may contain many such characters and applying substitution fonts to them may result in a serious loss of performance. In this case, you can speed up the perfomance by disabling the UseFontSubstitution property.

See Also