很多网友在问有没有 PyQt5 的文档之类的问题,在 PyQt4 的时候 PyQt 官网有了英文版的文档,随后有网友翻译成了中文。不过现在 PyQt5 官方的文档都指向了 C 的 Qt 文档,其实 C 的 Qt API 文档结构很清晰,翻阅很容易的,需要注意几点。
作为一个开发人员确实需要具备查阅文档、查询资料等基础技能,会为自己的开发带来很大的帮助,要善于搜索,通过不同的方式去搜索才能找到自己需要的东西。
拿 Qt C++ 文档来说,官网地址是:https://doc.qt.io/qt-5/qtwidgets-module.html 这里面记录了所有控件的详细函数文档。
比如拿 输入框 QLineEdit
来说,怎么去查询它的用法和信号槽等资料?
https://doc.qt.io/qt-5/qlineedit.html
# 左侧目录
在文档左侧目录中有如下几个:
Properties - 控件里的属性(比如宽高等,通常需要当作函数调用)
Public Slots - 这个是控件自己的槽函数(当作普通函数就行)
Signals - 这个是输入框的包含的信号
Public Functions、Reimplemented Public Functions、Static Public Members、Protected Functions、Reimplemented Protected Functions - 这几个都是函数列表
# 类说明
这里有两个注意点
- 红色方框内的表示该控件(输入框)继承于
QWidget
,所以该控件(输入框)拥有父类的所有方法和信号,当当前文档找不到相关资料和函数时,可以去父类找找看。 - 紫色方框内表示列举所有的方法(包括父类)
# 函数列表
这里列举的就是该控件(输入框)的函数,同理点击上面的紫色方框是查看所有方法,一般这里主要用来查询你需要的功能函数,Qt 的函数名比较容易理解,比如:只读 ReadOnly,选择文字:setSelection。
所以再查下这部分资料的时候建议在浏览器中 Ctrl + F 打开浏览器的搜索框,并输入英文关键词来检索你所需要的函数在哪里。
# 槽函数
这部分列举的是槽函数,其实在 PyQt 中槽函数可以当作普通的函数。普通的函数也可以作为槽函数,直接通过信号连接即可,注意方框所示,还有很多函数是在父类里面。
# 信号
这部分列举了该控件(输入框)所定义的信号,主要还是看名字,大多都能知道是做什么的,比如:
- editingFinished - 编辑完成信号
- returnPressed - 回车键信号
- textChanged (const QString &text) - 内容改变信号
这里还有个问题就是参数问题,一般 & 后面的 text 作为参数传递到槽函数中
# 函数详细说明
当不明确这个函数是做什么的,可以点击该函数跳转到下面的说明,比如回车键信号 returnPressed
如图上所示,用翻译插件翻译,大部分就明白了,如下:
# 关于如何搜索资料
比如当你要搜索输入框内容改变事件,一般建议两种搜索,且搜索的时候用空格把关键词分开搜索,而且直接用控件名
- 中文搜索引擎:QLineEdit 内容 改变
- 英文搜索引擎:QLineEdit text change