DXRichEditBehaviorOptions.UseFontSubstitution Property

Gets or sets whether to use a font substitution for displaying characters that are missing in the current font. This is a dependency property.

Namespace: DevExpress.Xpf.RichEdit

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

Declaration

public bool UseFontSubstitution { get; set; }
Public 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:

Object Type Path to UseFontSubstitution
RichEditControl
.BehaviorOptions.UseFontSubstitution

Remarks

With the UseFontSubstitution property enabled, RichEditControl selects the characters among the fonts available in a font cache.

The substitution font should meet 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.

usefontsubstitution

In the image above, the font has been changed from Arial to Arial Black. Since the Arial Black font has no symbol for representing the Object Replacement Character, the control substitutes this character by using the Arial font (shown in the image below).

See Also