当前位置：首页 > news >正文

PyQt——信号与槽

news 来源：原创 2025/5/14 16:46:47

一.信号与槽的概念

在PyQt中，信号（Signal）和槽（slot）是实现对象之间通信的核心机制，基于Qt的信号与槽机制。信号和槽是Qt框架中用于实现事件驱动编程的重要工具，允许对象之间以一种松耦合的方式进行交互。

1.信号（signal）

信号就是当事件（按钮点击，内容改变，窗口关闭事件）或者是状态（check选中了，togglebutton切换）。当程序触发了某种状态或者发生了某种事件（如：按钮被点击了，内容改变等等），那么就可以发射出来一个信号。

2.槽（slot）

槽是放置执行逻辑代码的一个函数，当信号发射过来后，捕获到信号就会执行与之绑定的槽内的函数。

3.信号与槽之间的连接

为了实现信号和槽之间的功能，比如：当点击某个按钮需要执行某个逻时，需要把具体的信号和具体的槽函数绑定到一起。

sender.signal.connect(receiver.slot)

sender：发出信号的对象。

signal：信号名称，通常是内置信号（如 clicked()）或自定义信号。

receiver：接收信号的对象。

slot：槽函数，用于处理信号。

二.信号和槽的示例

示例1：按钮接收信号

在 PyQt 中，按钮（如 QPushButton）本身并不“接收”信号，而是发出信号。按钮的信号（如 clicked）会在特定事件发生时被触发，并通知其他对象（通过槽函数）来处理这些事件。

注意：当按钮被点击时，clicked 信号会被触发，并传递一个布尔值参数。

import sys

from PyQt5.QtWidgets import QApplication, QWidget, QPushButton


class MyWindow(QWidget):
    def __init__(self):
        super().__init__()
        self.init_ui()

    def init_ui(self):
        # 更改当前Widge的宽高
        self.resize(500, 300)
        # 创建一个按钮
        btn = QPushButton("点我点我", self)
        # 设置窗口位置、宽高
        btn.setGeometry(200, 200, 100, 30)
        # 将按钮被点击时触发的信号与我们定义的函数（方法）进行绑定
        # 注意：这里没有()，即写函数的名字，而不是名字()
        btn.clicked.connect(self.click_my_btn)

    def click_my_btn(self, arg):
        # 槽函数，点击按钮则调用该函数
        # 这里的参数正好是信号发出，传递的参数
        print("点击按钮啦~", arg)


if __name__ == '__main__':
    app = QApplication(sys.argv)

    w = MyWindow()
    w.show()

    app.exec()

输出结果：

示例2：自定义信号

在PyQt中，自定义信号是指开发者根据自己的需求定义的信号，用于PyQt应用程序中实现对象之间的通讯。自定义信号可以携带数据（如字符串，整数，列表等），并且可以在任何继承自QObject的类中定义和使用。

如何自定义信号？

自定义信号需要使用 pyqtSignal 装饰器定义，并且只能在继承自 QObject 的类中定义。

QObject是什么东西？

QObject 是 Qt 框架的核心基类，提供了信号与槽机制、事件处理、对象管理和多线程支持等重要功能。在 PyQt 中，任何需要使用信号与槽机制的类都需要继承自 QObject。通过继承 QObject，Worker 类可以定义和发射自定义信号，从而实现与其他对象的通信。

import sys
from PyQt5.QtWidgets import QApplication, QWidget, QPushButton, QLabel, QVBoxLayout
from PyQt5.QtCore import QObject, pyqtSignal


class Worker(QObject):
    # 定义一个自定义信号，携带一个字符串参数
    custom_signal = pyqtSignal(str)

    def __init__(self, name):
        super().__init__()
        self.name = name

    def start_work(self):
        # 发射自定义信号
        self.custom_signal.emit(f"Hello from {self.name}!")


class MyWindow(QWidget):
    def __init__(self):
        super().__init__()
        self.init_ui()

    def init_ui(self):
        # 创建一个按钮
        button = QPushButton("Start Work", self)
        label = QLabel("Waiting...", self)

        # 创建 Worker 对象
        self.worker = Worker("Worker1")

        # 连接自定义信号到槽函数
        self.worker.custom_signal.connect(self.on_custom_signal)

        # 连接按钮点击信号到 Worker 的槽
        button.clicked.connect(self.worker.start_work)

        # 布局设置
        layout = QVBoxLayout()
        layout.addWidget(button)
        layout.addWidget(label)
        self.setLayout(layout)

        self.setWindowTitle("Custom Signal Example")
        self.label = label

    def on_custom_signal(self, message):
        # 槽函数，处理自定义信号
        self.label.setText(message)


if __name__ == "__main__":
    app = QApplication(sys.argv)
    w = MyWindow()
    w.show()
    sys.exit(app.exec_())

输出结果：

理解：直接接收信号和自定义信号的区别

我们看完上面的两个案例以后，会发现两个都是点击按钮啊，然后去触发信号，有样又有何区别呢？经过对比我们发现第一个案例是按钮触发，它是只传递布偶值的，而第二个案例我们可以同过自定义来规定我们要发送和接收的类型。

两者的区别

内置信号 vs 自定义信号
- 内置信号：如 QPushButton 的 clicked 信号，是 PyQt 提供的现成信号，用于处理按钮点击事件。它只能传递固定类型的参数（如 clicked 信号传递一个布尔值）。
- 自定义信号：通过 pyqtSignal 定义，可以传递任意类型的参数（如字符串、列表、字典等）。它允许开发者定义自己的事件通知机制。
应用场景
- 内置信号：适用于常见的事件处理（如按钮点击、文本框内容变化等）。它们是 PyQt 框架预先定义好的，使用方便。
- 自定义信号：适用于更复杂的场景，如跨线程通信、自定义对象之间的通信等。它们提供了更大的灵活性。
代码结构
- 内置信号：直接连接到控件（如按钮）的事件上，逻辑简单。
- 自定义信号：需要定义一个 QObject 的子类（如 Worker），并在该类中定义和发射信号。这使得代码结构更清晰，逻辑更模块化。