学习笔记之Qt从入门到精通（一）

整理日期： 2010年4月9日

曾经研究过的技术，现在编辑分享出来，很长，需要分三个链接来发布，大家耐心点看吧。

经常有人问哪里有学习Qt 的资料，Qt 的教程，怎么才能入门等等，或者抱怨说中文的信息太少。其实网上有很多关于Qt 的学习资料，今天在这里总结一下，希望各位想学习Qt 的同学，各取所需，早日从入门到精通！ 关于本教程： 本教程是基于您已经了解C++的基础之上，毕竟Qt 是一个C++库。否则您必须先学习c++后再来看本教程，C++入门比较好的书籍是《C++程序设计》(谭浩强)。 某些人可能觉得《c++ primer》好，但我认为这本书不适合c++入门，所以还是推荐一下谭老的这本通俗易懂的书吧。 教程由3 部分组成，第一部分为新手上路,是Qt 的官方教程。其实把它放在第一部分并不合适，因为对于一个初学Qt 的人来说一上来就将最好是从一个HelloWorld 程序开始学习比较好。所以推荐初学者从第二部分Qt 学习之路开始阅读。 第三部分为Qt 深入编程，对Qt 很熟悉的读者可以深入研究研究。教程中的所有代码必须联网才能下载，给您造成的不便之处本人感到非常抱歉。

本教程介绍了使用 Qt 跨平台框架的 GUI 编程。 在学习过程中，我们将了解部分 Qt 基本技术，如  Widget 和布局管理器  容器类  信号和槽  输入和输出设备 如果您完全不了解 Qt，请阅读如何学习 Qt（如果您还未阅读）。 教程的源代码位于 Qt 的 examples/tutorials/addressbook 目录下。 教程章节：

文件：  tutorials/addressbook/part1/addressbook.cpp  tutorials/addressbook/part1/addressbook.h  tutorials/addressbook/part1/main.cpp  tutorials/addressbook/part1/part1.pro 本教程的第一部分讲述了用于地址簿应用程序的基本图形用户界面 (GUI) 的设 计。 创建 GUI 程序的第一步就是设计用户界面。在本章中，我们的目标是设置应用 基本地址簿应用程序所需的标签和输入字段。下图为期望输出的屏幕截图。 我们需要使用两个 QLabel 对象：nameLabel 和 addressLabel，以及两个输入 字段：QLineEdit 对象 nameLine 和 QTextEdit 对象 addressText，这样用户 才能输入联系人的姓名和地址。使用的 widget 及其位置如下图所示。 要应用地址簿需使用三个文件：  addressbook.h — AddressBook 类的定义文件，  addressbook.cpp — AddressBook 类的执行文件，以及  main.cpp — 包含 main() 函数并带有 AddressBook 实例的文件。

在编写 Qt 程序时，我们通常使用 Qt 对象子类来添加功能。这是创建定制 widget 或标准 widget 集合的基本概念之一。使用子类扩展或改变 widget 的 操作具有以下优势：  我们可以编写虚函数或纯虚函数应用，以得到我们确切所需的功能，并在需要时再 使用基本的类应用。  这样我们就可以在类中封装部分用户界面，应用程序的其他部分也就无需了解用户 界面中单独使用的 widget。  可使用子类在同一应用程序或库中创建多个定制 widget，这样子类的代码可在其他 项目重复使用。 由于 Qt 未提供特定的地址簿 widget，我们在标准的 Qt widget 类中使用子 类，然后添加功能。我们在本教程中创建的 AddressBook 类在需要使用基本地 址簿 widget 的情况下可重复使用。 定义 AddressBook 类 addressbook.h 文件用于定义 AddressBook 类。 我们从定义 AddressBook 为 QWidget 子类和声明构造器开始入手。我们还使用 Q_OBJECT 宏表明该类使用国际化功能与 Qt 信号和槽功能，即使在本阶段不会 用到所有这些功能。

该类包含了 nameLine 和 addressText 的声明、上文提到的 QLineEdit 和 QTextEdit 的私有实例。在以后章节中，您会看到储存在 nameLine 和 addressText 中的数据在地址簿的许多功能中都会用到。 我们不必包含要使用的 QLabel 对象的声明，这是因为在创建这些对象后我们不 必对其进行引用。在下一部分中，我们会说明 Qt 记录对象所属关系的方式。 Q_OBJECT 宏本身应用了部分更高级的 Qt 功能。 我们暂时把 Q_OBJECT 宏理解 为使用 tr() 和 connect() 函数的快捷方式，这种理解对我们的学习更有用。 我们现已完成 addressbook.h 文件，接下来我们来执行对应的 addressbook.cpp 文件。

AddressBook 的构造器接收 QWidget 参数 parent。按惯例，我们将参数传递给 基本类的构造器。这种父项可有一个或多个子项的所属概念对 Qt 中的 widget 分组十分有用。例如，如果删除父项，也会删除其所有子项。

在该构造器中，我们声明并通过实例来表示两个局部 QLabel 对象 nameLabel 和 addressLabel，以及 nameLine 和 addressText。如果字符串已进行转换， 则 tr() 函数返回已转换的字符串，否则返回字符串本身。我们可以将此函数理 解 标识来标记要进行转换 QString 对象。在以后 章节和 Qt Examples 中，您会看到只要使用了可转换的字符串就是使用该函数。 使用 Qt 编程时，了解布局是如何起作用的会对您很有帮助。Qt 提供三个主要 布局类 QHBoxLayout、QVBoxLayout 和 QGridLayout 来处理 widget 的位置。 我们使用 QGridLayout 以结构化的方式放置标签和输入字段。QGridLayout 将 可用空间分为网格，并将 widget 放置在指定了行列号的单元格中。上面的图表 显示了布局单元格和 widget 的位置。我们通过以下代码指定这种排列方式：

请注意，addressLabel 是使用作为附加参数的 Qt::AlignTop 来排放位置。这 可确保其不会纵向放置在单元格 (1,0) 中央。有关 Qt 布局的基本简介，请参 见布局类文档。 要在 widget 上安装布局对象，必须调用 widget 的 setLayout() 函数：

最后，我们将 widget 标题设置为“简单地址簿”。

main() 函数使用单独的文件 main.cpp。在该函数中，我们实例化了 QApplication 对象 app。QApplication 负责管理多种应用范围的资源（如默认 字体和光标），以及运行事件循环。因此，在每个使用 Qt 的 GUI 应用程序中 都会有一个 QApplication 对象。

我们使用 new 关键字在堆中构造一个新的 AddressBook widget，然后调用 show() 函数对其进行显示。不过，该 widget 只有在应用程序事件循环开始时 才会显示。我们通过调用应用程序的 exec() 函数开始事件循环。该函数返回的 结果作为 main() 函数的返回值。

文件：  tutorials/addressbook/part2/addressbook.cpp  tutorials/addressbook/part2/addressbook.h  tutorials/addressbook/part2/main.cpp  tutorials/addressbook/part2/part2.pro 创建基本地址簿应用程序的下一步是添加少许用户互动操作。 我们将提供一个按钮，用户可点击该按钮来添加新联系人。此外，还需要对数据 结构进行限定，以便有序地储存这些联系人。

由于已经设置了标签和输入字段，我们只需添加按钮就可完成添加联系人这一步 骤。也就是说，在 addressbook.h 文件中已经声明了三个 QPushButton 对象和 三个对应的公共槽。

槽是对特殊信号进行响应的函数。我们将在应用 AddressBook 类时进一步详细 说明这一概念。如需有关 Qt 信号和槽概念的简介，请参见信号和槽文档。 三个 QPushButton 对象分别是 addButton、submitButton 和 cancelButton， 已与要在上一章中说明的 nameLine 和 addressText 一同包含在私有变量声明 中。

我们需要一个容器来储存地址簿联系人，这样才能搜索和显示联系人。QMap 对 象 contacts 就可实现此功能，因为其带有一个键-值对：联系人姓名作为键， 而联系人地址作为值。

我们还会声明两个私有 QString 对象：oldName 和 oldAddress。这些对象用来 保留在用户点击添加时最后显示的联系人姓名和地址。这样，当用户点击取消时， 我们就可以返回至上一个联系人的详细信息。

在 AddressBook 构造器中，我们将 nameLine 和 addressText 设置为只读，这 样就可仅显示而不必编辑现有联系人的详细信息。

然后，我们实例化以下按钮：addButton、submitButton 和 cancelButton。

显示 addButton 是通过调用 show() 函数实现的，而隐藏 submitButton 和 cancelButton 则需调用 hide()。这两个按钮仅当用户点击添加时才会显示，而 此操作是通过在下文中说明的 addContact() 函数处理的。

我们将按钮的 clicked() 信号与其相应的槽关联。下面的图表说明了此过程。 接下来，我们将按钮整齐的排列在地址簿 widget 的右侧，使用 QVBoxLayout 将 其进行纵向排列。

addStretch() 函数用来确保按钮并不是采用均匀间隔排列的，而是更靠近 widget 的顶部。下图显示了是否使用 addStretch() 的差别。 然后，我们使用 addLayout() 将 buttonLayout1 增加至 mainLayout。 这样我 们就有了嵌套布局，因为 buttonLayout1 现在是 mainLayout 的子项。

布局坐标显示如下： 在 addContact() 函数中，我们使用 oldName 和 oldAddress 储存最后显示的 联系人详细信息。然后，我们清空这些输入字段并关闭只读模式。输入焦点设置 在 nameLine，显示 submitButton 和 cancelButton。

submitContact() 函数可分为三个部分： 我们从 nameLine 和 addressText 提取联系人的详细信息，然后将其储存在 QString 对象中。我们还要验证确保用户没有在输入字段为空时点击提交，否则， 会显示 QMessageBox 提示用户输入姓名和地址。

我们接着继续检查是否联系人已存在。如果不存在，将联系人添加至 contacts， 然后显示 QMessageBox 提示用户已添加联系人。

如果联系人已存在，还是会显示 QMessageBox 以提示用户，以免添加重 复的联系人。由于 contacts 对象是基于姓名地址的键-值对，因此要确 保键唯一。 在处理了上述两种情况后，使用以下代码将按钮恢复为正常状态：

下面的屏幕截图显示了用于向用户显示提示信息的 QMessageBox 对象。 cancel() 函数恢复上次显示的联系人详细信息，并启用 addButton，还会隐藏 submitButton 和 cancelButton。

添加联系人的总体思想就是提高用户操作的灵活性，可在任何时候点击提交或取 消。下面的流程图详细说明了此概念：

文件：  tutorials/addressbook/part3/addressbook.cpp  tutorials/addressbook/part3/addressbook.h  tutorials/addressbook/part3/main.cpp  tutorials/addressbook/part3/part3.pro 构建地址簿应用程序现已进展过半。我们需要增加一些函数，以便浏览联系人。 但首先要决定采用何种数据结构方式来储存这些联系人。 在第二章中，我们使用了 QMap 键-值对，即联系人姓名作为键，而联系人地址 作为值。这种方式很适合我们的实例。不过，要浏览和显示每个条目，还需要进 行一些改进。 我们改进 QMap 的方式是，将数据结构替换为类似循环链接的列表，其中所有元 素都是相互关联的，包括第一个元素和最后一个元素。下图图解说明了该数据结 构。

要给地址簿应用程序增加浏览功能，我们需要为 AddressBook 类再增加两个函 数：next() 和 previous()。将这两个函数添加到 addressbook.h 文件中：

我们还需要使用其他两个 QPushButton 对象，因此将 nextButton 和 previousButton 声明为私有变量：

在 addressbook.cpp 的 AddressBook 构造器中，我们实例化 nextButton 和 previousButton，并且这两项默认为禁用。这是因为仅当地址簿中有多个联系人 时才会启用浏览功能。

然后，我们将这两个按钮与其相应的槽关联：

下图即为预期的图形用户界面。请注意，该用户界面已很接近应用程序最终的样子。 我们按照 next() 和 previous() 函数的基本规范，将 nextButton 放置在右 侧，而 previousButton 放置在左侧。为了使布局更加直观，我们使用 QHBoxLayout 将 widget 并排放置：

然后，将 QHBoxLayout 对象 buttonLayout2 增加至 mainLayout。

下图显示了 widget 在 mainLayout 中的坐标位置。 在 addContact() 函数中，我们必须禁用这几个按钮，这样用户就不会在增加联 系人时尝试进行浏览。

此外，在 submitContact() 函数中，我们启用了浏览按钮 nextButton 和 previousButton，这取决于 contacts 的多少。如上文所述，浏览功能仅在地址 簿中有多个联系人时才会启用。以下代码行说明了如何实现此功能：

我们还在 cancel() 函数中加入这几行代码。 记得我们曾使用 QMap 对象 contacts 模拟了一个循环链接的列表。因此，在 next() 函数中，我们获取 contacts 的迭代器，然后执行以下操作：  如果迭代器未达到 contacts 结尾，就会增加一。  如果迭代器已达到 contacts 的结尾，就移至 contacts 的起始位置。这给人感 觉 QMap 就像是一个循环链接的列表。

一旦在 contacts 中循环至正确的对象，就会通过 nameLine 和 addressText 显示对象的内容。 同样，在 previous() 函数中，我们获取 contacts 的迭代器，然后执行以下操 作：  如果迭代器达到 contacts 的结尾，就清除显示内容，然后返回。  如果迭代器在 contacts 的起始位置，就将其移至结尾。  然后，将迭代器减一。

接着，重新显示 contacts 中当前对象的内容。

文件：  tutorials/addressbook/part4/addressbook.cpp  tutorials/addressbook/part4/addressbook.h  tutorials/addressbook/part4/main.cpp  tutorials/addressbook/part4/part4.pro 在本章中，我们将了解如何修改储存在地址簿应用程序中的联系人的内容。 现有的地址簿不仅可以井井有条地储存联系人，还可进行浏览。再添加上编辑和 删除功能，以便在需要时更改联系人的详细信息，这样更易于使用。不过，还需 使用 enum 类型进行一些改进。在前几章中，我们使用以下两种模式：AddingMode 和 NavigationMode。但是，他们并未定义为 enum。我们是采用手动方式启用和 禁用相应的按钮，这就导致有多行重复的代码。 在本章中，我们定义带有以下三种不同值的 Mode enum 类型：  NavigationMode、  AddingMode 和  EditingMode。

addressbook.h 文件已更新为包含 Mode enum 类型： enum Mode { NavigationMode, AddingMode, EditingMode }; 我们还要向当前的公有槽列表增加两个新槽：editContact() 和

为了在模式间切换，我们引入了 updateInterface() 函数来控制所有 QPushButton 对象的启用和禁用。要实现上文提及的编辑和删除功能，我们还要 增加两个新按钮：editButton 和 removeButton。

最后，我们声明 currentMode 来跟踪 enum 的当前模式。

我们现在必须应用地址簿应用程序的模式更改功能。editButton 和 removeButton 已实例化并默认为禁用，这是因为地址簿启动时在内存中没有联 系人。

这些按钮会与其相应的槽 editContact() 和 removeContact() 关联，然后我们 将其添加至 buttonLayout1。

在将模式切换到 EditingMode 之前，editContact() 函数使用 oldName 和 oldAddress 储存联系人旧的详细信息。 在该模式下，submitButton 和 cancelButton 均已启用，这样用户就可以更改联系人的详细信息并可点击任何一个按钮。

submitContact() 函数已被 if-else 语句分为两部分。我们查看 currentMode 是否在 AddingMode 模式下。如果是，我们继续添加操作。

否则，我们查看 currentMode 是否在 EditingMode 模式下。如果是，我们比较 oldName 和 name。如果姓名已更改，我们从 contacts 中删除旧的联系人并插 入已更新的联系人。

如果仅更改了地址（例如 oldAddress 与 address 不同），我们就更新联系人 的地址。最后，我们将 currentMode 设置为 NavigationMode。这一步至关重要， 因为它会重新启用所有已禁用的按钮。 要从地址簿中删除联系人，我们采用 removeContact() 函数。该函数查看 contacts 中是否包含该联系人。

如果有，我们显示 QMessageBox，确认用户的删除操作。一旦用户确认操作，我们调用 previous() 确保用户界面显示其他联系人，然后我们使用 QMap 的remove() 函数删除已已确认的联系人。出于好意，我们会显示 QMessageBox 提示用户。在该函数中使用两种信息框显示如下：

我们在上文提到 updateInterface() 函数，它可根据当前的模式启用和禁用按 钮。该函数会根据传递给它的 mode 参数更新当前的模式，在校验值之前将参数 分配给 currentMode。 这样，每个按钮就根据当前的模式进行启用或禁用。AddingMode 和 EditingMode 的代码显示如下：

不过对于 NavigationMode，我们在 QPushButton::setEnabled() 函数的参数中加入了条件。这样可确保 editButton 和 removeButton 在地址簿中至少有一个联系人的情况下启用，而 nextButton 和 previousButton 仅在地址簿中有多个联系人时才启用。

通过在同一函数中设置模式和更新用户界面，我们可以避免用户界面与应用程序 内部状态不同步的可能性。

文件：  tutorials/addressbook/part5/addressbook.cpp  tutorials/addressbook/part5/addressbook.h  tutorials/addressbook/part5/finddialog.cpp  tutorials/addressbook/part5/finddialog.h  tutorials/addressbook/part5/main.cpp  tutorials/addressbook/part5/part5.pro 在本章中，我们将了解如何在地址簿应用程序中定位联系人和地址。 随着我们不断为地址簿应用程序添加联系人，使用下一个和上一个按钮浏览联系人就会变得很繁琐。在这种情况下，使用查找函数查找联系人就会更加有效。上面的屏幕截图显示了查找按钮及其在按钮面板上的位置。 当用户点击查找按钮时，有必要显示一个对话框，用户可在其中输入联系人的姓名。Qt 提供了 QDialog（我们会在本章中将其用作子类），可使用 FindDialog 类。

要使用 QDialog 的子类，我们首先要在 finddialog.h 文件中声明 QDialog 的 头信息。此外，我们还使用向前 (forward) 声明来声明 QLineEdit 和 QPushButton，这样我们就能在对话框类中使用这些 widget。 因为在 AddressBook 类中，FindDialog 类包含了 Q_OBJECT 宏，并且其构造器 已定义为接收父级 QWidget，即使对话框以单独的窗口方式打开。

我们定义了公有函数 getFindText()，供实例化 FindDialog 的类使用，这样这 些类可以获取用户输入的文本。公有槽 findClicked() 定义为在用户点击查找 按钮时处理搜索字符串。 最后，我们定义私有变量 findButton、lineEdit 和 findText，分别对应查找 按钮、用户输入搜索字符串的行编辑框和储存搜索字符串供稍后使用的内部字符 串。

在 FindDialog 的构造器中，我们设置私有变量 lineEdit、findButton 和 findText。使用 QHBoxLayout 放置 widget。

我们设定布局和窗口标题，并将信号与其各自的槽关联。请注意，findButton 的 clicked() 信号已与 findClicked() 和 accept() 关联。QDialog 提供的 accept() 槽会隐藏对话框并将结果代码设置为 Accepted。我们使用该函数有助 于 AddressBook 的 findContact() 函数知晓 FindDialog 对象关闭的时间。我 们在讨论 findContact() 函数时将对该函数做进一步说明。 在 findClicked() 中，我们验证 lineEdit 以确保用户没有在尚未输入联系人 姓名时就点击查找按钮。然后，我们将 findText 设置为从 lineEdit 提取的搜 索字符串。之后，我们清空 lineEdit 的内容并隐藏对话框。

findText 变量已有公有 getter 函数 getFindText() 与其相关联。既然我们仅 在构造器和 findClicked() 函数中直接设定了 findText， 我们就不在创建 getFindText() 的同时再创建 setter 函数。由于 getFindText() 是公有的， 实例化和使用 FindDialog 的类可始终读取用户已输入并确认的搜索字符串。

要确保我们可使用 AddressBook 类中的 FindDialog，我们要在 addressbook.h 文件中包含 finddialog.h。

至此，所有地址簿功能都有了 QPushButton 和对应的槽。同样，Find 功能有

最后，我们声明私有变量 dialog，用于引用 FindDialog 的实例。

在实例化对话框后，我们可能会对其进行多次使用。使用私有变量可在类中不同 位置对其进行多次引用。

在 AddressBook 类的构造器中，实例化私有对象 findButton 和 findDialog：

接下来，将 findButton 的 clicked() 信号与 findContact() 关联。 connect(findButton, SIGNAL(clicked()), this, SLOT(findContact())); 现在唯一要完成的就是 findContact() 函数的编码：

我们从显示 FindDialog 的实例 dialog 开始入手。这时用户开始输入联系人姓 名进行查找。用户点击对话框的 findButton 后，对话框会隐藏，并且结果代码 设置为 QDialog::Accepted.这样就确保了 if 语句始终为真。 然后，我们就开始使用 FindDialog 的 getFindText() 函数提取搜索字符串， 这个字符串也就是本例中的 contactName。如果地址簿中有联系人，就立即显示 该联系人。否则，显示如下所示的 QMessageBox 表明搜索失败。

文件：  tutorials/addressbook/part6/addressbook.cpp  tutorials/addressbook/part6/addressbook.h  tutorials/addressbook/part6/finddialog.cpp  tutorials/addressbook/part6/finddialog.h  tutorials/addressbook/part6/main.cpp  tutorials/addressbook/part6/part6.pro 本章描述了用于编写地址簿应用程序的加载和保存程序所使用的 Qt 文件处理 功能。 虽然浏览和搜索联系人是非常实用的功能，但只有在可以保存现有联系人并可以 在以后加载的前提下地址簿才真正完全可用。Qt 提供大量用于输入和输出的类， 但我们只选择两个易于合并使用的类：QFile 和 QDataStream。 QFile 对象表示磁盘上可读取和写入的文件。QFile 是代表多种不同设备且应用 更广的 QIODevice 类的子类。 QDataStream 对象用于按顺序排列二进制数据，以便储存在 QIODevice 中并供 以后检索。读取或写入 QIODevice 就如同打开数据流，然后读取或写入一样简 单，只是参数为不同的设备。

我们声明两个公有槽 saveToFile() 和 loadFromFile()，以及两个

在构造器中，我们实例化 loadButton 和 saveButton。理想情况下，将按钮标 签设置为“从文件加载联系人”和“将联系人保存至文件”会更方便用户使用。 不过，由于其他按钮的大小限制，我们将标签设置为加载…和保存…。幸运的 是，Qt 提供了使用 setToolTip() 来设置工具提示的简单方式，我们可通过如 下方式将其用于按钮：

虽然此处没有显示，但与其他应用的功能一样，我们在右侧的布局面板 button1Layout 上添加按钮，然后将按钮的 clicked() 信号与其相应的槽关联。 至于保存功能，我们首先使用 QFileDialog::getSaveFileName() 获取 fileName。 这是 QFileDialog 提供的一个便捷功能，可弹出样式文件对话框并 允许用户输入文件名或选择现有的 .abk 文件。.abk 文件是保存联系人时创建 的地址簿扩展名。

弹出的文件对话框屏幕截图显示如下： 如果 fileName 不为空，我们就使用 fileName 创建 QFile 对象 file。 QFile 与 QDataStream 一同使用，这是因为QFile 是 QIODevice。 接下来，我们尝试以 WriteOnly 模式打开文件。如果未能打开，会显示 QMessageBox 提示用户。

否则，会用实例表示 QDataStream 对象 out，以写入打开的文件。QDataStream 要求读写操作需使用相同版本的数据流。在将数据按顺序写入 file 之前，将使 用的版本设置为采用 Qt 4.5 的版本就可确保版本相同。

否则，会用实例表示 QDataStream 对象 in，按上文所述设置其版本，然后将按 顺序排列的数据读入 contacts 数据结构。请注意，在将数据读入之前清空 contacts 可简化文件读取过程。更高级的方法是将联系人读取至临时 QMap 对 象，然后仅复制 contacts 中不存在的联系人。

要显示从文件中读取的联系人，必须要先验证获取的数据，以确保读取的文件实 际包含地址簿联系人。如果为真，显示第一个联系人，否则显示 QMessageBox 提 示出现问题。最后，我们更新界面以相应地启用和禁用按钮。

文件：  tutorials/addressbook/part7/addressbook.cpp  tutorials/addressbook/part7/addressbook.h  tutorials/addressbook/part7/finddialog.cpp  tutorials/addressbook/part7/finddialog.h  tutorials/addressbook/part7/main.cpp  tutorials/addressbook/part7/part7.pro 本章讲述了部分可使地址簿应用程序日常使用更加便捷的附加功能。 虽然地址簿应用程序其自身功能已经很实用，但是如果可和其他应用程序互换联 系人数据就会更加有益。vCard 格式是一种流行的文件格式，就可用于此目的。 在本章中，我们会扩展地址簿客户端，可将联系人导出到 vCard .vcf 文件中。

我们在 addressbook.h 文件的 AddressBook 类中添加 QPushButton 对象 exportButton 以及对应的公有槽 exportAsVCard()。

在 AddressBook 构造器中，我们将 exportButton 的 clicked() 信号连接至 exportAsVCard()。我们还会将该按钮添加至 buttonLayout1，它是负责右侧按 钮面板的布局类。 在 exportAsVCard() 函数中，我们从提取 name 中联系人姓名开始入手。我们 声明 firstName、lastName 和 nameList。接下来，我们查找 name 中第一处空 白的索引。如果有空白，就将联系人的姓名分隔为 firstName 和 lastName。然 后，将空白替换为下划线 ("_")。或者，如果没有空白，就认定联系人只有名字。

至于 saveToFile() 函数，会打开文件对话框，让用户选择文件的位置。通过选 择的文件名称，我们创建要写入的 QFile 实例。 我们尝试以 WriteOnly 模式打开文件。如果操作失败，会显示 QMessageBox 提 示用户出现问题并返回。否则，将文件作为参数传递给 QTextStream 对象 out。 与 QDataStream 类似，QTextStream 类提供了读取纯文本和将其写入到文件的 功能。因此，所生成的 .vcf 文件可以在文本编辑器中打开进行编辑。

然后，我们写出依次带有 BEGIN:VCARD 和 VERSION:2.1 标记的 vCard 文件。 联系人的姓名使用 N: 标记写入。至于写入 vCard “File as”属性的 FN: 标 记，我们必须要查看是否联系人带有姓。如果联系人有姓，就使用 nameList 中 的详细信息填入该标记。否则，仅写入 firstName。