RichEditMailMergeOptions.CustomSeparators Property

Allows you to specify group and decimal separators used in a numeric format switch.

Namespace: DevExpress.XtraRichEdit

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

Declaration

C#

public MailMergeCustomSeparators CustomSeparators { get; }

VB.NET

Public ReadOnly Property CustomSeparators As MailMergeCustomSeparators

Property Value

Type	Description
MailMergeCustomSeparators	A MailMergeCustomSeparators object.

Property Paths

You can access this nested property as listed below:

Library	Object Type	Path to CustomSeparators
WinForms Controls	SnapControlOptions	.MailMerge.CustomSeparators
	RichEditControlOptions	.MailMerge.CustomSeparators
WPF Controls	RichEditControlOptions	.MailMerge.CustomSeparators
Office File API	RichEditControlOptionsBase	.MailMerge.CustomSeparators

Remarks

If custom separators are specified, they are used instead of separators which are specific for the current locale.

Consider the situation when the separators used in format switches differ from separators defined for the current locale. For example, the numeric format switch uses a comma as a decimal separator while the current locale uses a dot. Then the following field will be displayed incorrectly:

MERGEFIELD MyNumber ##,##

Instead of, say, “7.65” it will show “8”.

To fix the problem, use the CustomSeparators property and set the MailMergeCustomSeparators.MaskDecimalSeparator to “,” (comma). Subsequently the format string will be parsed as expected and the display will be “7.65”.