[Expand]General Information
[Collapse]WinForms Controls
  Prerequisites
 [Expand]What's Installed
 [Expand]Build an Application
 [Collapse]Controls and Libraries
  [Expand]Forms and User Controls
  [Expand]Messages, Notifications and Dialogs
  [Expand]Editors and Simple Controls
  [Expand]Ribbon, Bars and Menu
  [Expand]Application UI Manager
  [Expand]Docking Library
  [Expand]Data Grid
  [Expand]Vertical Grid
  [Expand]Property Grid
  [Expand]Pivot Grid
  [Expand]Tree List
  [Expand]Chart Control
  [Expand]Diagrams
  [Expand]Gauges
  [Expand]Map Control
  [Expand]Scheduler
  [Expand]Spreadsheet
  [Collapse]Rich Text Editor
   [Expand]Product Information
    Product Class Structure
    Supported Formats
   [Expand]Getting Started
   [Expand]RichEditControl Document
   [Expand]Fields
    Text Formatting
    Import and Export
   [Expand]Page Layout
    Printing
    Spell Checking
    AutoCorrect
    Mail Merge
    Restrictions and Protection
    Syntax Highlighting
   [Collapse]Visual Elements
    [Expand]Rich Edit Control
    [Expand]Command UI
    [Collapse]Dialogs
      Paste Special Dialog
      Font Dialog
      Paragraph and Tabs Dialogs
      Bullets and Numbering Dialog
      Find and Replace Dialog
      Symbol Dialog
      Bookmark Dialog
      Edit Hyperlink Dialog
      Page Setup Dialog
      Columns Dialog
      Line Numbers Dialog
      Insert Merge Field Dialog
      Document Protection Dialogs
      Editing Permissions Dialog
      Table Layout Dialogs
      Table Style Dialog
      Table Properties Dialogs
      Borders and Shading Dialog
      Style Editor Dialog
      Shape Layout Dialog
      Document Properties Dialog
      Table of Contents Dialog
      Language Dialog
     Pop-up Menus
    [Expand]Views
    Services
    Events
    Commands
    Keyboard Shortcuts
    HTML Tag Support
   [Expand]Examples
  [Expand]Spell Checker
  [Expand]Form Layout Managers
  [Expand]Navigation Controls
  [Expand]Printing-Exporting
  [Expand]PDF Viewer
   Reporting
  [Expand]Snap
  [Expand]TreeMap Control
  [Expand]Sunburst Control
 [Expand]Common Features
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Reporting
[Expand]Report and Dashboard Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

Insert Merge Field Dialog

The Insert Merge Field dialog enables end-users to insert merge fields from the data source into a document to perform a mail merge.

End-users can invoke this dialog by clicking Insert Merge Field on the Mail Merge ribbon tab. Refer to the How to: Create a Simple Word Processor with a Ribbon UI topic for details on how to provide the ribbon UI for the RichEditControl. Invoking the ShowInsertMergeFieldFormCommand command invokes this dialog as well.

Note

The dialog contains fields from the mail merge data source, which is attached to the RichEditControl by the RichEditMailMergeOptions.DataSource property.

To customize the default Insert Merge Field dialog or substitute it with completely new dialog, handle the RichEditControl.InsertMergeFieldFormShowing event. To get an example of the dialog replacement, refer to the How to: Customize the Search Form or How to: Customize the Hyperlink Form document.

To modify field names displayed within the dialog or in a drop-down list of the Write and Insert Field command bar or Ribbon group, handle the RichEditControl.CustomizeMergeFields event.

Expanded See Also

Is this topic helpful?​​​​​​​