getdpiforwindow 是 windows 10(1607+)及 windows 11 中获取窗口 dpi 的推荐方式,返回整型 dpi 值(如 144),缩放比例 = dpi / 96;需启用 permonitorv2 dpi 感知,响应 wm_dpichanged 动态重读,避免使用 getdpiforsystem 或缓存缩放值。

Windows 上用 GetDpiForWindow 获取当前窗口的 DPI 缩放因子
在 Windows 10(1607+)及 Windows 11 中,GetDpiForWindow 是最直接、推荐的方式。它返回的是每英寸点数(DPI),缩放比例 = DPI / 96(因为 100% 缩放对应 96 DPI)。注意:该函数要求窗口句柄有效,且程序需启用 DPI 感知(否则可能始终返回 96)。
实操要点:
- 必须在 manifest 中声明 DPI 感知,或调用
SetProcessDpiAwarenessContext(推荐DPI_AWARENESS_CONTEXT_PER_MONITOR_AWARE_V2) - 若传入
NULL或无效HWND,行为未定义;建议只对已创建的窗口调用 - 返回值是整型 DPI(如 144 表示 150% 缩放),不要直接当浮点比例用
- 示例:
int dpi = GetDpiForWindow(hwnd);<br>float scale = static_cast<float>(dpi) / 96.0f;</float>
跨显示器场景下避免误用 GetDpiForSystem
GetDpiForSystem 返回主显示器的 DPI,完全忽略当前窗口所在屏幕的实际缩放。多显示器混合缩放(比如主屏 125%,副屏 100%)时,用它会出错——哪怕窗口正显示在副屏上,仍返回主屏 DPI。
常见错误现象:
- 窗口拖到高 DPI 副屏后 UI 突然模糊或错位,但日志里显示“缩放 100%”
- 使用
GetDpiForSystem计算字体大小,结果在非主屏上文字过小 - 仅在单屏环境测试通过,多屏部署后失效
旧系统兼容:回退到 GetDeviceCaps + GetDC
Windows 8.1 或未启用高 DPI 感知的进程里,GetDpiForWindow 可能不可用(返回 0)。此时可用 GDI 方式获取逻辑 DPI:
实操要点:
- 调用
GetDC(NULL)获取全屏 DC,再用GetDeviceCaps(hdc, LOGPIXELSX)读取 X 方向 DPI - 该值反映当前线程 DPI 感知状态:未感知时返回系统默认(96),感知后可能返回主屏 DPI(仍不准确)
- 务必配对调用
ReleaseDC(NULL, hdc),否则资源泄漏 - 不推荐用于新项目,仅作降级兜底;优先确保
SetProcessDpiAwarenessContext调用成功
C++ 代码里缩放因子必须动态重读,不能只初始化一次
用户可在系统设置中随时更改缩放比例,甚至拖动窗口跨屏——此时 DPI 可能实时变化。Windows 会发送 WM_DPICHANGED 消息,但很多程序忽略它,导致 UI 持续错乱。
关键动作:
- 在窗口过程(
WndProc)中处理WM_DPICHANGED,重新调用GetDpiForWindow - 不要缓存缩放因子到全局变量并长期复用;每次布局、绘图前应确认当前值
- Direct2D / DirectWrite 等 API 内部也依赖此值,缩放变更后需重置设备上下文
- 调试时可监听
WM_GETDPISCALEDSIZE验证系统是否已正确响应缩放变更
最容易被忽略的是:即使你用了 PerMonitorV2 感知,也不代表系统会自动帮你重绘——重算缩放、调整窗口尺寸、重排控件,全得自己写逻辑。
C++免费学习笔记(深入):立即使用
在学习笔记中,你将探索 C++ 的入门与实战技巧!











