PyQt5信号与槽的三种实现方式详解

Oliver
Oliver
发布时间:2026-10-13| 5人浏览过
原创

本文详细讲解PyQt5中信号与槽的三种核心用法:内置信号与槽、自定义信号与槽以及基于装饰器的信号与槽。通过具体代码实例,演示如何连接按钮点击事件、定义带多参数的自定义信号并实现数据传递,以及利用@pyqtSlot装饰器简化事件绑定流程,帮助开发者灵活掌握PyQt5界面交互开发技巧。

在PyQt5开发中,信号与槽机制主要有三种实现方式。

第一种方式是使用内置的信号与槽。

第二种方式是使用自定义的信号与槽。

第三种方式是利用装饰器来实现信号与槽的连接。

一:内置信号与槽的使用

内置信号与槽指的是在发射信号时,直接调用窗口控件自带的函数,而非自定义函数。这是前文中最常见的用法,通过以下简单实例即可理解其工作原理。


import sys
from PyQt5.QtWidgets import QMessageBox,QPushButton,QApplication,QWidget
app=QApplication(sys.argv)
widget=QWidget()
def showMsg():
 QMessageBox.information(widget,'信息提示框','Ok 弹出测试信息')
btn=QPushButton('测试点击按钮',widget)
btn.clicked.connect(showMsg)
widget.show()
sys.exit(app.exec_())

运行上述脚本后,界面显示效果如下。

该示例将按钮对象的内置clicked信号与自定义槽函数showMsg()进行连接。当用户单击按钮时,便会触发该槽函数,弹出一个信息提示框。

二:自定义信号与槽的使用

自定义信号与槽是指在发射信号时,不使用窗口控件的内置函数,而是通过自定义函数(即使用pyqtSignal类实例)来发射信号。之所以引入自定义信号与槽,是因为内置函数存在局限:首先,内置信号仅包含常用类型,部分场景下找不到对应的内置函数;其次,某些信号仅在特定条件下发射(如按钮点击事件);最后,内置函数传递的参数是固定的,无法自定义。而自定义信号与槽则能克服这些缺陷。

在PyQt5中,自定义信号与槽的应用非常灵活。例如,因业务需求需要在程序特定位置发射一个信号并传递多种数据,随后在槽函数中接收这些数据,这种机制可以灵活实现复杂的业务逻辑。

以下是一个简单的自定义信号与槽实例。


from PyQt5.QtCore import QObject,pyqtSignal
#信号对象
class QTypeSignal(QObject):
 #定义一个信号
 # sendmsg = pyqtSignal(object)
 #todo 优化 多个参数传递
 sendmsg=pyqtSignal(str,str)
 def __init__(self):
 super(QTypeSignal, self).__init__()
 def run( self ):
 #发射信号
 #self.sendmsg.emit('hell')
 #todo 优化 发射多个参数
 self.sendmsg.emit('第一参数','第二个参数')
#槽对象
class QTypeSlot(QObject):
 def __init__(self):
 super(QTypeSlot, self).__init__()
 #槽对象中的槽函数
 # def get( self,msg ):
 # print("QSlot get msg => " + msg)
 #todo 优化 多个参数
 def get( self,msg1,msg2 ):
 print("QSlot get msg => " + msg1+' '+msg2)
if __name__ == '__main__':
 #实例化信号对象
 send=QTypeSignal()
 #实例化槽对象
 slot=QTypeSlot()
 #1
 print('_____-把信号绑定到槽函数上_____')
 send.sendmsg.connect(slot.get)
 send.run()
 print('_____-把信号与槽函数解绑_____')
 send.sendmsg.disconnect(slot.get)
 send.run()

信号与槽连接的主要步骤如下。

第一步:生成一个信号。

#定义一个信号

# sendmsg = pyqtSignal(object)

#todo 优化 多个参数传递

sendmsg=pyqtSignal(str,str)

第二步:将信号与槽函数连接起来。

print('_____-把信号绑定到槽函数上_____')

send.sendmsg.connect(slot.get)

第三步:槽函数接收数据。

def get( self,msg1,msg2 ):

print("QSlot get msg => " + msg1+' '+msg2)

第四步:发射信号的实现。

self.sendmsg.emit('第一参数','第二个参数')

第五步:将信号绑定到槽对象中的槽函数上,使得槽函数能够接收到所发射的信号,从而完成数据传递。过程十分简单,若需传递多个数据,只需自定义参数的类型与数量即可。

send=QTypeSignal()

slot=QTypeSlot()

    #

print('_____-把信号绑定到槽函数上_____')

send.sendmsg.connect(slot.get)

三:使用装饰器信号与槽

1、使用格式


@PyQt5.QtCore.pyqtSlot(参数)
def on_发送者对象名称_发射信号名称(self,参数):
 pass

2、注意点,使用装饰器时必须定义两个要素。

QMetaObject.connectSlotsByName(self)

给需要绑定事件的组件定义一个ID(self.btn.setObjectName('名称'))。

3、按钮的普通事件


...
class Window(QWidget):
 def __init__(self, *args, **kwargs):
 super().__init__(*args, **kwargs)
 self.setWindowTitle('装饰器信号与槽')
 self.resize(500, 500)
 self.move(400, 200)
 self.btn = QPushButton('按钮', self)
 self.init_ui()
 
 def init_ui(self):
 self.btn.clicked.connect(self.btn_hand)
 
 @staticmethod
 def btn_hand():
 print('使用connect点击了按钮')
...

4、使用装饰器后的事件


...
class Window(QWidget):
 def __init__(self, *args, **kwargs):
 super().__init__(*args, **kwargs)
 self.setWindowTitle('装饰器信号与槽')
 self.resize(500, 500)
 self.move(400, 200)
 self.btn = QPushButton('按钮', self)
 self.init_ui()
 # 要在加载组件后使用
 QMetaObject.connectSlotsByName(self)
 
 def init_ui(self):
 # 这个地方定义的名字直接在下面使用
 self.btn.setObjectName('btn')
 
 @pyqtSlot()
 def on_btn_clicked(self):
 print('使用装饰器点击了按钮')

本文主要讲解了PyQt5信号与槽的基础使用方法与实例,更多关于PyQt5信号与槽的知识请查看下面的相关链接

相关标签:

免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。

Python 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。