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
}
} | Language: VB.NET |
Imports Nevron.Nov
Imports Nevron.Nov.Diagram
Imports Nevron.Nov.Diagram.Shapes
Imports Nevron.Nov.Dom
Imports Nevron.Nov.Graphics
Imports Nevron.Nov.Layout
Imports Nevron.Nov.Text
Imports Nevron.Nov.Text.Data
Imports Nevron.Nov.UI
Imports Nevron.Nov.Windows.Forms
Imports System.IO
Public Class Form1
#Region "Constructors"
Public Sub New()
' This call is required by the designer.
InitializeComponent()
' Add any initialization after the InitializeComponent() call.
' Set form title
Text = "NOV WinForms - NMailMergeExample"
' Create the NOV example and its controls
Dim exampleContent As NWidget = CreateExampleContent()
Dim exampleControls As NWidget = CreateExampleControls()
If Not exampleControls Is Nothing Then
exampleControls.PreferredWidth = 300
End If
' Place the example and its controls in a pair box
Dim pairBox As NPairBox = 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
Dim host As NNovWidgetHost(Of NWidget) = New NNovWidgetHost(Of NWidget)(pairBox)
host.Dock = DockStyle.Fill
Controls.Add(host)
End Sub
#End Region
#Region "Example"
Public Function CreateExampleContent() As NWidget
' Create a simple drawing
Dim drawingViewWithRibbon As NDrawingViewWithRibbon = New NDrawingViewWithRibbon()
m_DrawingView = drawingViewWithRibbon.View
m_DrawingView.Document.HistoryService.Pause()
Try
InitDiagram(m_DrawingView.Document)
Finally
m_DrawingView.Document.HistoryService.Resume()
End Try
Return drawingViewWithRibbon
End Function
Public Function CreateExampleControls() As NWidget
Return Nothing
End Function
Public Function GetExampleDescription() As String
Dim 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.
"
End Function
'''
''' Gets the relevant documentation links for the example
'''
'''
Public Function GetDocumentationUrls() As (String, String)()
Return {("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")}
End Function
Private Sub InitDiagram(drawingDocument As NDrawingDocument)
Dim drawing = drawingDocument.Content
Dim activePage = drawing.ActivePage
' Hide the grid and the ports
drawing.ScreenVisibility.ShowGrid = False
drawing.ScreenVisibility.ShowPorts = False
' Get the basic shapes library
Dim basicShapes As NBasicShapeFactory = New NBasicShapeFactory()
basicShapes.DefaultSize = New NSize(100, 100)
' Create the Name shape
Dim nameShape = basicShapes.CreateShape(ENBasicShape.Rectangle)
nameShape.Width = 150
nameShape.PinX = activePage.Width / 2
nameShape.PinY = 100
Dim paragraph As NParagraph = 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
Dim 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
Dim 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
Dim connector As NRoutableConnector = 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
Dim stream As Stream = New MemoryStream(Nevron.Nov.NConvert.FromBase64String("RW1wbG95ZWVJRDtMYXN0TmFtZTtGaXJzdE5hbWU7VGl0bGU7VGl0bGVPZkNvdXJ0ZXN5O0JpcnRoRGF0ZTtIaXJlRGF0ZTtBZGRyZXNzO0NpdHk7UmVnaW9uO1Bvc3RhbENvZGU7Q291bnRyeTtIb21lUGhvbmU7RXh0ZW5zaW9uO1Bob3RvO05vdGVzO1JlcG9ydHNUbw0KMTtEYXZvbGlvO05hbmN5O1NhbGVzIFJlcHJlc2VudGF0aXZlO01zLjs4LjEyLjE5Njg7MS41LjE5OTI7IjUwNyAtIDIwdGggQXZlLiBFLg0KQXB0LiAyQSI7U2VhdHRsZTtXQTs5ODEyMjtVU0E7KDIwNikgNTU1LTk4NTc7NTQ2NztFbXBJRDEuYm1wOyJFZHVjYXRpb24gaW5jbHVkZXMgYSBCQSBpbiBwc3ljaG9sb2d5IGZyb20gQ29sb3JhZG8gU3RhdGUgVW5pdmVyc2l0eS4gIFNoZSBhbHNvIGNvbXBsZXRlZCAiIlRoZSBBcnQgb2YgdGhlIENvbGQgQ2FsbC4iIiAgTmFuY3kgaXMgYSBtZW1iZXIgb2YgVG9hc3RtYXN0ZXJzIEludGVybmF0aW9uYWwuIjsyDQoyO0Z1bGxlcjtBbmRyZXc7VmljZSBQcmVzaWRlbnQsIFNhbGVzO0RyLjsxOS4yLjE5NTI7MTQuOC4xOTkyOzkwOCBXLiBDYXBpdGFsIFdheTtUYWNvbWE7V0E7OTg0MDE7VVNBOygyMDYpIDU1NS05NDgyOzM0NTc7RW1wSUQyLmJtcDtBbmRyZXcgcmVjZWl2ZWQgaGlzIEJUUyBjb21tZXJjaWFsIGFuZCBhIFBoLkQuIGluIGludGVybmF0aW9uYWwgbWFya2V0aW5nIGZyb20gdGhlIFVuaXZlcnNpdHkgb2YgRGFsbGFzLiAgSGUgaXMgZmx1ZW50IGluIEZyZW5jaCBhbmQgSXRhbGlhbiBhbmQgcmVhZHMgR2VybWFuLiAgSGUgam9pbmVkIHRoZSBjb21wYW55IGFzIGEgc2FsZXMgcmVwcmVzZW50YXRpdmUsIHdhcyBwcm9tb3RlZCB0byBzYWxlcyBtYW5hZ2VyIGFuZCB3YXMgdGhlbiBuYW1lZCB2aWNlIHByZXNpZGVudCBvZiBzYWxlcy4gIEFuZHJldyBpcyBhIG1lbWJlciBvZiB0aGUgU2FsZXMgTWFuYWdlbWVudCBSb3VuZHRhYmxlLCB0aGUgU2VhdHRsZSBDaGFtYmVyIG9mIENvbW1lcmNlLCBhbmQgdGhlIFBhY2lmaWMgUmltIEltcG9ydGVycyBBc3NvY2lhdGlvbi47DQozO0xldmVybGluZztKYW5ldDtTYWxlcyBSZXByZXNlbnRhdGl2ZTtNcy47MzAuOC4xOTYzOzEuNC4xOTkyOzcyMiBNb3NzIEJheSBCbHZkLjtLaXJrbGFuZDtXQTs5ODAzMztVU0E7KDIwNikgNTU1LTM0MTI7MzM1NTtFbXBJRDMuYm1wO0phbmV0IGhhcyBhIEJTIGRlZ3JlZSBpbiBjaGVtaXN0cnkgZnJvbSBCb3N0b24gQ29sbGVnZSkuICBTaGUgaGFzIGFsc28gY29tcGxldGVkIGEgY2VydGlmaWNhdGUgcHJvZ3JhbSBpbiBmb29kIHJldGFpbGluZyBtYW5hZ2VtZW50LiAgSmFuZXQgd2FzIGhpcmVkIGFzIGEgc2FsZXMgYXNzb2NpYXRlIGFuZCB3YXMgcHJvbW90ZWQgdG8gc2FsZXMgcmVwcmVzZW50YXRpdmUuOzINCjQ7UGVhY29jaztNYXJnYXJldDtTYWxlcyBSZXByZXNlbnRhdGl2ZTtNcnMuOzE5LjkuMTk1ODszLjUuMTk5Mzs0MTEwIE9sZCBSZWRtb25kIFJkLjtSZWRtb25kO1dBOzk4MDUyO1VTQTsoMjA2KSA1NTUtODEyMjs1MTc2O0VtcElENC5ibXA7TWFyZ2FyZXQgaG9sZHMgYSBCQSBpbiBFbmdsaXNoIGxpdGVyYXR1cmUgZnJvbSBDb25jb3JkaWEgQ29sbGVnZSBhbmQgYW4gTUEgZnJvbSB0aGUgQW1lcmljYW4gSW5zdGl0dXRlIG9mIEN1bGluYXJ5IEFydHMuIFNoZSB3YXMgdGVtcG9yYXJpbHkgYXNzaWduZWQgdG8gdGhlIExvbmRvbiBvZmZpY2UgYmVmb3JlIHJldHVybmluZyB0byBoZXIgcGVybWFuZW50IHBvc3QgaW4gU2VhdHRsZS47Mg0KNTtCdWNoYW5hbjtTdGV2ZW47U2FsZXMgTWFuYWdlcjtNci47NC4zLjE5NTU7MTcuMTAuMTk5MzsxNCBHYXJyZXR0IEhpbGw7TG9uZG9uOztTVzEgOEpSO1VLOyg3MSkgNTU1LTQ4NDg7MzQ1MztFbXBJRDUuYm1wOyJTdGV2ZW4gQnVjaGFuYW4gZ3JhZHVhdGVkIGZyb20gU3QuIEFuZHJld3MgVW5pdmVyc2l0eSwgU2NvdGxhbmQsIHdpdGggYSBCU0MgZGVncmVlLiAgVXBvbiBqb2luaW5nIHRoZSBjb21wYW55IGFzIGEgc2FsZXMgcmVwcmVzZW50YXRpdmUsIGhlIHNwZW50IDYgbW9udGhzIGluIGFuIG9yaWVudGF0aW9uIHByb2dyYW0gYXQgdGhlIFNlYXR0bGUgb2ZmaWNlIGFuZCB0aGVuIHJldHVybmVkIHRvIGhpcyBwZXJtYW5lbnQgcG9zdCBpbiBMb25kb24sIHdoZXJlIGhlIHdhcyBwcm9tb3RlZCB0byBzYWxlcyBtYW5hZ2VyLiAgTXIuIEJ1Y2hhbmFuIGhhcyBjb21wbGV0ZWQgdGhlIGNvdXJzZXMgIiJTdWNjZXNzZnVsIFRlbGVtYXJrZXRpbmciIiBhbmQgIiJJbnRlcm5hdGlvbmFsIFNhbGVzIE1hbmFnZW1lbnQuIiIgIEhlIGlzIGZsdWVudCBpbiBGcmVuY2guIjsyDQo2O1N1eWFtYTtNaWNoYWVsO1NhbGVzIFJlcHJlc2VudGF0aXZlO01yLjsyLjcuMTk2MzsxNy4xMC4xOTkzOyJDb3ZlbnRyeSBIb3VzZQ0KTWluZXIgUmQuIjtMb25kb247O0VDMiA3SlI7VUs7KDcxKSA1NTUtNzc3Mzs0Mjg7RW1wSUQ2LmJtcDsiTWljaGFlbCBpcyBhIGdyYWR1YXRlIG9mIFN1c3NleCBVbml2ZXJzaXR5IChNQSwgZWNvbm9taWNzKSBhbmQgdGhlIFVuaXZlcnNpdHkgb2YgQ2FsaWZvcm5pYSBhdCBMb3MgQW5nZWxlcyAoTUJBLCBtYXJrZXRpbmcpLiAgSGUgaGFzIGFsc28gdGFrZW4gdGhlIGNvdXJzZXMgIiJNdWx0aS1DdWx0dXJhbCBTZWxsaW5nIiIgYW5kICIiVGltZSBNYW5hZ2VtZW50IGZvciB0aGUgU2FsZXMgUHJvZmVzc2lvbmFsLiIiICBIZSBpcyBmbHVlbnQgaW4gSmFwYW5lc2UgYW5kIGNhbiByZWFkIGFuZCB3cml0ZSBGcmVuY2gsIFBvcnR1Z3Vlc2UsIGFuZCBTcGFuaXNoLiI7NQ0KNztLaW5nO1JvYmVydDtTYWxlcyBSZXByZXNlbnRhdGl2ZTtNci47MjkuNS4xOTYwOzIuMS4xOTk0OyJFZGdlaGFtIEhvbGxvdw0KV2luY2hlc3RlciBXYXkiO0xvbmRvbjs7UkcxIDlTUDtVSzsoNzEpIDU1NS01NTk4OzQ2NTtFbXBJRDcuYm1wOyJSb2JlcnQgS2luZyBzZXJ2ZWQgaW4gdGhlIFBlYWNlIENvcnBzIGFuZCB0cmF2ZWxlZCBleHRlbnNpdmVseSBiZWZvcmUgY29tcGxldGluZyBoaXMgZGVncmVlIGluIEVuZ2xpc2ggYXQgdGhlIFVuaXZlcnNpdHkgb2YgTWljaGlnYW4gYW5kIHRoZW4gam9pbmluZyB0aGUgY29tcGFueS4gIEFmdGVyIGNvbXBsZXRpbmcgYSBjb3Vyc2UgZW50aXRsZWQgIiJTZWxsaW5nIGluIEV1cm9wZSwiIiBoZSB3YXMgdHJhbnNmZXJyZWQgdG8gdGhlIExvbmRvbiBvZmZpY2UuIjs1DQo4O0NhbGxhaGFuO0xhdXJhO0luc2lkZSBTYWxlcyBDb29yZGluYXRvcjtNcy47OS4xLjE5NTg7NS4zLjE5OTQ7NDcyNiAtIDExdGggQXZlLiBOLkUuO1NlYXR0bGU7V0E7OTgxMDU7VVNBOygyMDYpIDU1NS0xMTg5OzIzNDQ7RW1wSUQ4LmJtcDtMYXVyYSByZWNlaXZlZCBhIEJBIGluIHBzeWNob2xvZ3kgZnJvbSB0aGUgVW5pdmVyc2l0eSBvZiBXYXNoaW5ndG9uLiAgU2hlIGhhcyBhbHNvIGNvbXBsZXRlZCBhIGNvdXJzZSBpbiBidXNpbmVzcyBGcmVuY2guICBTaGUgcmVhZHMgYW5kIHdyaXRlcyBGcmVuY2guOzINCjk7RG9kc3dvcnRoO0FubmU7U2FsZXMgUmVwcmVzZW50YXRpdmU7TXMuOzIuNy4xOTY5OzE1LjExLjE5OTQ7NyBIb3VuZHN0b290aCBSZC47TG9uZG9uOztXRzIgN0xUO1VLOyg3MSkgNTU1LTQ0NDQ7NDUyO0VtcElEOS5ibXA7QW5uZSBoYXMgYSBCQSBkZWdyZWUgaW4gRW5nbGlzaCBmcm9tIFN0LiBMYXdyZW5jZSBDb2xsZWdlLiAgU2hlIGlzIGZsdWVudCBpbiBGcmVuY2ggYW5kIEdlcm1hbi47NQ0K"))
Dim dataSource As NMailMergeDataSource = NDataSourceFormat.Csv.LoadFromStream(stream, New NDataSourceLoadSettings(Nothing, Nothing, True))
' Set some field mappings
Dim fieldMap As NMailMergeFieldMap = 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
End Sub
#End Region
#Region "Implementation"
#End Region
#Region "Event Handlers"
#End Region
#Region "Fields"
Private m_DrawingView As NDrawingView
#End Region
#Region "Static Methods"
#End Region
#Region "Constants"
#End Region
#Region "Nested Types"
#End Region
End Class