Merging images is required in many templates: Company logos in invoices, pictures of employees in HR reports or signature images in letters. These images can't be part of the template as they have to be merged dynamically.
With the release of TX Text Control .NET Server 16.0, the MailMerge class comes with this feature out of the box. It is possible to pass an image path with the merge data or an image can be added dynamically in the new ImageFieldMerged event.
Image fields are regular merge fields with a special format:
'image:' is the identifier followed by the name of this field. In this sample, all image fields are merged with the same image in the ImageFieldMerged event:
void mailMerge_ImageFieldMerged(object sender, TXTextControl.DocumentServer.MailMerge.ImageFieldMergedEventArgs e)
{
if (pictureBox1.Image == null)
return;
// add the image from the PictureBox
TXTextControl.Image img = new TXTextControl.Image(pictureBox1.Image);
e.Image = img;
}Try it yourself using the code example. Just start the application, load the shipped template, select an image and click Merge. The minimum requirements for this sample application are TX Text Control Server for ASP.NET (incl. Windows Forms) trial version and Visual Studio .NET 2008.
This sample shows how to use the image merging capabilities of TX Text Control .NET Server's MailMerge class.
TX Text Control Server for ASP.NET (incl. Windows Forms) 16.0
Visual C# (Visual Studio 2008)
tx_merge_images.zip [28.08 KB]
January 21, 2011
