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_())