Win32高DPI缩放下窗口对齐任务栏出现固定像素偏移问题

架构老林

2026-8-28

问题根因

你遇到的偏移不是固定魔法值，本质是三个Win32 DPI和窗口渲染的坑叠加导致的：

线程DPI感知上下文不一致：你虽然在清单和初始化代码里设置了PerMonitorV2，但如果在调用GetWindowRect/SetWindowPos的间隙，线程DPI上下文被第三方注入DLL、系统钩子、或者其他API调用意外修改，会导致不同API返回的坐标分属不同的坐标体系——GetWindowRect(Shell_TrayWnd)拿到的是物理像素坐标，SetWindowPos却把传入的参数当成96DPI下的逻辑像素做二次缩放，坐标直接算错。
直接取任务栏窗口RECT的做法本身不可靠：Shell_TrayWnd的RECT包含了任务栏自身的透明边距、DWM阴影区域，和用户视觉上看到的任务栏实体边缘并不重合，100%缩放下你看到的数像素间隙就来自这个差值。
无边框Popup窗口的DWM阴影偏移：默认情况下GetWindowRect返回的窗口RECT包含DWM绘制的外阴影范围，窗口实际的视觉内容边缘比RECT记录的边缘向内收缩了几个像素，在非100%缩放下这个收缩值会随DPI缩放，进一步放大位置误差。

你看到的65像素偏移，是150%缩放下坐标体系换算偏差+阴影偏移+任务栏内边距刚好凑出的环境特定值，换DPI、换系统版本、换主题都会变，没有硬编码参考价值。

落地解决方案

按优先级做以下修改即可彻底解决，不需要硬编码任何偏移值：

所有窗口位置相关操作前后，显式切换线程DPI上下文，不要完全依赖清单配置

// 所有位置计算逻辑开始前，强制切到PerMonitorV2上下文，保存旧值
auto oldDpiCtx = SetThreadDpiAwarenessContext(DPI_AWARENESS_CONTEXT_PER_MONITOR_AWARE_V2);

// --- 所有GetWindowRect、MonitorFromWindow、SetWindowPos调用全放在这个区间内 ---

// 逻辑结束后恢复旧上下文，避免影响其他模块逻辑
SetThreadDpiAwarenessContext(oldDpiCtx);

放弃直接取任务栏RECT计算停靠位置的野路子，用系统提供的工作区API获取精准可用区域
直接拿任务栏窗口RECT无法兼容任务栏自动隐藏、多显示器切换、系统主题边距调整等场景，正确的可用区域应该通过显示器信息API获取：

// 先拿窗口所在的显示器句柄
HMONITOR hTargetMon = MonitorFromWindow(notificationWindowHandle, MONITOR_DEFAULTTONEAREST);
MONITORINFO monInfo = {sizeof(MONITORINFO)};
GetMonitorInfo(hTargetMon, &monInfo);
// monInfo.rcWork 是系统已经算好的、排除了任务栏/所有应用栏占用区域的可用工作区矩形
// 左侧停靠垂直任务栏场景下，rcWork.left就是窗口应该对齐的精确X坐标，不需要自己算任务栏宽度

修正DWM阴影带来的窗口尺寸误差
不要用GetWindowRect拿自身窗口的尺寸做偏移计算，用DwmGetWindowAttribute获取不含阴影的真实视觉边界：

RECT windowVisualRect = {0};
DwmGetWindowAttribute(
    notificationWindowHandle,
    DWMWA_EXTENDED_FRAME_BOUNDS,
    &windowVisualRect,
    sizeof(windowVisualRect)
);
int windowVisualHeight = windowVisualRect.bottom - windowVisualRect.top;

// 最终坐标计算
LONG newX = monInfo.rcWork.left;
LONG newY = monInfo.rcWork.bottom - windowVisualHeight;

SetWindowPos(notificationWindowHandle, NULL, newX, newY, 0, 0, 
    SWP_NOSIZE | SWP_NOZORDER | SWP_NOACTIVATE);

额外注意

如果需要窗口和任务栏之间留固定间隙，间隙值也要用GetDpiForWindow拿到当前窗口DPI后做缩放，不要写死像素值，比如要留2px逻辑间隙，就写2 * GetDpiForWindow(notificationWindowHandle) / 96。
不要在窗口创建完成前调用任何DPI相关的位置API，窗口创建过程中系统会做第一次DPI绑定，这之前的坐标设置会被虚拟化。

内容的提问来源于stack exchange，提问作者qloq