最可靠方式是用GetDpiForWindow通过窗口句柄获取实时DPI,缩放比=DPI/96;需声明PerMonitorV2清单并监听WM_DPICHANGED消息以响应动态缩放变化。

Windows平台用GetDpiForWindow获取当前窗口DPI缩放值
在Windows 10 1703+(或Windows 11)上,最可靠的方式是通过窗口句柄获取实时DPI——不是查注册表或系统设置,因为那些可能滞后或不反映实际渲染缩放。关键函数是GetDpiForWindow,它返回每英寸点数(DPI),缩放比例 = DPI / 96(96是Windows默认DPI)。
常见错误:直接调用GetDpiForSystem——它只返回主显示器的“系统级默认DPI”,无法感知多屏不同缩放、也无法响应用户动态调整(比如拖动窗口到另一个DPI显示器后未刷新)。
- 必须传入有效的窗口句柄(
HWND),哪怕只是临时创建的不可见窗口也行;无窗口环境(如控制台程序)需先调用CreateWindowEx或使用GetThreadDpiAwarenessContext配合GetDpiForSystem作兜底 - 返回值是整数DPI(如120、144、168),除以96.0得到浮点缩放比(1.25、1.5、1.75)
- 若窗口尚未完成DPI适配(比如未声明
PerMonitorV2清单),GetDpiForWindow可能仍返回96——这时要检查应用是否启用高DPI感知
声明DPI感知等级并启用PerMonitorV2支持
不声明DPI感知,Windows会按兼容模式缩放整个进程,GetDpiForWindow就失去意义。C++程序必须在manifest文件中显式配置,否则即使调用正确API,返回值也恒为96或系统默认值。
典型manifest片段(需嵌入资源或外置.exe.manifest):
立即学习“C++免费学习笔记(深入)”;
<application xmlns="urn:schemas-microsoft-com:asm.v3">
<windowsSettings>
<dpiAware xmlns="http://schemas.microsoft.com/SMI/2005/WindowsSettings">true/PM</dpiAware>
<dpiAwareness xmlns="http://schemas.microsoft.com/SMI/2016/WindowsSettings">PerMonitorV2</dpiAwareness>
</windowsSettings>
</application>
注意:PerMonitorV2是唯一支持“窗口跨屏时自动更新DPI”和“缩放变化时接收WM_DPICHANGED消息”的模式。旧的PerMonitor不支持字体/布局自动重缩放,容易出现模糊或错位。
- 链接时需加
/MANIFESTINPUT或确保manifest被正确加载(VS项目属性 → 配置属性 → 清单工具 → 输入和输出 → 使用清单文件 = 是) - 运行时可用
GetThreadDpiAwarenessContext验证当前上下文是否为DPI_AWARENESS_CONTEXT_PER_MONITOR_AWARE_V2 - 若程序启动后才动态切换DPI(如拔插4K显示器),仅靠初始化获取一次不够,必须监听
WM_DPICHANGED并重新调用GetDpiForWindow
监听WM_DPICHANGED捕获实时缩放变更
用户调整缩放比例、拖动窗口到不同DPI显示器、甚至远程桌面连接分辨率变化时,Windows会向窗口发送WM_DPICHANGED消息。忽略它,UI就会卡在旧缩放状态——文字模糊、控件错位、坐标计算全乱。
在窗口过程(WndProc)中处理该消息:
case WM_DPICHANGED: // lParam 是 RECT 结构指针,表示新DPI下推荐的窗口大小和位置 auto dpi = HIWORD(wParam); // 高字是DPI值 double scale = dpi / 96.0; // 此处触发重绘、重排版、重设字体等逻辑 break;
-
wParam高字(HIWORD)即新DPI值,无需再调用GetDpiForWindow——此时窗口已处于新DPI上下文 -
lParam指向RECT,给出建议的窗口尺寸(考虑缩放后的像素大小),应据此调整窗口大小,否则可能被裁剪或留黑边 - 如果使用Direct2D或GDI+,需同步调用
SetDpi或重建设备上下文;纯Win32控件(如Button、Static)通常自动适配,但自绘控件必须手动重算坐标
Linux/macOS没有等效GetDpiForWindow,需退化处理
C++跨平台项目常误以为有统一API。实际上Linux(X11/Wayland)和macOS无窗口粒度DPI查询接口:X11靠Xft.dpi或_NET_WORKAREA估算,Wayland需从xdg_output协议解析,macOS只能用[NSScreen backingScaleFactor]——且都**不保证实时性**,也不响应运行时缩放变更。
这意味着:跨平台GUI框架(Qt、wxWidgets、SDL)内部做了大量适配层,裸C++调用原生API几乎不可行。若必须支持:
- Linux上优先依赖Qt的
QScreen::devicePixelRatio()或GTK的gdk_monitor_get_scale_factor(),而非自己解析X11属性 - macOS上必须监听
NSApplicationDidChangeScreenParametersNotification,不能只在启动时读取 - 所有平台都应缓存DPI值,并提供手动刷新入口(如菜单项“重载显示设置”),因为自动监听失败率远高于Windows
真正棘手的不是怎么取值,而是缩放变更后如何让所有子系统(字体渲染、图像采样、鼠标坐标转换、OpenGL viewport)同步更新——这需要在整个UI栈里埋点,而不是在一个函数里搞定。


















