• 第6篇 实现Qt文本编辑功能
    • 版权声明
    • 导语
    • 正文
    • 结语

    第6篇 实现Qt文本编辑功能

    版权声明

    该文章原创于Qter开源社区（ http://www.qter.org ），作者 yafeilinux ，转载请注明出处！ 可以到 这里 讨论本文章！

    导语

    前面已经在主窗口中添加了菜单和工具栏，这一篇我们将实现基本的文本编辑功能。在开始正式写程序之前，先要考虑一下整个流程。因为这里要写一个记事本一样的程序，所以最好先打开Windows中的记事本，进行一些简单的操作，然后考虑怎样去实现这些功能。再者，再强大的软件，它的功能也是一个一个加上去的，不要设想一下子写出所有的功能。我们这里先实现新建文件、保存文件和文件另存为三个功能，然后再添加其他功能。

    环境：Windows 7 + Qt 5.8.0（包含QtCreator 4.2.1）

    正文

    一、实现新建文件、文件保存和另存为功能

    1.首先来分析下整个流程，当新建文件时，要考虑是否保存正在编辑的文件，如果需要保存，还要根据该文件以前是否保存过，从而进行保存或者另存为操作。下面我们根据这里的分析来添加需要的函数和对象。

    2.首先打开Qt Creator，然后打开上一篇的项目。

    3.在mainwindow.h文件类声明的public部分进行函数声明：

    1. void newFile();   // 新建操作
    2. bool maybeSave(); // 判断是否需要保存
    3. bool save();      // 保存操作
    4. bool saveAs();    // 另存为操作
    5. bool saveFile(const QString &fileName); // 保存文件

    这里的几个函数就是用来完成功能逻辑的，下面会添加它们的定义来实现相应的功能。因为这几个功能联系紧密，所以这几个函数会相互调用。

    4.然后在private部分添加变量定义：

    1. // 为真表示文件没有保存过，为假表示文件已经被保存过了
    2. bool isUntitled;
    3. // 保存当前文件的路径
    4. QString curFile;

    这里的isUntitled是一个标志，用来判断文档是否被保存过，而curFile用来保存当前打开的文件的路径。

    5.下面到mainwindow.cpp文件，先添加头文件包含：

    1. #include <QMessageBox>
    2. #include <QPushButton>
    3. #include <QFileDialog>
    4. #include <QTextStream>

    然后在构造函数中添加如下代码来进行一些初始化操作：

    1. // 初始化文件为未保存状态
    2. isUntitled = true;
    3. // 初始化文件名为"未命名.txt"
    4. curFile = tr("未命名.txt");
    5. // 初始化窗口标题为文件名
    6. setWindowTitle(curFile);

    这里设置了在启动程序时窗口标题显示文件的名字，效果如下图所示。

    6-1显示窗口标题.jpg

    6.下面添加那几个函数的定义。首先添加新建文件操作的函数：

    6-3.png

    这里先使用maybeSave()来判断文档是否需要保存，如果已经保存完了，则新建文档，并进行初始化。下面添加maybeSave()函数的定义：

    6-4.png

    这里先使用了isModified()来判断文档是否被更改了，如果被更改了，则弹出对话框让用户选择是否进行保存，或者取消操作。如果取消操作，那么就返回false，什么都不执行。下面添加save()函数的定义：

    6-5.png

    如果文档以前没有保存过，那么执行另存为操作saveAs()，如果已经保存过，那么调用saveFile()执行文件保存操作。下面添加saveAs()函数的定义：

    6-6.png

    这里使用QFileDialog来实现了一个另存为对话框，并且获取了文件的路径，然后使用文件路径来保存文件。下面添加saveFile()函数的定义：

    6-7.png

    该函数执行真正的文件保存操作。先是使用一个QFile类对象来指向要保存的文件，然后使用文本写入方式将其打开。打开后再使用QTextStream文本流将编辑器中的内容写入到文件中。这里使用了很多新的类，以后对自己不明白的类都可以去帮助里进行索引，这也许是我们以后要做的最多的一件事了。对于其中的英文解释，最好想办法弄明白大意，其实网上也有一些中文的翻译，但最好还是从一开始就尝试着看英文原版的帮助，这样以后才不会对中文翻译产生依赖。

    7.设置菜单功能。双击mainwindow.ui文件，在图形界面窗口下面的Action编辑器里，我们右击“新建”菜单一条，选择“转到槽”，然后选择triggered（），进入其触发事件槽。如下图所示。

    6-2转到动作的槽.png

    同理，进入其他两个菜单的槽，将相应的操作的函数写入槽中。最终代码如下：

    6-8.png

    现在运行程序，已经能够实现新建文件、保存文件和文件另存为的功能了。

    二、实现打开、关闭、退出、撤销、复制、剪切、粘贴等功能

    先到mainwindow.h文件中添加public函数声明：

    1. bool loadFile(const QString &fileName); // 加载文件

    然后到mainwindow.cpp文件中添加该函数的定义：

    6-9.png

    这里的操作和saveFile()函数是相似的。下面到设计模式，分别进入其他几个动作的触发信号的槽，更改如下：

    6-10.png

    6-11.png

    可以看到，这里复制、粘贴等常用功能QTextEdit已经实现了，我们只需要调用相应的函数即可。虽然实现了退出功能，但是，有时候会使用窗口标题栏的关闭按钮来关闭程序，这里我们需要使用关闭事件处理函数来实现相应的功能。

    下面到mainwindow.h文件中，先添加头文件包含#include ，然后添加函数声明：

    1. protected:
    2.     void closeEvent(QCloseEvent *event); // 关闭事件

    然后到mainwindow.cpp文件中添加该函数的定义： 6-12.png

    现在可以再次运行程序，测试各个功能。关于事件的概念，会在后面的教程中讲解。

    结语

    这一篇中实现了最基本的编辑功能，现在还剩下查找和帮助菜单没有实现，这个会在下一篇进行介绍。如果大家想学习一个更完整的文本编辑器的实现，可以参考《Qt及QtQuick开发实战精解》一书的第1章。