Python 小白从零开始 PyQt5 项目实战（3）信 与槽的连接

『Python 小白从零开始 PyQt5 项目实战 @ Youcans』系列，持续更新中
Python 小白从零开始 PyQt5 项目实战（1）安装与环境配置
Python 小白从零开始 PyQt5 项目实战（2）菜单和工具栏
Python 小白从零开始 PyQt5 项目实战（3）信 与槽的连接

1. 信 与槽（Signals and slots）

信 与槽机制是 PyQt 的核心机制，用于对象之间的通信，也就是实现函数之间的自动调用。

1.1 信 与槽的原理

简单地说，将信 与槽函数连接后，当信 被触发时，槽函数将被自动调用。

分析这个过程，涉及到几个基本概念和关系：

• 信 ：信 可以是一个动作，也可以是对象的一种状态，用于触发所连接的槽。
• 槽：槽就是一个函数，可以由连接的信 触发。
• 发射信 ：信 被发射时，自动调用信 连接的槽函数。通常，在对象的状态改变时发射信 。
• 信 可以带有参数，但必须与槽函数的参数相对应。
• 一个信 可以连接多个槽函数，多个信 也可以连接到一个槽函数。
• 一个信 可以连接到另一个信 上。
• 很多窗口部件（控件）内置了一下信 和槽，可以直接调用。也可以按需求自定义信 和槽。

1.2 信 发送者与槽的接收者

信 的发送者通常是一个控件对象，在控件对象的状态发生变化时发送信 。常见的发送者是图形窗口中的各种控件对象，但也可以是动作对象。

槽的接收者通常也是控件对象。槽函数是一个自定义的槽函数，或控件内置的槽函数。一般地，槽函数也有一个对象作为主体，即对于接受者这个控件对象执行函数定义的操作。例如槽函数执行的功能是关闭，哪么究竟是关闭那个控件呢对象就是接受者。

• 打开 PyCharm，从 Tools -> ExternalTools -> QtDesigner 打开 QtDesigner，打开 uiDemo3.ui 文件。

• 鼠标点击选中 QtDesigner 左侧控件栏 Buttons 中的 PushButton，按住鼠标不放，将其拖动到中间的图形界面后松开鼠标，就在图形界面中创建了一个 PushButton 控件。

• 鼠标点击选中 QtDesigner 左侧控件栏 InputWidget 中的 LineEdit，按住鼠标不放，将其拖动到中间的图形界面后松开鼠标，就在图形界面中创建了一个 LineEdit 控件。

• 重复以上步骤，再建立几个 PushButton 控件和 LineEdit 控件。

  • 注意在 QtDesigner 右侧 “对象查看器” 中所显示的控件名称和属性，多个 PushButton、LineEdit 被自动赋予不同的命名（objectName），如：LineEdit_1、LineEdit_2、LineEdit_3，这就如同桌子有几个抽屉分别标记为 “抽屉1”、“抽屉2”、“抽屉3” 以便识别。

• 鼠标选中在图形界面中创建的 PushButton 控件或 LineEdit 控件，可以拖动控件调整位置。

将这个应用程序图形界面另存为 uiDemo4.ui，其预览效果如下：

2.2 信 与槽的连接：不同的发送者与接收者，槽函数为自定义函数

本例介绍不同的发送者与接收者，槽函数为自定义函数的操作方法。

在 2.1 中介绍了使用控件内置的方法作为槽函数，可以直接调用，不需要对函数进行定义。程序设计中的核心功能通常是程序员根据需求开发的自定义函数。使用自定义函数作为槽函数，一方面当然是要编写自定义函数，另一方面要将自定义函数添加到槽函数配置连接表中。

QtDesigner 设置信 /槽的连接的操作步骤如下：

**首先要在 QtDesigner 将自定义函数添加到槽函数配置连接表中——非常重要。** 上的很多文章都没有讲具体实现方法，这个操作的入口也很难找到。

• （1）在 QtDesigner 右侧上方的 “对象查看器”，选中 MainWindow 或其它顶层对象，单击鼠标右键唤出下拉菜单，选择 “改变信 /槽”；
  • 弹出 “MainWindow 的信 /槽” 对话框，对话框的上方显示槽的选项，下方显示信 选项。
  • 点击对话框上方 “槽” 选项框下部的绿色 “+”，系统在 “槽” 选项表的最后自动增加了一行 “slot1()”。这就是新增的自定义槽函数。
  • 点击选中 “slot1()”，再鼠标双击，就可以修改槽函数的函数名，例如修改为 click_pushButton_2()。
  • 再点击对话框上方 “槽” 选项框下部的绿色 “+”，可以继续逐一添加自定义的槽函数。

最后，别忘了要在主程序中编写自定义的函数。但这已不属于 QtDesigner 设计的内容了，在此不再详述。

这表明：在自定义的子函数中，可以同时操作多个控件对象，进而可以实现用户定义的各种功能。

2.3 信 与槽的连接：相同的发送者与接收者，槽函数为控件的内置函数

本例介绍相同的发送者与接收者，槽函数为控件的内置函数的操作方法。

顾名思义，相同的发送者与接收者，就是说信 的发送者与槽函数的接收者是同一个控件对象。这是什么情况，一个开关按钮有 “On/Off” 两种状态，每按一次则按钮状态发生翻转。类似地，选项框也有选中、未选中两种状态。特殊地，点击按钮后，关闭该按钮控件，也属于相同的发送者与接收者。

我们首先将控件对象 “pushButton_4” 从按钮控件 QPushButton 改变为 选项框控件 “QCheckBox”：

• 点击控件对象 “pushButton_4”，控件对象的周围边界显示几个蓝色小方块；
• 点击鼠标右键唤出下拉菜单，选择：“变型为” ->“QCheckBox”。

此时，设计界面窗口中的按钮控件，变成了一个选项框。同时，右侧 “对象查看器” 中的控件 “pushButton_4”，也自动变更为 “checkBox_4”。变更的控件 “checkBox_4” 继承了原来控件 “pushButton_4” 的一些属性，如：位置、尺寸、显示内容。

接下来设置信 /槽的连接：

• （2）选中控件对象发送者，此处为按钮控件 “checkBox_4”，长按鼠标左键并移动，当鼠标移出控件对象区域后，出现一条带箭头的红线和一个红色的接地符 。
  • 长按鼠标左键，拖动鼠标再回到控件对象 “checkBox_4” 区域后松开鼠标左键，就建立了发送者和接收者都是控件对象 “checkBox_4” 的信 /槽连接。
  • 此时控件对象 “checkBox_4” 变为浅红色，带箭头的红线从 “checkBox_4” 出发，又返回到 “checkBox_4” 结束。
• （3）同时弹出了对话框 “配置连接 – QtDesigner”，对话框的左侧和右侧分别是控件对象 “checkBox_4” 的信 和槽函数。
  • 从对话框左侧选中 “clicked(bool)”；
  • 从对话框右侧选中 “setChecked(bool)”；
  • 点击对话框下方的按钮 “OK”，完成该信 /槽连接的配置。

3. 图形界面的主程序

上节在 QtDesigner 中完成了图形界面的设计，将该文件另存为 uiDemo4.ui。打开 PyCharm，选中文件 uiDemo4.ui，使用 PyUIC 可以将其转换为 uiDemo4.py。

接下来我们要编写图形界面的主程序，调用图形界面设计文件 uiDemo4.py。

3.1 从面向过程到面向对象

面向过程的程序设计

在上一篇文章中，我们在主程序中创建主窗口后，直接调用 UI 中的 Ui_MainWindow()。这是面向过程的程序设计方法。

面向对象的程序设计

例程 GUIdemo4.py 如下：

在上面这个例程中，我们创建了一个类 MyMainWindow()，它继承了 QtWidgets.QMainWindow 类方法和导入的 uiDemo4.py 中的 Ui_MainWindow 界面类。

“super(MyMainWindow, self).init()”：初始化父类，把 MyMainWindow 的对象 self 转成父类 QMainWindow 对象，并调用 init 函数。

“self.setupUi(self)”：继承 uiDemo4.py 中的 Ui_MainWindow 界面类，调用 Ui_MainWindow 类的setupUi() 方法。

不熟悉面向对象程序设计的小白，如果看不懂这段程序也没有关系，保存下来照猫画虎就可以了。

3.2 自定义槽函数

运行例程 GUIdemo4.py。咦， 错了：

AttributeError: ‘MyMainWindow’ object has no attribute ‘click_pushButton_2’

系统提示找不到 ‘click_pushButton_2’，这是因为在主程序中还没有编写 2.2 中自定义的槽函数。

将自定义的槽函数 click_pushButton_2()、click_pushButton_3、trigger_actHelp(self) 添加到主程序中。下面给出例程 GUIdemo4.py 完整的代码。

现在我们就得到了一个虽然简单但是很完整的面向对象的图形界面应用程序 GUIdemo4。

检查一下应用程序 GUIdemo4 的各项功能：

• 点击 “4# 按钮”， “4# 按钮” 的选项框被选中；
• 点击工具栏中的 “帮助”，弹出上图中的信息提示框，点击 “OK” 可以关闭信息框；
• 点击菜单栏或工具栏中的 “退出”，关闭图形窗口应用程序。

如果以上测试都成功了，那么恭喜小白同学，你已经掌握了用 QtDesigner 设计 PyQt5 图形界面的基本功能。

在下一篇文章中，我们将介绍 PyQt5 中的常用控件。

【本节完】

版权声明：

Copyright 2021 youcans, XUPT

Crated：2021-10-10

『Python 小白从零开始 PyQt5 项目实战 @ Youcans』系列，持续更新中
Python 小白从零开始 PyQt5 项目实战（1）安装与环境配置
Python 小白从零开始 PyQt5 项目实战（2）菜单和工具栏
Python 小白从零开始 PyQt5 项目实战（3）信 与槽的连接

文章知识点与官方知识档案匹配，可进一步学习相关知识OpenCV技能树首页概览11611 人正在系统学习中