PyQt5 中的事件和信号

最后修改于 2023 年 10 月 18 日

在本 PyQt5 编程教程中，我们将探讨应用程序中发生的事件和信号。

PyQt5 中的事件

GUI 应用程序是事件驱动的。事件主要由应用程序的用户生成。但它们也可以通过其他方式生成；例如，互联网连接、窗口管理器或计时器。当我们调用应用程序的 exec_ 方法时，应用程序进入主循环。主循环获取事件并将其发送给对象。

在事件模型中，有三个参与者

事件源
事件对象
事件目标

事件源 是其状态发生更改的对象。它生成事件。事件对象（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 数字的 display 槽。

发送者是发送信号的对象。接收者是接收信号的对象。槽是响应信号的方法。

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)

两个按钮都连接到同一个槽。

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 的 close 槽。

class Communicate(QObject):

    closeApp = pyqtSignal()

信号是使用 pyqtSignal 作为外部 Communicate 类的类属性创建的。

self.c = Communicate()
self.c.closeApp.connect(self.close)

自定义 closeApp 信号连接到 QMainWindow 的 close 槽。

def mousePressEvent(self, event):

    self.c.closeApp.emit()

当我们用鼠标指针单击窗口时，会发出 closeApp 信号。应用程序将终止。

在本 PyQt5 教程中，我们已经介绍了信号和槽。

电子书

PyQt5 中的事件和信号