PyQt5信号与槽的高级应用：自定义信号定义与带参槽函数调用技巧

小满

发布时间：2026-10-14 | 4人浏览过

原创

本文深入解析PyQt5中信号与槽的高级用法，涵盖自定义信号的定义、连接及发射流程。重点讲解当信号无参而槽函数需传参时的两种解决方案：利用Lambda表达式和functools.partial函数，并提供完整代码示例与运行效果分析，帮助开发者灵活处理复杂界面交互逻辑。

PyQt5信号与槽的高级自定义信号与槽

所谓高级自定义信号与槽，指的是开发者可以根据实际需求自由定义信号和槽函数，并灵活传递参数。实现这一机制的一般流程包括以下几个关键步骤：

第一步：定义信号
第二步：定义槽函数
第三步：连接信号与槽函数
第四步：发射信号

1、定义信号

可以通过类成员变量的方式直接定义信号对象，具体语法如下：


  #无参数的信号
  signal1=pyqtSignal()
  #带一个参数（整数）的信号
  signal2=pyqtSignal(int)
  #带两个参数（整数，字符串）的信号
  signal3=pyqtSignal(int,str)
  #带一个参数（列表）的信号
  signal4=pyqtSignal(list)
  #带一个参数（字典）的信号
  signal5=pyqtSignal(dict)
  #带（整数 字符串）或者（字符串）的信号
  signal6=pyqtSignal([int,str],[str])

2、定义槽函数

接下来需要定义对应的槽函数，这些函数可以接收不同类型的输入参数，例如整数、字符串、列表或字典等。


  def signalCall1( self ):
    print("signal1 emit")
  def signalCall2( self,val ):
    print('signal2 emit,value:',val)
  def signalCall3( self,val,text ):
    print('signall3 emit,value:',val,text)
  def signalCall4( self,val ):
    print('signal4 emit,value:',val)
  def signalCall5( self,val ):
    print('signal5 emit,value',val)
  def signalCall6( self,val,text ):
    print('signal6 emit,value',val,text)
  def signalCall7( self,val ):
    print('signal6 ovetload emit',val)

3、连接信号与槽函数


    #信号与槽函数的链接
    self.signal1.connect(self.signalCall1)
    self.signal2.connect(self.signalCall2)
    self.signal3.connect(self.signalCall3)
    self.signal4.connect(self.signalCall4)
    self.signal5.connect(self.signalCall5)
    self.signal6[int,str].connect(self.signalCall6)
    self.signal6[str].connect(self.signalCall7)

4、发射信号


    #信号发射
    self.signal1.emit()
    self.signal2.emit(1)
    self.signal3.emit(1,'第三个')
    self.signal4.emit([1,2,3,4])
    self.signal5.emit({"name":'JIA','age':'21'})
    self.signal6[int,str].emit(1,"第六")
    self.signal6[str].emit('第六')

5、实例

完整的代码实现如下所示：


from PyQt5.QtCore import QObject,pyqtSignal
class CusSignal(QObject):
  #无参数的信号
  signal1=pyqtSignal()
  #带一个参数（整数）的信号
  signal2=pyqtSignal(int)
  #带两个参数（整数，字符串）的信号
  signal3=pyqtSignal(int,str)
  #带一个参数（列表）的信号
  signal4=pyqtSignal(list)
  #带一个参数（字典）的信号
  signal5=pyqtSignal(dict)
  #带（整数 字符串）或者（字符串）的信号
  signal6=pyqtSignal([int,str],[str])
  def __init__(self,parent=None):
    super(CusSignal, self).__init__(parent)
    #信号与槽函数的链接
    self.signal1.connect(self.signalCall1)
    self.signal2.connect(self.signalCall2)
    self.signal3.connect(self.signalCall3)
    self.signal4.connect(self.signalCall4)
    self.signal5.connect(self.signalCall5)
    self.signal6[int,str].connect(self.signalCall6)
    self.signal6[str].connect(self.signalCall7)
    #信号发射
    self.signal1.emit()
    self.signal2.emit(1)
    self.signal3.emit(1,'第三个')
    self.signal4.emit([1,2,3,4])
    self.signal5.emit({"name":'JIA','age':'21'})
    self.signal6[int,str].emit(1,"第六")
    self.signal6[str].emit('第六')
  #槽函数
  def signalCall1( self ):
    print("signal1 emit")
  def signalCall2( self,val ):
    print('signal2 emit,value:',val)
  def signalCall3( self,val,text ):
    print('signall3 emit,value:',val,text)
  def signalCall4( self,val ):
    print('signal4 emit,value:',val)
  def signalCall5( self,val ):
    print('signal5 emit,value',val)
  def signalCall6( self,val,text ):
    print('signal6 emit,value',val,text)
  def signalCall7( self,val ):
    print('signal6 ovetload emit',val)
if __name__ == '__main__':
  custSignal=CusSignal()

运行上述代码后，控制台将输出相应的信号触发信息，具体结果如下：

自定义参数的传递

在PyQt编程实践中，经常遇到需要将自定义参数传递给槽函数的场景。例如，当信号与槽函数的连接语句为：

button.clicked.connect(show_page)

我们知道，对于clicked信号而言，它本身是不携带任何参数的。然而，如果show_page函数希望接收特定参数（如按钮名称或ID），其定义形式可能如下：

def show_page(self,name):

print(name',点击了')

这就导致了一个常见矛盾：信号发出的参数数量与槽函数期望接受的参数数量不一致。为解决此问题，这里提供两种有效的解决方法：

第一种方法：使用lambda表达式

第二种方法：使用functools模块中的partial函数

以下示例同时展示了这两种方法的实现，读者可自行运行代码并查看注释说明以加深理解。

具体实例代码如下：


import sys
from PyQt5.QtWidgets import *
from functools import partial
class WinForm(QMainWindow):
  def __init__(self,parent=None):
    super(WinForm, self).__init__(parent)
    #实例化两个按钮
    button1=QPushButton('Button1')
    button2=QPushButton('Button2')
    #todo 第一种方法
    #单击信号关联槽函数，利用Lanbda表达式传递一个参数
    # button1.clicked.connect(lambda :self.onButtonClick(1))
    # button2.clicked.connect(lambda :self.onButtonClick(2))
    #
    #todo 第二种方法
    button1.clicked.connect(partial(self.onButtonClick, 1))
    button2.clicked.connect(partial(self.onButtonClick, 2))
    #实例化窗口
    main=QWidget()
    #设置窗口的布局，并向其中添加控件
    layout=QHBoxLayout(main)
    layout.addWidget(button1)
    layout.addWidget(button2)
    #设置为中央控件
    self.setCentralWidget(main)
  def onButtonClick( self,n ):
    #弹窗信息提示框，输出被点击的信息
    print("Button {0}".format(n))
    QMessageBox.information(self,'信息提示框','Button {0}'.format(n))
if __name__ == '__main__':
  app=QApplication(sys.argv)
  form=WinForm()
  form.show()
  sys.exit(app.exec_())

运行该程序后的界面效果如图所示：