QDialog 是 Qt 提供的一个功能强大且灵活的对话框控件，通过本篇文章的学习，你应该对 QDialog 有了全面的理解，能够在自己的项目中正确使用它。对话框在用户界面中帮助你更好地管理和处理用户输入、消息显示等交互，有助于创建用户友好和高效的界面。

🧑 博主简介：现任阿里巴巴嵌入式技术专家，15年工作经验，深耕嵌入式+人工智能领域，精通嵌入式领域开发、技术管理、简历招聘面试。CSDN优质创作者，提供产品测评、学习辅导、简历面试辅导、毕设辅导、项目开发、C/C++/Java/Python/Linux/AI等方面的服务，如有需要请站内私信或者联系任意文章底部的的VX名片（ID：<code>gylzbk）

💬 博主粉丝群介绍：① 群内初中生、高中生、本科生、研究生、博士生遍布，可互相学习，交流困惑。② 热榜top10的常客也在群里，也有数不清的万粉大佬，可以交流写作技巧，上榜经验，涨粉秘籍。③ 群内也有职场精英，大厂大佬，可交流技术、面试、找工作的经验。④ 进群免费赠送写作秘籍一份，助你由写作小白晋升为创作大佬。⑤ 进群赠送CSDN评论防封脚本，送真活跃粉丝，助你提升文章热度。有兴趣的加文末联系方式，备注自己的CSDN昵称，拉你进群，互相学习共同进步。

【QT开发】对话框控件QDialog类详解及实战应用

1️⃣ 🌟 概述2️⃣ 📖 class 的介绍2.1 常用方法2.2 重要信号

3️⃣ 💻 示例代码3.1 代码解释

4️⃣ 🧐 注意事项5️⃣ 🛠️ 使用技巧6️⃣ 📌 总结

1️⃣ 🌟 概述

QDialog 是一个对话框控件，用于显示模态和非模态对话框。通过掌握 QDialog 的用法，你将能够在 Qt 项目中轻松添加和管理对话框组件，实现用户与程序的交互功能。

QDialog 在用户界面中非常常见，适用于用户输入、消息显示、设置调整等场景。

2️⃣ 📖 class 的介绍

在 Qt 官方文档中，<code>QDialog 类的定义如下：

class QDialog : public QWidget

{

Q_OBJECT

// ...

}

QDialog 继承自 QWidget，提供了一个对话框控件，用于显示模态和非模态对话框。以下是一些关键特性和功能：

模态和非模态：可以创建模态和非模态对话框。返回结果：支持通过 accept、reject 方法返回对话框结果。布局管理：支持在对话框中设置布局管理器。

2.1 常用方法

以下是 QDialog 类中一些常用的方法及其简要介绍：

QDialog(QWidget *parent = nullptr, Qt::WindowFlags f = Qt::WindowFlags())：构造函数，创建一个新的对话框。exec()：以模态方式显示对话框，并阻塞后续代码直到对话框关闭，返回对话框的结果码。accept()：接受对话框，并返回 Accepted 状态。reject()：拒绝对话框，并返回 Rejected 状态。done(int r)：关闭对话框，并设置结果码为 r。open()：以非模态方式显示对话框。setLayout(QLayout *layout)：设置对话框的布局管理器。

2.2 重要信号

accepted()：当对话框接受时发射。rejected()：当对话框拒绝时发射.

3️⃣ 💻 示例代码

下面是一个简单的示例，用来演示 QDialog 的基本用法，以及如何创建和管理一个对话框：

#include <QApplication>

#include <QWidget>

#include <QDialog>

#include <QVBoxLayout>

#include <QPushButton>

#include <QLabel>

#include <QLineEdit>

class MyDialog : public QDialog

{

Q_OBJECT

public:

MyDialog(QWidget *parent = nullptr) : QDialog(parent)

{

QVBoxLayout *layout = new QVBoxLayout(this);

QLabel *label = new QLabel("Enter your name:", this);

QLineEdit *lineEdit = new QLineEdit(this);

QPushButton *okButton = new QPushButton("OK", this);

QPushButton *cancelButton = new QPushButton("Cancel", this);

layout->addWidget(label);

layout->addWidget(lineEdit);

layout->addWidget(okButton);

layout->addWidget(cancelButton);

connect(okButton, &QPushButton::clicked, this, &QDialog::accept);

connect(cancelButton, &QPushButton::clicked, this, &QDialog::reject);

}

};

int main(int argc, char *argv[])

{

QApplication app(argc, argv);

// 创建一个QWidget对象作为主窗口

QWidget window;

window.setWindowTitle("QDialog Example");

window.resize(300, 200);

QVBoxLayout *layout = new QVBoxLayout(&window);

// 创建一个按钮，用于显示对话框

QPushButton *button = new QPushButton("Show Dialog", &window);

layout->addWidget(button);

// 连接按钮点击信号，显示对话框

QObject::connect(button, &QPushButton::clicked, [&]() {

MyDialog dialog(&window);

if (dialog.exec() == QDialog::Accepted) {

qDebug() << "Dialog accepted";

} else {

qDebug() << "Dialog rejected";

}

});

// 显示窗口

window.show();

return app.exec();

}

3.1 代码解释

创建一个 MyDialog 类，继承自 QDialog 并建立一个简单的对话框用户界面，包括标签、输入框和两个按钮（OK 和 Cancel）。

class MyDialog : public QDialog

{

Q_OBJECT

public:

MyDialog(QWidget *parent = nullptr) : QDialog(parent)

{

QVBoxLayout *layout = new QVBoxLayout(this);

QLabel *label = new QLabel("Enter your name:", this);

QLineEdit *lineEdit = new QLineEdit(this);

QPushButton *okButton = new QPushButton("OK", this);

QPushButton *cancelButton = new QPushButton("Cancel", this);

layout->addWidget(label);

layout->addWidget(lineEdit);

layout->addWidget(okButton);

layout->addWidget(cancelButton);

connect(okButton, &QPushButton::clicked, this, &QDialog::accept);

connect(cancelButton, &QPushButton::clicked, this, &QDialog::reject);

}

};

QVBoxLayout *layout = new QVBoxLayout(this);：设置对话框的布局管理器为垂直布局。connect(okButton, &QPushButton::clicked, this, &QDialog::accept); 和 connect(cancelButton, &QPushButton::clicked, this, &QDialog::reject);：连接按钮的点击信号到对话框的 accept 和 reject 槽函数。

创建一个主窗口，包含一个按钮，用于显示自定义对话框：

QWidget window;

window.setWindowTitle("QDialog Example");

window.resize(300, 200);

QVBoxLayout *layout = new QVBoxLayout(&window);

QPushButton *button = new QPushButton("Show Dialog", &window);

layout->addWidget(button);

QObject::connect(button, &QPushButton::clicked, [&]() {

MyDialog dialog(&window);

if (dialog.exec() == QDialog::Accepted) {

qDebug() << "Dialog accepted";

} else {

qDebug() << "Dialog rejected";

}

});

QPushButton *button = new QPushButton("Show Dialog", &window);：创建一个按钮，显示文本 “Show Dialog”，其父窗口是 window。QObject::connect(button, &QPushButton::clicked, [&]() { MyDialog dialog(&window); if (dialog.exec() == QDialog::Accepted) { qDebug() << "Dialog accepted"; } else { qDebug() << "Dialog rejected"; } });：连接按钮的 clicked 信号到槽函数，当按钮被点击时显示对话框，并根据对话框的结果执行相应操作。

4️⃣ 🧐 注意事项

对话框模式：需要注意区分模态和非模态对话框，模态对话框会阻塞后续代码执行，非模态对话框则不会。信号与槽：确保各组件信号与槽的连接正确，尤其在响应 accept 和 reject 时。自定义对话框：可以通过继承 QDialog 创建自定义对话框，以便设置更复杂的布局和功能。

5️⃣ 🛠️ 使用技巧

自定义对话框内容：可以通过继承 QDialog 并在其构造函数中添加自定义控件来实现自定义对话框内容：

class MyCustomDialog : public QDialog

{

// ...

};

非模态对话框：通过 show 方法显示非模态对话框：

MyDialog *dialog = new MyDialog(&window);

dialog->show();

通过信号处理对话框结果：可以连接对话框的 accepted 和 rejected 信号来处理对话框结果：

QObject::connect(&dialog, &QDialog::accepted, []() {

qDebug() << "Dialog accepted";

});

QObject::connect(&dialog, &QDialog::rejected, []() {

qDebug() << "Dialog rejected";

});

使用标准对话框：Qt 提供了一些标准对话框（如 QFileDialog、QMessageBox 等），可以直接使用这些对话框简化开发：

QString fileName = QFileDialog::getOpenFileName(&window, "Open File", "/path/to/file", "Text Files (*.txt);;All Files (*)");

if (!fileName.isEmpty()) {

// 使用选择的文件名执行操作

}

设置对话框属性：可以设置对话框的一些属性，如窗口标志、标题等：

dialog.setWindowTitle("Custom Dialog");

dialog.setWindowFlags(Qt::Dialog | Qt::WindowTitleHint | Qt::CustomizeWindowHint);

6️⃣ 📌 总结

QDialog 是 Qt 提供的一个功能强大且灵活的对话框控件，通过本篇文章的学习，你应该对 QDialog 有了全面的理解，能够在自己的项目中正确使用它。对话框在用户界面中帮助你更好地管理和处理用户输入、消息显示等交互，有助于创建用户友好和高效的界面。