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.v18.2.Core.dll
Declaration
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:
| Library | Object Type | Path to UseFontSubstitution |
|---|---|---|
| WinForms Controls | SnapControlOptions |
|
| RepositoryItemRichTextEdit |
|
|
| RichEditControlOptions |
|
|
| WPF Controls | RichEditControlOptions |
|
| Office File API | RichEditControlOptionsBase |
|
| ASP.NET Web Forms Controls | ASPxRichEditSettings |
|
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).
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.