WPF控件截图保存尺寸不符问题排查求助

问题原因 #

• DPI缩放未适配：WPF采用设备无关单位（1单位=1/96英寸），当系统开启高DPI缩放（如125%、150%）时，控件实际渲染的像素数量是布局尺寸乘以DPI缩放系数。如果截图时直接使用布局的设备无关尺寸创建RenderTargetBitmap，没有考虑DPI缩放，生成的图片像素数不足，就会显示偏小。
• 控件布局未完成：如果截图前控件未完成Measure、Arrange流程，ActualWidth/ActualHeight可能未更新为最终渲染尺寸，导致截图用了错误的尺寸计算。

解决办法 #

1. 适配DPI缩放系数 #

修改截图代码，获取控件的实际DPI值，以此计算正确的像素尺寸：

public void SaveControlImage(FrameworkElement control, string filePath)
{
    // 获取控件的DPI缩放参数
    var dpiScale = VisualTreeHelper.GetDpi(control);
    double dpiX = dpiScale.DpiX;
    double dpiY = dpiScale.DpiY;

    // 强制控件完成布局测量与排列
    control.Measure(new Size(double.PositiveInfinity, double.PositiveInfinity));
    control.Arrange(new Rect(0, 0, control.DesiredSize.Width, control.DesiredSize.Height));
    control.UpdateLayout();

    // 根据DPI计算实际需要的像素宽高
    int pixelWidth = (int)Math.Round(control.ActualWidth * dpiX / 96);
    int pixelHeight = (int)Math.Round(control.ActualHeight * dpiY / 96);

    // 创建匹配DPI的RenderTargetBitmap
    var renderBitmap = new RenderTargetBitmap(
        pixelWidth,
        pixelHeight,
        dpiX,
        dpiY,
        PixelFormats.Pbgra32);

    renderBitmap.Render(control);

    // 保存图片到指定路径
    using (var fileStream = new FileStream(filePath, FileMode.Create))
    {
        var pngEncoder = new PngBitmapEncoder();
        pngEncoder.Frames.Add(BitmapFrame.Create(renderBitmap));
        pngEncoder.Save(fileStream);
    }
}

2. 确保控件布局完成 #

对于动态加载或刚更新内容的控件，必须调用Measure、Arrange、UpdateLayout方法，保证ActualWidth和ActualHeight反映最终渲染尺寸，避免直接使用XAML中声明的固定Width/Height值。

3. 自定义控件的视觉刷新 #

如果使用了自定义控件（如你提到的OutlinedTextBlock），可能需要在截图前强制触发视觉树刷新，确保控件内容完全渲染：

control.InvalidateVisual();
control.UpdateLayout();

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