使用GemBox.Document邮件合并时的图片尺寸调整问题

Hey Nicolas, let's work through this image scaling problem with GemBox.Document's mail merge—both the direct fix for aspect ratio and the shape-based approach you were trying to use.

Fixing Image Aspect Ratio Directly in Code #

The easiest way to ensure your images preserve their aspect ratio while filling the table cell as much as possible is to hook into GemBox's ImageResizing event during mail merge. This lets you calculate the correct scale based on the cell's dimensions and apply it to the image.

Here's a code example that does exactly that:

// Load your Word template
DocumentModel document = DocumentModel.Load("YourTemplate.docx");

// Handle image resizing during mail merge
document.MailMerge.ImageResizing += (sender, e) =>
{
    // Get the table cell that contains the merge field
    var targetCell = e.Field.Parent.GetParent<TableCell>();
    if (targetCell == null) return;

    // Calculate the maximum scale that fits the cell without distorting the image
    double widthScale = targetCell.Width / e.Image.Size.Width;
    double heightScale = targetCell.Height / e.Image.Size.Height;
    double optimalScale = Math.Min(widthScale, heightScale);

    // Apply the scale to preserve aspect ratio
    e.Image.Width = e.Image.Size.Width * optimalScale;
    e.Image.Height = e.Image.Size.Height * optimalScale;

    // Optional: Center the image within the cell for a cleaner look
    e.Image.TextWrapping.Style = TextWrappingStyle.InFrontOfText;
    e.Image.HorizontalPosition = HorizontalPosition.Center;
    e.Image.VerticalPosition = VerticalPosition.Center;
};

// Run the mail merge with your data source
document.MailMerge.Execute(yourDataSource);
document.Save("FinalReport.docx");

This code checks the cell's size, finds the largest scale that fits either the width or height (whichever is more restrictive), and scales the image proportionally. No shape required for this approach!

Using Shapes in Your Word Template #

If you still want to use shapes to control image placement (maybe for consistent borders or positioning), here's a step-by-step guide to set it up correctly in Word:

• Open your template and navigate to the target table cell.
• Insert a shape (e.g., a rectangle) via Insert > Shapes. Resize it to fill the entire cell—this will be the boundary for your image.
• Right-click the shape and select Add Text. Place your merge field (like «ProductImage») inside the shape's text area.
• Adjust the shape's wrapping style: Right-click > Wrap Text > In Line with Text (this ensures the shape stays locked inside the cell).
• Save the template and run your mail merge as usual. GemBox will automatically fit the image into the shape while preserving its aspect ratio.

If you still see issues with the shape-based approach, you can combine it with the ImageResizing event above—just get the shape's dimensions instead of the cell's to calculate the scale.

内容的提问来源于stack exchange，提问作者Nicolas C