简介：一份Qt界面开发学习资源，演示如何利用QStackLayout实现窗口部件重叠，并深度整合事件穿透、位置拖动与无边框窗口（Qt::FramelessWindowHint）下的尺寸拖拽。项目面向具备基础Qt知识、想实现非规则或分层界面的开发者，通过完整代码可理解布局层级、事件过滤器、鼠标事件处理以及边缘缩放组件的实现思路。压缩包仅7KB，包含14个文件：5个C++头文件、4个源文件、3个Qt Designer界面文件、1个资源文件和1张png图片，整体小巧完整，适合直接运行与二次开发。资源中widgeta与widgetb展示了重叠窗口与事件互操作，自定义ResizeGrip类提供了无边框窗口的边缘抓取缩放，stacklayout相关文件则示范了布局类的扩展方式，同时drag.png等资源用于辅助识别可拖拽区域。已有1555人学习下载，对希望研究Qt高级窗口交互的开发者具有实际参考价值，能帮助读者高效掌握这类界面的编码技巧。 做桌面端自定义悬浮窗、桌面小组件、游戏启动器这类需求时，QStackLayout 配合 Qt::FramelessWindowHint 方案几乎是绕不开的。标题里这几个关键词凑在一起：窗口重叠、事件穿透、拖拽、无边框，其实就是一套非常典型的“自定义浮动层”技术组合。这篇文章我直接基于实际项目经验，把 QStackLayout 实现窗口重叠的完整思路、无边框窗口拖拽的两种主流写法、事件穿透的三种层级方案，以及它们组合在一起时的坑和取舍，一次性讲透。适合已经会用 Qt 基础控件、但想自己封装悬浮窗或桌面工具层的开发者参考。
1. 整体设计思路：为什么用 QStackLayout 来做窗口重叠
1.1 先厘清“窗口重叠”的正确打开方式
很多人一上来就把多个 QWidget 塞进同一个父窗口，然后手动调整 geometry 实现重叠。这种做法不是不行，但一旦涉及窗口切换、层级管理、透明区域点击穿透，代码很快就会失控。QStackLayout（实际常用的是 QStackedLayout）在这类需求里的角色是“页面管理器”，它保证同一时刻只有一个子控件是可见的，切换时自动处理显示和隐藏。这个特性放在悬浮窗场景里非常合适：你需要的是一个透明无边框的顶层容器，内部用 QStackedLayout 管理多个浮层页面——比如主面板、设置页、消息通知页，它们视觉上是“重叠”的，但实际上是通过索引切换展示，而不是靠手动挪位置。
这样做的好处有三个：第一，子页面的生命周期统一由布局管理，不用自己维护 visibility；第二，页面之间的切换动画、淡入淡出可以在布局层级统一处理；第三，事件穿透和拖拽逻辑只需要在整个容器的顶层做一次边界处理，不需要每个子页面各写一遍。
1.2 整套方案解决了什么核心问题
标题里涉及的所有能力，本质上都在解决同一个问题：让一个“没有系统边框的窗口”看起来像一个“自由浮动的桌面元素”。Qt::FramelessWindowHint 去掉标题栏和边框后，窗口失去了系统自带的拖动、缩放、关闭逻辑，而这些恰恰是桌面悬浮窗必须有的交互。事件穿透则是另一个方向：浮层有时候需要“让路”，比如悬浮窗盖住的区域，用户点击时应该直接点到下面的桌面图标或主程序，而不是被悬浮窗挡住。这套组合能做的场景非常多：桌面宠物、录屏工具的控制条、直播软件的悬浮礼物面板、IDE 的迷你地图浮窗，本质都是同一套底层。
2. 无边框窗口的拖拽实现：两种方案对比与选型
2.1 无边框窗口为什么“拖不动”
系统窗口能拖动，靠的是标题栏。一旦设置了 Qt::FramelessWindowHint，标题栏就不存在了，Windows 不知道应该把鼠标按下事件解释为“移动窗口”，所以整个窗口变成一块“死板”。要恢复拖动，本质上有两条路：要么“欺骗”系统，让系统以为鼠标按在了标题栏上；要么自己处理鼠标事件，手动修改窗口坐标。这两条路对应下面两种实现，我实测下来各有使用场景。
2.2 方案一：nativeEvent 拦截 WM_NCHITTEST（Windows 专用，代码最省）
这个方案的思路是：在窗口的 nativeEvent 里拦截 WM_NCHITTEST 消息，当鼠标命中的位置属于窗口客户区时，故意返回 HTCAPTION，让系统认为你点的是标题栏。这样系统会自动帮你完成拖动，连 move() 都不用写。
bool FramelessWidget::nativeEvent(const QByteArray &eventType, void *message, qintptr *result) { #ifdef Q_OS_WIN MSG *msg = static_cast<MSG*>(message); if (msg->message == WM_NCHITTEST) { *result = HTCAPTION; return true; } #endif return QWidget::nativeEvent(eventType, message, result); }这段代码实测下来有几个细节必须注意：Return true 会让整个窗口所有区域都能拖动，包括按钮区域——如果窗口里有可点击控件，需要先判断鼠标位置是否落在控件上，再做 HTCAPTION 处理。另外，这个方法只在 Windows 上生效，Linux/macOS 需要另想办法。优点是系统级拖动非常流畅，不会出现鼠标和窗口“脱节”的情况；缺点是灵活性差，如果你想在同一窗口内区分“拖动手柄区域”和“普通区域”，就得在 WM_NCHITTEST 里手动计算。
2.3 方案二：mousePressEvent + mouseMoveEvent 手动搬移（跨平台通用）
如果项目需要跨平台，或者想精细控制拖拽触发区域，那我推荐自己处理鼠标事件。核心逻辑很简单：按下时记录鼠标在窗口内的偏移量，移动时根据全局鼠标位置和偏移量重新设置窗口位置。
void FloatPanel::mousePressEvent(QMouseEvent *event) { if (event->button() == Qt::LeftButton && event->pos().y() < dragHandleHeight) { m_dragging = true; m_dragOffset = event->globalPosition().toPoint() - frameGeometry().topLeft(); event->accept(); } } void FloatPanel::mouseMoveEvent(QMouseEvent *event) { if (m_dragging && (event->buttons() & Qt::LeftButton)) { move(event->globalPosition().toPoint() - m_dragOffset); event->accept(); } } void FloatPanel::mouseReleaseEvent(QMouseEvent *event) { m_dragging = false; }这里有一个关键细节：一定要用 globalPosition()（Qt6）或 globalPos()（Qt5）减去 frameGeometry().topLeft()，而不是直接减去窗口坐标。因为窗口可以不在原点，window() 返回的 pos() 是相对父窗口的，在顶层窗口里虽然通常等价，但用 frameGeometry 更严谨。另一个坑是：如果窗口是半透明的，鼠标按在透明区域时，Qt 默认还是会派发事件，但如果你在 paintEvent 里对透明区域返回了 ignore，可能会导致事件穿透，这个要结合下一节的事件穿透一起处理。
2.4 两种方案的取舍对比
| 对比维度 | nativeEvent + HTCAPTION | 鼠标事件手动搬移 |
|---|---|---|
| 平台兼容性 | 仅 Windows | 全平台 |
| 拖动流畅度 | 极好（系统级） | 好，但受事件频率影响 |
| 指定区域拖拽 | 需要自己判断命中矩形 | 天然支持，用 if 判断即可 |
| 代码复杂度 | 低 | 中等 |
| 适合场景 | 纯 Windows 桌面工具 | 跨平台应用、需要精细控制的场景 |
我个人的习惯是：如果是内部工具、明确只跑 Windows，优先选方案一，省事且流畅；如果是一个要发布到多平台的商业应用，老老实实用方案二。
3. 事件穿透：从轻量到彻底的三种实现
3.1 Qt::WA_TransparentForMouseEvents：最轻量的穿透
如果你的需求只是“让这个窗口整体不拦截鼠标”，那 Qt 内置属性就够了：
setAttribute(Qt::WA_TransparentForMouseEvents);这个属性设置后，当前窗口的所有鼠标事件都会透传到它下面的窗口。实现原理是 Qt 在事件派发阶段直接跳过当前 widget，把它当作不存在。注意：它只对鼠标事件生效，键盘事件、焦点事件不受影响。配合 QStackLayout 使用时有个场景很实用——当浮层只需要展示信息（比如悬浮歌词、录屏倒计时），不需要任何交互时，直接开这个属性，下面桌面的一切操作都不受影响。
3.2 SetWindowLong + WS_EX_TRANSPARENT：Windows 下的窗口级穿透
如果窗口是真正的顶层窗口，而且需要更彻底地穿透——不仅 Qt 事件不拦截，连系统消息都不让它成为鼠标的“阻挡层”——那要在 Windows API 层面设置扩展样式：
#ifdef Q_OS_WIN #include <windows.h> HWND hwnd = (HWND)this->winId(); LONG_PTR style = GetWindowLongPtr(hwnd, GWL_EXSTYLE); SetWindowLongPtr(hwnd, GWL_EXSTYLE, style | WS_EX_TRANSPARENT | WS_EX_LAYERED); #endifWS_EX_TRANSPARENT 的效果是：当前窗口对鼠标“透明”，鼠标消息会直接穿透到下层窗口。WS_EX_LAYERED 是分层窗口，配合后面的透明度、圆角、阴影效果都要用到。注意顺序：如果只设置 WS_EX_TRANSPARENT 不设置 WS_EX_LAYERED，某些 Windows 版本上透明效果会失效，我踩过一次这个坑，表现为窗口偶尔变成不透明背景色块。
3.3 钩子级别穿透：全局鼠标钩子过滤
需要全局穿透的场景（比如悬浮窗在另一个进程窗口之上，而且不想让鼠标经过悬浮窗时产生任何事件）可以通过安装低层鼠标钩子实现。这个方案比较重，一般用不到。我在实际项目中只在做全局截图遮罩时用过一次：截图层覆盖整个屏幕，同时要让鼠标可以正常点击下面的应用，用 WM_NCHITTEST 返回 HTTRANSPARENT 或者设置 WS_EX_TRANSPARENT 都能搞定，不一定非要上钩子。
3.4 事件穿透与拖拽冲突的解决方案
这是整篇内容里最容易翻车的地方：你要让窗口可拖拽，就必须接收鼠标事件；你要让某块区域穿透，就必须不接收鼠标事件。这俩是互斥的，不能同时作用在同一块区域。
我目前最稳妥的做法是区域划分：
void FloatPanel::mousePressEvent(QMouseEvent *event) { QRect handleRect(0, 0, width(), dragHandleHeight); if (event->button() == Qt::LeftButton && handleRect.contains(event->pos())) { m_dragging = true; m_dragOffset = event->globalPosition().toPoint() - frameGeometry().topLeft(); return; } // 非拖拽区域的点击事件需要手动透传 QMouseEvent *proxyEvent = new QMouseEvent(*event); QCoreApplication::postEvent(parentWidget(), proxyEvent); event->accept(); }这种做法是：只有顶部指定高度的“拖拽手柄区”响应拖拽；其他区域把事件转发给父窗口或直接忽略，实现局部穿透。设置 WA_TransparentForMouseEvents 会导致整个窗口鼠标事件全部失效，包括拖拽区，所以不能全局设，只能在 paintEvent 里根据控件几何区域做命中测试。
4. 完整实现：QStackLayout 容器 + 拖拽 + 事件穿透整合
4.1 透明容器窗口的搭建
下面要搭一个完整的 Demo：一个无边框透明顶层窗口，内部用 QStackedLayout 管理两个页面，页面 A 是可拖拽的主面板，页面 B 是设置面板，两块面板都支持边缘拖拽，顶部手柄拖动，非手柄区域穿透点击。整个容器窗口本身设置为透明背景和 FramelessWindowHint。
class StackOverlapWindow : public QWidget { Q_OBJECT public: StackOverlapWindow() { setWindowFlags(Qt::FramelessWindowHint | Qt::WindowStaysOnTopHint); setAttribute(Qt::WA_TranslucentBackground); QStackedLayout *stackLayout = new QStackedLayout(this); stackLayout->setContentsMargins(0, 0, 0, 0); m_mainPanel = new FloatPanel(); m_settingsPanel = new FloatPanel(); stackLayout->addWidget(m_mainPanel); stackLayout->addWidget(m_settingsPanel); connect(m_mainPanel, &FloatPanel::openSettings, this, [this]() { // 切换到设置页 QStackedLayout *layout = qobject_cast<QStackedLayout*>(this->layout()); layout->setCurrentWidget(m_settingsPanel); }); connect(m_settingsPanel, &FloatPanel::backToMain, this, [this]() { QStackedLayout *layout = qobject_cast<QStackedLayout*>(this->layout()); layout->setCurrentWidget(m_mainPanel); }); } private: FloatPanel *m_mainPanel; FloatPanel *m_settingsPanel; };这里解释几个关键参数：Qt::FramelessWindowHint去掉系统边框，这是所有自定义浮层的基础；Qt::WindowStaysOnTopHint让浮层保持在桌面最上层，做悬浮工具几乎都会用到；WA_TranslucentBackground允许背景完全透明，这样 QStackedLayout 里的页面自身绘制圆角、阴影、异形轮廓时才不会被默认的灰色底兜住。注意：只有顶层窗口才设置这些 flag，里面的子面板不要再重复设置，否则会出现子窗口脱离布局的怪癖。
4.2 FloatPanel：单页面的拖拽与穿透封装
每个子页面都继承自 FloatPanel，这个类内部同时封装了拖拽和局部穿透逻辑。
class FloatPanel : public QWidget { Q_OBJECT public: explicit FloatPanel(QWidget *parent = nullptr) : QWidget(parent) {} signals: void openSettings(); void backToMain(); protected: void mousePressEvent(QMouseEvent *event) override { if (event->button() == Qt::LeftButton && event->pos().y() < 40) { m_dragging = true; m_dragOffset = event->globalPosition().toPoint() - frameGeometry().topLeft(); event->accept(); return; } // 非手柄区域：可以根据需求决定是否穿透 if (isClickThroughZone(event->pos())) { setAttribute(Qt::WA_TransparentForMouseEvents, true); // 临时关闭鼠标接收，让点击穿过本窗口到下层 QTimer::singleShot(100, this, [this]() { setAttribute(Qt::WA_TransparentForMouseEvents, false); }); event->accept(); return; } event->ignore(); } void mouseMoveEvent(QMouseEvent *event) override { if (m_dragging && (event->buttons() & Qt::LeftButton)) { move(event->globalPosition().toPoint() - m_dragOffset); event->accept(); } } void mouseReleaseEvent(QMouseEvent *event) override { m_dragging = false; event->accept(); } private: bool isClickThroughZone(const QPoint &pos) const { // 这里定义哪些区域需要穿透，比如右下角的展示区域 QRect zone(0, 40, width(), height() - 40); return zone.contains(pos); } bool m_dragging = false; QPoint m_dragOffset; };这段代码里有一个非常实用的技巧：你想让某块区域点击时透传到下层窗口，可以直接在按下时临时设置 WA_TransparentForMouseEvents，然后用单次定时器在 100ms 后恢复。为什么这么绕？因为如果一直开启透明鼠标事件，这个区域就连拖拽手柄也收不到事件了；临时开启再关闭，相当于只在“点击的那一瞬间”把事件让出去，让下层窗口处理一次，随后恢复本窗口的交互能力。这个技巧实测下来比手动转发 QMouseEvent 可靠，尤其当目标下层是另一个进程的窗口时，postEvent 只能处理同进程，而 WA_TransparentForMouseEvents 配合 winId 能实现真正的跨进程透传。
但要注意：这种临时穿透的方式在点击瞬间，本窗口的 hover 状态、tooltip 都会被触发一次，如果介意这些小瑕疵，可以改用前面讲的 WS_EX_TRANSPARENT 动态切换方案。
4.3 无边框窗口的边缘缩放
标题里提到的“大小下的拖拽功能”，除了移动之外，边缘缩放也是无边框窗口常要配套实现的。系统边框没了以后，右下角、边缘的光标变化和 resize 都要自己来。核心思路：mouseMoveEvent 里根据鼠标位置计算是否在边缘 8px 范围内，是就切换光标形状；mousePressEvent 里记录缩放方向和原始 geometry；mouseMoveEvent 里根据方向调整宽高。
void ResizablePanel::mouseMoveEvent(QMouseEvent *event) { if (m_resizing) { QRect newGeo = m_startGeo; if (m_dir & ResizeRight) newGeo.setWidth(event->globalPosition().toPoint().x() - newGeo.left()); if (m_dir & ResizeBottom) newGeo.setHeight(event->globalPosition().toPoint().y() - newGeo.top()); setGeometry(newGeo); event->accept(); return; } // 切换光标 const int edge = 8; QPoint pos = event->pos(); bool right = pos.x() >= width() - edge; bool bottom = pos.y() >= height() - edge; if (right && bottom) setCursor(Qt::SizeFDiagCursor); else if (right) setCursor(Qt::SizeHorCursor); else if (bottom) setCursor(Qt::SizeVerCursor); else unsetCursor(); QWidget::mouseMoveEvent(event); }缩放和移动的冲突也要处理：如果整个窗口都能拖动，那边缘缩放区域要优先判定——先判断是否命中边缘缩放区，命中就进入缩放模式而不是移动模式。我建议把缩放区宽度控制在 6~10px，太小了鼠标很难命中，太大了容易误触。
5. 常见问题与排查技巧实录
5.1 高频问题速查表
| 现象 | 可能原因 | 解决方案 |
|---|---|---|
| 设置了 FramelessWindowHint 后窗口拖不动 | 没有实现任何拖拽逻辑 | 按第 2 节方案实现 nativeEvent 或鼠标事件搬移 |
| 点击按钮没反应但窗口能拖动 | nativeEvent 里所有区域都返回了 HTCAPTION | 命中测试时排除子控件区域，或改用鼠标事件手动搬移 |
| 开启 WA_TransparentForMouseEvents 后连拖拽也不行了 | 事件穿透把拖拽区的事件也透传了 | 不要全局开启该属性，改为局部命中判定+临时穿透 |
| 窗口背景变成黑色不透明色块 | WA_TranslucentBackground 未设置，或缺少 WS_EX_LAYERED 扩展样式 | 顶层窗口设置透明属性；Windows 下同时设置 WS_EX_LAYERED |
| 拖拽时鼠标和窗口“脱节” | m_dragOffset 计算错误，用了 pos() 而不是 globalPosition | 统一用事件全局坐标减去 frameGeometry().topLeft() |
| 边缘缩放时窗口大小跳动 | 按下的初始 geometry 没有备份，或缩放方向判断不完整 | 在 mousePressEvent 里记录 m_startGeo 和 m_dir |
| 点击穿透到下层窗口后，悬浮窗失去焦点 | 这是穿透的副作用，无边框窗口本身没有激活策略 | 手动调用 activateWindow() 或设置 WindowStaysOnTopHint 恢复层级 |
5.2 独家避坑经验
第一，QStackedLayout 切换页面时，页面的 geometry 可能会因为外层容器大小变化而重建，如果你在子页面里手动设置了固定大小，记得在 resizeEvent 里重新调整布局间距。否则会出现切回主页面时控件间距被拉伸的问题。
第二，事件穿透和拖拽不能同时依赖同一个 winId 上的同一个属性。我在做录屏悬浮窗时，曾把整个窗口设置为 WS_EX_TRANSPARENT，然后用全局钩子判断是否在拖拽手柄上、动态清除该属性。逻辑上通，但实际触发时鼠标点击已经丢失了，钩子也没法恢复，最后迫不得已改成了顶层容器 + 子区域分离的方式——顶层容器负责穿透，内部实际可交互面板是一个独立子窗口往上偏移一层。这个架构适应性强很多，但代码复杂度也上来了。
第三，无边框窗口的阴影。去掉边框后，Win10 自带的一圈阴影也会消失，整个窗口看起来非常“平”。常见的补救方案是：给窗口添加一个 margin，用 QGraphicsDropShadowEffect 给最外层的 QWidget 加阴影效果，但注意阴影区域的鼠标事件需要额外处理，否则鼠标点在阴影上会觉得“点不到东西”。我目前的处理是在 paintEvent 里自绘阴影区域，并把阴影矩形从鼠标命中区域排除。
5.3 性能与稳定性的几个小提示
QStackedLayout 里不要放太重的内容。因为它是“切换一次显示一个”，页面虽然不可见，但控件仍然存在，如果每个页面都加载了大量图片、视频流，内存占用会累积。建议在 addWidget 之前先延迟创建页面，或者用 QStackedLayout 的 removeWidget 在页面隐藏时释放资源。
事件穿透的临时开关不要频繁调用，尤其是通过 SetWindowLong 切换 WS_EX_TRANSPARENT 时，频繁设置窗口样式会导致窗口闪烁。实测下来，单次切换间隔低于 50ms 就会出现肉眼可见的抖动。如果确实需要高频穿透切换，优先用 Qt 属性方式而不是 Win32 API。
6. 实测后的个人体会
这套组合我前后在三个项目里用到过：一个录屏工具的控制条、一个桌面上浮动的歌词面板、还有一个内部使用的快速启动器。整体来说，QStackLayout 负责页面组织非常稳，关键是别把它当成真正的“多窗口叠加”来用——它内部永远是单页表现，视觉重叠靠的是透明背景和页面切换实现。拖拽这块，Windows 下我八成场景用 nativeEvent + HTCAPTION，省心；一旦要适配 macOS，就得老老实实切到手动 mouseMoveEvent。
最后再分享一个小技巧：如果窗口需要同时支持“拖拽移动”“边缘缩放”“局部穿透”三种状态，最稳妥的状态管理方式是定义一个枚举，在 mousePressEvent 里根据鼠标位置一次性判定进入哪个状态，然后在 mouseMoveEvent 里用 switch 分发。不要在一个方法里叠加多个 if 判断，后期维护真的会晕。这一套改完，整个悬浮窗的代码结构会清晰很多，后面往里面加功能也顺手。
本文还有配套的精品资源，点击获取
