4.对话框QDialog
1.基本概念
对话框是 GUI 程序中不可或缺的组成部分。很多不能或者不适合放入主窗口的功能组件都必须放在对话框中设置。对话框通常会是一个顶层窗口，出现在程序最上层，用于实现短期任务或者简洁的用户交互。
Qt 中使用QDialog类实现对话框。就像主窗口一样，我们通常会设计一个类继承QDialog。QDialog（及其子类，以及所有Qt::Dialog类型的类）的对于其 parent 指针都有额外的解释：如果 parent 为 NULL，则该对话框会作为一个顶层窗口，否则则作为其父组件的子对话框（此时，其默认出现的位置是 parent 的中心）。顶层窗口与非顶层窗口的区别在于，顶层窗口在任务栏会有自己的位置，而非顶层窗口则会共享其父组件的位置。
对话框分为模态对话框和非模态对话框。
-
模态对话框，就是会阻塞同一应用程序中其它窗口的输入。
模态对话框很常见，比如“打开文件”功能。你可以尝试一下记事本的打开文件，当打开文件对话框出现时，我们是不能对除此对话框之外的窗口部分进行操作的。
-
与此相反的是非模态对话框，例如查找对话框，我们可以在显示着查找对话框的同时，继续对记事本的内容进行编辑。
示例：
#include "mainwindow.h" #include <QMenuBar> #include <QMenu> #include <QAction> #include <QDialog> #include <QMessageBox> #include <QFileDialog> MainWindow::MainWindow(QWidget *parent) : QMainWindow(parent) { // 设置菜单栏 QMenuBar *menuB = menuBar(); QMenu *File = menuB->addMenu("File"); // 增加两个菜单 QAction *dialog1 = File->addAction("dialog1"); QAction *dialog2 = File->addAction("dialog2"); connect(dialog1, &QAction::triggered, []() { // 创建模态对话框 QDialog dialog; dialog.exec(); }); QDialog *dialog = new QDialog(); connect(dialog2, &QAction::triggered, [=]() { // 创建非模态对话框 dialog->show(); }); QAction *dialog3 = File->addAction("dialog3"); connect(dialog3, &QAction::triggered, [&]() { // 标准对话框 QFileDialog::getOpenFileName(this, "Open File", "../", "source(*.cpp *.h);;text(*.txt)"); }); QAction *dialog4 = File->addAction("about"); connect(dialog4, &QAction::triggered, [=]() { QMessageBox::about(this, "about", "Qt"); }); } MainWindow::~MainWindow() { }
2.标准对话框
所谓标准对话框，是 Qt 内置的一系列对话框，用于简化开发。事实上，有很多对话框都是通用的，比如打开文件、设置颜色、打印设置等。这些对话框在所有程序中几乎相同，因此没有必要在每一个程序中都自己实现这么一个对话框。
Qt 的内置对话框大致分为以下几类：
-
QColorDialog： 选择颜色；
-
QFileDialog： 选择文件或者目录；
-
QFontDialog： 选择字体；
-
QInputDialog： 允许用户输入一个值，并将其值返回；
-
QMessageBox： 模态对话框，用于显示信息、询问问题等；
-
QPageSetupDialog： 为打印机提供纸张相关的选项；
-
QPrintDialog： 打印机配置；
-
QPrintPreviewDialog：打印预览；
-
QProgressDialog： 显示操作过程。
3.自定义消息框
Qt 支持模态对话框和非模态对话框。
模态与非模态的实现：
-
使用QDialog::exec()实现应用程序级别的模态对话框
-
使用QDialog::open()实现窗口级别的模态对话框
-
使用QDialog::show()实现非模态对话框。
4.消息对话框
头文件：#include <QMessageBox>
QMessageBox用于显示消息提示。我们一般会使用其提供的几个 static 函数：
-
显示关于对话框。
void about(QWidget * parent, const QString & title, const QString & text);
这是一个最简单的对话框，其标题是 title，内容是 text，父窗口是 parent。对话框只有一个 OK 按钮。
-
显示关于Qt对话框。该对话框用于显示有关Qt的信息。
void aboutQt(QWidget * parent, const QString & title = QString())：
-
显示严重错误对话框。
StandardButton critical(QWidget * parent,
const QString & title,
const QString & text,
StandardButtons buttons = Ok,
StandardButton defaultButton = NoButton)：
这个对话框将显示一个红色的错误符号。我们可以通过 buttons 参数指明其显示的按钮。默认情况下只有一个 Ok 按钮，我们可以使用StandardButtons类型指定多种按钮。
-
与QMessageBox::critical()类似，不同之处在于这个对话框提供一个普通信息图标。
StandardButton information(QWidget * parent,
const QString & title,
const QString & text,
StandardButtons buttons = Ok,
StandardButton defaultButton = NoButton)
-
与QMessageBox::critical()类似，不同之处在于这个对话框提供一个问号图标，并且其显示的按钮是“是”和“否”。
StandardButton question(QWidget * parent,
const QString & title,
const QString & text,
StandardButtons buttons = StandardButtons( Yes | No ),
StandardButton defaultButton = NoButton)
-
与QMessageBox::critical()类似，不同之处在于这个对话框提供一个黄色叹号图标。
StandardButton warning(QWidget * parent,
const QString & title,
const QString & text,
StandardButtons buttons = Ok,
StandardButton defaultButton = NoButton)
可以通过下面的代码来演示下如何使用QMessageBox。
if (QMessageBox::Yes == QMessageBox::question(this,
tr("Question"), tr("Are you OK?"),
QMessageBox::Yes | QMessageBox::No,
QMessageBox::Yes))
{
QMessageBox::information(this, tr("Hmmm..."),
tr("I'm glad to hear that!"));
}
else
{
QMessageBox::information(this, tr("Hmmm..."),
tr("I'm sorry!"));
}
上面使用QMessageBox::question()来询问一个问题。
-
对话框的父窗口是this。QMessageBox是QDialog的子类，这意味着它的初始显示位置将会实在parent窗口的中央。
-
第二个参数是对话框的标题。
-
第三个参数是我们想要显示的内容。这里就是我们需要询问的文字。下面，我们使用“或”运算符（|）指定对话框应该出现的按钮。这里我们希望是一个Yes和一个No。
-
最后一个参数指定默认选择的按钮。
这个函数有一个返回值，用于确定用户点击的是哪一个按钮。按照我们的写法，应该很容易看出，这是一个模态对话框，因此我们可以直接获取其返回值。
QMessageBox类的 static 函数优点是方便使用，缺点也很明显：非常不灵活。我们只能使用简单的几种形式。为了能够定制QMessageBox细节，我们必须使用QMessageBox的属性设置 API。
如果我们希望制作一个询问是否保存的对话框，我们可以使用如下的代码：
QMessageBox msgBox;
msgBox.setText(tr("The document has been modified."));
msgBox.setInformativeText(tr("Do you want to save your changes?"));
msgBox.setDetailedText(tr("Differences here..."));
msgBox.setStandardButtons(QMessageBox::Save
| QMessageBox::Discard
| QMessageBox::Cancel);
msgBox.setDefaultButton(QMessageBox::Save);
int ret = msgBox.exec();
switch (ret)
{
case QMessageBox::Save:
qDebug() << "Save document!";
break;
case QMessageBox::Discard:
qDebug() << "Discard changes!";
break;
case QMessageBox::Cancel:
qDebug() << "Close document!";
break;
}
msgBox是一个建立在栈上的QMessageBox实例。设置其主要文本信息为“The document has been modified.”，informativeText则是会在对话框中显示简单的说明文字。下面我们使用了一个detailedText，也就是详细信息，当我们点击了详细信息按钮时，对话框可以自动显示更多信息。我们自己定义的对话框的按钮有三个：保存、丢弃和取消。然后我们使用了exec()是其成为一个模态对话框，根据其返回值进行相应的操作。
5.标准文件对话框
QFileDialog，也就是文件对话框。在下面将尝试编写一个简单的文本文件编辑器，使用QFileDialog来打开一个文本文件，并将修改过的文件保存到硬盘。
首先，我们需要创建一个带有文本编辑功能的窗口。
openAction = new QAction(QIcon(":/images/file-open"), // QIcon 类代表图标 设置文件打开的图标 tr("&Open..."), this); openAction->setShortcuts(QKeySequence::Open); // 设置快捷键 openAction->setStatusTip(tr("Open an existing file"); // 添加状态栏的提示语句 saveAction = new QAction(QIcon(":/images/file-save"), tr("&Save..."), this); saveAction->setShort(QKeySequence::Open); saveAction->setStatusTip(tr("Save a new file)); QMenu *file = menuBar()->addMenu(tr("&File")); file->addAction(openAction); file->addAction(openAction); file->addAction(saveAction); QToolBar *toolBar = addTooBar(tr("&File")); toolBar->addAction(openAction); toolBar->addAction(saveAction); textEdit = new QTextEdit(this); setCentralWidget(textEdit);
在菜单和工具栏添加了两个动作：打开和保存。接下来是一个QTextEdit类，这个类用于显示富文本文件。也就是说，它不仅仅用于显示文本，还可以显示图片、表格等等。不过，我们现在只用它显示纯文本文件。QMainWindow有一个setCentralWidget()函数，可以将一个组件作为窗口的中心组件，放在窗口中央显示区。显然，在一个文本编辑器中，文本编辑区就是这个中心组件，因此我们将QTextEdit作为这种组件。
使用connect()函数，为这两个QAction对象添加响应的动作：
connect(openAction, &QAction::triggered,
this, &MainWindow::openFile);
connect(saveAction, &QAction::triggered,
this, &MainWindow::saveFile);
openFile()和saveFile()的代码：
// 打开文件 void MainWindow::openFile() { QString path = QFileDialog::getOpenFileName(this, tr("Open File"), ".", tr("Text File(*.txt)")); if(!path.isEmpty()) { QFile file(path); if(!file.open(QIODevice::ReadOnly | QIODevice::Text)) { QMessageBox::warning(this, tr("Read File"), tr("Cannot open file:\n%1").arg(path)); return; } QTextStream in(&file); textEdit->setText(in.readAll()); file.close(); } else { QMessageBox::warning(this, tr("Path"), tr("You did not select any file.")); } } void MainWindow::saveFile() { QString path = QFileDialog::getSaveFileName(this, tr("Open File"), ".", tr("Text File(*.txt)")); if(!path.empty()) { QFile file(path); if(!file.open(QIODevice::WriteOnly | QIODevice::Text)) { QMessageBox::warning(this, tr("Write File"), tr("Cannot open file:\n%1").arg(path)); return; } QTextStream out(&file); out << textEdit->toPlainText(); file.close(); } else { QMessageBox::warning(this, tr("Path"), tr("You did not select any file.")); } }
openFile()函数中，使用QFileDialog::getOpenFileName()来获取需要打开的文件的路径。这个函数原型如下：
QString getOpenFileName(QWidget * parent = 0,
const QString & caption = QString(),
const QString & dir = QString(),
const QString & filter = QString(),
QString * selectedFilter = 0,
Options options = 0)
不过注意，它的所有参数都是可选的，因此在一定程度上说，这个函数也是简单的。这六个参数分别是：
-
parent：父窗口。
Qt 的标准对话框提供静态函数，用于返回一个模态对话框；
-
caption：对话框标题；
-
dir：对话框打开时的默认目录
-
“.” 代表程序运行目录
-
“/” 代表当前盘符的根目录（特指 Windows 平台；Linux 平台当然就是根目录），这个参数也可以是平台相关的，比如“C:\\”等；
-
filter：过滤器。
我们使用文件对话框可以浏览很多类型的文件，但是，很多时候我们仅希望打开特定类型的文件。比如，文本编辑器希望打开文本文件，图片浏览器希望打开图片文件。过滤器就是用于过滤特定的后缀名。如果我们使用“Image Files(*.jpg *.png)”，则只能显示后缀名是 jpg 或者 png 的文件。如果需要多个过滤器，使用“;;”分割，比如“JPEG Files(*.jpg);;PNG Files(*.png)”；
-
selectedFilter：默认选择的过滤器；
-
options：对话框的一些参数设定
比如只显示文件夹等等，它的取值是enum QFileDialog::Option，每个选项可以使用 | 运算组合起来。
QFileDialog::getOpenFileName()返回值是选择的文件路径。我们将其赋值给 path。通过判断 path 是否为空，可以确定用户是否选择了某一文件。只有当用户选择了一个文件时，我们才执行下面的操作。
在saveFile()中使用的QFileDialog::getSaveFileName()也是类似的。使用这种静态函数，在 Windows、Mac OS 上面都是直接调用本地对话框，但是 Linux 上则是QFileDialog自己的模拟。这暗示了，如果你不使用这些静态函数，而是直接使用QFileDialog进行设置，那么得到的对话框很可能与系统对话框的外观不一致。这一点是需要注意的。
浙公网安备 33010602011771号