009.PyQt5_QObject基类_信号与槽函数
信号与槽函数
- 信号（Signal）就是在特定情况下被发射（emit）的一种通告。
- 例如一个PushButton按钮最常见的信号就是鼠标单击时发射的clicked()信号，一个ComboBox最常见的信号是选择的项变化时发射的CurrentIndexChanged()信号。GUI程序设计的主要内容就是对界面上各组件发射的特定信号进行响应，只需要知道什么情况下发射了哪些信号，然后合理地去响应和处理这些信号就可以了
- 槽（Slot）就是对信号响应的函数。
- 槽实质上是一个函数，它可以被直接调用。槽函数与一般的函数不同的是：槽函数可以与一个信号关联，当信号被发射时，关联的槽函数会被自动执行。Qt的类一般都有一些内建（build-in）的槽函数
- 例如QWidget有一个槽函数close()，其功能是关闭窗口。如果将一个PushButton按钮的clicked()信号与窗体的close()槽函数关联，那么点击按钮时就会关闭窗口
-
- 理解
- 当锅开了(发出信号)，你去关火(执行槽函数)
-
- 在QT中的信号与槽
-
- 信号(Signal)和槽(Slot)是Qt中的核心机制,主要作用在于对象之间进行通讯
- 信号：当一个控件的状态发生改变时, 向外界发出的信息
控件内置的一些函数， 按下按钮 QPushButton().pressed 按下并弹起按钮 QPushButton().clicked； 也可以自定义pyqtSignal() - 槽：一个执行某些操作的函数/方法
控件内置的槽函数；也有自定义的函数/方法 - 连接方式
对象.信号.connect(槽函数) - 所有继承自QWidget的控件都支持"信号与槽"的机制
- 当信号发出时, 连接的槽函数会自动执行
- 特性
- 一个信号可以连接多个槽函数
- 一个信号也可以连接另外一个信号
- 信号的参数可以是任何Python类型
- 一个槽可以监听多个信号
- ......
QObject对象信号处理API
- 相关API
widget.信号.connect(槽) # 连接信号和槽 obj.disconnect() # 取消连接信号与槽，无法恢复，只能重新连接 （控件.disconnect() # 取消控件的所有信号连接） （对象.信号.disconnect() # 取消对象指定信号的连接） widget.blockSignals(bool) # 临时（取消）阻止指定控件所有的信号与槽的连接（True：取消，False：恢复） widget.signalsBlocked() # 判断信号是否被阻止 widget.receivers(widget.信号) # 返回当前对象指定信号连接的槽函数数量 - QObject对象的信号
QObject.objectNameChanged(objectName) # 对象名称发生改变时，发射此信号 QObject.destroyed(obj) # 对象被销毁时, 发射此信号 QWidget.windowTitleChanged # 窗口标题发生改变时，发射此信号 - 案例1：destroyed信号。当obj对象被销毁时，打印 '对象被销毁了'
from PyQt5.Qt import * import sys class Windows(QWidget): def __init__(self): super().__init__() self.setWindowTitle('QObject信号与槽') self.resize(980, 500) self.widget_list() def widget_list(self): self.add_widget() def add_widget(self): obj = QObject() def destroyed_cao(): print('对象被释放了！') obj.destroyed.connect(destroyed_cao) if __name__ == '__main__': app = QApplication(sys.argv) w = Windows() w.show() sys.exit(app.exec_()) - 当这段代码一运行，就会打印'对象被释放了'，是因为obj当前是局部变量，当add_widget方法被执行完之后就会被自动销毁，所以就执行了
- 修改代码，将obj设置成w的属性，有指针指向obj的时候就不会自动销毁了。我们再通过del来手动销毁obj，从而触发destroyed信号
def add_widget(self): self.obj = QObject() def destroyed_cao(): print('对象被释放了！') self.obj.destroyed.connect(destroyed_cao) print('obj对象还未销毁') print('销毁obj对象') del self.obj print('obj对象被销毁了') - 输出结果
-
- 信号的参数
- 其实我们再引用destroyed这个信号的时候可以看到它本身是有参数的
-
- destroyed(self, object)这个信号中的object就是被销毁的对象，会自动传递给它所连接的槽函数，我们只需要在槽函数中添加参数(形参)接收信号传递过来的参数(实参)就可以直接使用了
def add_widget(self): self.obj = QObject() def destroyed_cao(obj): print(obj, '对象被释放了！') self.obj.destroyed.connect(destroyed_cao) print('obj对象还未销毁') print('销毁obj对象') del self.obj print('obj对象被销毁了') - 输出结果
-
- 案例2：objectNameChanged信号。对象名称发生改变时，打印 对象名称被改变了
from PyQt5.Qt import * import sys class Windows(QWidget): def __init__(self): super().__init__() self.setWindowTitle('QObject信号与槽') self.resize(980, 500) self.widget_list() def widget_list(self): self.add_widget() def obj_name_cao(self): print('对象名称被改变了！') def add_widget(self): obj = QObject() obj.objectNameChanged.connect(self.obj_name_cao) print('对象名称还未修改') print('修改对象名称') obj.setObjectName('new_objname') print('对象名称已被修改结束') if __name__ == '__main__': app = QApplication(sys.argv) w = Windows() w.show() sys.exit(app.exec_()) - 输出结果
-
- 案例3和案例2的区别，在于槽函数的位置。案例3调用的槽函数是属于window对象的函数，所以在连接槽函数的时候需要指定为 self.obj_name_cao
- 其实在objectNameChanged信号中也是有传递参数的objectNmae
-
- objectNameChanged(self, objectNmae)信号中的objectName参数是将对象修改后的新名称传递给槽函数，我们只需要在槽函数中添加参数接收这个信号传递过来的值就可以获取到对象修改后的名称
def obj_name_cao(self, newname): print('对象名称被改变了！', newname) def add_widget(self): obj = QObject() obj.objectNameChanged.connect(self.obj_name_cao) print('对象名称还未修改') print('修改对象名称') obj.setObjectName('new_objname') print('对象名称已被修改结束') - 输出结果
-
- 案例3：disconnect取消信号与槽的连接，无法恢复，只能重新连接
控件.disconnect() # 取消控件的所有信号与槽的连接 对象.信号.disconnect() # 取消对象指定信号与槽的连接- 控件.disconnect() # 取消控件的所有信号与槽的连接
from PyQt5.Qt import * import sys class Windows(QWidget): def __init__(self): super().__init__() self.setWindowTitle('QObject信号与槽') self.resize(980, 500) self.widget_list() def widget_list(self): self.add_widget() def obj_name_cao(self, newname): print('对象名称被改变了！', newname) def obj_name_cao2(self, newname): print('对象名称被改变成：！', newname) def destroyed_cao(self): print('对象被释放了') def add_widget(self): obj = QObject() obj.objectNameChanged.connect(self.obj_name_cao) obj.objectNameChanged.connect(self.obj_name_cao2) obj.destroyed.connect(self.destroyed_cao) # 取消对象所有信号与槽的连接，无法恢复，只能重新连接 obj.disconnect() # 取消对象指定信号与槽的连接 # obj.objectNameChanged.disconnect() obj.setObjectName('修改后的对象名') if __name__ == '__main__': app = QApplication(sys.argv) w = Windows() w.show() sys.exit(app.exec_()) - 输出结果
-
- 对象.信号.disconnect() # 取消对象指定信号与槽的连接
from PyQt5.Qt import * import sys class Windows(QWidget): def __init__(self): super().__init__() self.setWindowTitle('QObject信号与槽') self.resize(980, 500) self.widget_list() def widget_list(self): self.add_widget() def obj_name_cao(self, newname): print('对象名称被改变了！', newname) def obj_name_cao2(self, newname): print('对象名称被改变成：！', newname) def destroyed_cao(self): print('对象被释放了') def add_widget(self): obj = QObject() obj.objectNameChanged.connect(self.obj_name_cao) obj.objectNameChanged.connect(self.obj_name_cao2) obj.destroyed.connect(self.destroyed_cao) # 取消对象所有信号与槽的连接，无法恢复，只能重新连接 # obj.disconnect() # 取消对象指定信号与槽的连接 obj.objectNameChanged.disconnect() obj.setObjectName('修改后的对象名') if __name__ == '__main__': app = QApplication(sys.argv) w = Windows() w.show() sys.exit(app.exec_()) -
- 输出结果
-
- 结果可以看出，当用disconnect取消信号与槽的连接之后，第一次修改对象名称，没有执行槽函数
。当重新连接信号与槽之后，第二次修改对象名称时就执行了槽函数 控件.disconnect是取消当前控件所有信号与槽的连接对象.信号.disconnect是取消当前对象指定信号与槽的连接- 案例4：widget.blockSignals(bool) # 临时（取消）阻止指定控件所有的信号与槽的连接
widget.blockSignals(True) # 临时取消信号与槽的连接 widget.blockSignals(False) # 恢复信号与槽的连接from PyQt5.Qt import * import sys class Windows(QWidget): def __init__(self): super().__init__() self.setWindowTitle('QObject信号与槽') self.resize(980, 500) self.widget_list() def widget_list(self): self.add_widget() def obj_name_cao(self, newname): print('对象名称被改变了！', newname) def add_widget(self): obj = QObject() obj.objectNameChanged.connect(self.obj_name_cao) # 临时取消信号与槽的连接 obj.blockSignals(True) obj.setObjectName('第一次修改对象名称') # 恢复信号与槽的连接 obj.blockSignals(False) obj.setObjectName('第二次修改对象名称') if __name__ == '__main__': app = QApplication(sys.argv) w = Windows() w.show() sys.exit(app.exec_()) - 输出结果
-
- 注意：widget.blockSignals()方法是取消对象所有的信号与槽连接
- 案例5：widget.signalsBlocked() # 判断信号是否被阻止
from PyQt5.Qt import * import sys class Windows(QWidget): def __init__(self): super().__init__() self.setWindowTitle('QObject信号与槽') self.resize(980, 500) self.widget_list() def widget_list(self): self.add_widget() def obj_name_cao(self, newname): print('对象名称被改变了！', newname) def add_widget(self): obj = QObject() obj.objectNameChanged.connect(self.obj_name_cao) # 临时取消信号与槽的连接 obj.blockSignals(True) obj.setObjectName('第一次修改对象名称') # 判断obj对象信号与槽连接是否被阻止 print('1', obj.signalsBlocked()) # 恢复信号与槽的连接 obj.blockSignals(False) obj.setObjectName('第二次修改对象名称') # 判断obj对象信号与槽连接是否被阻止 print('2', obj.signalsBlocked()) if __name__ == '__main__': app = QApplication(sys.argv) w = Windows() w.show() sys.exit(app.exec_()) - 输出结果
-
- 案例6：widget.receivers(widget.信号) # 返回当前对象指定信号连接的槽函数数量
from PyQt5.Qt import * import sys class Windows(QWidget): def __init__(self): super().__init__() self.setWindowTitle('QObject信号与槽') self.resize(980, 500) self.widget_list() def widget_list(self): self.add_widget() def obj_name_cao(self, newname): print('对象名称被改变了！', newname) def obj_name_cao2(self, newname): print('对象名称被改变成：！', newname) def add_widget(self): obj = QObject() obj.objectNameChanged.connect(self.obj_name_cao) obj.objectNameChanged.connect(self.obj_name_cao2) print('开始位置：', obj.receivers(obj.objectNameChanged)) # 临时(取消)阻止该对象的所有信号与槽的连接 obj.blockSignals(True) print('blockSignals之后：', obj.receivers(obj.objectNameChanged)) # 断开该对象所有信号与槽的连接 obj.disconnect() print('disconnect之后：', obj.receivers(obj.objectNameChanged)) if __name__ == '__main__': app = QApplication(sys.argv) w = Windows() w.show() sys.exit(app.exec_()) - 输出结果
-
- 实例
- 用户点击按钮的时候，打印“点我嘎哈？”
- 相关知识点
- 按钮的单击信号：clicked
from PyQt5.Qt import * import sys class Windows(QWidget): def __init__(self): super().__init__() self.setWindowTitle('') self.resize(980, 500) self.widget_list() def widget_list(self): self.add_widget() def btn_cao(self): print('点我嘎哈？') def add_widget(self): btn = QPushButton(self) btn.setText("点击我") btn.clicked.connect(self.btn_cao) if __name__ == '__main__': app = QApplication(sys.argv) w = Windows() w.show() sys.exit(app.exec_())
- 在所有修改的窗口标题前，添加前缀“新标题”
- 相关知识点
- 设置窗口标题：setWindowTitle
- 监听窗口标题改变信号
- 临时取消/恢复信号与槽的连接
from PyQt5.Qt import * import sys class Windows(QWidget): def __init__(self): super().__init__() self.setWindowTitle('') self.resize(980, 500) self.widget_list() def widget_list(self): self.add_widget() def windowtitle_cao(self, title): # 临时取消信号与槽的连接，防止下面修改标题进入死循环 self.blockSignals(True) self.setWindowTitle('新标题 - ' + title) # 恢复信号与槽的连接，为下一次修改标题做准备 self.blockSignals(False) def add_widget(self): self.windowTitleChanged.connect(self.windowtitle_cao) self.setWindowTitle('Hello') self.setWindowTitle('World') if __name__ == '__main__': app = QApplication(sys.argv) w = Windows() w.show() sys.exit(app.exec_()) - 注意：
- 如果槽函数中不加blockSignals(True)临时取消信号与槽连接的API，就会由于槽函数中也有setWindowTitle信号，会无线调用槽函数，形成死循环
- 如果槽函数中最后不加blockSignals(False)，那么程序中后面再修改标题，就不会再执行槽函数了