简介围绕Qt与WinAPI混合编程的无边框窗口示例工程面向希望实现Win7 AERO视觉与完整系统交互的桌面开发者也适合作为Qt事件处理、窗口消息机制的进阶练习。工程重点解决去除系统边框后仍保留图标显示、窗口缩放、拖拽、阴影、最大最小化及贴边Snap等行为的问题并将DWM非客户区渲染、模糊背景与自定义标题栏按钮整合到统一窗口框架中。压缩包共48个文件约73KB包含13个头文件和12个cpp源码以及2个ui界面文件、qrc资源表、png/ico/svg图标素材和pro/pri工程配置另附css样式、ini配置与说明文档便于直接编译并对照消息处理与界面资源组织。已有1267人学习下载适合中高级Qt开发者参照。读者可从中获得无边框窗口的完整实现骨架包括命中测试、非客户区计算、图标设置、DWM阴影与模糊调用等关键代码也能借鉴自定义最大化/最小化、窗口拖动和样式资源分离的组织方式用于排查实际项目中的窗口交互与AERO效果问题。1. 先别急着 setWindowFlagsQT 无边框窗口在 WINAPI 里到底缺了哪几块拼图很多人第一次做 QT 无边框窗口都是从一行setWindowFlags(Qt::FramelessWindowHint)起步的接着三件事同时出问题窗口拖到屏幕边缘不触发 snap 分屏最大化后四边被任务栏压住任务栏图标和最小化动画还时不时丢。这不是 QT 的问题FramelessWindowHint只做了一件事——把WS_CAPTION从窗口样式里摘掉剩下的 AERO 风格行为全落在 Win32 窗口过程里阴影归 DWM 管贴边归WM_NCHITTEST管最大化的几何归WM_NCCALCSIZE管。QT 负责画WINAPI 负责窗口行为两层必须在 HWND 上重新对接一次。这套方案覆盖图标、缩放、拖拽、阴影、最大最小化和 AERO 风格适合已经能用 QT 摆布局、但被无边框窗口的边角料磨过一轮的桌面端开发者。2. 窗口骨架从 QWidget 到 HWND 的三个对接点2.1 三个必须最先关掉的默认行为在写任何 Win32 消息处理之前有三件事必须先定下来否则后面所有调试都是在错误的地基上打补丁。第一窗口类型只留Qt::Window别用Qt::Tool或Qt::Popup。Qt::Tool在 Windows 上会被当作工具窗口任务栏不显示图标最小化动画也没有等到你发现任务栏里找不到程序时已经改了一堆代码。第二不要打开Qt::WA_TranslucentBackground。很多人开它就是为了自己画圆角和阴影结果是窗口变成分层窗口layered windowDWM 不再给你画系统阴影DwmExtendFrameIntoClientArea的效果也会被吃掉。阴影这件事交给 DWM比自己用 QPainter 画一圈模糊便宜得多也真实得多。第三别在构造函数里就急着读winId()去做 DWM 设置——那时窗口还没真正创建句柄可能变。稳妥的做法是打开WA_NativeWindow强制提前创建然后在showEvent之后再做 DWM 相关调用。// mainwindow.cpp —— 窗口初始化顺序很关键 #define WIN32_LEAN_AND_MEAN #define NOMINMAX #include windows.h #include dwmapi.h #pragma comment(lib, dwmapi.lib) MainWindow::MainWindow(QWidget *parent) : QWidget(parent) { // 1) 只保留 Window Frameless别混入 Tool / Popup setWindowFlags(Qt::Window | Qt::FramelessWindowHint | Qt::WindowSystemMenuHint | Qt::WindowMinMaxButtonsHint); // 2) 强制提前创建原生窗口后面拿 HWND 才稳定 setAttribute(Qt::WA_NativeWindow); // 3) 不要开半透明背景阴影交给 DWM setAttribute(Qt::WA_TranslucentBackground, false); // 4) 减少重绘闪烁 setAttribute(Qt::WA_OpaquePaintEvent, true); }这段代码里Qt::WindowMinMaxButtonsHint看起来对无边框窗口没意义但它决定了系统菜单里“最大化/最小化”项是否存在也影响WM_SYSCOMMAND的行为建议保留。WA_OpaquePaintEvent是减少重绘闪烁的常用手段代价是你得保证paintEvent里把整个矩形填满否则会留下残影——这一点在自绘标题栏和内容区背景色不一致时特别容易翻车。真正的对接点在nativeEvent。QT 会把它收到的每一条 Windows 消息原样转发过来你在这里处理WM_NCCALCSIZE、WM_NCHITTEST、WM_NCACTIVATE、WM_GETMINMAXINFO这几条就够了其余的交给 QT 默认逻辑。注意函数签名在 QT5 和 QT6 之间有差异QT5 是long *resultQT6 是qintptr *result跨版本编译时这是第一个会报错的地方。2.2 WM_NCCALCSIZE把整块非客户区“吃掉”无边框窗口最核心的一条消息就是WM_NCCALCSIZE。它决定客户区client area在窗口矩形里占多大。默认情况下 Windows 会把标题栏、边框这些非客户区扣掉客户区是剩下的中间那块我们要做的是让客户区等于整个窗口矩形边框和标题栏全部由 QT 自己画。这条消息有个容易忽略的细节wParam TRUE时lParam指向的是NCCALCSIZE_PARAMS结构里面rgrc[0]是建议的新窗口矩形rgrc[1]是旧窗口矩形rgrc[2]是旧客户区wParam FALSE时lParam只是一个RECT*表示客户区。我们只关心TRUE的分支。bool MainWindow::nativeEvent(const QByteArray eventType, void *message, qintptr *result) { Q_UNUSED(eventType); MSG *msg static_castMSG *(message); switch (msg-message) { case WM_NCCALCSIZE: { if (msg-wParam ! TRUE) break; // FALSE 分支交给默认处理 NCCALCSIZE_PARAMS *p reinterpret_castNCCALCSIZE_PARAMS *(msg-lParam); if (IsZoomed(msg-hwnd)) { // 最大化客户区对齐到显示器工作区避开任务栏 MONITORINFO mi { sizeof(MONITORINFO) }; GetMonitorInfo(MonitorFromWindow(msg-hwnd, MONITOR_DEFAULTTONEAREST), mi); p-rgrc[0] mi.rcWork; } // 还原态不改 rgrc[0]客户区就等于整个窗口矩形 *result 0; // 0 表示客户区已由我们算好 return true; } } return QWidget::nativeEvent(eventType, message, result); }还原态下“不改rgrc[0]”这句话是整段的关键。rgrc[0]进入时已经是窗口矩形原样返回、*result 0Windows 就认为客户区铺满整个窗口非客户区宽度为零。如果你手贱把它设成GetWindowRect拿到的值在缩放过程中会因为消息时序问题拿到旧矩形窗口边缘会出现一条撕不开的缝。最大化分支则必须换成mi.rcWork。默认的最大化矩形是显示器全尺寸rcMonitor会盖住任务栏用工作区矩形才能让窗口“贴着任务栏上沿”。这里还有一个 Win10 之后的老坑最大化时 Windows 会额外给窗口加一圈约 8 像素的不可见边框如果不做这一步修正用户看到的就是窗口四边各少一截或者任务栏被压住一半。2.3 DwmExtendFrameIntoClientArea 与阴影预留的 1 像素非客户区被吃干净之后DWM 就不知道该怎么给你画阴影了——它默认只给有标准边框的窗口投影。解决办法是调用DwmExtendFrameIntoClientArea把窗口框架向客户区“延伸”一点点DWM 就会沿着这条延伸线画系统阴影。参数是MARGINS结构网上流传的写法五花八门{1,1,1,1}、{-1,-1,-1,-1}、{0,0,0,0}都有人用但行为完全不同。{-1,-1,-1,-1}是 Aero 玻璃时代的“整窗玻璃”Win8 之后基本失效{0,0,0,0}等于关闭延伸阴影也没了{1,1,1,1}是现在最稳的写法——四周各延伸 1 像素既让 DWM 画出阴影又不会在客户区里留下可见的边框线。void MainWindow::setupDwmShadow() { HWND hwnd reinterpret_castHWND(winId()); // 四周各延伸 1 像素DWM 沿这条线画系统阴影 MARGINS margins { 1, 1, 1, 1 }; DwmExtendFrameIntoClientArea(hwnd, margins); // 通知 DWM 重新计算非客户区否则要等下一次 resize 才生效 SetWindowPos(hwnd, nullptr, 0, 0, 0, 0, SWP_FRAMECHANGED | SWP_NOMOVE | SWP_NOSIZE | SWP_NOZORDER | SWP_NOACTIVATE); // Win11 圆角不设的话无边框窗口是直角和系统风格不搭 enum { DWMWA_WINDOW_CORNER_PREFERENCE_ 33 }; enum { DWMWCP_ROUND_ 2 }; DWORD corner DWMWCP_ROUND_; DwmSetWindowAttribute(hwnd, DWMWA_WINDOW_CORNER_PREFERENCE_, corner, sizeof(corner)); }SWP_FRAMECHANGED这一句容易被漏掉。DwmExtendFrameIntoClientArea只是改了一个属性窗口不会立刻重算非客户区表现是“代码明明调了阴影就是不出现拖动一下窗口才出来”。加上SWP_FRAMECHANGED强制触发一次WM_NCCALCSIZE就好了。Win11 的圆角枚举在 SDK 头文件里叫DWMWA_WINDOW_CORNER_PREFERENCE如果你的编译环境 SDK 版本偏旧、头文件里没有这个符号就按上面代码那样自己定义常量值比升级 SDK 省事。注意圆角只影响视觉命中测试的矩形还是方的圆角附近的点击会有几像素的“死角”这个后面在排查章里还会提到。3. Aero Snap 与拖拽缩放让 WM_NCHITTEST 说实话3.1 命中测试的返回码与边框宽度的 DPI 换算窗口能不能拖、能不能缩放、能不能贴边全看WM_NCHITTEST返回什么。Windows 在鼠标移动时非客户区跟踪模式下会不断发这条消息问你“这个坐标点落在窗口的哪个部位”你返回部位代码系统就执行对应行为——返回HTLEFT系统自己去改宽度返回HTCAPTION系统自己去拖窗口。这就是无边框窗口能保留原生行为的关键不是你去模拟而是你告诉系统“这里还是标题栏”。返回码覆盖区域系统行为HTLEFT/HTRIGHT左右边框条水平缩放光标变双向箭头HTTOP/HTBOTTOM上下边框条垂直缩放HTTOPLEFT/HTBOTTOMRIGHT等四个角双向等比缩放HTCAPTION标题栏空白区拖拽、双击最大化、贴边 snapHTCLIENT内容区、按钮消息正常派发给 QTHTNOWHERE不该命中的地方鼠标事件穿透判断顺序很重要按钮区域必须先判再判边框最后判标题栏。如果反了落在标题栏上的按钮会被当成HTCAPTION点下去变成拖窗口按钮永远点不动——这个坑我在第一次做自绘标题栏时踩了整整一个下午。边框宽度不能写死成 6 像素。GetWindowRect和lParam里的坐标都是物理像素而你的设计稿是按逻辑像素给的在 150% 缩放的屏幕上直接写 6 会让可拖拽区域缩水到 4 个物理像素手感极差。case WM_NCHITTEST: { const POINT pt { GET_X_LPARAM(msg-lParam), GET_Y_LPARAM(msg-lParam) }; RECT rc; GetWindowRect(msg-hwnd, rc); // 1) 自绘按钮优先落到按钮上就交还给 QT const QPoint gpt(pt.x, pt.y); if (m_titleBar m_titleBar-hitTestButtons(gpt)) { *result HTCLIENT; return true; } // 2) 边框命中最大化状态下不提供缩放 if (!IsZoomed(msg-hwnd)) { const int bw qRound(kResizeBorder * devicePixelRatioF()); const bool left pt.x rc.left bw; const bool right pt.x rc.right - bw; const bool top pt.y rc.top bw; const bool bottom pt.y rc.bottom - bw; if (top left) { *result HTTOPLEFT; return true; } if (top right) { *result HTTOPRIGHT; return true; } if (bottom left) { *result HTBOTTOMLEFT; return true; } if (bottom right) { *result HTBOTTOMRIGHT; return true; } if (left) { *result HTLEFT; return true; } if (right) { *result HTRIGHT; return true; } if (top) { *result HTTOP; return true; } if (bottom) { *result HTBOTTOM; return true; } } // 3) 标题栏区域 const int titleH qRound(m_titleBar-height() * devicePixelRatioF()); if (pt.y rc.top titleH) { *result HTCAPTION; return true; } *result HTCLIENT; return true; }devicePixelRatioF()取的是窗口所在屏幕的缩放比。这里有个细节devicePixelRatioF()是 QT 给的主屏比例窗口跨屏拖动时它未必跟着变所以更严谨的写法是用GetDpiForWindow(msg-hwnd) / 96.0现算。两种写法在单屏场景下没差别多屏混合 DPI 场景下后者才准第 5 章会专门说这个。3.2 为什么标题栏必须返回 HTCAPTION 而不是自己 mouseMove这是整篇最关键的一条经验。网上大量 QT 无边框教程教你重写mousePressEvent/mouseMoveEvent记录按下点和窗口位置然后move()。这种写法能拖动但会同时丢掉四样东西Aero Snap 贴边分屏、拖到屏幕顶端最大化、双击标题栏最大化/还原、以及窗口最大化状态下拖拽还原并跟随鼠标。你可以在代码里把这四样全部手写一遍但每一样都有边界情况——贴边分屏还要判断多显示器边界拖拽还原还要算鼠标在标题栏里的相对位置比例写完之后大概三百行还容易在缩放比例变化时错位。返回HTCAPTION就全部免费。系统收到这个返回码后会接管鼠标走的是和资源管理器窗口完全相同的代码路径拖到边缘出半屏预览拖到顶部出最大化提示双击等于按标题栏最大化状态下按住标题栏往下拖会自动还原并让鼠标保持在标题栏的相对位置。这套行为是操作系统的原生实现你的程序天然和系统里其他窗口一致。代价是标题栏区域里的 QT 控件收不到鼠标事件——这也是为什么按钮区域必须在WM_NCHITTEST里提前排除、返回HTCLIENT。我的做法是给标题栏控件加一个hitTestButtons(QPoint)方法内部用mapToGlobal(rect())把每个按钮的全局矩形算出来做包含判断把所有按钮合并成一个QRegion一次判断鼠标移动时开销可以忽略。还有一个隐蔽的坑如果你的标题栏容器本身设了setMouseTracking(true)QT 会持续跟踪鼠标但WM_NCHITTEST在HTCAPTION区域已经把事件拦走了QT 层的跟踪其实是空的别指望靠它实现悬停高亮老老实实把按钮拆成独立子控件。3.3 WM_GETMINMAXINFO 与最大化几何修正无边框窗口的“最小尺寸”在 QT 层用setMinimumSize()设理论上就够了但实际会失效——因为WM_GETMINMAXINFO走的是 Windows 自己的计算路径DefWindowProc会用窗口样式推一个默认最小值某些 DPI 下比你在 QT 里设的还大表现为“明明设了 600×400拖到 800 就拖不动了”。case WM_GETMINMAXINFO: { MINMAXINFO *mmi reinterpret_castMINMAXINFO *(msg-lParam); const qreal dpr devicePixelRatioF(); mmi-ptMinTrackSize.x qRound(minimumWidth() * dpr); mmi-ptMinTrackSize.y qRound(minimumHeight() * dpr); *result 0; return true; }这里同样要用物理像素。ptMinTrackSize的单位是物理像素直接塞minimumWidth()在 200% 缩放下会让最小值变成设计值的一半。最大化几何在第 2 章的WM_NCCALCSIZE里已经用mi.rcWork修过一次但还有第二种情况窗口从最大化还原时Windows 会把窗口恢复到最大化之前的矩形如果那个矩形是在另一块屏幕上记录的、或者那块屏幕已经被拔掉了还原后窗口会跑到屏幕外面。稳妥的补充处理是在WM_SYSCOMMAND里拦截SC_RESTORE还原前检查一次目标矩形是否和任一显示器工作区有交集没有就居中到主屏。这段逻辑我一般放在 QT 层用QGuiApplication::screens()遍历判断比在 Win32 里写更清楚。4. 自绘标题栏图标、最小化按钮与 AERO 视觉状态的联动4.1 图标、按钮的布局与 DPI 对齐标题栏做成一个独立的QWidget高度按逻辑像素给 40内部用QHBoxLayout排左边图标 标题文字右边最小化/最大化/关闭三个按钮。按钮不要用QPushButton用QToolButton加setAutoRaise(true)默认样式接近系统 caption 按钮改起来也方便。图标这一块要注意两件事。第一窗口图标要同时设两处setWindowIcon()管 QT 内部比如任务栏预览、AltTab 列表WM_SETICON管标题栏和任务栏的位图缓存。只设前者的话任务栏图标有时是空的特别是程序启动后第一次最小化再恢复的时候——这是 Windows 的图标缓存机制导致的补一条WM_SETICON就稳定了。第二图标尺寸要按 DPI 准备多套Windows 在 125%/150% 下会找 20/24 像素的图标只给 16 和 32 会触发位图缩放边缘发虚。void MainWindow::applyWindowIcon(const QIcon icon) { setWindowIcon(icon); // QT 侧AltTab、任务栏预览 HWND hwnd reinterpret_castHWND(winId()); const int dpi GetDpiForWindow(hwnd); // 需要 Win10 1607 const int cx MulDiv(16, dpi, 96); // 按 DPI 换算图标边长 HICON hi icon.pixmap(cx, cx).toImage().toHICON(); SendMessage(hwnd, WM_SETICON, ICON_SMALL, reinterpret_castLPARAM(hi)); SendMessage(hwnd, WM_SETICON, ICON_BIG, reinterpret_castLPARAM(hi)); }toHICON()是 QT5.15 之后才有的便捷方法早期版本得用QImage手动构造HBITMAP再CreateIconIndirect麻烦且容易泄漏建议按最低 QT 版本决定要不要写这一层。图标句柄的所有权在 Windows 侧重复调用WM_SETICON时旧句柄不会自动释放频繁换图标的场景比如根据主题切换要自己DestroyIcon否则每次切换漏一个 GDI 对象跑一天能到几万个。4.2 激活态与非激活态WM_NCACTIVATE 的状态同步系统标题栏在窗口失焦时会变成灰色自绘标题栏也得跟着变否则用户切到别的窗口你的标题栏还亮着视觉上很别扭。判断依据是WM_NCACTIVATEwParam TRUE表示获得焦点FALSE表示失去焦点。这条消息有个默认行为要改DefWindowProc处理WM_NCACTIVATE时会重绘非客户区在无边框窗口上会引发整条标题栏闪一下尤其是快速 AltTab 切换时特别明显。标准做法是返回TRUE但不让它重绘。case WM_NCACTIVATE: { const bool active (msg-wParam TRUE); if (m_titleBar) m_titleBar-setActive(active); // 切换标题栏配色 *result TRUE; // 告诉系统我已处理阻止默认重绘 return true; }*result TRUE和return true要一起给。只return true不给 result系统拿到的返回码是未初始化的栈值行为随机——有时候标题栏不刷新有时候整个窗口重绘。激活态配色我一般做两套激活时文字用#1a1a1a、按钮悬停背景用半透明黑失活时文字降到#8a8a8a、按钮悬停几乎不变色。这套颜色跟随系统深浅色主题的话可以用QGuiApplication::styleHints()-colorScheme()判断再在WM_SETTINGCHANGE里监听ImmersiveColorSet变化重新取色。不放宽这块也行深色主题下浅色标题栏确实会显得突兀属于体验上的最后 10%。4.3 系统菜单、右键菜单与任务栏图标的补充处理Qt::WindowSystemMenuHint加了之后在标题栏上按 Alt空格、或者右键标题栏系统期望弹出窗口系统菜单。但因为我们把非客户区吃掉了WM_NCRBUTTONUP根本不会发到标题栏上——事件走的是HTCLIENT路径。处理办法是在标题栏控件的contextMenuEvent里主动发一次void TitleBar::contextMenuEvent(QContextMenuEvent *e) { // 手动拉起系统菜单锚点用全局坐标 HWND hwnd reinterpret_castHWND(window()-winId()); const QPoint g e-globalPos(); SendMessage(hwnd, WM_SYSCOMMAND, SC_MOUSEMENU, MAKELPARAM(g.x(), g.y())); e-accept(); }SC_MOUSEMENU会让系统在指定坐标弹出标准的还原/移动/大小/最小化/最大化/关闭菜单项的状态跟着窗口当前状态走不用自己维护。用SC_KEYMENU就是 Alt空格的效果坐标随便填。任务栏图标还有一处要补如果程序有多个顶层窗口Windows 默认可能把每个都当成独立任务栏项或者合并成一组但图标取第一个窗口的。要想固定用主窗口图标做分组图标得设AppUserModelID在main()里SetCurrentProcessExplicitAppUserModelID(LYourApp.Id)一次即可。这个 ID 是字符串随便取但要全进程唯一改了就相当于换了一个新的任务栏分组用户原来固定的快捷方式会失效所以第一次发布前就要定下来。5. 排查清单黑边、闪白、Snap 失灵的五个现场5.1 最大化后四边被任务栏压住或多出黑边现象点最大化按钮窗口铺满整块屏幕底部任务栏被盖住或者反过来窗口四边各露出一条和内容区颜色不一致的窄边。原因有两个层次。第一层是WM_NCCALCSIZE里没处理最大化分支客户区还是按窗口矩形算而窗口矩形是rcMonitor全屏自然压任务栏。第二层更隐蔽即使改成了rcWork如果WM_NCCALCSIZE的wParam判断写成了if (msg-wParam)而不是if (msg-wParam TRUE)FALSE分支lParam是RECT*也会进到同一段代码里被当成NCCALCSIZE_PARAMS解析读到的是垃圾指针行为完全随机。解决严格按wParam TRUE分流最大化分支里用MonitorFromWindow(hwnd, MONITOR_DEFAULTTONEAREST)取当前显示器再GetMonitorInfo拿rcWork。多显示器场景下千万不要用主屏的rcWork窗口在副屏最大化时会跑到主屏去。5.2 窗口创建瞬间闪白、拖动时撕裂现象程序启动的零点几秒里窗口先闪一个白色矩形再变成正常内容或者拖动窗口时边框处有一条白线闪烁。原因QT 的默认背景填充和 Windows 的窗口擦除在打架。窗口刚创建时系统会先发一次WM_ERASEBKGND用默认画刷填白然后 QT 才跟上画内容。拖动时撕裂则是WS_EX_COMPOSITED没开DWM 合成和 QT 重绘之间有一个时间窗。解决nativeEvent里拦截WM_ERASEBKGND直接返回 1表示“我已经擦过了”同时在 QT 侧保证paintEvent覆盖整个窗口矩形。这一步对性能影响不大因为 DWM 本来就会合成重复擦除纯属浪费。case WM_ERASEBKGND: *result 1; // 告诉系统擦除已处理跳过默认白底 return true;如果闪白还在检查是不是构造函数里设了setStyleSheet且带背景色——样式表在窗口显示后异步应用第一帧还是白底。改成在paintEvent里手动fillRect一次或者用setAutoFillBackground(true)配QPalette提前把背景色定死。5.3 Snap 贴边失效、双击标题栏不还原现象窗口能拖但拖到屏幕边缘没有半屏预览双击标题栏没反应或者双击之后窗口变大了但没贴到工作区。原因八成是标题栏区域没有返回HTCAPTION而是走了mouseMoveEvent里自己move()。系统根本没收到“这里是标题栏”的信号自然不会有 snap 和双击行为。另一种可能是返回了HTCAPTION但WM_NCCALCSIZE把客户区算错了导致rc.top titleH这个判断阈值落到了窗口外面整个标题栏都被判成HTCLIENT。解决先确认WM_NCHITTEST里能走到HTCAPTION分支——在分支里打一行qDebug()看鼠标移到标题栏时有没有输出。如果有输出但 snap 还是没有检查是不是在别处调用了SetWindowLongPtr(GWL_STYLE, ...)把WS_THICKFRAME去掉了WS_THICKFRAME是无边框窗口保留 snap 和缩放能力的必要条件Qt::FramelessWindowHint不会动它但有人为了让窗口“更干净”手动清了样式之后所有原生行为一起消失。5.4 拖到第二块屏幕后缩放边距全部错位现象主屏 150% 缩放、副屏 100% 缩放窗口从主屏拖到副屏边框的可拖拽区域突然变窄一半或者变宽到 9 像素手感完全不对。原因devicePixelRatioF()返回的是窗口所属屏幕的比例但 QT 在跨屏拖动时不会立即更新这个值存在一到两帧的滞后另外WM_NCHITTEST是高频消息每次都调devicePixelRatioF()也会拿到过期的缓存。解决在WM_NCHITTEST内部改用GetDpiForWindow(msg-hwnd) / 96.0现算这个 API 直接问 Windows 当前窗口所在显示器的 DPI没有缓存滞后。GetDpiForWindow需要 Win10 1607 以上更老的系统用GetDpiForMonitor配MonitorFromWindow兜底。static double dpiScaleOf(HWND hwnd) { const UINT dpi GetDpiForWindow(hwnd); // Win10 1607 return dpi ? dpi / 96.0 : 1.0; }顺带提一句如果程序声明了 per-monitor DPI awaremanifest 里的dpiAwareness设PerMonitorV2Windows 会在窗口跨屏时发WM_DPICHANGED你可以在那里同步更新标题栏高度、按钮尺寸和图标。没声明的话系统会做位图拉伸缩放边距虽然对了但整个界面是模糊的属于另一种翻车。5.5 任务栏图标丢失或最小化动画消失现象程序跑起来任务栏里没有图标只有一个空白占位或者点最小化窗口“啪”地消失没有那个缩到任务栏的动画。原因任务栏图标丢失通常是WM_SETICON没设或者设的HICON尺寸不对比如给了 32×32 却标成ICON_SMALL最小化动画消失则多半是窗口样式里混进了WS_EX_TOOLWINDOW——QT 的Qt::Tool会自动带这个扩展样式一旦带上系统就把它当工具窗口不给任务栏项也不给最小化动画。解决确认窗口 flags 里没有Qt::Tool或Qt::Popup然后检查GetWindowLongPtr(hwnd, GWL_EXSTYLE)的结果里有没有WS_EX_TOOLWINDOW有就SetWindowLongPtr清掉再SetWindowPos(SWP_FRAMECHANGED)。图标方面按 4.1 的做法ICON_SMALL和ICON_BIG都设尺寸按 DPI 换算别图省事两个都用 32。6. 收进一个 NativeFrameHelper把消息收敛成可复用类上面这些逻辑如果全堆在MainWindow::nativeEvent里第二个窗口要用的时候就得复制一遍改一处漏一处是迟早的事。我一般的做法是抽一个NativeFrameHelper构造时传宿主QWidget*内部装一个事件过滤器接管nativeEvent把边框宽度、标题栏高度、按钮命中回调做成可配置项。class NativeFrameHelper : public QObject { Q_OBJECT public: explicit NativeFrameHelper(QWidget *host, QObject *parent nullptr) : QObject(parent), m_host(host) { m_host-setAttribute(Qt::WA_NativeWindow); m_host-installEventFilter(this); } void setResizeBorder(int logicalPx) { m_border logicalPx; } void setTitleBarHeight(int logicalPx) { m_titleH logicalPx; } // 返回 true 表示该全局坐标落在自绘按钮上交还给 QT std::functionbool(const QPoint ) buttonHitTest; protected: bool eventFilter(QObject *obj, QEvent *ev) override { if (ev-type() QEvent::WinEventAct) { /* 占位 */ } return QObject::eventFilter(obj, ev); } bool nativeEvent(const QByteArray , void *message, qintptr *result); private: QWidget *m_host nullptr; int m_border 6; int m_titleH 40; };真正干活的是nativeEvent里那个switch和前面几章写的完全一样只是把m_titleBar-hitTestButtons(gpt)换成了buttonHitTest(gpt)回调把minimumWidth()换成了宿主控件的查询。这样主窗口、设置窗口、关于窗口都能复用区别只在按钮区和标题栏高度。接入之后别急着收工按下面这张清单过一遍每一条都对应前面提过的一个坑验证项操作期望结果贴边分屏拖标题栏到屏幕左边缘出现半屏预览松手占满左半顶部最大化拖标题栏到屏幕顶端出现最大化提示松手最大化双击标题栏双击标题栏空白处最大化再双击还原最大化还原拖拽最大化后按住标题栏往下拖自动还原且鼠标保持相对位置四边缩放从四条边和四个角拖拽光标变双向箭头窗口跟随最小化动画点最小化按钮有缩到任务栏的动画任务栏图标查看任务栏图标清晰无空白占位多屏 DPI拖到不同缩放比的屏幕边框手感一致界面不模糊阴影观察窗口四周有系统投影无黑边失焦配色点击其他窗口标题栏变灰无闪烁这套东西我从最早的mouseMove拖动版一路改到现在的HTCAPTION版中间翻过的车基本都在第 5 章里了。最血泪的一次是WM_NCCALCSIZE里用GetWindowRect拿到旧矩形在 4K 屏上表现为窗口右边缘怎么都拖不动查了两个晚上才定位到是消息时序问题。从那以后我每次写完nativeEvent都强制按上面那张表从头到尾走一遍尤其是多屏 DPI 那一条——单屏开发环境永远测不出来等用户反馈的时候已经发版了。希望帮到你。本文还有配套的精品资源点击获取