FieldOptions.HighlightMode Property

Gets or sets when the document fields should be highlighted.

Namespace: DevExpress.XtraRichEdit

Assembly: DevExpress.RichEdit.v18.2.Core.dll

Declaration

C#

[DefaultValue(FieldsHighlightMode.Auto)]
public FieldsHighlightMode HighlightMode { get; set; }

VB.NET

<DefaultValue(FieldsHighlightMode.Auto)>
Public Property HighlightMode As FieldsHighlightMode

Property Value

Type	Default	Description
FieldsHighlightMode	**Auto**	A FieldsHighlightMode enumeration member specifying the condition.

Available values:

Name	Description
Auto	Default highlight mode (equals to FieldsHighlightMode.Never)
Never	Document fields are not visually recognized.
Always	Document fields are always highlighted.

Property Paths

You can access this nested property as listed below:

Library	Object Type	Path to HighlightMode
WinForms Controls	SnapControlOptions	.Fields.HighlightMode
	RichEditControlOptions	.Fields.HighlightMode
WPF Controls	RichEditControlOptions	.Fields.HighlightMode
Office File API	RichEditControlOptionsBase	.Fields.HighlightMode

Remarks

To specify the highlight color, use the FieldOptions.HighlightColor property. Options for display of the document fields are available via the RichEditControlOptionsBase.Fields property of the RichEditControl’s and RichEditDocumentServer’s options.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the HighlightMode property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

how-to-create-nested-fields-programmatically-e4004/CS/Form1.cs#L39

richEditControl1.Options.Fields.HighlightMode = FieldsHighlightMode.Always;
richEditControl1.Options.Fields.HighlightColor = System.Drawing.Color.Yellow;

how-to-replace-document-fields-with-their-values-e3482/CS/Form1.cs#L15

richEditControl1.Options.Fields.HighlightMode = FieldsHighlightMode.Always;
richEditControl1.Options.Fields.HighlightColor = Color.Yellow;

utility-for-creating-a-mail-merge-template-e3661/CS/Form1.cs#L15

richEditControl1.Options.Fields.HighlightColor = Color.Yellow;
richEditControl1.Options.Fields.HighlightMode = FieldsHighlightMode.Always;
richEditControl1.Options.DocumentSaveOptions.CurrentFileName = Path.Combine(Application.StartupPath, "Template.rtf");

VB.NET

how-to-replace-document-fields-with-their-values-e3482/VB/Form1.vb#L17

richEditControl1.Options.Fields.HighlightMode = FieldsHighlightMode.Always
richEditControl1.Options.Fields.HighlightColor = Color.Yellow

utility-for-creating-a-mail-merge-template-e3661/VB/Form1.vb#L17

richEditControl1.Options.Fields.HighlightColor = Color.Yellow
richEditControl1.Options.Fields.HighlightMode = FieldsHighlightMode.Always
richEditControl1.Options.DocumentSaveOptions.CurrentFileName = Path.Combine(Application.StartupPath, "Template.rtf")