GetDpiForSystem和GetDpiForWindow需启用Per-Monitor V2感知,否则恒返96;Linux依赖GDK_SCALE/Xft.dpi;macOS须用Objective-C++调NSScreen.backingScaleFactor;各平台均需响应动态DPI变化事件。

Windows 上用 GetDpiForSystem 和 GetDpiForWindow 获取 DPI 缩放比例
Windows 10 1703+ 原生支持 High DPI,GetDpiForSystem 返回系统级逻辑 DPI(通常是 96 × 缩放百分比),GetDpiForWindow 返回指定窗口当前实际 DPI(考虑多显示器不同缩放时更准确)。注意:这两个函数要求启用 Per-Monitor DPI 感知,否则返回值恒为 96。
常见错误是没在 manifest 中声明 DPI 感知模式,或没调用 SetProcessDpiAwarenessContext。若程序未声明感知级别,即使调用成功也只拿到主屏缩放值,跨屏拖动时失效。
- 必须在进程启动早期(如
WinMain开头)调用SetProcessDpiAwarenessContext(DPI_AWARENESS_CONTEXT_PER_MONITOR_AWARE_V2) - manifest 文件中需包含
<dpiAware>true/PM</dpiAware>或<dpiAwareness>PerMonitorV2</dpiAwareness> -
GetDpiForWindow(hWnd)返回的是每英寸点数(如 144 表示 150% 缩放),换算成百分比用(dpi + 0.5) / 96.0
Linux(X11)下读取 scale_factor 和 Xft.dpi
Linux 没有统一的 High DPI API,依赖桌面环境和底层库。GTK/Qt 应用通常通过 gdk_screen_get_resolution() 或 QScreen::logicalDotsPerInch() 获取,但纯 C++ 程序需手动查环境变量和 X11 属性。
关键路径有两个:GDK_SCALE(整数缩放因子,如 2)和 Xft.dpi(X11 字体 DPI,影响文本渲染)。两者不一致时容易出现界面模糊或文字过小。
立即学习“C++免费学习笔记(深入)”;
- 读
GDK_SCALE:用getenv("GDK_SCALE"),仅对 GTK 生效;Qt 使用QT_SCALE_FACTOR - 读
Xft.dpi:调用XGetDefault(display, "Xft", "dpi"),返回字符串,需atoi转换 - 若两者都未设置,默认按 96 DPI 处理;但 Wayland 下这些变量可能无效,需 fallback 到
xdpyinfo | grep dots解析
macOS 上用 NSScreen 获取 backingScaleFactor 和 devicePixelRatio
macOS 的缩放本质是屏幕“背板缩放因子”,由 NSScreen.backingScaleFactor 给出(1.0、2.0 或自定义缩放如 1.5)。C++ 无法直接调 Objective-C 接口,必须通过 Objective-C++ 混合编译(.mm 文件)桥接。
容易忽略的是:该值反映的是当前屏幕的物理像素密度,不是用户设置的“显示缩放”菜单选项(如“更大文字”)。后者影响的是 NSView 的 convertRectFromBacking: 行为,而非直接暴露数值。
- 必须在 .mm 文件中 import
<AppKit/AppKit.h>,用[NSScreen mainScreen].backingScaleFactor - 多显示器场景下,需监听
NSApplicationDidChangeScreenParametersNotification实时更新 - 如果只用纯 C++(无 ObjC++),只能靠
CGDisplayGetPixelWidth/CGDisplayGetPixelHeight与CGDisplayBounds手动计算近似值,误差较大
实时监听 DPI 变化:Windows 的 WM_DPICHANGED 和 macOS 的通知机制
DPI 不是静态配置——用户拖动窗口到不同缩放的显示器、动态切换缩放设置时,应用必须响应变化,否则 UI 元素错位或模糊。Windows 发送 WM_DPICHANGED 消息,macOS 发送 NSApplicationDidChangeScreenParametersNotification,Linux 几乎无标准机制。
很多程序只在启动时读一次 DPI,导致跨屏后按钮变小、文字挤在一起。尤其 Windows 上,WM_DPICHANGED 的 lParam 是 RECT*,表示新 DPI 下推荐的窗口尺寸,必须用它调整窗口大小,否则系统会强制缩放导致模糊。
- Windows:在窗口过程里处理
WM_DPICHANGED,调用SetWindowPos用lParam提供的矩形重设窗口 - macOS:注册通知观察者,收到后调用
[self.view setNeedsDisplay]并重新布局 - Linux:无通用事件,只能轮询(如每秒检查
GDK_SCALE)或依赖 GTK/Qt 自带的信号(如screen-changed)
跨平台封装时,别试图抽象出统一的 “DPI changed” 事件——各平台触发时机、语义、配套动作差异太大,硬统一反而掩盖细节问题。


















