Qt学习笔记2——对话框及其数据传递

学习自：https://www.devbean.net/2012/08/qt-study-road-2-catelog/
记录学习笔记仅供自己学习使用，如有侵权，请联系作者删除。

1.对话框简介

对话框是 GUI 程序中不可或缺的组成部分。很多不能或者不适合放入主窗口的功能组件都必须放在对话框中设置。对话框通常会是一个顶层窗口，出现在程序最上层，用于实现短期任务或者简洁的用户交互。

QDialog类： 实现对话框。就像主窗口一样，我们通常会设计一个类继承QDialog。QDialog（及其子类，以及所有Qt::Dialog类型的类）对于其 parent 指针都有额外的解释：如果 parent 为 NULL，则该对话框会作为一个顶层窗口，否则则作为其父组件的子对话框（此时，其默认出现的位置是 parent 的中心）。顶层窗口与非顶层窗口的区别在于：顶层窗口在任务栏会有自己的位置，而非顶层窗口则会共享其父组件的位置。

void MainWindow::open()
{
    QDialog dialog(this);		//创建一个对话框，并设置其parent指针。
    dialog.setWindowTitle(tr("Hello Dialog!"));
    dialog.exec();      //将对话框显示出来
}

1.1.模态对话框

对话框分为模态对话框和非模态对话框。
模态对话框： 会阻塞同一应用程序中其它窗口的输入。 模态对话框很常见，比如“打开文件”功能。你可以尝试一下记事本的打开文件，当打开文件对话框出现时，我们是不能对除此对话框之外的窗口部分进行操作的。与此相反的是非模态对话框，例如查找对话框，我们可以在显示着查找对话框的同时，继续对记事本的内容进行编辑。

Qt 有两种级别的模态对话框：应用程序级别的模态和窗口级别的模态，默认是应用程序级别的模态。应用程序级别的模态是指，当该种模态的对话框出现时，用户必须首先对对话框进行交互，直到关闭对话框，然后才能访问程序中其他的窗口。窗口级别的模态是指，该模态仅仅阻塞与对话框关联的窗口，但是依然允许用户与程序中其它窗口交互。

Qt 使用QDialog::exec()实现应用程序级别的模态对话框；
使用QDialog::open()实现窗口级别的模态对话框；
使用QDialog::show()实现非模态对话框。

1.2.非模态对话框

void MainWindow::open()
{
    QDialog dialog(this);		//建立在栈上的dialog，放
    dialog.setWindowTitle(tr("Hello, dialog!"));
    dialog.show();
}

对话框竟然一闪而过！这是因为，show()函数不会阻塞当前线程，对话框会显示出来，然后函数立即返回，代码继续执行。注意，dialog 是建立在栈上的，show()函数返回，MainWindow::open()函数结束，dialog 超出作用域被析构，因此对话框消失了。 知道了原因就好改了，我们将 dialog 改成堆上建立，当然就没有这个问题了：

void MainWindow::open()
{
    QDialog *dialog = new QDialog;		//建立在堆上的dialog
    dialog->setWindowTitle(tr("Hello, dialog!"));
    dialog->show();
}

上述代码存在问题：dialog 存在内存泄露！ dialog 使用 new 在堆上分配空间，却一直没有 delete。解决方案也很简单：将 MainWindow 的指针赋给 dialog 即可。（Qt的对象系统）。
不过，这样做有一个问题：如果我们的对话框不是在一个界面类中出现呢？由于QWidget的 parent 必须是QWidget指针，那就限制了我们不能将一个普通的 C++ 类指针传给 Qt 对话框。另外，如果对内存占用有严格限制的话，当我们将主窗口作为 parent 时，主窗口不关闭，对话框就不会被销毁，所以会一直占用内存。在这种情景下，我们可以设置 dialog 的WindowAttribute：

void MainWindow::open()
{
    QDialog *dialog = new QDialog;
    dialog->setAttribute(Qt::WA_DeleteOnClose);
    dialog->setWindowTitle(tr("Hello, dialog!"));
    dialog->show();
}

setAttribute()函数设置对话框关闭时，自动销毁对话框。另外，QObject还有一个deleteLater()函数，该函数会在当前事件循环结束时销毁该对话框（具体到这里，需要使用exec()开始一个新的事件循环）。

2.对话框数据传递

2.1.模态对话框

对话框与主窗口之间的数据交互：对话框分为模态对话框和非模态对话框两种。
模态对话框使用了exec()函数将其显示出来。exec()函数的真正含义是开启一个新的事件循环。 所谓事件循环，可以理解成一个无限循环。Qt 在开启了事件循环之后，系统发出的各种事件才能够被程序监听到。这个事件循环相当于一种轮询的作用。既然是无限循环，当然在开启了事件循环的地方，代码就会被阻塞，后面的语句也就不会被执行到。因此，对于使用了exec()显示的模态对话框，我们可以在exec()函数之后直接从对话框的对象获取到数据值。

void MainWindow::open()
{
    QDialog dialog(this);
    dialog.setWindowTitle(tr("Hello, dialog!"));
    dialog.exec();
    qDebug() << dialog.result();
}

我们使用**exec()**显示一个模态对话框。最后一行代码，qDebug()类似于std::cout;语句，将后面的信息输出到标准输出，一般就是控制台。使用 qDebug() 需要引入头文件。在exec()函数之后，我们直接可以获取到 dialog 的数据值。注意，exec()开始了一个事件循环，代码被阻塞到这里。 由于exec()函数没有返回，因此下面的result()函数也就不会被执行。直到对话框关闭，exec()函数返回，此时，我们就可以取得对话框的数据。

注意：如果我们设置 dialog 的属性为WA_DeleteOnClose，那么当对话框关闭时，对象被销毁，我们就不能使用这种办法获取数据了。 在这种情况下，我们可以考虑使用 parent 指针的方式构建对话框，避免设置WA_DeleteOnClose属性；或者是利用另外的方式。

实际上，QDialog::exec()是有返回值的，其返回值是QDialog::Accepted或者QDialog::Rejected。 一般我们会使用类似下面的代码：（来判断对话框的返回值，也就是用户是点击了“确定”还是“取消”。）

QDialog dialog(this);
if (dialog.exec() == QDialog::Accepted) {
    // do something
} else {
    // do something else
}

2.2.非模态对话框

如果是非模态对话框，QDialog::show()函数会立即返回，如果我们也这么写，就不可能取得用户输入的数据。因为show()函数不会阻塞主线程，show()立即返回，用户还没有来得及输入，就要执行后面的代码，当然是不会有正确结果的。 那么我们就应该换一种思路获取数据，那就是使用信号槽机制。

由于非模态对话框在关闭时可以调用QDialog::accept()函数或者QDialog::reject()函数 或者更通用的QDialog::done()函数 ，所以我们可以在这里发出信号。另外，如果找不到合适的信号发出点，我们可以重写QDialog::closeEvent()函数，在这里发出信号。在需要接收数据的窗口（这里是主窗口）连接到这个信号即可。类似的代码片段如下所示：

void UserAgeDialog::accept()
{
    emit userAgeChanged(newAge); // newAge is an int
    QDialog::accept();
}

// in main window:
void MainWindow::showUserAgeDialog()
{
    UserAgeDialog *dialog = new UserAgeDialog(this);
    connect(dialog, &UserAgeDialog::userAgeChanged, this, &MainWindow::setUserAge);
    dialog->show();
}

// ...

void MainWindow::setUserAge(int age)
{
    userAge = age;
}

不要担心如果对话框关闭，是不是还能获取到数据。因为 Qt 信号槽的机制保证，槽函数在调用的时候，我们始终可以使用sender()函数获取到 signal 的发出者。 sender()函数的存在使我们可以利用这个函数，来实现一个只能打开一个的非模态对话框（方法就是在对话框打开时在一个对话框映射表中记录下标记，在对话框关闭时利用sender()函数判断是不是该对话框，然后从映射表中将其删除）。