java.lang.Objectcom.aspose.words.MergeFieldImageDimension
public class MergeFieldImageDimension
Example:
public void mergeFieldImageDimension() throws Exception {
Document doc = new Document();
// Insert a merge field where images will be placed during the mail merge
DocumentBuilder builder = new DocumentBuilder(doc);
FieldMergeField field = (FieldMergeField) builder.insertField("MERGEFIELD Image:ImageColumn");
Assert.assertEquals("Image:ImageColumn", field.getFieldName());
// 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 = new DataTable("Images");
dataTable.getColumns().add(new DataColumn("ImageColumn"));
dataTable.getRows().add(getImageDir() + "Logo.jpg");
dataTable.getRows().add(getImageDir() + "Transparent background logo.png");
dataTable.getRows().add(getImageDir() + "Enhanced Windows MetaFile.emf");
doc.getMailMerge().setFieldMergingCallback(new MergedImageResizer(200.0, 200.0, MergeFieldImageDimensionUnit.POINT));
doc.getMailMerge().execute(dataTable);
doc.updateFields();
doc.save(getArtifactsDir() + "Field.MERGEFIELD.ImageDimension.docx");
}
/// <summary>
/// Sets the size of all mail merged images to one defined width and height.
/// </summary>
private static class MergedImageResizer implements IFieldMergingCallback {
public MergedImageResizer(final double imageWidth, final double imageHeight, final int unit) {
mImageWidth = imageWidth;
mImageHeight = imageHeight;
mUnit = unit;
}
public void fieldMerging(final FieldMergingArgs args) {
throw new UnsupportedOperationException();
}
public void imageFieldMerging(final ImageFieldMergingArgs args) {
args.setImageFileName(args.getFieldValue().toString());
args.setImageWidth(new MergeFieldImageDimension(mImageWidth, mUnit));
args.setImageHeight(new MergeFieldImageDimension(mImageHeight, mUnit));
Assert.assertEquals(mImageWidth, args.getImageWidth().getValue());
Assert.assertEquals(mUnit, args.getImageWidth().getUnit());
Assert.assertEquals(mImageHeight, args.getImageHeight().getValue());
Assert.assertEquals(mUnit, args.getImageHeight().getUnit());
}
private double mImageWidth;
private double mImageHeight;
private int mUnit;
}
Constructor Summary |
---|
MergeFieldImageDimension(double value)
Creates an image dimension instance with the given value in points. |
MergeFieldImageDimension(double value, int unit)
Creates an image dimension instance with the given value and the given unit. |
Property Getters/Setters Summary | ||
---|---|---|
int | getUnit() | |
void | setUnit(int value) | |
The unit. The value of the property is MergeFieldImageDimensionUnit integer constant. | ||
double | getValue() | |
void | setValue(double value) | |
The value. |
Constructor Detail |
---|
public MergeFieldImageDimension(double value)
value
- The value.Example:
Shows how to set the dimensions of merged images.public void mergeFieldImageDimension() throws Exception { Document doc = new Document(); // Insert a merge field where images will be placed during the mail merge DocumentBuilder builder = new DocumentBuilder(doc); FieldMergeField field = (FieldMergeField) builder.insertField("MERGEFIELD Image:ImageColumn"); Assert.assertEquals("Image:ImageColumn", field.getFieldName()); // 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 = new DataTable("Images"); dataTable.getColumns().add(new DataColumn("ImageColumn")); dataTable.getRows().add(getImageDir() + "Logo.jpg"); dataTable.getRows().add(getImageDir() + "Transparent background logo.png"); dataTable.getRows().add(getImageDir() + "Enhanced Windows MetaFile.emf"); doc.getMailMerge().setFieldMergingCallback(new MergedImageResizer(200.0, 200.0, MergeFieldImageDimensionUnit.POINT)); doc.getMailMerge().execute(dataTable); doc.updateFields(); doc.save(getArtifactsDir() + "Field.MERGEFIELD.ImageDimension.docx"); } /// <summary> /// Sets the size of all mail merged images to one defined width and height. /// </summary> private static class MergedImageResizer implements IFieldMergingCallback { public MergedImageResizer(final double imageWidth, final double imageHeight, final int unit) { mImageWidth = imageWidth; mImageHeight = imageHeight; mUnit = unit; } public void fieldMerging(final FieldMergingArgs args) { throw new UnsupportedOperationException(); } public void imageFieldMerging(final ImageFieldMergingArgs args) { args.setImageFileName(args.getFieldValue().toString()); args.setImageWidth(new MergeFieldImageDimension(mImageWidth, mUnit)); args.setImageHeight(new MergeFieldImageDimension(mImageHeight, mUnit)); Assert.assertEquals(mImageWidth, args.getImageWidth().getValue()); Assert.assertEquals(mUnit, args.getImageWidth().getUnit()); Assert.assertEquals(mImageHeight, args.getImageHeight().getValue()); Assert.assertEquals(mUnit, args.getImageHeight().getUnit()); } private double mImageWidth; private double mImageHeight; private int mUnit; }
public MergeFieldImageDimension(double value, int unit)
value
- The value.unit
- A Example:
Shows how to set the dimensions of merged images.public void mergeFieldImageDimension() throws Exception { Document doc = new Document(); // Insert a merge field where images will be placed during the mail merge DocumentBuilder builder = new DocumentBuilder(doc); FieldMergeField field = (FieldMergeField) builder.insertField("MERGEFIELD Image:ImageColumn"); Assert.assertEquals("Image:ImageColumn", field.getFieldName()); // 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 = new DataTable("Images"); dataTable.getColumns().add(new DataColumn("ImageColumn")); dataTable.getRows().add(getImageDir() + "Logo.jpg"); dataTable.getRows().add(getImageDir() + "Transparent background logo.png"); dataTable.getRows().add(getImageDir() + "Enhanced Windows MetaFile.emf"); doc.getMailMerge().setFieldMergingCallback(new MergedImageResizer(200.0, 200.0, MergeFieldImageDimensionUnit.POINT)); doc.getMailMerge().execute(dataTable); doc.updateFields(); doc.save(getArtifactsDir() + "Field.MERGEFIELD.ImageDimension.docx"); } /// <summary> /// Sets the size of all mail merged images to one defined width and height. /// </summary> private static class MergedImageResizer implements IFieldMergingCallback { public MergedImageResizer(final double imageWidth, final double imageHeight, final int unit) { mImageWidth = imageWidth; mImageHeight = imageHeight; mUnit = unit; } public void fieldMerging(final FieldMergingArgs args) { throw new UnsupportedOperationException(); } public void imageFieldMerging(final ImageFieldMergingArgs args) { args.setImageFileName(args.getFieldValue().toString()); args.setImageWidth(new MergeFieldImageDimension(mImageWidth, mUnit)); args.setImageHeight(new MergeFieldImageDimension(mImageHeight, mUnit)); Assert.assertEquals(mImageWidth, args.getImageWidth().getValue()); Assert.assertEquals(mUnit, args.getImageWidth().getUnit()); Assert.assertEquals(mImageHeight, args.getImageHeight().getValue()); Assert.assertEquals(mUnit, args.getImageHeight().getUnit()); } private double mImageWidth; private double mImageHeight; private int mUnit; }
Property Getters/Setters Detail |
---|
getUnit/setUnit | |
public int getUnit() / public void setUnit(int value) |
Example:
Shows how to set the dimensions of merged images.public void mergeFieldImageDimension() throws Exception { Document doc = new Document(); // Insert a merge field where images will be placed during the mail merge DocumentBuilder builder = new DocumentBuilder(doc); FieldMergeField field = (FieldMergeField) builder.insertField("MERGEFIELD Image:ImageColumn"); Assert.assertEquals("Image:ImageColumn", field.getFieldName()); // 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 = new DataTable("Images"); dataTable.getColumns().add(new DataColumn("ImageColumn")); dataTable.getRows().add(getImageDir() + "Logo.jpg"); dataTable.getRows().add(getImageDir() + "Transparent background logo.png"); dataTable.getRows().add(getImageDir() + "Enhanced Windows MetaFile.emf"); doc.getMailMerge().setFieldMergingCallback(new MergedImageResizer(200.0, 200.0, MergeFieldImageDimensionUnit.POINT)); doc.getMailMerge().execute(dataTable); doc.updateFields(); doc.save(getArtifactsDir() + "Field.MERGEFIELD.ImageDimension.docx"); } /// <summary> /// Sets the size of all mail merged images to one defined width and height. /// </summary> private static class MergedImageResizer implements IFieldMergingCallback { public MergedImageResizer(final double imageWidth, final double imageHeight, final int unit) { mImageWidth = imageWidth; mImageHeight = imageHeight; mUnit = unit; } public void fieldMerging(final FieldMergingArgs args) { throw new UnsupportedOperationException(); } public void imageFieldMerging(final ImageFieldMergingArgs args) { args.setImageFileName(args.getFieldValue().toString()); args.setImageWidth(new MergeFieldImageDimension(mImageWidth, mUnit)); args.setImageHeight(new MergeFieldImageDimension(mImageHeight, mUnit)); Assert.assertEquals(mImageWidth, args.getImageWidth().getValue()); Assert.assertEquals(mUnit, args.getImageWidth().getUnit()); Assert.assertEquals(mImageHeight, args.getImageHeight().getValue()); Assert.assertEquals(mUnit, args.getImageHeight().getUnit()); } private double mImageWidth; private double mImageHeight; private int mUnit; }
getValue/setValue | |
public double getValue() / public void setValue(double value) |
Example:
Shows how to set the dimensions of merged images.public void mergeFieldImageDimension() throws Exception { Document doc = new Document(); // Insert a merge field where images will be placed during the mail merge DocumentBuilder builder = new DocumentBuilder(doc); FieldMergeField field = (FieldMergeField) builder.insertField("MERGEFIELD Image:ImageColumn"); Assert.assertEquals("Image:ImageColumn", field.getFieldName()); // 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 = new DataTable("Images"); dataTable.getColumns().add(new DataColumn("ImageColumn")); dataTable.getRows().add(getImageDir() + "Logo.jpg"); dataTable.getRows().add(getImageDir() + "Transparent background logo.png"); dataTable.getRows().add(getImageDir() + "Enhanced Windows MetaFile.emf"); doc.getMailMerge().setFieldMergingCallback(new MergedImageResizer(200.0, 200.0, MergeFieldImageDimensionUnit.POINT)); doc.getMailMerge().execute(dataTable); doc.updateFields(); doc.save(getArtifactsDir() + "Field.MERGEFIELD.ImageDimension.docx"); } /// <summary> /// Sets the size of all mail merged images to one defined width and height. /// </summary> private static class MergedImageResizer implements IFieldMergingCallback { public MergedImageResizer(final double imageWidth, final double imageHeight, final int unit) { mImageWidth = imageWidth; mImageHeight = imageHeight; mUnit = unit; } public void fieldMerging(final FieldMergingArgs args) { throw new UnsupportedOperationException(); } public void imageFieldMerging(final ImageFieldMergingArgs args) { args.setImageFileName(args.getFieldValue().toString()); args.setImageWidth(new MergeFieldImageDimension(mImageWidth, mUnit)); args.setImageHeight(new MergeFieldImageDimension(mImageHeight, mUnit)); Assert.assertEquals(mImageWidth, args.getImageWidth().getValue()); Assert.assertEquals(mUnit, args.getImageWidth().getUnit()); Assert.assertEquals(mImageHeight, args.getImageHeight().getValue()); Assert.assertEquals(mUnit, args.getImageHeight().getUnit()); } private double mImageWidth; private double mImageHeight; private int mUnit; }