上周给大家推荐了新书Python Qt GUI与数据可視化编程受到了广大读者的青睐，很多人问我何时上架什么时间预订？能不能给发完整目录需要这种知识很久了等回应。今天可以告诉大家这本书上架啦！！！！

本书介绍在Python中使用PyQt5和其他模块进行GUI和数据可视化编程的方法。第一部分介绍PyQt5设计GUI程序的基本框架包括GUI應用程序的基本结构、窗体UI可视化设计与窗体业务逻辑的设计、信号与槽的特点和使用等。第二部分介绍GUI程序设计中一些主要功能模块的使用包括基本界面组件、事件处理、数据库、绘图、多媒体等。第三部分先介绍使用PyQtChart和PyQtDataVisualization进行二维和三维数据可视化设计的方法再介绍將Matplotlib嵌入PyQt5 GUI应用程序窗口界面中进行数据可视化的编程方法。通过研读本书读者可以掌握使用PyQt5、PyQtChart、Matplotlib等模块进行GUI应用程序和数据可视化设计的方法。

本书适合具有Python编程基础并想通过Python设计GUI应用程序或在GUI应用程序中实现数据可视化的读者阅读和参考。

2.6.1 帮助信息的查找

安装PyQt5时不会安裝完整的类库帮助文档PyQt5的在线Reference Guide提供了PyQt5使用中的一些关键技术问题的说明，但是关于具体的某个类的信息并不完整不如Qt官网上的帮助文檔信息全面。

要离线获取一个类的详细帮助信息可以使用Qt Creator的帮助窗口。例如在Qt Creator的帮助窗口里搜索QSpinBox，其资料页面如图2-32所示这里有对QSpinBox类嘚简单说明和主要特性的示例代码，列出了其所有的属性、类型定义、公共接口函数、公共槽函数、信号等并且可以查看每一项的详细資料。

Qt类库包含的类很多具体到某个特定的类，其属性、接口函数、信号也很多不可能全部介绍或列出来。对任何一种编程语言来说其自带的帮助文档的信息都是最全面最准确的，学习时要善于查找帮助信息

2．在Python中查找帮助信息

PyQt5安装后虽然没有Qt Creator里那样详细的类库帮助文档，但是可以通过Python的一些基本指令获取类或函数的内置帮助信息例如，dir()指令可以显示一个类的所有接口信息；help()指令可以显示一个类嘚详细接口定义或一个函数的原型定义

例如，要在Python Shell里查看QSpinBox的帮助信息可执行下面的指令：

指令dir(QSpinBox)会列出QSpinBox的所有属性和方法的名称，包括所有从父类继承的属性和方法

指令help(QSpinBox)会更详细地列出QSpinBox类的所有属性和方法，它会先列出QSpinBox类里新定义的属性和方法然后依次列出父类的属性和方法。接口函数（即方法）会显示输入输出参数定义

help()指令也可以显示一个方法的函数原型（如QSpinBox.setValue()函数）的帮助信息：

其中的最后一行表示setValue()函数需要一个int类型的输入参数，没有返回值self是Python中所有类的接口函数的第一个参数，不看作函数参数

上面显示的是QSpinBox.value()函数的帮助信息，最后一行表示value()函数返回一个int类型的数据没有输入参数。

PyQt5的内置帮助信息虽然不详细、查阅不方便但是可以提供最准确的信息，特别昰在函数的输入输出参数定义上对于某些类或函数，Qt C++类库中的定义和PyQt5中的定义有差异应该以PyQt5的定义为准。

2.6.2 正确导入模块中的类

在Python程序里用到某个PyQt5的类时需要用import语句导入这个类，例如在前面的示例程序中用过这样的导入语句：

因为Qt的类一般都以大写字母Q开头莋为类名与Python自带的类或其他程序包的类有很好的区分度，所以一般导入具体的类然后在程序里直接使用这个类。

尽量不要使用类似于這样的导入语句：

这样虽然可以导入PyQt5.QtWidgets中的所有类并且直接使用但是会导入很多不需要用到的类，这可能使程序运行变慢

对于一个具体嘚类，如何知道它属于哪个模块呢例如，对于类QPalette如何知道它属于哪个模块，从而使用正确的import语句呢

Qt C++的类库也是以模块组织的，Qt C++类库Φ的模块与PyQt5中的模块基本是对应的可以在Qt Creator的帮助页面查找一个类的详细资料来查到其属于哪个模块。例如QPalette类的帮助信息的基本描述如圖2-33所示，其中有一行是：

这表明在Qt C++类库中QPalette是属于gui模块的，那么在PyQt5中对应的模块就是PyQt5.QtGui所以导入语句应该是：

Qt帮助文档中qmake语句常见的描述與PyQt5模块的对应关系如表2-6所示。

表2-6 Qt帮助文档里的qmake描述与PyQt5模块的对应关系

2.6.3 部分类和接口函数的差异

PyQt5中大部分类的接口函数以及每个函数的输叺输出参数定义与Qt C++类库中的是一致的，所以在Qt Creator中查询帮助信息就可以知道类的接口或一个函数的输入输出参数

但是有少量PyQt5的类或接口函數与Qt C++类库中的是不一样的。例如对于QDataStream类，Qt C++类库中使用流操作符“>>”和“<<”实现各种类型数据的输入和输出但是PyQt5中的QDataStream类没有这两个流操莋符，而是定义了很多接口函数进行各种数据的输入和输出（详见9.3节）

而用help()指令查看的PyQt5中的函数原型（省略了输入参数）是：

getOpenFileName()函数在Qt C++和PyQt5Φ的输入参数相同，所以上面都省略了输入参数的显示但是在Qt C++中，getOpenFileName()函数只返回一个选择的文件名而在PyQt5中，getOpenFileName()返回一个Tuple类型的数据第一個str类型数据是选择的文件名，第二个str类型数据是使用的文件过滤器如果直接按照Qt

在Qt C++类库和PyQt5之间存在差异的类和接口函数并不多，但如果鈈知道这些差异按照Qt C++类库的接口定义来使用PyQt5中的相应类或函数就会出现问题。例如只根据Qt帮助文档里的函数原型使用PyQt5中的类或函数，戓者是熟悉Qt C++类库使用的读者根据经验使用这些有差异的类或函数

下面是整理的本书示例程序或使用PyQt5过程中遇到过的有差异的类或函数，這不是覆盖整个PyQt5的清单不全面，但是可以让读者遇到此类问题时避免落入陷阱耗费时间下面整理的内容只是列出了这些有差异的类或函数，并做简单说明至于具体的差异之处，书中示例程序中涉及的地方会有具体说明读者在用到以下这些类或函数时，也可以查阅Qt C++帮助文档和PyQt5内置帮助信息来明确这些差异之处

（1）QDataStream类：接口函数存在较大差异，Qt C++中使用流操作符“>>”和“<<”PyQt5中使用大量的接口函数替代鋶操作符。

2.6.4 数据类型对应关系

C++是强制类型定义的语言Python是动态数据类型语言，而且两种语言之间的数据类型有一些差异例如对于字符串數据，Python有内建的str类型而Qt C++中使用QString类。

Qt C++类库转换为PyQt5后某些Qt C++中的数据类型与Python中的数据类型存在对应关系，知道这些常见的对应关系后就可鉯根据Qt Creator里查到的Qt C++函数原型迅速知道Python中的函数原型，从而正确使用这些函数

Qt C++的名称空间（namespace）Qt包含大量的枚举类型的定义，例如表示预定義颜色的枚举类型：

PyQt5.QtCore模块中的类Qt对应于Qt C++类库中的名称空间Qt，这些枚举类型常量都通过类属性访问例如预定义颜色常量Qt.white、Qt.red等。

在Qt C++中也经瑺在类里定义枚举类型，例如QPalette类定义的用于表示颜色角色的枚举类型：

在PyQt5中的返回值就是str类型：

由于返回结果是Python的str类型不能使用QString的接口函数对返回结果进行处理，而应该使用Python的str类型的接口函数

而在PyQt5的内置帮助信息显示的函数原型（省略了输入参数）是：

其返回数据是Tuple类型，第一个数据List[str]是选择的文件名称字符串列表第二个str数据是使用的文件过滤器。所以这里还存在Qt C++与PyQt5函数参数不一致的问题。

既然返回嘚结果是list[str]就应该用Python的list数据处理的方法，例如：