Click or drag to resize

MergeFieldImageDimensionUnit Enumeration

Specifies an unit of an image dimension (i.e. the width or the height) used across a mail merge process.

Namespace:  Aspose.Words.Fields
Assembly:  Aspose.Words (in Aspose.Words.dll) Version: 20.2
public enum MergeFieldImageDimensionUnit
  Member nameValueDescription
Point0 The point (i.e. 1/72 inch).
Percent1 The percent of the original image dimension value.
Shows how to set the dimensions of merged images.
public void MergeFieldImageDimension()
    Document doc = new Document();

    // Insert a merge field where images will be placed during the mail merge
    DocumentBuilder builder = new DocumentBuilder(doc);
    builder.InsertField("MERGEFIELD Image:ImageColumn");

    // Create a data table for the mail merge
    // The name of the column that contains our image filenames needs to match the name of our merge field
    DataTable dataTable = CreateDataTable("Images", "ImageColumn",
        new string[]
            ImageDir + "Aspose.Words.jpg",
            ImageDir + "Watermark.png",
            ImageDir + "dotnet-logo.png"

    doc.MailMerge.FieldMergingCallback = new MergedImageResizer(450, 200, MergeFieldImageDimensionUnit.Point);

    doc.Save(ArtifactsDir + "Field.MERGEFIELD.ImageDimension.docx");

/// <summary>
/// Creates a data table with a single column.
/// </summary>
private static DataTable CreateDataTable(string tableName, string columnName, string[] columnContents)
    DataTable dataTable = new DataTable(tableName);
    dataTable.Columns.Add(new DataColumn(columnName));

    foreach (string s in columnContents)
        DataRow dataRow = dataTable.NewRow();
        dataRow[0] = s;

    return dataTable;

/// <summary>
/// Sets the size of all mail merged images to one defined width and height.
/// </summary>
private class MergedImageResizer : IFieldMergingCallback
    public MergedImageResizer(double imageWidth, double imageHeight, MergeFieldImageDimensionUnit unit)
        mImageWidth = imageWidth;
        mImageHeight = imageHeight;
        mUnit = unit;

    public void FieldMerging(FieldMergingArgs e)
        throw new NotImplementedException();

    public void ImageFieldMerging(ImageFieldMergingArgs args)
        args.ImageFileName = args.FieldValue.ToString();
        args.ImageWidth = new MergeFieldImageDimension(mImageWidth, mUnit);
        args.ImageHeight = new MergeFieldImageDimension(mImageHeight, mUnit);

        Assert.AreEqual(mImageWidth, args.ImageWidth.Value);
        Assert.AreEqual(mUnit, args.ImageWidth.Unit);
        Assert.AreEqual(mImageHeight, args.ImageHeight.Value);
        Assert.AreEqual(mUnit, args.ImageHeight.Unit);

    private readonly double mImageWidth;
    private readonly double mImageHeight;
    private readonly MergeFieldImageDimensionUnit mUnit;
See Also