getdpiforwindow是最可靠的实时dpi获取方式,返回整数dpi值(如120),需除以96.0得缩放系数;必须启用permonitorawarev2感知,否则降级为全局缩放。

Windows平台下用GetDpiForWindow获取当前窗口所在显示器的实时DPI缩放比
直接调用GetDpiForWindow是最可靠的方式,它返回的是每英寸像素数(DPI),不是百分比。要换算成缩放比例(如125% → 1.25),需除以基准DPI(通常是96):scale = GetDpiForWindow(hwnd) / 96.0。这个API从Windows 10 1607起可用,且会随系统缩放设置动态变化——比如用户拖动窗口到另一个DPI不同的显示器,再次调用就能拿到新值。
常见错误是误用GetDeviceCaps(hdc, LOGPIXELSX):它只反映主显示器或GDI上下文创建时的DPI,不响应运行时切换,也不支持Per-Monitor V2模式下的独立缩放。
- 必须确保程序已声明Per-Monitor DPI Awareness(在manifest中设
dpiAwareness="perMonitorAwareV2",或调用SetProcessDpiAwarenessContext(DPI_AWARENESS_CONTEXT_PER_MONITOR_AWARE_V2)) - 传入的
HWND不能为NULL;若无窗口,可用MonitorFromPoint+GetDpiForMonitor组合替代 - 返回值是整数(如120、144、192),除以96.0后才是浮点缩放系数
没有窗口句柄时用GetDpiForMonitor配合MonitorFromPoint
命令行工具、后台服务或初始化阶段尚未创建窗口时,无法用GetDpiForWindow。此时应先定位目标显示器,再查其DPI。典型做法是用MonitorFromPoint(传入屏幕坐标)或MonitorFromRect获取HMONITOR,再调GetDpiForMonitor。
注意:该函数在Windows 8.1+可用,但需链接shcore.lib并加载Shcore.dll中的导出函数(或使用#pragma comment(lib, "shcore.lib"))。若未启用DPI Awareness,它可能始终返回主显示器的DPI。
-
POINT pt = {0, 0}; HMONITOR hmon = MonitorFromPoint(pt, MONITOR_DEFAULTTONEAREST);可获取原点所在显示器 -
GetDpiForMonitor(hmon, MDT_EFFECTIVE_DPI, &dpiX, &dpiY)中MDT_EFFECTIVE_DPI表示系统当前应用的缩放值(等效DPI),MDT_RAW_DPI则返回物理DPI(忽略缩放) - 返回的
dpiX和dpiY通常相等;只需取其一即可
Qt或wxWidgets等框架内避免重复封装,优先用原生接口
Qt 5.14+ 的QScreen::devicePixelRatio()看似方便,但它返回的是逻辑像素与设备像素比(即scale),底层仍调用Windows API。问题在于:若应用未正确声明DPI Awareness,Qt可能缓存初始值不再更新,导致窗口跨显示器时比例错乱。
wxWidgets的wxDisplay::GetPPI()同理,依赖初始化时的GDI调用,不具备实时性。真正需要“实时”响应的场景(如拖拽过程中动态调整UI布局),必须绕过框架封装,直接调用GetDpiForWindow。
- Qt中可在
winEvent里监听WM_DPICHANGED消息,再调用GetDpiForWindow刷新 - wxWidgets可通过
wxTopLevelWindow::MSWHandleMessage捕获WM_DPICHANGED,避免依赖GetPPI() - 所有框架都无法绕过进程级DPI Awareness配置——没设对,再怎么调API也拿不到正确值
Linux/macOS上不存在等价的“实时缩放比例”概念
Linux(X11/Wayland)和macOS不提供类似Windows的系统级统一缩放比例参数。它们采用更细粒度的渲染控制:X11靠XRANDR的scale属性(仅对整个输出生效),Wayland靠协议扩展(如wp-output-scale),macOS则用NSScreen.backingScaleFactor——但该值是固定的(1x/2x/3x),不支持125%、150%这类非整数缩放。
这意味着:C++跨平台代码里硬写“获取系统缩放比例”逻辑,在非Windows平台注定失效或只能做粗略估算(比如读取QT_SCALE_FACTOR环境变量,但这是Qt专属,且不保证实时)。
- Windows是唯一提供
WM_DPICHANGED消息和Per-Monitor API的主流桌面平台 - 若项目必须跨平台,建议只在Windows分支实现DPI感知,其他平台默认按1.0处理,或由GUI框架自行适配
- 不要试图用
GetSystemMetrics(SM_CXSCREEN)之类间接推算——分辨率变化≠缩放变化,尤其在多显示器混合DPI场景下完全不可靠
perMonitorAwareV2或进程启动时没调SetProcessDpiAwarenessContext,所有后续DPI查询都会降级回全局缩放值。C++免费学习笔记(深入):立即使用
在学习笔记中,你将探索 C++ 的入门与实战技巧!











