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.3
Syntaxpublic enum MergeFieldImageDimensionUnit
Public Enumeration MergeFieldImageDimensionUnit
public enum class MergeFieldImageDimensionUnit
type MergeFieldImageDimensionUnit
Members
| Member name | Value | Description |
---|
| Point | 0 |
The point (i.e. 1/72 inch).
|
| Percent | 1 |
The percent of the original image dimension value.
|
ExamplesShows how to set the dimensions of merged images.
public void MergeFieldImageDimension()
{
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
builder.InsertField("MERGEFIELD Image:ImageColumn");
DataTable dataTable = CreateDataTable("Images", "ImageColumn",
new string[]
{
ImageDir + "Logo.jpg",
ImageDir + "Transparent background logo.png",
ImageDir + "Enhanced Windows MetaFile.emf"
});
doc.MailMerge.FieldMergingCallback = new MergedImageResizer(200, 200, MergeFieldImageDimensionUnit.Point);
doc.MailMerge.Execute(dataTable);
doc.UpdateFields();
doc.Save(ArtifactsDir + "Field.MERGEFIELD.ImageDimension.docx");
}
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;
dataTable.Rows.Add(dataRow);
}
return dataTable;
}
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