当前位置：首页 > news >正文

WPF 打印报告图片大小的自适应（含完整示例与详解）

news 2025/8/19 15:43:46

目标：在 FlowDocument 报告里，根据 1~6 张图片的数量，自动选择 2 行 × 3 列 的最佳布局；在只有 1、2、4 张时保持“占满感”，打印清晰且不变形。
规则一览：
1 张 → 占满 2×3（大图居中）
2 张 → 1×2（只占一行）
3 张 → 1×3（只占一行）
4 张 → 2×2（视觉上仍居中于 2×3 区域）
5–6 张 → 2×3

一、为什么要“自适应 + 占满感”？

打印报告的图片既要 等比缩放，又要在不同数量时 视觉均衡。常见坑：

直接 UniformGrid 2×3 固定排布，1/2/4 张图会显得松散；
源图 DPI 不一致导致打印缩放异常；
Stretch 使用不当造成拉伸变形或留白过多。

本文通过 ItemsControl + 动态 ItemsPanelTemplate 实现布局切换，并配合 DPI 统一、像素对齐 提升打印品质。

二、XAML（FlowDocument 内）

说明：预定义 5 套布局模板；其中 2×2 居中 模板用外层 2×3 容器包一层 2×2，使其在视觉上位于中间。

<FlowDocument.Resources><!-- 2×3 大面板，用于 1 张图占满整个区域（或作为通用容器） --><ItemsPanelTemplate x:Key="Panel1x1"><UniformGrid Rows="2" Columns="3"/></ItemsPanelTemplate><!-- 1 行 2 列：用于 2 张图 --><ItemsPanelTemplate x:Key="Panel1x2"><UniformGrid Rows="1" Columns="2"/></ItemsPanelTemplate><!-- 1 行 3 列：用于 3 张图 --><ItemsPanelTemplate x:Key="Panel1x3"><UniformGrid Rows="1" Columns="3"/></ItemsPanelTemplate><!-- 2×2 居中在 2×3 区域：用于 4 张图（让视觉更均衡） --><ItemsPanelTemplate x:Key="Panel2x2Centered"><Grid><!-- 外层 2×3 占位 --><Grid.RowDefinitions><RowDefinition/><RowDefinition/></Grid.RowDefinitions><Grid.ColumnDefinitions><ColumnDefinition/><ColumnDefinition/><ColumnDefinition/></Grid.ColumnDefinitions><!-- 内层 2×2 真正承载图片，放中间两列（或居中对齐） --><UniformGrid Rows="2" Columns="2"Grid.RowSpan="2" Grid.ColumnSpan="2"Grid.Row="0" Grid.Column="0"HorizontalAlignment="Center" VerticalAlignment="Center"/></Grid></ItemsPanelTemplate><!-- 2×3：用于 5~6 张图 --><ItemsPanelTemplate x:Key="Panel2x3"><UniformGrid Rows="2" Columns="3"/></ItemsPanelTemplate><!-- 单项模板：标题 + 图片（等比缩放、像素对齐） --><DataTemplate x:Key="PrintImageTemplate"><StackPanel Orientation="Vertical"><TextBlock Text="{Binding ImageInfo}"FontSize="12" Margin="5" TextWrapping="Wrap"/><!-- 外层 Grid 允许拉伸占满单元格，Image 使用 Uniform 保持比例 --><Grid HorizontalAlignment="Stretch" VerticalAlignment="Stretch"SnapsToDevicePixels="True" UseLayoutRounding="True"><Image Source="{Binding BitmapSource}"Stretch="Uniform"RenderOptions.BitmapScalingMode="HighQuality"RenderOptions.EdgeMode="Aliased"Margin="5"/></Grid></StackPanel></DataTemplate>
</FlowDocument.Resources><!-- 图像区域（2 行 3 列的总体设计） -->
<ItemsControl Name="ImagesItemsControl"Grid.Row="6" Grid.ColumnSpan="3" Margin="0,5,0,15"ItemTemplate="{StaticResource PrintImageTemplate}"><!-- 让每项容器撑满自身单元格，避免 Image 因容器未拉伸而显示偏小 --><ItemsControl.ItemContainerStyle><Style TargetType="ContentPresenter"><Setter Property="HorizontalAlignment" Value="Stretch"/><Setter Property="VerticalAlignment" Value="Stretch"/></Style></ItemsControl.ItemContainerStyle>
</ItemsControl>

小贴士：
打印走 FlowDocument 时，尽量保持控件树简单，避免过多 ViewBox 嵌套。
SnapsToDevicePixels 与 UseLayoutRounding 有助于边界像素对齐，减少细纹模糊。

三、模型定义（数据与视图绑定）

public class PrintImageModel
{public BitmapSource BitmapSource { get; set; }public string ImageInfo { get; set; }  // 标题/说明（拍摄时间、层号等）
}

四、代码绑定（含 DPI 统一与布局选择）

说明：
先对图片按深度/序号排序，只取前 6 张；
将位图统一到 96 DPI，避免打印引擎因 DPI 不一致而缩放异常；
根据数量选择 ItemsPanel；
绑定到 ItemsControl。

三、模型定义（数据与视图绑定）public class PrintImageModel
{public BitmapSource BitmapSource { get; set; }public string ImageInfo { get; set; }  // 标题/说明（拍摄时间、层号等）
}// 根据数量选择 ItemsPanelTemplate
private static ItemsPanelTemplate GetPanelForCount(ResourceDictionary res, int count)
{ItemsPanelTemplate Panel(string key) => res[key] as ItemsPanelTemplate;return count switch{<= 0 => Panel("Panel2x3"),        // 回退1    => Panel("Panel1x1"),         // 单图占满 2×32    => Panel("Panel1x2"),3    => Panel("Panel1x3"),4    => Panel("Panel2x2Centered"), // 2×2 居中_    => Panel("Panel2x3"),         // 5~6};
}// 将 BitmapSource 统一到 96 DPI，打印更稳定
private static BitmapSource EnsureDpi96(BitmapSource src)
{if (src == null) return null;const double dpi = 96.0;if (Math.Abs(src.DpiX - dpi) < 0.1 && Math.Abs(src.DpiY - dpi) < 0.1)return src; // 已经是 96 DPI// 复制像素数据到新的 96 DPI 位图var format = src.Format; // 保留原像素格式int stride = (src.PixelWidth * format.BitsPerPixel + 7) / 8;byte[] buffer = new byte[stride * src.PixelHeight];src.CopyPixels(buffer, stride, 0);var normalized = BitmapSource.Create(src.PixelWidth, src.PixelHeight, dpi, dpi,format, src.Palette, buffer, stride);normalized.Freeze();return normalized;
}public void BindReportImages(FlowDocument doc,IEnumerable<(int Depth, Mat Mat, object Meta)> tempList,string timeStr)
{if (doc == null) return;var imagesItemsControl = doc.FindName("ImagesItemsControl") as ItemsControl;if (imagesItemsControl == null) return;// 1) 排序并取前 6 张var list = tempList?.OrderBy(s => s.Depth).Take(6).ToList() ?? new();// 2) 组装绑定模型，并统一 DPIvar imageModelList = new List<PrintImageModel>(list.Count);foreach (var item in list){if (item.Mat == null) continue;var src = BitmapUtils.ToBitmapSource2(item.Mat); // 你现有的 Mat → BitmapSourcevar fixedDpi = EnsureDpi96(src);imageModelList.Add(new PrintImageModel{BitmapSource = fixedDpi,ImageInfo = GetImageInfo(item.Meta, timeStr, item.Depth)});}// 3) 选择合适的 ItemsPanelimagesItemsControl.ItemsPanel = GetPanelForCount(doc.Resources, imageModelList.Count);// 4) 绑定数据imagesItemsControl.ItemsSource = imageModelList;
}

关于 BitmapUtils.ToBitmapSource2：如果它内部使用了 MemoryStream 临时对象，请务必在 BitmapImage 完成初始化后 Freeze()，以防打印时跨线程访问异常。

五、打印清晰度与缩放的关键点

统一 DPI（推荐 96）：WPF 视觉树的度量与渲染以 96 DPI 为基准。若源图为 300 DPI，但尺寸以像素为准，打印时仍以像素为依据，可能出现缩放计算偏差，统一 DPI 可减少不可控因素。
像素对齐：启用 SnapsToDevicePixels 与 UseLayoutRounding，避免边界半像素导致的灰边。
高质量缩放：RenderOptions.BitmapScalingMode="HighQuality" 能在缩小图片时明显改善清晰度。
避免多层缩放：不要在 Image 外再套 ViewBox，否则缩放叠乘影响清晰度。
打印管线：如对分页/边距有严格控制，考虑使用 DocumentPaginator 或 FixedDocument，避免 Flow 文档自动分页带来的不可控换行。