QT的学习（一）如何查阅QT文档？（以QPushButton为例）

一、为什么写这篇文章？

• QT接口繁多，可以但没必要掌握所有的接口
• 网上的信息参差不齐、零散且难以完全适用当前文档
• QT的帮助文档全面、权威
• QT文档可以离线查找

二、文档概览

点击查看QT5.15在线帮助文档：https://doc.qt.io/qt.html#qt5。每个版本都会提供三个方面的内容:

• Qt Framework 框架（API）
  Intuitive APIs for C++ and JavaScript-like programming with Qt Quick for rapid UI creation.

• Qt Creator IDE 编译器（IDE）
  A powerful cross-platform integrated development environment, including UI designer tools and on-device debugging.

• Tools and Toolchains 工具和编译链
  Internationalization support, embedded toolchains, Build with CMake, and more.

开发中常用的模块（Modules）可以在这里查看：https://doc.qt.io/qt-5/qtmodules.html#qt-essentials，它分为基础模块和附加模块，大多数QT程序都会用到基础模块，某些场合可能会使用到附加模块（线程、串口、网络等）。

基础模块

点进去你可以看到对这个模块的简单介绍，和配置使用的方法（cmake qmake），相关类和一些使用的例子。以Qt Serial Port为例：

对于我们使用的每一个类，必然属于某个模块下的，使用前需要进行链接。

三、更适合开发使用的查询方式

查看某个类的用法，除了通过上述的方法查阅文档（由上至下），还能使用离线帮助文档，相较于在线方式，离线文档更加适合开发，Qt的帮助系统可以帮助你：

• 根据模块查看帮助信息（这一点和在线一样）
• 可以检索关键字
• 源代码中直接检索
• 帮助文档书签

这里以QPushButton为例，下面是我的源代码编辑界面：

选中对应的关键字QPushButton，按下F1直接进入帮助界面对应类的位置，这个界面位于右侧。

在当前帮助页最上边我们可以查看知道以下信息：

• QT 5.15 类的版本信息
• Qt Widgets 模块名
• C++ classes 模块下的类
• QPushButton 具体类名
• 类的帮助信息

类的帮助信息包括以下部分：

• 属性
  
• 公共函数（构造函数、析构函数、普通方法）
  
• 重新实现的公有函数
  
  一些默认的size.

那么我们最关心的信号与槽呢？别担心，如果没有看到信号，那么就肯定在继承的信号中，我们在类的描述中看到了QPushButton是继承了QAbstractButton的，点击进去QAbstractButton就可以看到QPushButton拥有的信号与槽了：

下次写信号与槽再也用担心写不对啦！下一篇内容预告： 信号与槽的机制