大网数据广告活动
.NET 与 C# 开发

在 Windows 窗体中的高 DPI 支持

· 52CE 我爱测

从.NET Framework 4.7 开始,Windows 窗体包括增强功能的常见高 DPI 和动态 DPI 方案。 这些问题包括:

从.NET Framework 4.7 开始,Windows 窗体包括增强功能的常见高 DPI 和动态 DPI 方案。 这些问题包括:

  • 改进的缩放和多个 Windows 窗体的布局控件,如xref:System.Windows.Forms.MonthCalendar控件和xref:System.Windows.Forms.CheckedListBox控件。

  • 单次传递缩放。 在.NET Framework 4.6 和更早版本中,通过多个通过,这导致一些控件,以扩展超过需要执行缩放。

  • 对 Windows 窗体应用程序已启动后在用户更改 DPI 或缩放系数的动态 DPI 方案的支持。

在版本的.NET Framework 从.NET Framework 4.7 开始,增强了高 DPI 支持是可选功能。 必须配置应用程序以充分利用它。

高 DPI 支持在 Windows 窗体应用中配置

支持高 DPI 识别的新 Windows 窗体功能是仅在面向.NET Framework 4.7 和从 Windows 10 创意者更新的 Windows 操作系统上运行的应用程序中可用。

此外,若要在 Windows 窗体应用程序中配置高 DPI 支持,必须执行以下操作:

  • 声明与 Windows 10 的兼容性。

    若要执行此操作,以下代码添加到清单文件:

    <compatibility xmlns="urn:schemas-microsoft-com:compatibility.v1">
      <application>
        <!-- Windows 10 compatibility -->
        <supportedOS Id="{8e0f7a12-bfb3-4fe8-b9a5-48fd50a15a9a}" />
      </application>
    </compatibility>
    
  • 启用中的每监视器 DPI 感知app.config文件。

    Windows 窗体引入了一个新 <System.Windows.Forms.ApplicationConfigurationSection> 元素以支持新功能和自定义项添加从.NET Framework 4.7 开始。 若要充分利用支持高 DPI 的新功能,以下代码添加到应用程序配置文件。

    <System.Windows.Forms.ApplicationConfigurationSection>
      <add key="DpiAwareness" value="PerMonitorV2" />
    </System.Windows.Forms.ApplicationConfigurationSection>
    

    IMPORTANT 在以前版本的.NET Framework,您可以使用清单添加高 DPI 支持。 不再建议使用此方法,因为它会替代 app.config 文件中定义的设置。

  • 调用静态xref:System.Windows.Forms.Application.EnableVisualStyles*方法。

    这应该是应用程序的入口点中的第一个方法调用。 例如:

    static void Main()
    {
        Application.EnableVisualStyles();
        Application.SetCompatibleTextRenderingDefault(false);
        Application.Run(new Form2());
    }
    

选择退出各个高 DPI 功能

设置DpiAwareness值设为PerMonitorV2使支持的.NET Framework 版本从.NET Framework 4.7 开始的所有高 DPI 感知功能。 通常情况下,这是适合大多数 Windows 窗体应用程序。 但是,你可能想要选择退出一个或多个单独的功能。 执行此操作的最重要的原因是,现有的应用程序代码已处理该功能。 例如,如果你的应用程序处理自动缩放,你可能想要禁用自动调整大小功能,如下所示:

<System.Windows.Forms.ApplicationConfigurationSection>
  <add key="DpiAwareness" value="PerMonitorV2" />
  <add key="EnableWindowsFormsHighDpiAutoResizing" value="false" />
</System.Windows.Forms.ApplicationConfigurationSection>

有关各个键及其值的列表,请参阅Windows 窗体添加配置元素。

新 DPI 更改事件

从.NET Framework 4.7 开始,三个新事件使您能够以编程方式处理动态 DPI 更改:

新的帮助器方法和属性

.NET Framework 4.7 也将添加大量新的帮助器方法和属性,提供有关 DPI 缩放信息,可用于执行 DPI 缩放。 这些问题包括:

版本控制考虑事项

除了.NET Framework 4.7 和 Windows 10 创意者更新上运行,你的应用程序还可能会运行它不与高 DPI 改进兼容的环境中。 在这种情况下,你将需要开发的应用程序回退。 你可以执行自定义绘图来处理缩放。

若要执行此操作,还需要确定您的应用程序正在其运行的操作系统。 可以使用如下所示的代码执行的操作:

// Create a reference to the OS version of Windows 10 Creators Update.
Version OsMinVersion = new Version(10, 0, 15063, 0);

// Access the platform/version of the current OS.
Console.WriteLine(Environment.OSVersion.Platform.ToString());
Console.WriteLine(Environment.OSVersion.VersionString);

// Compare the current version to the minimum required version.
Console.WriteLine(Environment.OSVersion.Version.CompareTo(OsMinVersion));

请注意,是否未列出的应用程序清单中受支持的操作系统,你的应用程序不会成功检测 Windows 10。

此外可以检查生成应用程序时所针对的.NET framework 版本:

Console.WriteLine(AppDomain.CurrentDomain.SetupInformation.TargetFrameworkName);

请参阅

历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者(原始作者元数据 rpetrusha)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体、发布器占位标签和导航标记。

资料来源与适用范围

资料来源
Microsoft / .NET 中文文档历史快照
适用范围
历史中文快照 2019-08-18;详见原文产品版本;文档日期 05/16/2017
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。