python -- PyQt5（designer）中文详细教程(一)Qt的基本功能
在介绍PyQt5中文详细教程前，如有需要安装PyQt5的同学可以在此 PyQt5安装详细教程_M_Q_T的博客-CSDN博客参考安装，里面有详细的安装内容。
下一章内容python -- PyQt5（designer）中文详细教程(二)菜单和工具栏
http://t.csdn.cn/QObiv
PyQt5中⽂教程
PyQt5-Chinese-tutorial
PyQt5中⽂教程，翻译⾃ zetcode，项⽬地址：https://github.com/maicss/PyQt5-Chinese-tutoral。 这个教程⽐较好的地⽅是，能讲解每⼀段代码的含义。 虽然PyQt的函数命名已经⾮常语义化了，但是对于新⼿来说，有这⼀步还是更好的。
更新： 2017-8
菜单和⼯具栏 【新增】 右键菜单 子菜单 勾选菜单
事件和信号 【新增】 事件对象
绘图 【新增】 贝塞尔曲线
PyQt5 简介
本教程的⽬的是带领你⼊门PyQt5。教程内所有代码都在Linux上测试通过。PyQt4 教程是PyQt4的 教程，PyQt4是⼀个Python（同时⽀持2和3）版的Qt库。
关于 PyQt5
PyQt5 是Digia的⼀套Qt5应⽤框架与python的结合，同时⽀持2.x和3.x。本教程使⽤的是3.x。Qt库 由Riverbank Computing开发，是最强⼤的GUI库之⼀ ，官⽅⽹站www.riverbankcomputing.co.uk/news。
PyQt5是由⼀系列Python模块组成。超过620个类，6000函数和⽅法。能在诸如Unix、Windows和 Mac OS等主流操作系统上运⾏。PyQt5有两种证书，GPL和商业证书。
PyQt5类分为很多模块，主要模块有：
QtCore 包含了核⼼的⾮GUI的功能。主要和时间、⽂件与⽂件夹、各种数据、流、URLs、 mime类⽂件、进程与线程⼀起使⽤。
QtGui 包含了窗⼜系统、事件处理、2D图像、基本绘画、字体和⽂字类。
QtWidgets 包含了⼀系列创建桌⾯应⽤的UI元素。
QtMultimedia 包含了处理多媒体的内容和调⽤摄像头API的类。
QtBluetooth 包含了查找和连接蓝⽛的类。
QtNetwork QtNetwork包含了⽹络编程的类，这些⼯具能让TCP/IP和UDP开发变得更加⽅便和 可靠。
QtPositioning 包含了定位的类，可以使⽤卫星、WiFi甚⾄⽂本。
Enginio 包含了通过客户端进⼊和管理Qt Cloud的类。
QtWebSockets 包含了WebSocket协议的类。
QtWebKit 包含了⼀个基WebKit2的web浏览器。
QtWebKitWidgets 包含了基于QtWidgets的WebKit1的类。
QtXml 包含了处理xml的类，提供了SAX和DOM API的⼯具。
QtSvg 提供了显⽰SVG内容的类，Scalable Vector Graphics (SVG)是⼀种是⼀种基于可扩展标 记语⾔（XML），⽤于描述⼆维⽮量图形的图形格式。
QtSql 提供了处理数据库的⼯具。
QtTest QtTest提供了测试PyQt5应⽤的⼯具。
PyQt4和PyQt5的区别
PyQt5不兼容PyQt4。PyQt5有⼀些巨⼤的改进。但是，迁移并不是很难，两者的区别如下：
重新组合模块，⼀些模块已经被废弃(QtScript)，有些被分为两个⼦模块(QtGui, QtWebKit)。
添加了新的模块，⽐如QtBluetooth, QtPositioning，和Enginio。
废弃了SINGAL()和SLOT()的调⽤⽅式，使⽤了新的信号和xx处理⽅式。
不再⽀持被标记为废弃的或不建议使⽤的API。
Hello New World！
本章学习Qt的基本功能
例1，简单的窗口
这个简单的⼩例⼦展⽰的是⼀个⼩窗⼜。但是我们可以在这个⼩窗⼜上⾯做很多事情，改变⼤⼩， 最⼤化，最⼩化等，这需要很多代码才能实现。这在很多应⽤中很常见，没必要每次都要重写这部 分代码，Qt已经提供了这些功能。PyQt5是⼀个⾼级的⼯具集合，相⽐使⽤低级的⼯具，能省略上 百⾏代码。
#!/usr/bin/python3
# -*- coding: utf-8 -*-
"""
ZetCode PyQt5 tutorial
In this example, we create a simple
window in PyQt5.
author: Jan Bodnar
website: zetcode.com
Last edited: August 2017
"""
import sys
from PyQt5.QtWidgets import QApplication, QWidget
if __name__ == '__main__':
app = QApplication(sys.argv)
w = QWidget()
w.resize(250, 150)
w.move(300, 300)
w.setWindowTitle('Simple')
w.show()
sys.exit(app.exec_())这个简单的⼩例⼦展⽰的是⼀个⼩窗口。
程序预览：
import sys
from PyQt5.QtWidgets import QApplication, QWidget
这⾥引⼊了PyQt5.QtWidgets模块，这个模块包含了基本的组件。
app = QApplication(sys.argv)
每个PyQt5应⽤都必须创建⼀个应⽤对象。sys.argv是⼀组命令⾏参数的列表。Python可以在shell里运行，这个参数提供对脚本控制的功能。
w = QWidget()
QWidge控件是⼀个⽤户界⾯的基本控件，它提供了基本的应⽤构造器。默认情况下，构造器是没有父级的，没有⽗级的构造器被称为窗口（window）。
w.resize(250, 150)
resize()⽅法能改变控件的⼤⼩，这⾥的意思是窗⼜宽250px，⾼150px。
w.move(300, 300)
move()是修改控件位置的的⽅法。它把控件放置到屏幕坐标的(300, 300)的位置。注：屏幕坐标系 的原点是屏幕的左上⾓。
w.setWindowTitle('Simple')
我们给这个窗⼜添加了⼀个标题，标题在标题栏展⽰（虽然这看起来是⼀句废话，但是后⾯还有各 种栏，还是要注意⼀下，多了就蒙了）。
w.show()
show()能让控件在桌⾯上显示出来。控件在内存⾥创建，之后才能在显⽰器上显⽰出来。
sys.exit(app.exec_())
最后，我们进⼊了应⽤的主循环中，事件处理器这个时候开始⼯作。主循环从窗⼜上接收事件，并 把事件传⼊到派发到应⽤控件⾥。当调⽤ exit() ⽅法或直接销毁主控件时，主循环就会结 束。 sys.exit() ⽅法能确保主循环安全退出。外部环境能通知主控件怎么结束。
exec_() 之所以有个下划线，是因为 exec 是⼀个Python的关键字。
例2，带窗口图标
窗口图标通常是显⽰在窗⼜的左上⾓，标题栏的最左边。下⾯的例⼦就是怎么⽤PyQt5创建⼀个这样 的窗口。
在某些环境下，图标显⽰不出来。如果你遇到了这个问题，看我在Stackoverfolw的回答
#!/usr/bin/python3
# -*- coding: utf-8 -*-
"""
ZetCode PyQt5 tutorial
This example shows an icon
in the titlebar of the window.
Author: Jan Bodnar
Website: zetcode.com
Last edited: August 2017
"""
import sys
from PyQt5.QtWidgets import QApplication, QWidget
from PyQt5.QtGui import QIcon
class Example(QWidget):
def __init__(self):
super().__init__()
self.initUI()
def initUI(self):
self.setGeometry(300, 300, 300, 220)
self.setWindowTitle('Icon')
self.setWindowIcon(QIcon('1670057961739.jpg'))
self.show()
if __name__ == '__main__':
app = QApplication(sys.argv)
ex = Example()
sys.exit(app.exec_())
这个简单的⼩例⼦展⽰的是⼀个⼩窗口。
程序预览：
前⼀个例⼦是使⽤的过程式编程。Python还⽀持⾯向对象的编程：
class Example(QWidget):
def __init__(self):
super().__init__(）
.....
⾯向对象编程最重要的三个部分是类(class)、数据和⽅法。我们创建了⼀个类的调⽤，这个类继承 ⾃ QWidget 。这就意味着，我们调⽤了两个构造器，⼀个是这个类本⾝的，⼀个是这个类继承 的。 super() 构造器⽅法返回⽗级的对象。 __init__() ⽅法是构造器的⼀个⽅法。
self.initUI(）
使⽤ initUI() ⽅法创建⼀个GUI。
# ⾃⼰准备⼀个图片例如JPG格式的网图1670057961739.jpg
self.setGeometry(300, 300, 300, 220)
self.setWindowTitle('Icon')
self.setWindowIcon(QIcon('1670057961739.jpg'))
上⾯的三个⽅法都继承⾃ QWidget 类。 setGeometry() 有两个作⽤：把窗⼜放到屏幕上并且设置窗 ⼜⼤⼩。参数分别代表屏幕坐标的x、y和窗⼜⼤⼩的宽、⾼。也就是说这个⽅法是 resize() 和 move() 的合体。最后⼀个⽅法是添加了图标。先创建⼀个QIcon对象，然后接受⼀个路径作为参数 显⽰图标。
if __name__ == '__main__':
app = QApplication(sys.argv)
ex = Example()
sys.exit(app.exec_()）
应⽤和⽰例的对象创⽴，主循环开始。
程序预览：
例3，提示框
import sys
from PyQt5.QtWidgets import (QWidget, QToolTip, QPushButton, QApplication)
from PyQt5.QtGui import QFont
class Example(QWidget):
def __init__(self):
super().__init__()
self.initUI()
def initUI(self):
QToolTip.setFont(QFont('SansSerif', 10))
self.setToolTip('This is a QWidget widget')
btn = QPushButton('Button', self)
btn.setToolTip('This is a QPushButton widget')
btn.resize(btn.sizeHint())
btn.move(50, 50)
self.setGeometry(300, 300, 300, 200)
self.setWindowTitle('Tooltips')
self.show()
if __name__ == '__main__':
app = QApplication(sys.argv)
ex = Example()
sys.exit(app.exec_())在这个例⼦中，我们为应⽤创建了⼀个提示框。
QToolTip.setFont(QFont('SansSerif', 10))
这个静态方法设置了提示框的字体，我们使⽤了10px的SansSerif字体。
self.setToolTip('This is a QWidget widget')
调⽤ setTooltip() 创建提示框可以使用富文本格式的内容。
btn = QPushButton('Button', self)
btn.setToolTip('This is a QPushButton widget')
创建⼀个按钮，并且为按钮添加了⼀个提示框。
btn.resize(btn.sizeHint())
btn.move(50, 50)
调整按钮大小，并让按钮在屏幕上显示出来， sizeHint() 方法提供了⼀个默认的按钮大小
程序预览：
例4，关闭窗口
关闭⼀个窗口最直观的⽅式就是点击标题栏的那个叉，这个例⼦⾥，我们展⽰的是如何⽤程序关闭 ⼀个窗口。这⾥我们将接触到⼀点single和slots的知识。 本例使⽤的是QPushButton组件类。
QPushButton(string text, QWidget parent = None)
text 参数是想要显示的按钮名称， parent 参数是放在按钮上的组件，在我们的例子里，这个参数 是 QWidget 。应用中的组件都是⼀层⼀层（继承⽽来的？）的，在这个层⾥，大部分的组件都有自己的父级，没有父级的组件，是顶级的窗口。
import sys
from PyQt5.QtWidgets import QWidget, QPushButton, QApplication
from PyQt5.QtCore import QCoreApplication
class Example(QWidget):
def __init__(self):
super().__init__()
self.initUI()
def initUI(self):
qbtn = QPushButton('Quit', self)
qbtn.clicked.connect(QCoreApplication.instance().quit)
qbtn.resize(qbtn.sizeHint())
# print(qbtn.sizeHint())
# 结果是PyQt5.QtCore.QSize(75,23),75和 23是这个btn的⻓和⾼
qbtn.move(50, 50)
self.setGeometry(300, 300, 350, 200)
self.setWindowTitle('Quit button')
self.show()
if __name__ == '__main__':
app = QApplication(sys.argv)
ex = Example()
sys.exit(app.exec_())这⾥创建了⼀个点击之后就退出窗口的按钮。
from PyQt5.QtCore import QCoreApplication
程序需要 QtCore 对象。
qbtn = QPushButton('Quit', self)
创建⼀个继承自 QPushButton 的按钮。第⼀个参数是按钮的⽂本，第⼆个参数是按钮的父级组件， 这个例⼦中，父级组件就是我们创建的继承⾃ Qwidget 的 Example 类。
qbtn.clicked.connect(QCoreApplication.instance().quit)
事件传递系统在PyQt5内建的single和slot机制⾥⾯。点击按钮之后，信号会被捕捉并给出既定的反 应。 QCoreApplication 包含了事件的主循环，它能添加和删除所有的事件， instance() 创建了⼀ 个它的实例。 QCoreApplication 是在 QApplication ⾥创建的。 点击事件和能终止进程并退出应用 的quit函数绑定在了⼀起。在发送者和接受者之间建⽴了通讯，发送者就是按钮，接受者就是应用 对象。
程序预览：
例5，消息盒⼦
默认情况下，我们点击标题栏的×按钮，QWidget就会关闭。但是有时候，我们修改默认⾏为。比如，如果我们打开的是⼀个⽂本编辑器，并且做了⼀些修改，我们就会想在关闭按钮的时候让⽤户进⼀步确认操作。
import sys
from PyQt5.QtWidgets import QWidget, QMessageBox, QApplication
class Example(QWidget):
def __init__(self):
super().__init__()
self.initUI()
def initUI(self):
self.setGeometry(300, 300, 350, 200)
self.setWindowTitle('Message box')
self.show()
def closeEvent(self, event): # 这是⼀个重载⽅法
reply = QMessageBox.question(self, 'Message',
"Are you sure to quit?",
QMessageBox.Yes | QMessageBox.No,
QMessageBox.No)
# 第⼆个参数是No表示默认的是No被选中，
if reply == QMessageBox.Yes:
event.accept()
else:
event.ignore()
if __name__ == '__main__':
app = QApplication(sys.argv)
ex = Example()
sys.exit(app.exec_())如果关闭QWidget，就会产⽣⼀个QCloseEvent，并且把它传⼊到closeEvent函数的event参数中。 改变控件的默认⾏为，就是替换掉默认的事件处理。（重载了）
reply = QMessageBox.question(self, 'Message',
"Are you sure to quit?",
QMessageBox.Yes | QMessageBox.No,
QMessageBox.No)
我们创建了⼀个消息框，上⾯有俩按钮：Yes和No.第⼀个字符串显⽰在消息框的标题栏，第⼆个字 符串显⽰在对话框，第三个参数是消息框的俩按钮，最后⼀个参数是默认按钮，这个按钮是默认选 中的，这个参数可以没有。返回值在变量 reply ⾥。
if reply == QMessageBox.Yes:
event.accept()
else:
event.ignore()
这⾥判断返回值，如果点击的是Yes按钮，我们就关闭组件和应⽤，否者就忽略关闭事件。
例6，窗口居中
import sys
from PyQt5.QtWidgets import QWidget, QDesktopWidget, QApplication
class Example(QWidget):
def __init__(self):
super().__init__()
self.initUI()
def initUI(self):
self.resize(350, 200)
self.center()
self.setWindowTitle('Center')
self.show()
def center(self):
qr = self.frameGeometry()
cp = QDesktopWidget().availableGeometry().center()
qr.moveCenter(cp)
self.move(qr.topLeft())
if __name__ == '__main__':
app = QApplication(sys.argv)
ex = Example()
sys.exit(app.exec_())
QtGui.QDesktopWidget 提供了⽤户的桌⾯信息，包括屏幕的⼤⼩。
self.center()
这个⽅法是调⽤我们下⾯写的，实现对话框居中的⽅法。
qr = self.frameGeometry()
获得主窗⼜所在的框架。print（qr）的结果是PyQt5.QtCore.QRect(0，0，249，149)
cp = QDesktopWidget().availableGeometry().center()
获取显⽰器的分辨率，然后得到屏幕中间点的位置。
qr.moveCenter(cp)
然后把主窗⼜框架的中⼼点放置到屏幕的中⼼位置。
self.move(qr.topLeft())
然后通过move函数把主窗⼜的左上⾓移动到其框架的左上⾓，这样就把窗⼜居中了。
运行后对话框出现在屏幕中心位置，程序预览：
该专栏内容参考：https://download.csdn.net/download/weixin_41243677/12391339