企业官网建设流程全解析

简介：基于QT与Windows API混合编程的无边框窗口示例工程，面向需要在Windows桌面端实现自定义标题栏与高级外观的Qt开发者。代码完整演示了图标显示、窗口缩放、鼠标拖拽、Win7阴影、最大最小化操作及AERO风格融合，并深入处理WM_NCHITTEST、WM_GETMINMAXINFO、DwmExtendFrameIntoClientArea等关键消息，解决FramelessWindowHint去除边框后系统交互缺失的常见痛点。资源共48个文件，以h/cpp源码为核心，辅以ui界面文件、qrc/ico/png/svg图标与样式资源、pri/pro工程配置及说明文档，压缩包仅73KB，结构紧凑便于直接导入Qt工程学习。已有1264人学习下载，适合具备基础Qt事件处理与WinAPI常识、希望从混合编程角度提升窗口定制能力的开发者参考，亦可作为自定义无边框窗体的代码模板使用。

1. 无边框窗口从哪一步开始翻车：QSS 做出干净界面，却弄丢了系统的缩放和阴影

接手过一个偏古典的 Windows 桌面客户端，界面要全部换成 QSS 自绘风格，于是第一件事就是setWindowFlags(Qt::FramelessWindowHint)。窗口是干净了，但紧接着用户反馈像连珠炮：窗口拖不动、边缘不能拉大拉小、没有阴影像一张贴纸盖在桌面上、最大化之后露出一圈白边、最小化回来位置还偏移。这套从 Qt 侧模拟出来的无边框窗口行为，怎么看都差点意思。

标题里那句“QT使用WINAPI实现支持图标、缩放、拖拽、阴影、最大最小化、AERO风格无边框窗口”说得很直白：无边框窗口不能只靠 Qt 的窗口标志位，真正的阴影、缩放、拖拽这套，Windows 自己的窗口管理器早就实现了，只是被 FramelessWindowHint 一并关掉了。要做的就是通过 WINAPI 把 AERO 阴影找回来、把命中测试接管回来，让系统窗口逻辑继续为该服务。这条路适合所有在 Windows 上做 Qt 自绘界面、又不想跟系统行为硬刚的桌面端开发者。下面按落地顺序：原理、关键 API、完整实现、参数与踩坑，一步步说透。

2. 为什么必须把 WINAPI 拉进来：DWM 阴影、WM_NCHITTEST 和窗口风格位才是幕后黑手

2.1 纯 Qt 无边框方案丢掉的四样东西：不是 bug，是窗口风格位不对

很多人以为无边框窗口只是“不要标题栏”，然后自己补一套拖拽、缩放、最小化最大化逻辑。实际上 Qt 的FramelessWindowHint做的是：去掉WS_CAPTION和WS_THICKFRAME这两个窗口样式位。Windows 的默认窗口行为，比如边缘拖拽改变大小、AERO 阴影、最大化动画、Aero Snap 贴靠、双击标题栏最大化，全都依赖这两个风格位。你去掉了，系统自然就不认这个窗口是“带边框的顶级窗口”了，后续的一切问题都从这里来。

纯 Qt 方案通常的做法是：重写mousePressEvent移动窗口，重写mouseMoveEvent算缩放，用QGraphicsDropShadowEffect补阴影，用windowState()做最大化。这套方案表面可行，实际翻车在四个点。第一，阴影是画在窗口内容上的，不是系统阴影，缩放时模糊区域会变形，切到高性能 GPU 时还经常闪烁。第二，鼠标缩放靠定时器轮询或高频事件累积，边缘没有原生窗口那种跟手的感觉，尤其是快速拖动时。第三，最大化动画完全没有，要么瞬间跳变，要么自己用 QPropertyAnimation 模拟，效果和系统动画差一个量级。第四，也是最隐蔽的，系统级贴靠、分屏、Win+方向键这些行为全部丢失，用户一用就会觉得“这不是个正经窗口”。

从 Windows 的实现看，这些行为本来就归系统管。窗口管理器（DWM）负责绘制阴影和动画，命中测试机制（WM_NCHITTEST）决定鼠标落在窗口的哪个部位、该触发移动还是缩放。纯 Qt 方案等于重新发明了一个简化版窗口管理器，还装不进系统层。

2.2 WINAPI 介入的三个关键点：DWM 扩展、WM_NCHITTEST、SetWindowLongPtr

既然问题是窗口风格位丢了，那就把它找回来。我一般用三个 WINAPI 入口完成这件事。

第一个入口是DwmExtendFrameIntoClientArea。它是 AERO 阴影恢复的关键。Windows 的阴影不是画在窗口外部的附加层，而是 DWM 根据窗口 frame 扩展区域自动渲染的。无边框窗口没有 frame，阴影就没有了。用MARGINS {-1}调用DwmExtendFrameIntoClientArea，相当于告诉 DWM：把整个客户区都当成 frame 扩展区来对待。这样 AERO 阴影会回来，同时窗口四边的半透明效果也能配合主题渲染。

第二个入口是 WM_NCHITTEST。这是无边框窗口能否“复活”原生交互的核心。系统在处理鼠标命中的时候，会给窗口发送 WM_NCHITTEST，窗口返回一个值告诉系统“鼠标在我身上哪个部位”。返回HTCAPTION，系统就按标题栏行为处理，鼠标按住可以拖动、双击可以最大化；返回HTLEFT、HTRIGHT、HTTOP、HTBOTTOM以及对应的四角值，系统就按边框行为处理，鼠标变成缩放光标并改变窗口大小。一切拖拽和缩放都是系统做的，你只需要把鼠标位置翻译成语义正确的命中区域。

第三个入口是SetWindowLongPtr。用它把WS_THICKFRAME加回窗口样式，同时保留WS_POPUP的外观。这样窗口看起来还是无边框的，但系统层的缩放和阴影逻辑开始继续工作。配合WM_NCCALCSIZE返回 0，强制系统不绘制边框，只保留边框逻辑。

2.3 什么时候值得切混合方案：需求清单和判断标准

不是每个无边框窗口都需要引入 WINAPI，小工具和内部演示程序用 QSS 方案也能应付。但如果你的项目命中以下任何两条，我建议尽早改方案：用户会频繁切换窗口位置和大小；设计稿要求窗口有真实阴影或圆角；需要支持 Windows 10/11 的贴靠布局和虚拟桌面行为；界面里有高频刷新的内容，阴影在动态缩放时必须是稳定的；程序会跑在多种 DPI 的显示器上。

还有一种情况也值得切：你已经实现了拖拽，但发现标题栏上的按钮点击被拖拽逻辑干扰了。这是纯 Qt 方案的老问题——自己处理 mousePressEvent 和 mouseMoveEvent 时，很容易把按下和拖动混在一起，按钮的点击判定变得很脆弱。用 WM_NCHITTEST 返回语义区域之后，标题栏区域的拖拽由系统处理，按钮区域返回 HTCLIENT 仍然走 Qt 的事件系统，两者天然隔离。

判断标准其实很简单：当你发现自己开始写“窗口是否被拖动”的状态变量时，就走错方向了。这套逻辑系统已经实现了，而且比任何人写的都健壮。

3. 用 WINAPI 恢复 AERO 阴影、拖拽与缩放：DWM 扩展与命中测试的核心实现

3.1 工程准备：nativeEvent 的接入与 DPI 感知设置

动手之前要做两件基础工作：开启 DPI 感知、准备一个接收原生消息的窗口基类。DPI 感知不设置，后面所有坐标换算都会乱，尤其是混合分辨率的多屏场景。程序入口处调用一次：

#include <windows.h> // 必须在 QApplication 创建之前调用 SetProcessDpiAwarenessContext(DPI_AWARENESS_CONTEXT_PER_MONITOR_AWARE_V2);

DPI_AWARENESS_CONTEXT_PER_MONITOR_AWARE_V2是 Windows 10 1703 之后推荐的模式。它让系统在窗口跨屏移动时主动通知 DPI 变化，并且让 WM_NCHITTEST 收到的坐标是物理像素坐标。配合下面的除法换算，才能保证 HiDPI 下缩放热区不偏。如果省略这一步，Windows 会按系统级缩放给你“虚拟化”坐标，窗口会模糊，边缘热区位置也会和鼠标实际位置错开。

然后是事件接入。在 QWidget 子类里重写nativeEvent，所有 WINAPI 相关的逻辑都在这里：

// FramelessWindow.h class FramelessWindow : public QWidget { Q_OBJECT protected: bool nativeEvent(const QByteArray &eventType, void *message, qintptr *result) override; int hitTest(const QRect &rect, const QPoint &pos) const; private: void setupDwmShadow(HWND hwnd); void updateWindowStyle(HWND hwnd); };

注意 Qt6 里nativeEvent的签名和 Qt5 相同，但eventType参数在 Windows 上可能是空字节数组，判断消息类型时不要依赖它，直接判断MSG::message。result是要返回给系统的 LRESULT，在 Qt6 里是qintptr*，强转时保持一致。

3.2 找回 AERO 阴影：DwmExtendFrameIntoClientArea 的最小可运行代码

阴影是窗口质感的第一印象，QSS 方案画出来的阴影在边缘总是发硬。用 DWM 扩展来恢复真正的 AERO 阴影，代码不多，但顺序不能乱：

#include <dwmapi.h> #pragma comment(lib, "dwmapi.lib") void FramelessWindow::setupDwmShadow(HWND hwnd) { // MARGINS 全体设为 -1，表示把整个客户区都当作 frame 扩展区 MARGINS margins = {-1, -1, -1, -1}; DwmExtendFrameIntoClientArea(hwnd, &margins); // 强制 DWM 开启非客户区渲染策略，阴影才会生效 DWMNCRENDERINGPOLICY policy = DWMNCRP_ENABLED; DwmSetWindowAttribute(hwnd, DWMWA_NCRENDERING_POLICY, &policy, sizeof(policy)); }

这段代码要在窗口创建完成后尽早调用，最合适的位置是showEvent里拿HWND之后。DwmExtendFrameIntoClientArea的第一个参数是窗口句柄，可以通过(HWND)winId()拿到。第二个参数是 MARGINS 结构体，四个值分别代表左、右、上、下的扩展像素。传-1表示“扩展到整个窗口”，DWM 就把阴影画在窗口四周。

这里有个容易踩的细节：如果只调用DwmExtendFrameIntoClientArea，不开DWMWA_NCRENDERING_POLICY，在某些 Windows 版本上阴影还是出不来。保险起见两个都做。DWMNCRP_ENABLED明确要求 DWM 对窗口做非客户区渲染，阴影、动画、半透明都归 DWM 管。

但这只是阴影这一步。此时窗口还是无法拖拽、无法缩放，因为FramelessWindowHint已经把WS_THICKFRAME移除了。下面一步是把窗口样式修正回来。

3.3 恢复拖拽：WM_NCHITTEST 返回 HTCAPTION，把移动交给系统

无边框窗口恢复拖拽的正确姿势不是自己在 mouseMove 里算位移，而是告诉系统“这整块区域就是标题栏”。系统收到这个信息之后，按下、移动、释放整套流程都归它管，拖拽过程窗口跟随鼠标的节奏是原生的，不会出现拖快了窗口跟不上的问题。

bool FramelessWindow::nativeEvent(const QByteArray &eventType, void *message, qintptr *result) { #ifdef Q_OS_WIN MSG *msg = static_cast<MSG *>(message); if (msg->message == WM_NCHITTEST) { // lParam 携带的是鼠标的屏幕坐标（物理像素） const qreal dpr = devicePixelRatioF(); const QPoint pos(GET_X_LPARAM(msg->lParam) / dpr, GET_Y_LPARAM(msg->lParam) / dpr); const QRect winRect = this->geometry(); *result = hitTest(winRect, pos); return true; } #endif return QWidget::nativeEvent(eventType, message, result); }

GET_X_LPARAM和GET_Y_LPARAM是 Windows 提供的宏，用来拆解 lParam 里的坐标。重点在devicePixelRatioF()这步：WM_NCHITTEST 给的坐标是物理像素，而 Qt 的geometry()是逻辑像素，在 150% 缩放的屏幕上不除这个值，热区会整体偏左上。

然后看hitTest的实现，这是整篇最关键的函数，拖拽和缩放的命中判断都在这：

int FramelessWindow::hitTest(const QRect &rect, const QPoint &pos) const { // 边缘热区宽度，单位是逻辑像素 const int inset = 6; // 可拖拽标题栏高度，根据自绘标题栏高度调整 const int titleHeight = 36; const bool left = pos.x() < rect.left() + inset; const bool right = pos.x() > rect.right() - inset; const bool top = pos.y() < rect.top() + inset; const bool bottom = pos.y() > rect.bottom() - inset; // 四角优先，避免边缘和标题栏抢占命中 if (top && left) return HTTOPLEFT; if (top && right) return HTTOPRIGHT; if (bottom && left) return HTBOTTOMLEFT; if (bottom && right) return HTBOTTOMRIGHT; if (left) return HTLEFT; if (right) return HTRIGHT; if (top) return HTTOP; if (bottom) return HTBOTTOM; // 标题栏区域，系统负责拖动、双击最大化、右键菜单 if (pos.y() < rect.top() + titleHeight) { return HTCAPTION; } return HTCLIENT; }

这里的返回值语义是给系统看的，不是给 Qt 看的。返回HTCAPTION之后，Win32 会自动处理拖动、双击最大化、右键弹出系统菜单。返回HTLEFT/HTRIGHT等值后，鼠标光标会由系统切换成水平或垂直缩放光标，窗口尺寸改变也是系统完成，QWidget 的resizeEvent会照常触发，界面内容正常布局。

inset是边缘热区的半宽，我习惯用 6。值太小不好抓边缘，值太大会干扰边缘控件的操作。在触摸屏上可以适当放宽到 8。titleHeight必须和你自绘的标题栏实际高度一致，否则会出现“标题栏上半截能拖、下半截点了没反应”的割裂感。

3.4 恢复缩放：边缘与四角的完整热区表，以及 inset 参数怎么调

上一段代码已经在hitTest里把边缘缩放返回了，但这里值得单独展开，因为这个参数配不好，缩放就会出现各种“卡手”现象。下表是 WM_NCHITTEST 返回值与系统行为的对照，排查问题时对照着看：

有个细节值得注意：HTCAPTION区域的判定要在边缘判定之后。如果标题栏和边缘热区重叠，比如窗口高度小于 12 像素，或者标题栏高度被设成 10，那顶部区域就分不清该缩放还是该拖拽。我的做法是边缘判定优先，如下图所示，鼠标落在上边缘 6 像素内返回 HTTOP，超过 6 像素才返回 HTCAPTION。这样即使标题栏高度很小，用户仍然能抓住边缘缩放。

inset参数在不同场景下要微调。高分屏上，逻辑 6 像素对应的物理像素更多，已经足够好抓；在低分辨率屏或者窗口尺寸极小的工具窗里，用户手指比较粗，可以提高到 8。但不能盲目调大，否则窗口内容区的控件在靠近边缘时会先触发缩放而不是控件点击。判断热区被占用的特征是：边缘的按钮需要点两三次才能按到，那就是 inset 太大压了控件热区。

4. 图标、最大最小化与系统菜单：让这套无边框窗口行为对齐原生窗口

4.1 图标：Qt setWindowIcon 与 WM_SETICON 的分工

无边框窗口的图标要管两个地方：任务栏和 Alt+Tab 里的应用图标，以及窗口自绘标题栏上的图标。这两个地方来源不同。任务栏和 Alt+Tab 显示的是窗口图标，由窗口类图标或WM_SETICON消息决定；自绘标题栏上的图标是你自己画上去的，QSS 里引用资源即可。有些人只调 Qt 的setWindowIcon，发现标题栏有了，但任务栏在窗口最小化后变成空白，原因就是没有发 WM_SETICON。

我的做法是两套都设置：

void FramelessWindow::setupNativeIcon(HWND hwnd) { // Qt 侧负责资源加载和缩放，同时影响任务栏、Alt+Tab 图标 setWindowIcon(QIcon(QStringLiteral(":/icons/app_icon.png"))); // 从资源里取 HICON，发给系统，确保系统菜单和某些场景下的图标正确 HICON hIcon = static_cast<HICON>( LoadImageW(nullptr, L"path/to/app_icon.ico", IMAGE_ICON, 32, 32, LR_LOADFROMFILE)); if (hIcon) { SendMessageW(hwnd, WM_SETICON, ICON_BIG, (LPARAM)hIcon); SendMessageW(hwnd, WM_SETICON, ICON_SMALL, (LPARAM)hIcon); DestroyIcon(hIcon); } }

实际项目中图标文件一般随程序一起发布，用LoadImageW从文件加载更直接，不依赖 Qt 资源系统。ICON_BIG是 32x32，用于 Alt+Tab；ICON_SMALL是 16x16，用于标题栏和任务栏小图标模式。图标加载完记得DestroyIcon，否则每次切换都会泄漏一个 GDI 对象。如果图标需要适配多分辨率，可以加载 48x48 的版本发给ICON_BIG，Windows 会自动缩放。

任务栏图标还有个容易忽视的点：setWindowIcon要在show()之前设置。如果窗口已经显示出来再设置，部分 Windows 版本上任务栏图标不会刷新，需要window()->update()或者隐藏再显示才能生效。

4.2 最大最小化：HTCAPTION 双击 vs 自绘按钮调用 ShowWindow

无边框窗口的最大化和最小化有两条路线。第一条路线是我推荐的：通过在 WM_NCHITTEST 里返回HTCAPTION，让标题栏双击行为、系统菜单行为全部保留，最大化/还原动画也是系统原生的。但这要求自绘标题栏里不放按钮，或者按钮区域单独返回 HTCLIENT。如果标题栏右侧设计了最小化、最大化、关闭三个按钮，那就走第二条路线。

第二条路线是自绘按钮，自己处理点击动作。按钮点击之后调用 Windows API 是最可靠的：

// 最小化 ShowWindow(hwnd, SW_MINIMIZE); // 最大化 / 还原切换 if (IsZoomed(hwnd)) { ShowWindow(hwnd, SW_RESTORE); } else { ShowWindow(hwnd, SW_MAXIMIZE); }

IsZoomed返回窗口是否处于最大化状态。这里的hwnd用(HWND)winId()获取。有个常见错误是在按钮的 clicked 信号里调showMinimized()或showMaximized()，这两个函数在无边框窗口下行为不太稳定，尤其是在 DWM 扩展边框已经生效的窗口上，偶尔会出现最大化后阴影位置偏移。用 ShowWindow 直接操作原生窗口，绕开 Qt 的状态管理，行为更可控。

两条路线的取舍如下表：

如果你既要自绘按钮，又想保留双击标题栏最大化的系统行为，就把按钮所在区域在hitTest里返回HTCLIENT，按钮区域之外的标题栏区域返回HTCAPTION。这样按钮能收到正常的鼠标事件，标题栏空白处仍然可以双击最大化。按钮区域的判断要放在HTCAPTION判断之前，否则按钮区域先被返回成 HTCAPTION，点击就被系统吃掉了。

4.3 系统菜单与 Alt+Tab：免费得到的原生行为，以及一个热区提醒

当标题栏区域返回HTCAPTION后，你免费获得了两个系统行为：右键弹出系统菜单、Alt+Tab 切换窗口时的图标和标题正确显示。这些细节在纯 Qt 方案里最难补全。系统菜单包含还原、移动、大小、最小化、最大化、关闭，用户对这些菜单的位置和功能已经形成肌肉记忆，自己画一个出来反而显得不专业。

热区提醒是这套方案最容易忽略的部分：HTCAPTION区域内的任何 Qt 控件，鼠标点击都会被系统优先处理，QWidget 收不到mousePressEvent。如果你在自绘标题栏里放了菜单按钮、搜索框或者用户头像，必须在hitTest里为这些控件所在区域返回HTCLIENT。正确顺序是：先判断按钮区域，再判断边缘缩放，最后判断标题栏。如果按钮区域和边缘热区重叠，按钮区域优先。

这里的常见问题在下一章展开，属于我见过最多人栽跟头的地方。

5. 无边框窗口避坑清单：DWM 失效、Qt 版本混用与 HiDPI 坐标错乱

5.1 现象一：加了 DWM 阴影却消失——WA_TranslucentBackground 的锅

现象：按照上面的代码调好了 DWM，阴影出不来，窗口边缘是一块突兀的深色背景。原因：很多人做无边框窗口时会顺手加setAttribute(Qt::WA_TranslucentBackground)做圆角或阴影，但 DWM 的 frame 扩展和完全透明背景是冲突的。WA_TranslucentBackground会把窗口的合成方式切到红绿蓝加透明度通道，DWM 认为窗口内容是自绘半透明层，就不再为你渲染标准 AERO 阴影。解决：去掉WA_TranslucentBackground，窗口背景用不透明的 QSS 颜色填充。如果项目必须做圆角，用DwmSetWindowAttribute的DWMWA_WINDOW_CORNER_PREFERENCE让系统画圆角，不要走透明背景路线。

5.2 现象二：最大化后阴影残留和边缘越位——WM_GETMINMAXINFO 没写

现象：窗口最大化之后，四边露出一圈白边或者阴影残影，窗口内容被截掉一小块。原因：系统在最大化之前会查询WM_GETMINMAXINFO，得到窗口允许的最大尺寸和位置。无边框窗口没有触发这个逻辑的自觉，系统按默认工作区大小算，而 DWM 扩展的 frame 区域把窗口实际边界推出了屏幕可显示范围。解决：在 nativeEvent 里处理WM_GETMINMAXINFO，把最大尺寸限制在工作区范围内：

if (msg->message == WM_GETMINMAXINFO) { MINMAXINFO *mmi = reinterpret_cast<MINMAXINFO *>(msg->lParam); // 获取主屏工作区，不含任务栏 RECT workArea; SystemParametersInfoW(SPI_GETWORKAREA, 0, &workArea, 0); mmi->ptMaxSize.x = workArea.right - workArea.left; mmi->ptMaxSize.y = workArea.bottom - workArea.top; mmi->ptMaxPosition.x = workArea.left; mmi->ptMaxPosition.y = workArea.top; *result = 0; return true; }

这段处理的是主屏场景。多屏环境需要根据窗口当前所在屏幕的工作区计算，用MonitorFromWindow拿句柄，再配合GetMonitorInfoW获取对应显示器的工作区。忽略这个处理，最大化后阴影和白边问题几乎必现。

5.3 现象三：HiDPI 下鼠标缩放错位——坐标没除以 devicePixelRatio

现象：150% 缩放的屏幕上，窗口边缘的缩放热区整体偏移，鼠标要挪到离窗口边缘十几像素远才能触发缩放光标，或者反过来，鼠标已经超出窗口了热区还没触发。原因：WM_NCHITTEST的 lParam 是物理像素坐标，你的geometry()返回逻辑像素，两者直接比较必然错位，缩放热区被等比放大或缩小。解决：在nativeEvent开头做除法，把物理坐标转换成逻辑坐标，然后再做geometry()比较。另外确认 DPI 感知已开启，否则devicePixelRatioF()返回的可能是游戏厅模式的 1.0，除不除都错。这个坑在混合 DPI 的笔记本外接显示器场景里非常隐蔽，排查优先级最高。

5.4 现象四：程序一启动就崩溃——cannot mix incompatible qt library

现象：程序编译链接都没问题，运行直接在 Qt 初始化阶段崩掉，输出cannot mix incompatible qt library (version 0x5060101) with this library，有时候连这个错误都不弹，直接 abort。原因：程序运行时加载了多个 Qt 版本，最常见的是 PATH 环境变量里配置了一个旧版本的 Qt bin 目录，或者系统目录下有残留的 Qt5Core.dll、Qt6Core.dll，程序加载时优先命中了版本不一致的库。在无边框窗口项目里这个坑尤其容易踩，因为要交叉验证 DWM 行为时经常在多个 Qt 版本间切换测试。解决：用 windeployqt 把与编译器匹配的 Qt DLL 部署到程序目录，程序目录在 Windows 的 DLL 搜索顺序里优先于 PATH；确认 PATH 里没有多余的 Qt bin；代码里不要混用不同版本的 Qt 模块，比如 Qt 5.15 的库配 Qt 6 的插件目录。另外别把不同版本的 Qt 装在同一目录。

5.5 现象五：标题栏按钮点不动——HTCAPTION 吃掉了子控件点击

现象：自绘标题栏上的最小化按钮、设置按钮点击没反应，偶尔双击会触发最大化。原因：hitTest里返回HTCAPTION的区域，会被系统当作标题栏处理，鼠标事件不再分发到 Qt 控件。解决：在 hitTest 里把按钮区域显式返回HTCLIENT，但要注意顺序。按钮区域优先判断，其次是边缘热区，最后才是 HTCAPTION。按钮区域返回 HTCLIENT 之后，Qt 的mousePressEvent才能正常收到事件，按钮点击恢复。如果按钮位于窗口右上角，比如关闭按钮，还要同时避开上边缘热区，否则鼠标在按钮附近时先被 HTTOP 截获，缩放光标会遮挡按钮点击。

6. 最后验证与质感提升：三分钟确认阴影和热区，再用 DWM 圆角收尾

6.1 三分钟验证法：阴影渐变、边缘热区与双击动画

验证这套方案有没有真正生效，不需要写测试代码，三分钟就够了。

第一分钟，看阴影。把窗口拖到浅色纯色背景上，留意窗口四边有没有一层平滑的渐变阴影。原生 AERO 阴影是 8 到 16 像素的渐变，不是一条硬边。如果阴影边界清晰锐利，说明 DWM 扩展没生效，回查DwmExtendFrameIntoClientArea的 MARGINS 参数和DWMNCRP_ENABLED是否都设置了。

第二分钟，测热区。鼠标慢慢从屏幕外往窗口边缘移动，观察光标有没有变成双向箭头。然后按住边缘拖动，窗口尺寸变化是否跟手。重点测四角，对角线缩放在原生窗口里是非常顺滑的，如果出现跳动或者缩放方向不对称，查hitTest里的坐标除法和四角分支。最后按住标题栏拖动，窗口移动过程应该和系统窗口完全一致，不会有任何延迟感。

第三分钟，测双击和最大化。双击标题栏空白处，窗口应该切到最大化并播放系统动画，再双击应该还原。最大化之后四边不能有白边，窗口内容要完整贴合工作区。最后按一下 Win+方向键，测试贴靠布局是否正常，这在无边框窗口方案里是最大的隐形验收项。上面任何一步不通过，回查对应章节的代码和参数。

6.2 进阶技巧：用 DWM 圆角让无边框窗口更贴合现代 Windows，以及一套建议的参数

最后这步是锦上添花，但用户感知很强。Windows 11 开始，原生窗口自带圆角，而无边框窗口默认没有圆角，四角是直角，放在 Win11 桌面上显得很突兀。用 DWM 属性可以强制系统绘制圆角：

#include <dwmapi.h> DWORD cornerPreference = DWMWCP_ROUND; DwmSetWindowAttribute(hwnd, DWMWA_WINDOW_CORNER_PREFERENCE, &cornerPreference, sizeof(cornerPreference));

DWMWA_WINDOW_CORNER_PREFERENCE只在 Windows 11 上生效，Windows 10 调用会返回失败，不影响运行。值与 DWM 扩展配合时，注意窗口背景不要设置圆角 QSS，圆弧和阴影都交给系统画，QSS 背景保持矩形，否则圆角区域会露出底色。

这套方案落地之后，我习惯用一组固定的参数模板：边缘热区 inset 取 6，标题栏高度取 36，阴影 MARGINS 取 -1，DPI 感知用 PerMonitorV2，最大化用WM_GETMINMAXINFO限制工作区，标题栏按钮区域返回 HTCLIENT。这套参数跑通了 4K 和 1080P 混合环境，也跑通了 96 DPI 到 200% 缩放的切换。之前我也在 QSS 方案里折腾过窗口阴影和拖拽，最后发现把系统自带的能力找回来，比重新造一套稳定得多。希望帮到你。

本文还有配套的精品资源，点击获取