This example demonstrates how to use the mail merge functionality of the Nevron Diagram control.
Click the Preview Mail Merge button from the Mailings ribbon tab to see the values for the currently selected mail merge record. When ready, click the Merge & Save button to save all merged documents to a file.
The Merge & Save button saves each individual document resulting from the mail merge operation to a folder.

| Language: C# |
using Nevron.Nov;
using Nevron.Nov.Diagram;
using Nevron.Nov.Diagram.Shapes;
using Nevron.Nov.Dom;
using Nevron.Nov.Graphics;
using Nevron.Nov.Layout;
using Nevron.Nov.Text;
using Nevron.Nov.Text.Data;
using Nevron.Nov.UI;
using Nevron.Nov.Windows.Forms;
using System.IO;
using System.Windows.Forms;
namespace NovWinFormsProject
{
public partial class Form1 : Form
{
#region Constructors
public Form1()
{
InitializeComponent();
// Set form title
Text = "NOV WinForms - NMailMergeExample";
// Create the NOV example and its controls
NWidget exampleContent = CreateExampleContent();
NWidget exampleControls = CreateExampleControls();
if (exampleControls != null)
{
exampleControls.PreferredWidth = 300;
}
// Place the example and its controls in a pair box
NPairBox pairBox = new NPairBox(exampleContent, exampleControls);
pairBox.FillMode = ENStackFillMode.First;
pairBox.FitMode = ENStackFitMode.First;
pairBox.Margins = new NMargins(NDesign.HorizontalSpacing, NDesign.VerticalSpacing);
// Host the example in the form
NNovWidgetHost host = new NNovWidgetHost(pairBox);
host.Dock = DockStyle.Fill;
Controls.Add(host);
}
#endregion
#region Example
public NWidget CreateExampleContent()
{
// Create a simple drawing
NDrawingViewWithRibbon drawingViewWithRibbon = new NDrawingViewWithRibbon();
m_DrawingView = drawingViewWithRibbon.View;
m_DrawingView.Document.HistoryService.Pause();
try
{
InitDiagram(m_DrawingView.Document);
}
finally
{
m_DrawingView.Document.HistoryService.Resume();
}
return drawingViewWithRibbon;
}
public NWidget CreateExampleControls()
{
return null;
}
public string GetExampleDescription()
{
string previewMailMergeUri = NUriHelpers.CreateDataUriString(Nevron.Nov.Graphics.NImage.FromBytes(Nevron.Nov.NConvert.FromBase64String("iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAABrElEQVR4Ac2OA6ydQRBGt3Zj1LZt2whq2+bVM++zbdsIarsNaptBrdN/alsn+bLfcEf9EeydzFa29o7Y2DkgEu/g7GKtvgcbe8cr6enpfIzktNrVrw/bOVolpyQjLArdRGd9Cl0MKSwN24yQotVs7Z2s1MeMHTcBeS0srXny8B7LYnZTeOwO3Xr0oVXHXizLPM3K2D1Sw9LaBukdP2EiShg5crSYNuL1RhPCyIADtG3Tnvh95/HcdZ4qjdswOvAAgtFkgXpFm5ezfXr3fZNQ63QGePaYqcmXqVm3IVXqNqZqo2ZUbtCEaVpOajq96W3/m9k2LVu05M2Ca1cv47rrHqpkBXzOQdJjKFamIpK7duUyOqM10tuiZdu3l6s3ZvbceUFBwcHcun0H74OwapumreCl+Ztaztc/CGsnL96f+ZjKK1auvuXvH8Dpk8e4efUiIvE+vgGs1tny/PFt9np1RX2F5tOmzwpevnwVy5ateCXNL12pY2PEashuCA92stu7z1eXVJYTP1a6ZR+ehleHvFZs9RiA+gnaJFoMJsE0hCP+XTeqn+TNRXXUf8ELg3Iu6K3kg3kAAAAASUVORK5CYII=")));
return $@"
This example demonstrates how to use the mail merge functionality of the Nevron Diagram control.
Click the Preview Mail Merge button (
)
from the Mailings ribbon tab to see the values for the currently selected
mail merge record. When ready, click the Merge & Save button to save all merged documents to a file.
The Merge & Save button saves each individual document resulting from the mail
merge operation to a folder.
";
}
///
/// Gets the relevant documentation links for the example
///
///
public (string Name, string Url)[] GetDocumentationUrls()
{
return new[]
{
("Rich Text - Mail Merge Overview", "https://www.nevron.com/docs/openvision/rich-text-mail-merge-overview.html"),
("Text Block", "https://www.nevron.com/docs/openvision/diagram-text-block.html"),
("Rich Text - Mail Merge Fields", "https://www.nevron.com/docs/openvision/rich-text-mail-merge-fields.html"),
("Rich Text - Mail Merge Data Sources", "https://www.nevron.com/docs/openvision/rich-text-mail-merge-data-sources.html"),
};
}
private void InitDiagram(NDrawingDocument drawingDocument)
{
NDrawing drawing = drawingDocument.Content;
NPage activePage = drawing.ActivePage;
// Hide the grid and the ports
drawing.ScreenVisibility.ShowGrid = false;
drawing.ScreenVisibility.ShowPorts = false;
// Get the basic shapes library
NBasicShapeFactory basicShapes = new NBasicShapeFactory();
basicShapes.DefaultSize = new NSize(100, 100);
// Create the Name shape
NShape nameShape = basicShapes.CreateShape(ENBasicShape.Rectangle);
nameShape.Width = 150;
nameShape.PinX = activePage.Width / 2;
nameShape.PinY = 100;
NParagraph paragraph = new NParagraph();
paragraph.Inlines.Add(new NFieldInline(new NMailMergePredefinedFieldValue(ENMailMergeDataField.FirstName)));
paragraph.Inlines.Add(new NTextInline(" "));
paragraph.Inlines.Add(new NFieldInline(new NMailMergePredefinedFieldValue(ENMailMergeDataField.LastName)));
nameShape.GetTextBlock().Content.Blocks.Clear();
nameShape.GetTextBlock().Content.Blocks.Add(paragraph);
activePage.Items.Add(nameShape);
// Create the City shape
NShape cityShape = basicShapes.CreateShape(ENBasicShape.SixPointStar);
cityShape.PinX = nameShape.PinX - 150;
cityShape.PinY = nameShape.PinY + 200;
paragraph = new NParagraph();
paragraph.Inlines.Add(new NFieldInline(new NMailMergePredefinedFieldValue(ENMailMergeDataField.City)));
cityShape.GetTextBlock().Content.Blocks.Clear();
cityShape.GetTextBlock().Content.Blocks.Add(paragraph);
activePage.Items.Add(cityShape);
// Create the Birth Date shape
NShape birthDateShape = basicShapes.CreateShape(ENBasicShape.Circle);
birthDateShape.PinX = nameShape.PinX + 150;
birthDateShape.PinY = cityShape.PinY;
paragraph = new NParagraph();
paragraph.Inlines.Add(new NFieldInline(new NMailMergeSourceFieldValue("BirthDate")));
birthDateShape.GetTextBlock().Content.Blocks.Clear();
birthDateShape.GetTextBlock().Content.Blocks.Add(paragraph);
activePage.Items.Add(birthDateShape);
// Connect the shapes
NRoutableConnector connector = new NRoutableConnector();
connector.Text = "City";
connector.TextBlock.BackgroundFill = new NColorFill(NColor.White);
connector.GlueBeginToNearestPort(nameShape);
connector.GlueEndToNearestPort(cityShape);
activePage.Items.Add(connector);
connector = new NRoutableConnector();
connector.Text = "Birth Date";
connector.TextBlock.BackgroundFill = new NColorFill(NColor.White);
connector.GlueBeginToNearestPort(nameShape);
connector.GlueEndToNearestPort(birthDateShape);
activePage.Items.Add(connector);
// Load a mail merge data source from resource
Stream stream = new MemoryStream(Nevron.Nov.NConvert.FromBase64String("RW1wbG95ZWVJRDtMYXN0TmFtZTtGaXJzdE5hbWU7VGl0bGU7VGl0bGVPZkNvdXJ0ZXN5O0JpcnRoRGF0ZTtIaXJlRGF0ZTtBZGRyZXNzO0NpdHk7UmVnaW9uO1Bvc3RhbENvZGU7Q291bnRyeTtIb21lUGhvbmU7RXh0ZW5zaW9uO1Bob3RvO05vdGVzO1JlcG9ydHNUbw0KMTtEYXZvbGlvO05hbmN5O1NhbGVzIFJlcHJlc2VudGF0aXZlO01zLjs4LjEyLjE5Njg7MS41LjE5OTI7IjUwNyAtIDIwdGggQXZlLiBFLg0KQXB0LiAyQSI7U2VhdHRsZTtXQTs5ODEyMjtVU0E7KDIwNikgNTU1LTk4NTc7NTQ2NztFbXBJRDEuYm1wOyJFZHVjYXRpb24gaW5jbHVkZXMgYSBCQSBpbiBwc3ljaG9sb2d5IGZyb20gQ29sb3JhZG8gU3RhdGUgVW5pdmVyc2l0eS4gIFNoZSBhbHNvIGNvbXBsZXRlZCAiIlRoZSBBcnQgb2YgdGhlIENvbGQgQ2FsbC4iIiAgTmFuY3kgaXMgYSBtZW1iZXIgb2YgVG9hc3RtYXN0ZXJzIEludGVybmF0aW9uYWwuIjsyDQoyO0Z1bGxlcjtBbmRyZXc7VmljZSBQcmVzaWRlbnQsIFNhbGVzO0RyLjsxOS4yLjE5NTI7MTQuOC4xOTkyOzkwOCBXLiBDYXBpdGFsIFdheTtUYWNvbWE7V0E7OTg0MDE7VVNBOygyMDYpIDU1NS05NDgyOzM0NTc7RW1wSUQyLmJtcDtBbmRyZXcgcmVjZWl2ZWQgaGlzIEJUUyBjb21tZXJjaWFsIGFuZCBhIFBoLkQuIGluIGludGVybmF0aW9uYWwgbWFya2V0aW5nIGZyb20gdGhlIFVuaXZlcnNpdHkgb2YgRGFsbGFzLiAgSGUgaXMgZmx1ZW50IGluIEZyZW5jaCBhbmQgSXRhbGlhbiBhbmQgcmVhZHMgR2VybWFuLiAgSGUgam9pbmVkIHRoZSBjb21wYW55IGFzIGEgc2FsZXMgcmVwcmVzZW50YXRpdmUsIHdhcyBwcm9tb3RlZCB0byBzYWxlcyBtYW5hZ2VyIGFuZCB3YXMgdGhlbiBuYW1lZCB2aWNlIHByZXNpZGVudCBvZiBzYWxlcy4gIEFuZHJldyBpcyBhIG1lbWJlciBvZiB0aGUgU2FsZXMgTWFuYWdlbWVudCBSb3VuZHRhYmxlLCB0aGUgU2VhdHRsZSBDaGFtYmVyIG9mIENvbW1lcmNlLCBhbmQgdGhlIFBhY2lmaWMgUmltIEltcG9ydGVycyBBc3NvY2lhdGlvbi47DQozO0xldmVybGluZztKYW5ldDtTYWxlcyBSZXByZXNlbnRhdGl2ZTtNcy47MzAuOC4xOTYzOzEuNC4xOTkyOzcyMiBNb3NzIEJheSBCbHZkLjtLaXJrbGFuZDtXQTs5ODAzMztVU0E7KDIwNikgNTU1LTM0MTI7MzM1NTtFbXBJRDMuYm1wO0phbmV0IGhhcyBhIEJTIGRlZ3JlZSBpbiBjaGVtaXN0cnkgZnJvbSBCb3N0b24gQ29sbGVnZSkuICBTaGUgaGFzIGFsc28gY29tcGxldGVkIGEgY2VydGlmaWNhdGUgcHJvZ3JhbSBpbiBmb29kIHJldGFpbGluZyBtYW5hZ2VtZW50LiAgSmFuZXQgd2FzIGhpcmVkIGFzIGEgc2FsZXMgYXNzb2NpYXRlIGFuZCB3YXMgcHJvbW90ZWQgdG8gc2FsZXMgcmVwcmVzZW50YXRpdmUuOzINCjQ7UGVhY29jaztNYXJnYXJldDtTYWxlcyBSZXByZXNlbnRhdGl2ZTtNcnMuOzE5LjkuMTk1ODszLjUuMTk5Mzs0MTEwIE9sZCBSZWRtb25kIFJkLjtSZWRtb25kO1dBOzk4MDUyO1VTQTsoMjA2KSA1NTUtODEyMjs1MTc2O0VtcElENC5ibXA7TWFyZ2FyZXQgaG9sZHMgYSBCQSBpbiBFbmdsaXNoIGxpdGVyYXR1cmUgZnJvbSBDb25jb3JkaWEgQ29sbGVnZSBhbmQgYW4gTUEgZnJvbSB0aGUgQW1lcmljYW4gSW5zdGl0dXRlIG9mIEN1bGluYXJ5IEFydHMuIFNoZSB3YXMgdGVtcG9yYXJpbHkgYXNzaWduZWQgdG8gdGhlIExvbmRvbiBvZmZpY2UgYmVmb3JlIHJldHVybmluZyB0byBoZXIgcGVybWFuZW50IHBvc3QgaW4gU2VhdHRsZS47Mg0KNTtCdWNoYW5hbjtTdGV2ZW47U2FsZXMgTWFuYWdlcjtNci47NC4zLjE5NTU7MTcuMTAuMTk5MzsxNCBHYXJyZXR0IEhpbGw7TG9uZG9uOztTVzEgOEpSO1VLOyg3MSkgNTU1LTQ4NDg7MzQ1MztFbXBJRDUuYm1wOyJTdGV2ZW4gQnVjaGFuYW4gZ3JhZHVhdGVkIGZyb20gU3QuIEFuZHJld3MgVW5pdmVyc2l0eSwgU2NvdGxhbmQsIHdpdGggYSBCU0MgZGVncmVlLiAgVXBvbiBqb2luaW5nIHRoZSBjb21wYW55IGFzIGEgc2FsZXMgcmVwcmVzZW50YXRpdmUsIGhlIHNwZW50IDYgbW9udGhzIGluIGFuIG9yaWVudGF0aW9uIHByb2dyYW0gYXQgdGhlIFNlYXR0bGUgb2ZmaWNlIGFuZCB0aGVuIHJldHVybmVkIHRvIGhpcyBwZXJtYW5lbnQgcG9zdCBpbiBMb25kb24sIHdoZXJlIGhlIHdhcyBwcm9tb3RlZCB0byBzYWxlcyBtYW5hZ2VyLiAgTXIuIEJ1Y2hhbmFuIGhhcyBjb21wbGV0ZWQgdGhlIGNvdXJzZXMgIiJTdWNjZXNzZnVsIFRlbGVtYXJrZXRpbmciIiBhbmQgIiJJbnRlcm5hdGlvbmFsIFNhbGVzIE1hbmFnZW1lbnQuIiIgIEhlIGlzIGZsdWVudCBpbiBGcmVuY2guIjsyDQo2O1N1eWFtYTtNaWNoYWVsO1NhbGVzIFJlcHJlc2VudGF0aXZlO01yLjsyLjcuMTk2MzsxNy4xMC4xOTkzOyJDb3ZlbnRyeSBIb3VzZQ0KTWluZXIgUmQuIjtMb25kb247O0VDMiA3SlI7VUs7KDcxKSA1NTUtNzc3Mzs0Mjg7RW1wSUQ2LmJtcDsiTWljaGFlbCBpcyBhIGdyYWR1YXRlIG9mIFN1c3NleCBVbml2ZXJzaXR5IChNQSwgZWNvbm9taWNzKSBhbmQgdGhlIFVuaXZlcnNpdHkgb2YgQ2FsaWZvcm5pYSBhdCBMb3MgQW5nZWxlcyAoTUJBLCBtYXJrZXRpbmcpLiAgSGUgaGFzIGFsc28gdGFrZW4gdGhlIGNvdXJzZXMgIiJNdWx0aS1DdWx0dXJhbCBTZWxsaW5nIiIgYW5kICIiVGltZSBNYW5hZ2VtZW50IGZvciB0aGUgU2FsZXMgUHJvZmVzc2lvbmFsLiIiICBIZSBpcyBmbHVlbnQgaW4gSmFwYW5lc2UgYW5kIGNhbiByZWFkIGFuZCB3cml0ZSBGcmVuY2gsIFBvcnR1Z3Vlc2UsIGFuZCBTcGFuaXNoLiI7NQ0KNztLaW5nO1JvYmVydDtTYWxlcyBSZXByZXNlbnRhdGl2ZTtNci47MjkuNS4xOTYwOzIuMS4xOTk0OyJFZGdlaGFtIEhvbGxvdw0KV2luY2hlc3RlciBXYXkiO0xvbmRvbjs7UkcxIDlTUDtVSzsoNzEpIDU1NS01NTk4OzQ2NTtFbXBJRDcuYm1wOyJSb2JlcnQgS2luZyBzZXJ2ZWQgaW4gdGhlIFBlYWNlIENvcnBzIGFuZCB0cmF2ZWxlZCBleHRlbnNpdmVseSBiZWZvcmUgY29tcGxldGluZyBoaXMgZGVncmVlIGluIEVuZ2xpc2ggYXQgdGhlIFVuaXZlcnNpdHkgb2YgTWljaGlnYW4gYW5kIHRoZW4gam9pbmluZyB0aGUgY29tcGFueS4gIEFmdGVyIGNvbXBsZXRpbmcgYSBjb3Vyc2UgZW50aXRsZWQgIiJTZWxsaW5nIGluIEV1cm9wZSwiIiBoZSB3YXMgdHJhbnNmZXJyZWQgdG8gdGhlIExvbmRvbiBvZmZpY2UuIjs1DQo4O0NhbGxhaGFuO0xhdXJhO0luc2lkZSBTYWxlcyBDb29yZGluYXRvcjtNcy47OS4xLjE5NTg7NS4zLjE5OTQ7NDcyNiAtIDExdGggQXZlLiBOLkUuO1NlYXR0bGU7V0E7OTgxMDU7VVNBOygyMDYpIDU1NS0xMTg5OzIzNDQ7RW1wSUQ4LmJtcDtMYXVyYSByZWNlaXZlZCBhIEJBIGluIHBzeWNob2xvZ3kgZnJvbSB0aGUgVW5pdmVyc2l0eSBvZiBXYXNoaW5ndG9uLiAgU2hlIGhhcyBhbHNvIGNvbXBsZXRlZCBhIGNvdXJzZSBpbiBidXNpbmVzcyBGcmVuY2guICBTaGUgcmVhZHMgYW5kIHdyaXRlcyBGcmVuY2guOzINCjk7RG9kc3dvcnRoO0FubmU7U2FsZXMgUmVwcmVzZW50YXRpdmU7TXMuOzIuNy4xOTY5OzE1LjExLjE5OTQ7NyBIb3VuZHN0b290aCBSZC47TG9uZG9uOztXRzIgN0xUO1VLOyg3MSkgNTU1LTQ0NDQ7NDUyO0VtcElEOS5ibXA7QW5uZSBoYXMgYSBCQSBkZWdyZWUgaW4gRW5nbGlzaCBmcm9tIFN0LiBMYXdyZW5jZSBDb2xsZWdlLiAgU2hlIGlzIGZsdWVudCBpbiBGcmVuY2ggYW5kIEdlcm1hbi47NQ0K"));
NMailMergeDataSource dataSource = NDataSourceFormat.Csv.LoadFromStream(stream, new NDataSourceLoadSettings(null, null, true));
// Set some field mappings
NMailMergeFieldMap fieldMap = new NMailMergeFieldMap();
fieldMap.Set(ENMailMergeDataField.CourtesyTitle, "TitleOfCourtesy");
fieldMap.Set(ENMailMergeDataField.FirstName, "FirstName");
fieldMap.Set(ENMailMergeDataField.LastName, "LastName");
fieldMap.Set(ENMailMergeDataField.City, "City");
// Configure the drawing's mail merge
drawing.MailMerge.DataSource = dataSource;
}
#endregion
#region Implementation
#endregion
#region Event Handlers
#endregion
#region Fields
private NDrawingView m_DrawingView;
#endregion
#region Static Methods
#endregion
#region Constants
#endregion
#region Nested Types
#endregion
}
}