TX Text Control .NET Server

ImageFieldMergedEventArgs Class

Class|Introduced in 16.0
Namespace
TXTextControl.DocumentServer
Package
TXTextControl.TextControl.Core.SDK from the private NuGet feed or Text Control Offline Packages
Assembly
TXDocumentServer.Core.dll
Install
dotnet add package TXTextControl.TextControl.Core.SDK .NET 8 and later. For .NET Framework, reference TXDocumentServer.dll from the setup.
Also in
TXTextControl.TextControl.ASP.SDK as TXDocumentServer.dll
Inherits
  1. CancelEventArgs
  2. MergedEventArgs
  3. MailMerge.ImageFieldMergedEventArgs

Description

The ImageFieldMergedEventArgs class provides data for the ImageFieldMerged event.

Syntax

public class MailMerge.ImageFieldMergedEventArgs : MailMerge.MergedEventArgs

Examples

The following example creates an Image Field Merged Event Args instance and configures its cancel setting for a document workflow.

TXTextControl.DocumentServer.MailMerge.ImageFieldMergedEventArgs imageFieldMergedEventArgs = new("CustomerName", "document.docx", new TXTextControl.Image { FileName = @"Images\company-logo.png", Name = "CompanyLogo", DescriptiveText = "Company logo" }, true);
imageFieldMergedEventArgs.Cancel = true;

Members

Constructors

ConstructorDescription
ImageFieldMergedEventArgsNot described in the reference. public ImageFieldMergedEventArgs(string fieldName, string filename, Image image, bool merged);

Properties

PropertyDescription
FieldNameGets the name of the merged field.
FilenameGets the filename of the merged image.
ImageGets or sets the image that has been merged into the field. This allows to subsequently change the merge result.
MergeBlockNameIf the image field is part of a merge block, this property returns the name of the block. If not, an empty string is returned.
MergedGets a bool value that indicates whether the current field has been merged successfully or not.
NestingDepthIf the image field is part of a merge block, this property returns the one-based nesting depth of the block. Otherwise 0 is returned.
TableCellIf the image field is inside of a table, this property returns the containing table cell as a TXTextControl.TableCell instance or null otherwise.

Further Reading

  • New Sample: How to Merge Images into MS Word Templates –