Skip to main content

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.v24.1.Core.dll

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

Declaration

[DefaultValue(true)]
public virtual bool UseFontSubstitution { get; set; }

Property Value

Type Default Description
Boolean true

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

Property Paths

You can access this nested property as listed below:

Object Type Path to UseFontSubstitution
RichEditControlOptionsBase
.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