### 信号机制与 `pyqtSignal` 的作用 在 PyQt 中，信号（Signal）与槽（Slot）机制是实现对象间通信的核心机制。`pyqtSignal` 是 `QObject` 的一个类方法，用于定义自定义信号。通过 `pyqtSignal()` 可以声明一个信号，该信号可以在特定条件下被发射（emit），从而触发一个或多个与之连接的槽函数执行[^1]。 ### `pyqtSignal` 的基本用法 使用 `pyqtSignal` 时，需要将其定义为类的属性。它支持多种参数类型，包括 `int`、`str`、`list`、`dict` 等，也可以组合多个参数类型。定义信号后，可以通过 `emit()` 方法触发该信号。 以下是一个简单的示例： ```python from PyQt5.QtCore import QObject, pyqtSignal class CustomObject(QObject): # 定义一个带参数的信号 message_emitted = pyqtSignal(str, int) def send_message(self, text, number): # 触发信号 self.message_emitted.emit(text, number) # 创建对象并连接信号 obj = CustomObject() # 定义槽函数 def handle_message(text, number): print(f"Received message: {text}, Number: {number}") # 连接信号与槽 obj.message_emitted.connect(handle_message) # 发射信号 obj.send_message("Hello", 42) ``` 输出结果为： ``` Received message: Hello, Number: 42 ``` ### 信号的参数类型定义 `pyqtSignal` 支持在声明时指定参数类型，例如： ```python signal1 = pyqtSignal() # 无参数 signal2 = pyqtSignal(int) # 一个整数参数 signal3 = pyqtSignal(str, int) # 两个参数：字符串和整数 signal4 = pyqtSignal(list) # 列表参数 signal5 = pyqtSignal(dict, str, int) # 多个参数混合 ``` 这种类型声明方式不仅提高了代码可读性，还增强了类型安全性，有助于在开发过程中发现错误。 ### 信号与多线程通信 在 PyQt 的多线程编程中，`pyqtSignal` 常用于线程间通信。例如，通过 `QThread` 或 `QRunnable` 执行耗时任务时，可以通过信号将结果返回给主线程更新界面。 ```python from PyQt5.QtCore import QThread, pyqtSignal class WorkerThread(QThread): result_ready = pyqtSignal(int) def run(self): # 模拟耗时操作 import time time.sleep(2) self.result_ready.emit(100) # 发送结果 # 使用线程 thread = WorkerThread() def on_result(value): print(f"Result from thread: {value}") thread.result_ready.connect(on_result) thread.start() ``` 此方式避免了直接操作 UI 控件的线程安全问题，确保 GUI 更新在主线程中进行。 ### 信号与界面组件的交互 在 GUI 应用中，`pyqtSignal` 广泛用于界面组件之间的数据同步。例如，当用户点击按钮时，可以发射一个信号来通知其他组件更新状态。 ```python from PyQt5.QtWidgets import QPushButton, QApplication from PyQt5.QtCore import pyqtSignal, QObject class ButtonManager(QObject): button_clicked = pyqtSignal() app = QApplication([]) btn = QPushButton("Click me") manager = ButtonManager() # 连接按钮点击事件到信号 btn.clicked.connect(manager.button_clicked) # 连接信号到处理函数 def on_button_click(): print("Button was clicked via signal!") manager.button_clicked.connect(on_button_click) btn.show() app.exec_() ``` 此类机制提升了组件之间的解耦程度，使代码更易维护和扩展。 ---