第7篇 实现Qt文本查找功能

版权声明

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

导语

这一篇我们来添加查找菜单的功能。因为本篇还会涉及Qt Creator很多实用功能，所以单独用一篇文章来介绍。以前都用设计器设计界面，而这次我们用代码实现一个简单的查找对话框。除了讲解怎么实现查找功能，还会详细介绍怎么进行类中方法的查找和使用，以及Qt Creator程序中怎样在函数的声明和定义间进行快速切换等内容。

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

正文

一、添加查找对话框

1.继续在前一篇程序的基础之上进行更改。首先到mainwindow.h文件中添加类的前置声明（对于什么是前置声明，以及这样使用的好处，可以自己百度一下）：

  1. class QLineEdit;
  2. class QDialog;

注意前置声明所在的位置跟头文件包含的位置相同。

然后在private部分添加对象定义：

  1. QLineEdit *findLineEdit;
  2. QDialog *findDlg;

下面再添加一个私有槽声明：

  1. private slots:
  2.     void showFindText();

2.下面到mainwindow.cpp文件中，因为前面在头文件中使用了类的前置声明，所以这里需要先添加头文件包含：

  1. #include

注意QLineEdit类的头文件以前已经包含过了，所以这次只包含QDialog的头文件。然后在构造函数中进行初始化操作，即添加如下代码：

  1. findDlg = new QDialog(this);
  2. findDlg->setWindowTitle(tr("查找"));
  3. findLineEdit = new QLineEdit(findDlg);
  4. QPushButton *btn= new QPushButton(tr("查找下一个"), findDlg);
  5. QVBoxLayout *layout= new QVBoxLayout(findDlg);
  6. layout->addWidget(findLineEdit);
  7. layout->addWidget(btn);
  8. connect(btn, &QPushButton::clicked, this, &MainWindow::showFindText);

这里创建了一个对话框，然后将一个行编辑器和一个按钮放到了上面，并使用布局管理器进行布局。最后将按钮的单击信号关联到了自定义的显示查找结果槽上。下面来添加该槽的定义。

3.这里先说一个可以快速从头文件声明处创建函数定义的方法。到mainwindow.h文件中，将鼠标定位到showFindText()函数上，然后点击右键，在弹出的菜单中选择“Refactor→在mainwindow.cpp添加定义”，如下图所示，或者直接使用Alt+Enter快捷键，这样就会直接在mainwindow.cpp文件中添加函数定义，并跳转到该函数处。

7-1快速添加定义.png

二、实现查找功能

下面我们分步完成showFindText()函数。在讲解过程中会介绍一些很实用的功能。

1.先在函数中添加一行代码来获取行编辑器中要查找的字符串。

  1. void MainWindow::showFindText()
  2. {
  3.    QString str = findLineEdit->text();
  4. }

2.在下一行，我们先输入ui，然后按下键盘上的“>.”键，这时就会自动输入“.”或者“->”，并且列出ui上所有可用部件的对象名。如下图所示。

7-2成员列表.png

3.我们要输入textEdit，先输入t，这时会自动弹出textEdit，只需按下回车键即可。如下图所示。

7-3自动补全.png

4.下面将光标放到textEdit上，这时就会出现QTextEdit类的简单介绍，如下图所示。

7-4简单介绍.jpg

5.按照提示，按下键盘上的F1键，就会在编辑器的右侧打开QTextEdit类的帮助文档。如下图所示。这时还可以按下上面的“Open in Help Mode”进入到帮助模式中打开该文档。

7-5打开帮助.png

6.我们在该类的Public Functions公共函数列表中发现有一个find()函数。如下图所示。

7-6找到find()函数.png

7.从字面意思上可以知道该函数应该是用于查找功能的，它有两种重载形式，我们单击第一个find函数进入到它的详细介绍处。如下图所示。

7-7find()函数介绍.png

8.根据介绍可以知道该函数用于查询指定的exp字符串，如果找到了就将光标跳转到查找到的位置，如果没有找到就返回false。这个函数还有一个QTextDocument::FindFlags参数，为了了解该参数的意思，我们点击该参数进入其详细介绍处。如下图所示。

7-8参数介绍.png

可以看到该参数是一个枚举变量，用来指定查找的方式，分别是向后查找、区分大小写、全词匹配等。如果不指定该参数，默认的是向前查找、不区分大小写、包含该字符串的词也可以查找到。这几个方式还可以使用“|”符号来一起使用。

9.根据帮助，我们补充完该行代码：

  1. ui->textEdit->find(str, QTextDocument::FindBackward);
  • 这时已经能实现查找的功能了。但是刚才看到find的返回值类型是bool型，而且，我们也应该为查找不到字符串作出提示。将这行代码更改为：
  1. if (!ui->textEdit->find(str, QTextDocument::FindBackward))
  2. {
  3.    QMessageBox::warning(this, tr("查找"),
  4.             tr("找不到%1").arg(str));
  5. }

这里的%1作为占位符，在显示时会被arg()中的参数替换掉，这是一种常用的在字符串中添加变量值的方式。现在查找函数的功能就基本实现了。

  • 我们会发现随着程序功能的增强，其中的函数也会越来越多，大家都会为查找某个函数的定义位置感到头疼。而在QtCreator中有几种快速定位函数的方法。 第一种，在函数声明的地方直接跳转到函数定义的地方。

例如我们在mainwindow.h文件的loadFile()函数上右击，在弹出的菜单上选择“Switch Between Function Declaration/Definition”，这时就会自动跳转到mainwindow.cpp文件中该函数的定义处。如下图所示。当然还可以反向使用。

7-9方法声明定义间切换.png

第二种，快速查看一个文件里的所有函数。

可以在编辑器正上方的下拉框里查看正在编辑的文件中所有的函数的列表，单击一个函数就会跳转到指定位置。如下图所示。

7-10函数列表.png

第三种，使用类视图或者大纲视图。

在项目列表上面的下拉框中可以更改查看的内容，如果选择为类视图或者大纲，则会显示文件中所有的函数的列表。如下图所示。

7-11视图模式.png

第四种，使用查找功能查看函数的所有调用处。在一个函数名上右击，然后选择“Find Usages”菜单，这时就会在下面的搜索结果栏中显示该函数所有的使用位置。我们可以通过点击一个位置来跳转到该位置。如下图所示。

7-12查找函数使用情况.png

第五种，使用定位器。

有的同学可能早就发现QtCreator左下方的搜索栏了，就是上面写着“Type to locate”的搜索栏，其实我们可以把它叫做定位器，因为使用它可以很方便地定位到一个文件、帮助文档或者函数等等你需要快速定位的内容。我们按下快捷键Ctrl+K，这时会显示出多个过滤器介绍及其功能前缀，如下图所示。

7-13定位器.png

使用定位器的格式就是“过滤器前缀+空格+要定位的内容”，比如这里定位当前打开文档中的closeEvent函数，那么可以输入“m closeE”来定位，如下图所示。

7-14定位函数.png

12.最后，我们来实现界面上的查找功能。从设计模式进入查找动作的触发信号的槽，更改如下：

  1. void MainWindow::on_action_Find_triggered()
  2. {
  3.    findDlg->show();
  4. }

这时运行程序，效果如下图所示。

7-15查找功能运行结果.png

结语

讲到这里，我们已经详细地讲解了怎样去使用一个类里面未接触过的函数；也讲解了Qt Creator中的一些便捷操作。可以看到，Qt Creator开发环境有很多很人性化的设计，大家应该熟练掌握这些操作，这样可以节省大量时间。在以后的文章中，我们不会再详细地去用帮助来说明一个函数是怎么来的，该怎么用，这些应该自己试着去查找。