下载掌阅APP，畅读海量书库
立即打开
Qt Assistant（助手）是用来查看在线文档的工具。
Qt的安装包中包括Qt SDK的非常详尽的参考文档，每个模块（无论大小）都有概括性的介绍和使用指南，几乎每一个公开的类、每一个公开的API都有说明，连SDK中提供的示例都有简洁清晰的介绍。另外，还包括各种工具的使用手册（如qmake、Qt Creator、Assistant、Linguist、Designer等）……，而所有这些文档，都可以使用Assistant或者直接在Qt Creator IDE中查看。
独立使用Assistant
如果你想直接启动Assistant来查看文档，可以在“开始”菜单中找到它，单击它即可，见图2-37。
启动后界面如图2-38所示。
图2-37 “开始”菜单中的Assistant快捷方式
图2-38 Qt Assistant独立启动模式
在Assistant中，文档可以按内容、索引、搜索、书签等四种方式查找。具体怎么使用，根据个人习惯，用两次即可熟悉。
在Qt Creator中使用Assistant
独立运行的Assistant界面与集成在Qt Creator中的不太一样，不过基本用法都是一样的。图2-39是Qt Creator的欢迎界面，在此可以有两种方式启动Assistant，已经标注出来了。
我们以第一种方式来简要说明Assistant的基本用法（第二种启动方式，启动后看到的界面和内容与第一种一样），不会深入，学习完本节后可以通过索引模式输入“assistant”即可看到有关Assistant的更详尽的指南。
图2-39 Qt Creator打开Assistant的两种方式
如图2-39所示，单击标号为1的帮助按钮，Qt Creator会切换到Assistant界面，它可能以索引模式打开Assistant，也可能以目录模式打开，这取决于你上次用什么模式使用它。图2-40是我的电脑上的截图。
图2-40 Qt Creator中的帮助功能简介
标号为1的区域，通过单击可以在Assistant支持的“索引”、“书签”、“目录”、“查找”等几种模式间切换。如图2-40所示，单击区域1后，会弹出标号为3的下拉菜单，很方便就能切换到其他模式。
标号为2的编辑框，可以输入你想查看的文档的部分字符，Assistant会自动在下面展示它即时联想到的文档。
标号为4的是添加书签按钮，单击后可以把你关注的文档加入书签。
如果你想知道某个类，比如QObject的用法，索引模式可以最快的速度找到它的文档。
后面的讲解，如无特殊说明，都是在Qt Creator中使用Qt Assistant。
使用目录模式查看文档
如果你切换到目录模式，就可以像使用资源管理器一样使用Qt Assistant，一个目录一个目录地浏览，找到你感兴趣的主题就可以双击链接，对应的内容就可以在右侧窗口中显示出来。
如果你想知道Qt Assistant中都包含了哪些主题，或者你明确知道你想看的内容属于哪个模块，目录模式是最合适的。
图2-41是我通过目录模式，浏览Qt Network模块的QAbstractSocket类时截的图，可以说明目录模式的用法。
图2-41 Qt Creator中的帮助之目录模式
使用搜索（查找）模式
如果你记不住你要用的功能在哪个类中，仅仅有一点点线索，搜索模式可以帮助你。比如你想进行网络编程，知道“socket”这个关键字，就可以像图2-42一样搜索。
图2-42 Qt Creator中的帮助之检索模式
如果你知道要查找的功能的更多信息，可以打开“高级搜索”。比如你既知道“socket”又知道某个方法“connectToHost”，可以像图2-43这般进行搜索。
图2-43 Qt Creator中的帮助之高级搜索
使用书签模式
如果你之前已经把某些你喜欢的文档加入书签（前面已经讲过，可以回顾一下），下次就可以直接以书签模式使用Qt Assistant，如图2-44所示。
图2-44 Qt Creator中的帮助之书签模式
到这里为止，关于Qt Assistant的使用，已经介绍完了。之所以花较多的篇幅介绍Qt Assistant，是想让大家在日后的开发过程中，遇到问题能够首先问教于Assistant，而不是在互联网上漫无目的地搜索（其实挺浪费时间的，不只是搜索的时间，还有你翻看可能无关的搜索结果花费的时间和受到的影响所消耗的潜在时间），因为Qt Assistant包含了你使用Qt应用框架开发所需要的一切，它是体贴的、温柔的、高大全的、全知的、富而美的，只要你能静下心来学习，你遇到的绝大多数问题，都可以通过这种途径解决掉。
谨请善用之、善待之。