一、提要
PyQt5的事件:GUI 应用程序是事件驱动的。事件主要由应用程序的用户生成。但它们也可以通过其他方式生成;例如Internet 连接、窗口管理器或计时器。当我们调用应用程序的 exec_ 方法时,应用程序进入主循环。主循环获取事件并将它们发送给对象。事件本身是一个对象体,从其源发起,最后到达目的地。
在事件模型中,有三个组成:
- event source 事件源
- event object 状态对象
- event target 要通知的对象
事件源是:状态发生变化的对象。它生成事件。
事件对象(event)封装了事件源中的状态变化。
事件目标是要通知的对象。事件源对象将处理事件的任务委托给事件目标。
PyQt5 有一个独特的信号和槽机制来处理事件。信号和槽用于对象之间的通信。发生特定事件时会发出信号。插槽可以是任何 Python 可调用的。发出连接信号时调用插槽。
二、PyQt5 信号和槽
这是一个演示 PyQt5 中信号和槽的简单示例。
signals_slots.py
#!/usr/bin/python
"""
ZetCode PyQt5 tutorial
In this example, we connect a signal
of a QSlider to a slot of a QLCDNumber.
Author: Jan Bodnar
Website: zetcode.com
"""
import sys
from PyQt5.QtCore import Qt
from PyQt5.QtWidgets import (QWidget, QLCDNumber, QSlider,
QVBoxLayout, QApplication)
class Example(QWidget):
def __init__(self):
super().__init__()
self.initUI()
def initUI(self):
lcd = QLCDNumber(self)
sld = QSlider(Qt.Horizontal, self)
vbox = QVBoxLayout()
vbox.addWidget(lcd)
vbox.addWidget(sld)
self.setLayout(vbox)
sld.valueChanged.connect(lcd.display)
self.setGeometry(300, 300, 250, 150)
self.setWindowTitle('Signal and slot')
self.show()
def main():
app = QApplication(sys.argv)
ex = Example()
sys.exit(app.exec_())
if __name__ == '__main__':
main()
在我们的示例中,我们显示一个 QtGui.QLCDNumber 和一个 QtGui.QSlider。我们通过拖动滑块旋钮来更改 LCD 编号。
sld.valueChanged.connect(lcd.display)
在这里,我们将滑块的 valueChanged 信号连接到 lcd 数字的显示槽。
发送者是发送信号的对象。接收器是接收信号的对象。插槽是对信号做出反应的方法。

三、PyQt5 重新实现事件处理程序
PyQt5 中的事件通常通过重新实现事件处理程序来处理。
reimplement_handler.py
#!/usr/bin/python
"""
ZetCode PyQt5 tutorial
In this example, we reimplement an
event handler.
Author: Jan Bodnar
Website: zetcode.com
"""
import sys
from PyQt5.QtCore import Qt
from PyQt5.QtWidgets import QWidget, QApplication
class Example(QWidget):
def __init__(self):
super().__init__()
self.initUI()
def initUI(self):
self.setGeometry(300, 300, 250, 150)
self.setWindowTitle('Event handler')
self.show()
def keyPressEvent(self, e):
if e.key() == Qt.Key_Escape:
self.close()
def main():
app = QApplication(sys.argv)
ex = Example()
sys.exit(app.exec_())
if __name__ == '__main__':
main()
在我们的示例中,我们重新实现了 keyPressEvent 事件处理程序。
def keyPressEvent(self, e): if e.key() == Qt.Key_Escape: self.close()
如果我们单击 Escape 按钮,应用程序将终止。
四、PyQt5的事件对象
事件对象是一个 Python 对象,它包含许多描述事件的属性。事件对象特定于生成的事件类型。
event_object.py
#!/usr/bin/python
"""
ZetCode PyQt5 tutorial
In this example, we display the x and y
coordinates of a mouse pointer in a label widget.
Author: Jan Bodnar
Website: zetcode.com
"""
import sys
from PyQt5.QtCore import Qt
from PyQt5.QtWidgets import QWidget, QApplication, QGridLayout, QLabel
class Example(QWidget):
def __init__(self):
super().__init__()
self.initUI()
def initUI(self):
grid = QGridLayout()
x = 0
y = 0
self.text = f'x: {x}, y: {y}'
self.label = QLabel(self.text, self)
grid.addWidget(self.label, 0, 0, Qt.AlignTop)
self.setMouseTracking(True)
self.setLayout(grid)
self.setGeometry(300, 300, 450, 300)
self.setWindowTitle('Event object')
self.show()
def mouseMoveEvent(self, e):
x = e.x()
y = e.y()
text = f'x: {x}, y: {y}'
self.label.setText(text)
def main():
app = QApplication(sys.argv)
ex = Example()
sys.exit(app.exec_())
if __name__ == '__main__':
main()
在此示例中,我们在标签小部件中显示鼠标指针的 x 和 y 坐标。
self.text = f'x: {x}, y: {y}'
self.label = QLabel(self.text, self)
x 和 y 坐标显示在 QLabel 小部件中。
self.setMouseTracking(True)
默认情况下禁用鼠标跟踪,因此当鼠标移动时至少按下一个鼠标按钮时,小部件才会接收鼠标移动事件。如果启用了鼠标跟踪,即使没有按下按钮,小部件也会接收鼠标移动事件。
def mouseMoveEvent(self, e): x = e.x() y = e.y() text = f'x: {x}, y: {y}' self.label.setText(text)
e 是事件对象;它包含有关已触发事件的数据;在我们的例子中,鼠标移动事件。使用 x 和 y 方法,我们确定鼠标指针的 x 和 y 坐标。我们构建字符串并将其设置为标签小部件。
五、PyQt5事件发送
有时很方便知道哪个小部件是信号的发送者。为此,PyQt5 有 sender 方法。
event_sender.py
#!/usr/bin/python """ ZetCode PyQt5 tutorial In this example, we determine the event sender object. Author: Jan Bodnar Website: zetcode.com """ import sys from PyQt5.QtWidgets import QMainWindow, QPushButton, QApplication class Example(QMainWindow): def __init__(self): super().__init__() self.initUI() def initUI(self): btn1 = QPushButton("Button 1", self) btn1.move(30, 50) btn2 = QPushButton("Button 2", self) btn2.move(150, 50) btn1.clicked.connect(self.buttonClicked) btn2.clicked.connect(self.buttonClicked) self.statusBar() self.setGeometry(300, 300, 450, 350) self.setWindowTitle('Event sender') self.show() def buttonClicked(self): sender = self.sender() self.statusBar().showMessage(sender.text() + ' was pressed') def main(): app = QApplication(sys.argv) ex = Example() sys.exit(app.exec_()) if __name__ == '__main__': main()
我们的示例中有两个按钮。在 buttonClicked 方法中,我们通过调用 sender 方法来确定我们点击了哪个按钮。
btn1.clicked.connect(self.buttonClicked) btn2.clicked.connect(self.buttonClicked)
Both buttons are connected to the same slot.
def buttonClicked(self): sender = self.sender() self.statusBar().showMessage(sender.text() + ' was pressed')
我们通过调用 sender 方法来确定信号源。在应用程序的状态栏中,我们显示正在按下的按钮的标签。

六、PyQt5发射信号
从 QObject 创建的对象可以发出信号。以下示例显示了我们如何发出自定义信号。
custom_signal.py
#!/usr/bin/python
"""
ZetCode PyQt5 tutorial
In this example, we show how to
emit a custom signal.
Author: Jan Bodnar
Website: zetcode.com
"""
import sys
from PyQt5.QtCore import pyqtSignal, QObject
from PyQt5.QtWidgets import QMainWindow, QApplication
class Communicate(QObject):
closeApp = pyqtSignal()
class Example(QMainWindow):
def __init__(self):
super().__init__()
self.initUI()
def initUI(self):
self.c = Communicate()
self.c.closeApp.connect(self.close)
self.setGeometry(300, 300, 450, 350)
self.setWindowTitle('Emit signal')
self.show()
def mousePressEvent(self, event):
self.c.closeApp.emit()
def main():
app = QApplication(sys.argv)
ex = Example()
sys.exit(app.exec_())
if __name__ == '__main__':
main()
我们创建了一个名为 closeApp 的新信号。此信号在鼠标按下事件期间发出。该信号连接到 QMainWindow 的关闭插槽。
class Communicate(QObject): closeApp = pyqtSignal()
使用 pyqtSignal 作为外部通信类的类属性创建信号。
self.c = Communicate()
self.c.closeApp.connect(self.close)
自定义 closeApp 信号连接到 QMainWindow 的关闭槽。
def mousePressEvent(self, event): self.c.closeApp.emit()
当我们用鼠标指针单击窗口时,会发出 closeApp 信号。应用程序终止。