Document.CreateMailMergeOptions() Method

Enables customizing the mail merge options.

Namespace: DevExpress.XtraRichEdit.API.Native

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

NuGet Package: DevExpress.RichEdit.Core

Declaration

C#

MailMergeOptions CreateMailMergeOptions()

VB.NET

Function CreateMailMergeOptions As MailMergeOptions

Returns

Type	Description
MailMergeOptions	A MailMergeOptions instance, specifying the mail merge options.

Remarks

The default mail merge options are specified via the RichEditControlOptionsBase.MailMerge property.

To modify mail merge options, create a MailMergeOptions object (by calling the CreateMailMergeOptions method), and pass the modified options as a parameter to the Document.MailMerge method.

For more information, refer to Mail Merge.

Related GitHub Examples

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

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#

mail-merge-in-a-richeditcontrol/CS/MailMerge/Form1.cs#L27

#region #merge
MailMergeOptions myMergeOptions = richEditControl1.Document.CreateMailMergeOptions();
myMergeOptions.FirstRecordIndex = 1;

how-to-use-images-in-richedit-mail-merge/CS/Form1.cs#L39

if (form.ShowDialog(this) == DialogResult.OK) {
    MailMergeOptions options = richEditControl1.Document.CreateMailMergeOptions();

winforms-richedit-use-calculatedocumentvariable-event-to-insert-formatted-content/CS/Form1.cs#L31

private void button2_Click(object sender, EventArgs e) {
    MailMergeOptions myMergeOptions = richEditControl1.Document.CreateMailMergeOptions();
    myMergeOptions.MergeMode = MergeMode.NewParagraph;

how-to-use-docvariable-fields/CS/DocumentVariablesExample/Form1.cs#L35

private void btnMailMerge_Click(object sender, EventArgs e) {
    MailMergeOptions myMergeOptions = richEditControl1.Document.CreateMailMergeOptions();
    myMergeOptions.MergeMode = MergeMode.NewSection;

word-document-api-use-docvariable-fields/CS/WordProcessingFileAPI_CalcDocumentVariable/Program.cs#L28

// Adjust mail-merge options
MailMergeOptions myMergeOptions = document.CreateMailMergeOptions();
myMergeOptions.MergeMode = MergeMode.NewSection;

VB.NET

mail-merge-in-a-richeditcontrol/VB/MailMerge/Form1.vb#L26

'#Region "#merge"
            Dim myMergeOptions As MailMergeOptions = richEditControl1.Document.CreateMailMergeOptions()
            myMergeOptions.FirstRecordIndex = 1

how-to-use-images-in-richedit-mail-merge/VB/Form1.vb#L40

If form.ShowDialog(Me) = DialogResult.OK Then
    Dim options As MailMergeOptions = richEditControl1.Document.CreateMailMergeOptions()
    CalculateMailMergeOptions(form, options)

winforms-richedit-use-calculatedocumentvariable-event-to-insert-formatted-content/VB/Form1.vb#L29

Private Sub button2_Click(ByVal sender As Object, ByVal e As EventArgs)
    Dim myMergeOptions As MailMergeOptions = richEditControl1.Document.CreateMailMergeOptions()
    myMergeOptions.MergeMode = MergeMode.NewParagraph

how-to-use-docvariable-fields/VB/DocumentVariablesExample/Form1.vb#L35

Private Sub btnMailMerge_Click(ByVal sender As Object, ByVal e As EventArgs)
    Dim myMergeOptions As MailMergeOptions = richEditControl1.Document.CreateMailMergeOptions()
    myMergeOptions.MergeMode = MergeMode.NewSection

word-document-api-use-docvariable-fields/VB/WordProcessingFileAPI_CalcDocumentVariable/Program.vb#L22

' Adjust mail-merge options
Dim myMergeOptions As MailMergeOptions = document.CreateMailMergeOptions()
myMergeOptions.MergeMode = MergeMode.NewSection