WPF DPI 缩放转换器

前言

随着高分辨率屏幕的普及，Windows 系统默认会对界面进行 DPI 缩放（如 125%、150%），以提升视觉体验。然而，在 WPF 应用中，这种缩放机制会导致原本设定的固定尺寸（如 Width、Height）被自动放大，造成布局错乱、控件变形等问题。

为了解决这一问题，本文介绍一个 DPI 缩放转换器（DpiConverter）的实际应用案例。该转换器通过获取当前系统的 DPI 缩放比例，并在绑定时对数值进行反向缩放，从而将"被放大"的尺寸还原为设计时的原始值，确保 UI 在不同 DPI 设置下显示一致。

正文

1、问题背景

现在笔记本电脑普遍采用高分辨率屏幕，并启用系统级 DPI 缩放功能（例如 125%）。

WPF 框架虽然支持自动缩放，但某些场景下：

• 固定尺寸的控件会被拉伸；

• 图形绘制出现偏差；

• 自定义控件或坐标定位失准。

这给开发带来了不小的挑战，尤其是在需要精确控制像素和布局的应用中（如图像处理、图表绘制等）。

2、解决方案概述

我们可以通过实现一个 自定义的 IValueConverter来动态调整绑定的尺寸值。这个转换器会在运行时获取当前窗口的 DPI 缩放比例，并根据需要将尺寸值除以该比例，从而抵消系统缩放带来的影响。

3、核心代码解析

以下是一个完整的 DpiConverter 实现：

public class DpiConverter : IValueConverter
{
    /// <summary>
    /// 将设计时尺寸转换为物理像素尺寸（即缩小回去）
    /// </summary>
    public object Convert(object value, Type targetType, object parameter, CultureInfo culture)
    {
        Matrix matrix = PresentationSource.FromVisual(Application.Current.MainWindow)
                         .CompositionTarget.TransformToDevice;
        double dpiScaleX = matrix.M11;
        double dpiScaleY = matrix.M22;

        if (value is double doubleValue)
        {
            if (parameter is string dir && dir.ToLower() == "y")
                return doubleValue / dpiScaleY;

            return doubleValue / dpiScaleX;
        }

        if (value is int intValue)
        {
            return intValue / dpiScaleX;
        }

        return DependencyProperty.UnsetValue;
    }

    /// <summary>
    /// 将物理像素尺寸转换回设计时尺寸（用于双向绑定）
    /// </summary>
    public object ConvertBack(object value, Type targetType, object parameter, CultureInfo culture)
    {
        Matrix matrix = PresentationSource.FromVisual(Application.Current.MainWindow)
                         .CompositionTarget.TransformToDevice;
        double dpiScaleX = matrix.M11;
        double dpiScaleY = matrix.M22;

        if (value is double doubleValue)
        {
            if (parameter is string dir && dir.ToLower() == "y")
                return doubleValue * dpiScaleY;

            return doubleValue * dpiScaleX;
        }

        if (value is int intValue)
        {
            return intValue * dpiScaleX;
        }

        return DependencyProperty.UnsetValue;
    }

    /// <summary>
    /// 获取当前DPI缩放比例（静态访问）
    /// </summary>
    public static (double scaleX, double scaleY) GetDpiScaling()
    {
        Matrix matrix = PresentationSource.FromVisual(Application.Current.MainWindow)
                         .CompositionTarget.TransformToDevice;
        return (matrix.M11, matrix.M22);
    }
}

4、使用方式

在 XAML 中注册资源

<Window.Resources>
    <local:DpiConverter x:Key="dpiConverter"/>
</Window.Resources>

绑定时使用转换器

例如设置按钮宽度为 100px（即使在 125% 缩放下也保持不变）：

<Button Width="{Binding Source={x:Static System:Double.Parse}, Converter={StaticResource dpiConverter}, ConverterParameter=x}" />
<!-- 或者 -->
<Button Width="{Binding Source={x:Static System:Double.Parse}, Converter={StaticResource dpiConverter}}" />

注：实际绑定源可以是任意 double 类型的数据，此处仅作示意。

5、效果与验证

经过实测，在启用了 125%、150% DPI 缩放的系统上，使用此转换器后：

• 控件尺寸不会被自动放大；

• 自定义图形绘制位置准确；

• 布局更加稳定；

• 提升了多分辨率下的兼容性和一致性。

总结

在 WPF 开发中，DPI 缩放是一个不可忽视的问题，尤其对于需要严格控制尺寸和布局的界面来说。

本文提供了一个实用的 DpiConverter 转换器实现，能够在绑定过程中动态调整控件尺寸，有效解决因系统 DPI 缩放引起的布局异常问题。

通过这种方式，大家可以在不修改原有布局逻辑的前提下，轻松实现跨 DPI 的兼容性适配，提升应用程序在各种设备上的显示质量和用户体验。

关键词 C#、WPF、DPI缩放、IValueConverter、尺寸适配、Matrix、TransformToDevice、UI布局优化、高分辨率适配、Convert转换器。

最后

如果你觉得这篇文章对你有帮助，不妨点个赞支持一下！你的支持是我继续分享知识的动力。如果有任何疑问或需要进一步的帮助，欢迎随时留言。

也可以加入微信公众号 [DotNet技术匠] 社区，与其他热爱技术的同行一起交流心得，共同成长！

优秀是一种习惯，欢迎大家留言学习！

作者：我是刹那、

出处：cnblogs.com/wuyaxiansheng/p/18823309

声明：网络内容，仅供学习，尊重版权，侵权速删，歉意致谢！