PyQt5自定义信号

一.简介

在 PyQt5 中，自定义信号是一个常见的任务，通常用于在对象之间传递信息或触发特定行为。自定义信号需要继承自 QtCore.pyqtSignal 并定义其参数类型。

二.操作步骤

1.导入必要的模块

from PyQt5.QtCore import QObject, pyqtSignal

2.创建自定义信号

1）继承自 QObject

2）定义信号参数的类型

class MyCustomObject(QObject):
    # 定义一个没有参数的信号
    signal_without_params = pyqtSignal()  

    # 定义一个带有字符串参数的信号
    signal_with_string_param = pyqtSignal(str)

3.在类中触发信号

class MyCustomObject(QObject):
    # ... 信号定义 ...  

    def some_method(self, message):
        # 做一些事情...
        # 然后触发带有字符串参数的信号
        self.signal_with_string_param.emit(message)

4.连接信号（Singnals）到槽（Slots）

# 假设你有一个 MyCustomObject 的实例
my_obj = MyCustomObject()  

# 连接信号到槽
def handle_signal(message):
    print(f"Received message: {message}")  

my_obj.signal_with_string_param.connect(handle_signal)  

# 触发信号
my_obj.some_method("Hello, PyQt5!")

5.pyqt5常用的信号

下面列举几个常用的信号

QPushButton.clicked()	当按钮被点击时发出
QLineEdit.textChanged(str)	当行编辑框中的文本发生变化时发出，并传递新的文本作为参数
QCheckBox.stateChanged(int)	当复选框的状态发生变化时发出，传递新的状态（Qt.Unchecked, Qt.Checked, 或 Qt.PartiallyChecked）作为参数
QSpinBox.valueChanged(int)	当数值框的值发生变化时发出，传递新的值作为参数
QSlider.valueChanged(int)	当滑块的值发生变化时发出，传递新的值作为参数。
QComboBox.currentIndexChanged(int)	当下拉列表框的当前索引发生变化时发出，传递新的索引作为参数
QTimer.timeout()	当定时器超时时发出。
QMouseEvent	相关的信号：如 mousePressEvent(QMouseEvent), mouseReleaseEvent(QMouseEvent), mouseMoveEvent(QMouseEvent) 等，这些信号在鼠标事件发生时由相应的控件发出。
QKeyEvent	相关的信号：如 keyPressEvent(QKeyEvent), keyReleaseEvent(QKeyEvent) 等，这些信号在键盘事件发生时由相应的控件发出。
QCloseEvent	相关的信号：如 closeEvent(QCloseEvent)，这个信号在窗口即将关闭时发出。
action.triggered	QAction 是一个代表用户界面动作的对象，比如菜单项、工具栏按钮或快捷键。triggered 是 QAction 的一个信号，当这个动作被触发时（例如，用户点击了对应的菜单项或工具栏按钮），这个信号就会被发出。

三.实例

import sys
from PyQt5.QtCore import QObject, pyqtSignal
from PyQt5.QtWidgets import QApplication, QMainWindow, QPushButton, QLineEdit

# 自定义信号
class MyCustomObject(QObject):
    # 定义一个没有参数的信号
    signal_without_params = pyqtSignal()
    # 定义一个带有字符串参数的信号
    signal_with_string_param = pyqtSignal(str)

    def some_method(self, message):
        self.signal_with_string_param.emit(message)  # 触发

class FileChooserApp(QMainWindow):
    def __init__(self):
        super().__init__()
        self.initUI()

    def initUI(self):
        self.ql = QLineEdit(self)
        # self.ql.textChanged.connect(self.edit)  # 当QLineEdit框内容发送变化时
        self.ql.move(100, 100)

        self.button = QPushButton("确定", self)
        self.my_obj = MyCustomObject()
        self.my_obj.signal_with_string_param.connect(self.edit)  # 自定义信号和槽连接
        self.button.clicked.connect(lambda: self.my_obj.some_method("message"))  # 点击按钮触发自定义信号
        # self.button.clicked.connect(self.my_obj.some_method)  # 点击按钮触发自定义信号（无参时写法）

        self.setGeometry(500, 500, 250, 180)
        self.setWindowTitle('textChanged')

    def edit(self):
        self.ql.setText("重新输入")

if __name__ == '__main__':
    app = QApplication(sys.argv)
    ex = FileChooserApp()
    ex.show()
    sys.exit(app.exec_())