Qt学习笔记2——文件对话框：QFileDialog

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

1.创建一个带有文本编辑功能的窗口

QTextEdit类： 用于显示文本文件。也就是说，它不仅仅用于显示文本，还可以显示图片、表格等等。不过，我们现在只用它显示纯文本文件。
QMainWindow有一个 setCentralWidget() 函数，可以将一个组件作为窗口的中心组件，放在窗口中央显示区。显然，在一个文本编辑器中，文本编辑区就是这个中心组件，因此我们将QTextEdit作为这种组件。

//MainWindow.cpp

//
void MainWindow::openFile()
{
    QString path = QFileDialog::getOpenFileName(this,
                                                tr("Open File"),
                                                ".",
                                                tr("Text Files(*.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 Files(*.txt)"));
    if(!path.isEmpty()) {
        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进行设置，就像我们前面介绍的 QMessageBox 的设置一样，那么得到的对话框很可能与系统对话框的外观不一致。

首先，我们创建一个QFile对象，将用户选择的文件路径传递给这个对象。然后我们需要打开这个文件，使用的是QFile::open()，其参数是指定的打开方式，这里我们使用只读方式和文本方式打开这个文件（因为我们选择的是后缀名 txt 的文件，可以认为是文本文件。当然，在实际应用中，可能需要进行进一步的判断）。QFile::open()打开成功则返回 true，由此继续进行下面的操作：使用QTextStream::readAll()读取文件所有内容，然后将其赋值给QTextEdit显示出来。 最后不要忘记关闭文件。

另外，saveFile()函数也是类似的，只不过最后一步，我们使用<<重定向，将QTextEdit的内容输出到一个文件中。 关于文件操作，我们会在后面的章节中进一步介绍。

注意： 我们的代码仅仅是用于演示，很多必须的操作并没有进行。比如：我们没有检查这个文件的实际类型是不是一个文本文件。并且，我们使用了QTextStream::readAll()直接读取文件所有内容，如果这个文件有 100M，程序会立刻死掉。【这些都是实际程序必须考虑的问题】

2.Qt中的explicit关键字

public:
    explicit MainWindow(QWidget *parent = 0);

关键字 explicit： 可以禁止“单参数构造函数”被用于自动类型转换，声明为explicit的构造函数不能在隐式转换中使用。C++中， 一个参数的构造函数(或者除了第一个参数外其余参数都有默认值的多参构造函数)， 承担了两个角色。一是个构造器，二是个默认且隐含的类型转换操作符。