精通 Qt 界面：从 show() 到 exec() 的窗口组件避坑指南
2025-11-19
在使用 Qt 的窗口和对话框时，开发者经常会遇到一些挑战。以下是一些常见的问题及其对应的解决方法。
忘记调用 show() 方法。
在非主线程中创建或显示 QWidget（Qt 组件）。
程序过早退出。
确保您在程序主入口（通常是 main 函数）中正确创建并显示了主窗口，并且启动了事件循环。
示例代码
#include
#include
int main(int argc, char *argv[])
{
// 1. 创建 QApplication 实例 (必须!)
QApplication app(argc, argv);
// 2. 创建主窗口实例
QWidget window;
window.setWindowTitle("我的主窗口");
window.resize(400, 300);
// 3. 关键步骤：显示窗口
window.show();
// 4. 关键步骤：启动事件循环，让程序保持运行并响应用户输入
// 只有在事件循环运行时，窗口才能保持显示
return app.exec();
}
需要一个模态 (Modal) 对话框（即用户必须先关闭此对话框才能操作父窗口），但使用了 show() 方法，导致它是非模态 (Non-Modal) 的。
使用了模态对话框，但忘记处理 exec() 的返回值，不知道用户是点击了“确定”还是“取消”。
非模态对话框 (Non-Modal Dialog) 使用 show()。它不会阻塞调用它的代码。适用于工具箱或浮动面板。
模态对话框 (Modal Dialog) 使用 exec()。它会阻塞调用它的函数，直到对话框关闭。适用于需要用户立即做出选择的场景（如“保存文件”或“登录”）。
示例代码 (使用 QDialog 的 exec())
#include
#include
#include
#include
void openDialog()
{
QDialog *dialog = new QDialog();
dialog->setWindowTitle("模态对话框示例");
// 添加布局和按钮（如 QDialogButtonBox）...
// 使用 exec() 启动对话框，并检查返回值
int result = dialog->exec();
// 在对话框关闭后执行的操作
if (result == QDialog::Accepted) {
QMessageBox::information(nullptr, "结果", "用户点击了确定 (Accepted)。");
} else {
QMessageBox::information(nullptr, "结果", "用户点击了取消或其他 (Rejected)。");
}
// 注意：如果是堆上创建的对话框，通常需要在关闭后进行清理
delete dialog;
}
没有给 QWidget 或 QDialog 设置布局管理器 (Layout Manager)，导致组件位置和大小是固定的，窗口调整大小时，组件不会自动调整。
始终使用 Qt 提供的布局管理器 (如 QHBoxLayout, QVBoxLayout, QGridLayout 等) 来组织窗口中的组件。布局管理器会自动处理窗口大小变化时的组件重定位和缩放。
示例代码 (使用 QVBoxLayout)
#include
#include
#include
// 创建一个带垂直布局的窗口
QWidget *createLayoutWindow()
{
QWidget *window = new QWidget();
// 创建组件
QPushButton *button1 = new QPushButton("按钮 1");
QPushButton *button2 = new QPushButton("按钮 2");
// 1. 创建布局管理器 (垂直布局)
QVBoxLayout *layout = new QVBoxLayout();
// 2. 将组件添加到布局中
layout->addWidget(button1);
layout->addWidget(button2);
// 3. **关键步骤：** 将布局设置给窗口
window->setLayout(layout);
window->setWindowTitle("布局示例");
return window;
}
想在用户关闭窗口前执行某些操作（如“是否保存”的提示），但不知道如何拦截关闭事件。
重写 QWidget (或 QDialog 的基类) 的 closeEvent(QCloseEvent∗event) 方法。
示例代码 (重写 closeEvent)
#include
#include
#include
class MyMainWindow : public QMainWindow
{
Q_OBJECT // 如果使用信号/槽，需要这个宏
public:
MyMainWindow(QWidget *parent = nullptr) : QMainWindow(parent) {}
protected:
void closeEvent(QCloseEvent *event) override
{
// 弹出确认对话框
QMessageBox::StandardButton res = QMessageBox::question(
this, "确认", "您确定要退出吗？未保存的数据可能会丢失。",
QMessageBox::Yes | QMessageBox::No
);
if (res != QMessageBox::Yes) {
// 阻止窗口关闭
event->ignore();
} else {
// 允许窗口关闭 (默认行为)
event->accept();
}
}
};
希望这份详细的指南能帮助您更好地使用 Qt 进行窗口和对话框的开发！