★ FEATURED ARTICLE 用 Qt Creator 写小工具的人几乎都会遇到这样一个需求主窗口上点一个按钮弹出第二个窗口而且这个窗口得是真正独立的能拖到屏幕另一边、能单独最小化、能同时对着两个窗口操作。听起来简单但你照着脑子里“新建一个类、new 出来、show 一下”的思路写完跑起来八成会发现不对劲第二个窗口要么牢牢被框在主窗口里出不来要么跟着主窗口一起最小化要么主窗口一关程序直接闪退。这篇就把 Qt Creator 里做两个独立窗口这件事从头拆一遍包括窗口标志Window Flags背后的机制、父子关系到底影响了什么、生命周期的三种写法各自会带来什么后果、窗口之间怎么传数据以及我自己踩过的那几个特别隐蔽的坑。适合刚上手 Qt Widgets 不久、或者已经写过窗口但被“独立”两个字卡住的同学代码按 Qt 5.12 以上到 Qt 6 通用Qt Creator 里新建 Widgets Application 就能直接跑。1. 第二个窗口为什么总被“吸”进主窗口1.1 父子关系管的是销毁窗口标志管的是形态很多人第一反应是“我不给它传 parent 不就独立了吗”这个直觉方向对但只对了一半。在 Qt 里QWidget的构造函数接受一个QWidget *parent这个参数同时承担了两层含义而它们其实是解耦的一层是对象树归属QObject的父子关系决定析构顺序——父对象被销毁时子对象会被一并delete另一层是界面归属决定这个 widget 是作为一个控件画在父窗口的客户区里还是作为一个独立的顶层窗口出现在桌面窗口管理器面前。默认情况下这两层是绑在一起的你new SecondWindow(this)它既成了this的子对象也会被当成this的一个普通子控件贴在主窗口里面位置还受布局管理器摆布。这就是“吸进去”现象的来源。想拆开这两层靠的是Qt::Window这个窗口标志——setWindowFlags(Qt::Window)之后界面归属变成顶层窗口但对象树归属还是原来的父对象。所以它既能单独显示又会在主窗口析构时被顺手带走。这里有个概念要先立住“独立窗口”在 Qt 的语境里有两种不同强度的含义。一种是“视觉上独立”——能自由拖动、能单独最小化、有自己的标题栏但背后还挂在主窗口的对象树上另一种是“彻底独立”——没有父对象生命周期自己管主窗口死了它还能活着。绝大多数“两个独立窗口”的需求其实是前者但如果你希望关掉主窗口后子窗口还在那就必须是后者。选哪种取决于你的业务语义不是随便挑一个就行。1.2 Qt::Window 和 Qt::SubWindow 的分水岭窗口标志里有一组类型位Qt::Widget、Qt::Window、Qt::Dialog、Qt::Sheet、Qt::Drawer、Qt::Popup、Qt::Tool、Qt::ToolTip、Qt::SplashScreen它们互斥只能存在一个。不同类型的实际表现差异挺大我整理了一张对照表这张表比翻文档快标志类型有无边框任务栏图标跟随父窗口最小化典型用途Qt::Widget默认无父有有不适用无父时等价于 WindowQt::Window有有有父时跟随普通独立窗口Qt::Dialog有视平台而定有父时跟随对话框、设置面板Qt::Tool有较窄通常无跟随浮动工具面板、调色板Qt::Popup无无不适用下拉菜单、气泡提示Qt::Tool这个类型值得单独说一句它在多数桌面平台上不出现在任务栏里AltTab 也切不到而且总是浮在父窗口之上。如果你的第二个窗口是一个“辅助面板”性质的比如主窗口旁边挂的一个实时预览窗用Qt::Tool比Qt::Window更符合用户预期。但如果你希望用户能像切换普通程序一样在两个窗口间来回切那就老老实实用Qt::Window。还有一个容易忽略的点QMainWindow和QDialog的构造函数里其实已经把类型位设好了QDialog默认就是Qt::Dialog。你在QDialog派生类上调setWindowFlags(Qt::Window)会把Qt::Dialog类型位替换掉同时也会连带清掉一些默认属性。所以改标志的时候规范写法是先把当前的标志取出来按位与掉类型位再或上新的类型位Qt::WindowFlags flags w-windowFlags(); flags ~Qt::WindowType_Mask; // 清掉类型位 flags | Qt::Window; // 设成普通顶层窗口 w-setWindowFlags(flags);直接setWindowFlags(Qt::Window)会把之前设置的Qt::WindowStaysOnTopHint、Qt::FramelessWindowHint之类的全部冲掉这个问题我在一个带自定义标题栏的窗口上卡了快一个小时才反应过来。1.3 在 Qt Creator 里新建第二个窗口的两种路径Qt Creator 提供了现成的模板右键项目 → Add New → Qt →Qt Designer Form Class然后选Widget、Dialog或者Main Window。这个动作会一次性生成三样东西头文件、源文件、.ui文件源文件里还帮你把Ui::XxxClass的成员和setupUi调用都写好了。这是最省事的路径也是我一般推荐的。选Widget还是Dialog关键看你的第二个窗口是不是“必须先处理完才能回到主窗口”。需要阻塞式交互比如填写一个必填表单点确定或取消才继续就用Dialog需要主窗口和子窗口同时可见、同时可操作比如主窗口是控制台子窗口是实时日志就必须用Widget派生因为Dialog的exec()会开一个局部事件循环把调用点堵住。另一条路径是完全手写代码不建.ui。好处是代码一目了然、不需要维护 ui 文件坏处是布局全得自己敲。我个人的习惯是窗口里有超过五个控件就用设计器纯展示或者逻辑驱动的窗口就手写。两条路径在运行时的行为完全一致选哪个纯粹是维护成本问题。2. 把两个窗口真正跑起来的骨架2.1 主窗口侧的三种打开方式差别比想象中大我先给出最常用、也最不容易出问题的一种写法然后解释为什么这么写。// mainwindow.h #include QPointer class SecondWindow; class MainWindow : public QMainWindow { Q_OBJECT public: explicit MainWindow(QWidget *parent nullptr); ~MainWindow(); private slots: void openSecondWindow(); void onValueReady(const QString text); private: Ui::MainWindow *ui; QPointerSecondWindow m_second; // 用 QPointer 而不是裸指针 };// mainwindow.cpp void MainWindow::openSecondWindow() { if (!m_second) { m_second new SecondWindow(nullptr); // 关键parent 传 nullptr connect(m_second, SecondWindow::valueReady, this, MainWindow::onValueReady); } m_second-show(); m_second-raise(); // 从被遮挡状态提到最前 m_second-activateWindow(); // 抢焦点否则只是显示但不激活 }这里有几个点值得掰开。第一m_second用QPointer而不是裸指针。QPointer在对象被销毁时会自动置空这就避免了一个特别经典的崩溃用户关掉第二个窗口如果设了WA_DeleteOnClose指针变成野指针你再点一次按钮就是访问已释放内存程序直接崩。裸指针写法在调试版可能侥幸不崩发布版一崩一个准。第二show()之后必须补raise()和activateWindow()。如果窗口之前被显示过、又被其他窗口盖住单靠show()不一定会把它提到最前面用户会觉得“我点了按钮怎么没反应”。raise()负责层叠顺序activateWindow()负责键盘焦点两个一起用才完整。第三窗口只new一次重复点击只是重新show。这引出单实例窗口的写法后面单独说。如果你的需求是“模态对话框”那写法就完全不一样了SecondWindow dlg(this); if (dlg.exec() QDialog::Accepted) { QString result dlg.resultText(); // 使用结果 }这段代码用的是栈对象函数返回即销毁没有内存泄漏风险非常干净。但注意exec()会开新的局部事件循环在它返回之前openSecondWindow()这个函数是被“卡住”的。如果你的第二个窗口需要和主窗口同时操作这条路走不通必须换非模态。2.2 独立窗口那一侧类声明里要盯住的几件事第二个窗口的类本身没什么玄机重点是构造函数的 parent 默认值和信号定义。// secondwindow.h class SecondWindow : public QWidget { Q_OBJECT public: explicit SecondWindow(QWidget *parent nullptr); signals: void valueReady(const QString text); // 用于把数据回传给主窗口 private slots: void onConfirmClicked(); private: Ui::SecondWindow *ui; };构造函数里那个parent nullptr的默认参数很关键。如果你写成explicit SecondWindow(QWidget *parent)不带默认值调用方就很容易被 IDE 提示带着写成new SecondWindow(this)一脚踩进“被吸进主窗口”的坑。给个默认nullptr至少在心理上提醒了调用方这里不传父对象是完全合法的。另外独立窗口的类里不要出现任何qApp-quit()或者close()主窗口的逻辑除非你确定那是业务需要。我见过有人在子窗口的关闭按钮里连了qApp-quit()结果用户关掉子窗口整个程序没了主窗口上未保存的数据全丢。2.3 生命周期的三种写法各自会咬你一口这部分是我觉得最该讲清楚、但大部分教程都跳过的地方。第一种无父 手动管理。new SecondWindow(nullptr)主窗口持有一个QPointer在主窗口析构时手动delete或者干脆不 delete 让它泄漏到进程结束对小型工具来说进程退出时系统回收实际危害很小但不推荐。这种做法下第二个窗口的生命周期独立于主窗口——主窗口关了它还在除非你显式处理。第二种有父 Qt::Window标志。new SecondWindow(this)然后setWindowFlags(Qt::Window)。它视觉上是独立窗口但挂在主窗口的对象树上主窗口析构时自动被删。这里有两个坑一是setWindowFlags必须在show()之前调用如果窗口已经显示再改标志窗口会被隐藏得再show()一次二是它会跟随主窗口最小化——主窗口一最小化第二个窗口也消失这个行为在某些场景下是想要的但在“独立窗口”的语境下往往不是。第三种栈对象 exec()。前面写过了只适合模态。栈对象的最大好处是异常安全和零泄漏但如果你的exec()在一个循环里被调用每次都要重建整个窗口构造开销和 UI 重建开销都要考虑进去。我把这三种的差异列一下方便对照选择写法内存管理主窗口关闭后跟随最小化适用场景new X(nullptr)QPointer手动或泄漏可继续存在否真正独立的工具窗口new X(this)Qt::Window自动一起销毁是附属面板、从属关系明确栈对象 exec()自动阻塞中不可关闭不适用模态表单选哪个不是审美问题而是“关掉主窗口之后第二个窗口还应不应该活着”这个业务问题的直接映射。想清楚这一点写法就定了。3. 两个窗口之间的数据怎么走3.1 信号槽是最省心的通道但方向要设计对独立窗口最大的价值是“并行操作”那必然涉及数据同步。Qt 的官方答案就是信号槽但用的时候要注意方向性子窗口向上报主窗口向下推不要把两个方向混在一根信号里。子窗口向上报标准写法是子窗口定义信号、主窗口连接// secondwindow.cpp void SecondWindow::onConfirmClicked() { emit valueReady(ui-lineEdit-text()); // 只发信号不关心谁在听 } // mainwindow.cpp 连接处 connect(m_second, SecondWindow::valueReady, this, MainWindow::onValueReady);主窗口向下推则是主窗口定义信号或直接调子窗口的公有方法// 方式 A主窗口发信号子窗口槽接收 connect(this, MainWindow::configChanged, m_second, SecondWindow::applyConfig); // 方式 B主窗口直接调用子窗口的公有接口 if (m_second) m_second-applyConfig(newConfig);我一般偏好方式 A因为解耦更彻底——主窗口不需要知道子窗口内部实现只要发信号就行。但方式 A 有个前置条件连接必须在子窗口创建之后建立如果连接写在构造函数里而子窗口是懒加载的就得把 connect 挪到创建处或者用connect之后立刻判断m_second是否已存在。这里有个细节值得单独提跨窗口的 connect 默认是Qt::AutoConnection同一线程内会退化成直连Direct Connection也就是说emit那一行实际上就是一次函数调用槽函数执行完才返回。这一点很重要因为你如果在槽里做了耗时操作比如读大文件发出信号的那个窗口会直接卡住。遇到这种情况要么把耗时逻辑扔到线程里要么显式指定Qt::QueuedConnection让它异步走事件循环。3.2 模态拿返回值非模态靠信号别混着来一个特别常见的错误设计是用非模态窗口show()然后在主窗口里写个while循环等子窗口的结果。这不仅丑而且会卡死事件循环——窗口永远等不到用户点击因为点击事件根本没机会被处理。正确的做法很清晰模态就用exec()的返回值加公有 getter非模态就用信号。QDialog的accept()和reject()会自动设置返回码配合QDialogButtonBox基本不用写额外代码// 模态调用方拿到结果再继续 SecondDialog dlg(this); if (dlg.exec() QDialog::Accepted) { handle(dlg.text()); } // 非模态结果通过信号回来主流程不阻塞 m_second-show(); // 之后在 onValueReady 里处理如果非要给非模态窗口也提供“确认/取消”的语义可以自己加一个bool m_accepted成员在accept信号里置位但更多时候用户根本不需要这个语义——非模态窗口的数据通常是实时生效的改完就是改完了。3.3 数据共享的两种思路谁持有真相当两个窗口都要读写同一份数据时就有了“真相源在哪”的问题。两种常见做法做法一主窗口持有数据子窗口只有视图。主窗口里放一个AppState结构体或QAbstractItemModel子窗口通过指针引用它或者通过信号槽同步。优点是数据流向清晰只有一个写入口缺点是子窗口的每个修改都要走一遍信号往返代码量大。做法二抽一个单例或共享模型。两个窗口都从同一个单例拿数据各自直接改。优点是代码短缺点是同步时机不好控制——A 窗口改了B 窗口的界面不会自动刷新除非你用QAbstractItemModel或者Q_PROPERTYNOTIFY信号走 Qt 的属性系统。我做过的一个小工具里第二个窗口是一个“批量重命名预览”面板主窗口负责选文件。这里的真相源是文件列表我把它放在主窗口用一个信号fileListChanged(QStringList)推给子窗口子窗口只负责渲染。这个结构跑了很久没出过同步问题因为只有一个写入口这是关键。4. 那些跑起来才发现不对的现象4.1 主窗口最小化第二个窗口跟着消失这是最常见的“独立失败”症状。原因基本可以锁定为第二个窗口有父对象且类型位是Qt::Window或Qt::Dialog。Qt 对“有父的顶层窗口”的处理是让它们和父窗口组成一个整体父窗口最小化时它们跟着走。这是设计行为不是 bug。解决办法有两条。要么彻底去掉父对象——new SecondWindow(nullptr)问题当场消失要么保留父对象但改成Qt::Tool工具窗口的行为在某些平台上是浮动的但注意Qt::Tool在 Windows 上仍然会跟随最小化所以如果你的目标平台是 Windows唯一可靠的办法还是去掉父对象。排查这个问题的技巧临时在子窗口的构造函数里qDebug() parentWidget();如果不是nullptr那就是父子关系在作祟。再补一句qDebug() windowFlags();看类型位。这两行日志基本能定位 90% 的窗口归属问题。4.2 关掉最后一个窗口程序不退出或者退出得太突然QApplication::quitOnLastWindowClosed这个属性默认是true意思是“所有可见窗口都关闭后退出程序”。当你做了一个无父的独立窗口关掉主窗口时子窗口还开着程序就不会退出用户会看到一个孤儿窗口还在那儿。这不一定是你想要的。反过来的情况是你设了quitOnLastWindowClosed(false)结果关掉所有窗口后进程还在后台跑任务管理器里能看到。这时候需要在主窗口的closeEvent里显式处理void MainWindow::closeEvent(QCloseEvent *event) { if (m_second) { m_second-close(); // 或 m_second-deleteLater(); } QMainWindow::closeEvent(event); }用deleteLater()比delete安全因为它把删除排进事件循环不会在事件处理过程中把对象拆掉避免“在信号发射过程中删除接收者”这类崩溃。还有一个更隐蔽的变体主窗口关闭后程序没退出然后又点了一次子窗口的按钮想重新打开主窗口结果主窗口指针是空的。这种一般是主窗口是栈对象在main()里exec()返回后就析构了。要么改成在堆上创建要么接受“关主窗口即退出”的语义。4.3 任务栏图标、置顶和 AltTab 的意外表现用Qt::Window时Windows 任务栏上会出现一个新的图标条目这是正常的独立窗口行为。但如果你的第二个窗口只是个小面板多一个任务栏图标会让用户困惑。这时候Qt::Tool更合适。窗口置顶方面setWindowFlag(Qt::WindowStaysOnTopHint)可以让子窗口始终浮在所有窗口之上适合做“悬浮监视器”。但要注意这个标志和Qt::Tool组合在部分平台上的表现不一致而且用户如果打开了别的程序的置顶窗口两个置顶窗口会互相抢导致闪烁。我的经验是尽量不要给普通窗口加置顶除非那个窗口的功能确实要求时刻可见。跨窗口焦点也是个小坑。用户在主窗口操作子窗口的输入框里光标还在闪但键盘输入实际进的是主窗口。这个行为是平台相关的Qt 层面能做的有限activateWindow()只能在你主动调用时生效用户自己点哪个窗口就是哪个。4.4 多显示器和高分屏下的位置漂移第二个窗口如果用了固定的move(x, y)坐标在多显示器环境下很容易跑到屏幕外。尤其是笔记本外接显示器的场景主窗口在副屏时子窗口按主屏坐标算可能出现在用户看不到的地方。稳妥做法是用主窗口的几何信息做参照而不是写死坐标void MainWindow::openSecondWindow() { if (!m_second) { m_second new SecondWindow(nullptr); } if (!m_second-isVisible()) { const QRect mainRect frameGeometry(); QRect target(mainRect.right() 20, mainRect.top(), 420, 520); // 防止跑到屏幕外 if (QScreen *screen this-screen()) { const QRect avail screen-availableGeometry(); if (!avail.contains(target.topLeft())) { target.moveLeft(avail.left() 40); target.moveTop(avail.top() 40); } } m_second-setGeometry(target); } m_second-show(); m_second-raise(); m_second-activateWindow(); }frameGeometry()拿的是含窗口边框的几何screen()-availableGeometry()拿的是扣掉任务栏之后的可用区域。用它们算出来的位置基本不会出现“窗口飞到屏幕外面找不回来”的尴尬。高分屏缩放Device Pixel Ratio方面Qt 5 之后的新版本默认开启高 DPI 支持setGeometry用的是设备无关像素一般不需要手动乘系数。但如果你在移动窗口时混用了物理像素的设备信息就可能出现窗口尺寸不对的情况。判断标准很简单同一份代码在 125% 缩放的屏幕上测一遍如果尺寸正常基本就没问题。5. 让它更像一个“正经”的独立窗口5.1 记住窗口位置下次打开还原用户辛辛苦苦把第二个窗口拖到副屏某个位置下次打开又回到默认位置体验会很差。用QSettings存一下saveGeometry()和saveState()就行// 关闭时保存 void SecondWindow::closeEvent(QCloseEvent *event) { QSettings s(MyTools, DualWindowDemo); s.setValue(secondWindow/geometry, saveGeometry()); QWidget::closeEvent(event); } // 构造时还原 void SecondWindow::restoreFromSettings() { QSettings s(MyTools, DualWindowDemo); const QByteArray geo s.value(secondWindow/geometry).toByteArray(); if (!geo.isEmpty()) { restoreGeometry(geo); } }restoreGeometry内部会做屏幕范围检查如果存下来的位置在当前配置下不可用它会自动调整比手动存pos()和size()可靠得多。这一点我吃过亏早期版本我存的是pos()用户换了显示器之后窗口就出现在屏幕外了后来改成saveGeometry才彻底解决。5.2 单实例打开别让用户点出一堆窗口按钮连点两下就弹两个一模一样的窗口这是新手代码里非常典型的问题。前面给的QPointer方案已经解决了这一步但还需要处理“窗口已存在但被最小化”的情况void MainWindow::openSecondWindow() { if (!m_second) { m_second new SecondWindow(nullptr); connect(m_second, SecondWindow::valueReady, this, MainWindow::onValueReady); } if (m_second-isMinimized()) { m_second-showNormal(); // 从最小化恢复 } else { m_second-show(); } m_second-raise(); m_second-activateWindow(); }showNormal()这一步很多人会漏。如果窗口处于最小化状态只调show()和raise()是不会把它恢复的用户会觉得按钮失灵。判断顺序也要注意先判断isMinimized()再调show()因为show()一个已经最小化的窗口不会自动恢复。5.3 关闭即销毁还是隐藏后复用如果第二个窗口的构造开销很小一般 UI 窗口都很小我更倾向于关闭时只隐藏、不销毁这样下次打开是瞬间的而且窗口里的滚动位置、输入内容都还在。实现方式是给窗口设WA_DeleteOnClose为false这是默认值然后在closeEvent里event-ignore(); hide();void SecondWindow::closeEvent(QCloseEvent *event) { QSettings s(MyTools, DualWindowDemo); s.setValue(secondWindow/geometry, saveGeometry()); event-ignore(); hide(); }但要小心一个副作用窗口被hide()之后如果里面有正在跑的定时器或网络请求它们不会停。所以在hideEvent里要顺手把不该继续跑的活停掉void SecondWindow::hideEvent(QHideEvent *event) { m_timer.stop(); QWidget::hideEvent(event); }反过来如果你确实希望关闭即销毁比如窗口里有大块数据要释放就设setAttribute(Qt::WA_DeleteOnClose)然后务必把主窗口里持有的指针改成QPointer否则就是前面说的野指针崩溃。这两件事必须成对出现缺一个都会出问题。6. 一份能直接跑的最小工程把上面的东西拼起来就是一个完整的最小示例。主窗口放一个按钮点开一个完全独立的第二个窗口窗口里一个输入框和一个按钮点按钮把文字发回主窗口的标签上。// secondwindow.h #ifndef SECONDWINDOW_H #define SECONDWINDOW_H #include QWidget namespace Ui { class SecondWindow; } class SecondWindow : public QWidget { Q_OBJECT public: explicit SecondWindow(QWidget *parent nullptr); ~SecondWindow(); signals: void valueReady(const QString text); private slots: void onConfirmClicked(); private: Ui::SecondWindow *ui; }; #endif// secondwindow.cpp #include secondwindow.h #include ui_secondwindow.h #include QCloseEvent #include QSettings SecondWindow::SecondWindow(QWidget *parent) : QWidget(parent) , ui(new Ui::SecondWindow) { ui-setupUi(this); setWindowTitle(QStringLiteral(独立窗口)); setAttribute(Qt::WA_DeleteOnClose, false); // 关闭只隐藏复用 QSettings s(MyTools, DualWindowDemo); const QByteArray geo s.value(secondWindow/geometry).toByteArray(); if (!geo.isEmpty()) restoreGeometry(geo); else resize(420, 300); connect(ui-btnConfirm, QPushButton::clicked, this, SecondWindow::onConfirmClicked); } SecondWindow::~SecondWindow() { delete ui; } void SecondWindow::onConfirmClicked() { emit valueReady(ui-lineEdit-text()); } void SecondWindow::closeEvent(QCloseEvent *event) { QSettings s(MyTools, DualWindowDemo); s.setValue(secondWindow/geometry, saveGeometry()); event-ignore(); hide(); }// mainwindow.cpp 中的关键部分 void MainWindow::openSecondWindow() { if (!m_second) { m_second new SecondWindow(nullptr); // 无父 → 彻底独立 connect(m_second, SecondWindow::valueReady, this, MainWindow::onValueReady); } if (m_second-isMinimized()) m_second-showNormal(); else m_second-show(); if (!m_second-isVisible() || m_second-geometry().isNull()) { const QRect r frameGeometry(); m_second-move(r.right() 24, r.top()); } m_second-raise(); m_second-activateWindow(); } void MainWindow::onValueReady(const QString text) { ui-labelResult-setText(QStringLiteral(来自独立窗口) text); }跑起来之后你可以做几个验证拖动第二个窗口到主窗口外面它不会弹回去最小化主窗口第二个窗口还在在第二个窗口输入文字点确认主窗口的标签立刻更新把第二个窗口拖到副屏关掉程序再开它还在副屏那个位置。这四条都过了说明窗口归属、通信链路、状态持久化三个环节都通了。最后分享一个我自己的排查套路。遇到“窗口表现不对”时我一般按这个顺序检查第一步qDebug()打出parentWidget()和windowFlags()确认归属和类型位第二步确认setWindowFlags是否在show之前调用第三步确认指针是不是QPointer有没有野指针风险第四步才去看业务逻辑。前两步能解决绝大多数问题而且耗时不到一分钟——比反复改代码试错快得多。这套顺序是我被窗口问题折磨了小半年之后总结出来的现在基本一次就能定位。
阅读完成 · 觉得有帮助？
