QDialog如何设置模态对话框并在关闭时返回自定义数据？

Question

**如何使用QDialog创建模态对话框并返回自定义数据？** 在Qt开发中，如何利用QDialog设置一个模态对话框，并在用户关闭对话框时返回自定义数据（如字符串、整数或复杂对象）是一个常见需求。例如，当用户在对话框中填写表单并点击“确定”按钮后，主窗口需要获取这些输入值。此时，可以通过重载`QDialog::done(int)`或使用信号槽机制，在对话框关闭时将数据传递给调用方。此外，还需要确保对话框以模态方式显示（使用`exec()`而非`show()`），以便阻塞主窗口的交互，直到对话框处理完成。如何优雅地实现这一功能，同时保持代码清晰和可维护性？

Answer 1

1. 初步了解QDialog与模态对话框

在Qt开发中，QDialog 是一个用于创建对话框的基础类。通过设置对话框为模态（modal），可以确保用户只能与该对话框交互，而主窗口被阻塞。模态对话框通常用于需要用户立即响应的场景。

要创建一个模态对话框并返回自定义数据，首先需要理解 exec() 方法的作用。与非模态的 show() 不同，exec() 会启动事件循环，直到对话框关闭才会返回。

• exec(): 返回一个整数值，通常表示对话框的退出状态。
• done(int): 可以重载以控制退出状态和行为。

接下来，我们将逐步探讨如何实现这一功能。

2. 实现模态对话框的基本步骤

以下是创建模态对话框并返回自定义数据的基本流程：

1. 继承 QDialog 并设计对话框界面。
2. 在对话框中添加输入控件（如 QLineEdit、QSpinBox 等）。
3. 重载 done(int) 或使用信号槽机制传递数据。
4. 调用 exec() 显示对话框，并处理返回值。

例如，以下代码展示了如何创建一个简单的模态对话框：

// MyDialog.h
#ifndef MYDIALOG_H
#define MYDIALOG_H

#include <QDialog>
#include <QString>

class MyDialog : public QDialog {
    Q_OBJECT
public:
    MyDialog(QWidget *parent = nullptr);
    QString getUserInput() const;

private slots:
    void accept();

private:
    QLineEdit *lineEdit;
    QString userInput;
};

#endif // MYDIALOG_H

3. 数据传递的多种方式

在对话框关闭时，可以通过以下几种方式将数据传递给调用方：

方法	优点	缺点
重载 done(int)	简单直接，适合少量数据传递。	无法传递复杂对象或多个数据。
使用成员变量	易于实现，支持复杂数据结构。	需要手动管理数据存储。
信号槽机制	灵活性高，适合跨线程通信。	可能增加代码复杂度。

对于复杂对象的传递，推荐使用成员变量存储数据，并在对话框关闭后通过 getter 方法获取。

4. 完整示例：返回字符串和整数

以下是一个完整的示例，展示如何创建一个模态对话框并返回字符串和整数：

// MyDialog.cpp
MyDialog::MyDialog(QWidget *parent) : QDialog(parent) {
    lineEdit = new QLineEdit(this);
    QPushButton *okButton = new QPushButton("OK", this);

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

    QVBoxLayout *layout = new QVBoxLayout(this);
    layout->addWidget(lineEdit);
    layout->addWidget(okButton);
}

void MyDialog::accept() {
    userInput = lineEdit->text();
    QDialog::accept(); // 关闭对话框并返回 Accept
}

QString MyDialog::getUserInput() const {
    return userInput;
}

// 主窗口代码
int main(int argc, char *argv[]) {
    QApplication app(argc, argv);

    MyDialog dialog;
    if (dialog.exec() == QDialog::Accepted) {
        QString result = dialog.getUserInput();
        qDebug() << "User input:" << result;
    }

    return app.exec();
}

上述代码中，exec() 的返回值决定了用户是否点击了“确定”按钮。

5. 使用信号槽机制优化数据传递

如果需要更灵活的数据传递方式，可以使用信号槽机制：

signals:
    void dataReady(const QString &data);

void MyDialog::accept() {
    emit dataReady(lineEdit->text());
    QDialog::accept();
}

主窗口可以通过连接信号来实时接收数据：

MyDialog dialog;
connect(&dialog, &MyDialog::dataReady, [](const QString &data) {
    qDebug() << "Data received:" << data;
});

if (dialog.exec() == QDialog::Accepted) {
    qDebug() << "Dialog accepted.";
}

6. 流程图：数据传递逻辑

以下是数据传递的整体逻辑流程图：

graph TD;
    A[主窗口调用 exec()] --> B[对话框显示];
    B -- 用户输入 --> C[点击确定];
    C -- 调用 done(int) 或信号槽 --> D[返回数据];
    D --> E[主窗口处理数据];

通过这种方式，可以优雅地实现模态对话框的功能，同时保持代码的清晰性和可维护性。