【PyQt5教程二】Qt Designer 信号与槽的使用方法及PyQt5基本小部件说明

一、信号与槽机制：

二、信号与槽使用方法：

（1）使用Qt Designer 的信号与槽编辑器：

（2）使用固定语法直接建立信号槽连接：

三、PyQt小部件及其触发信号：

（1）常见PyQt小部件及其触发信号：

（2） PyQt5 官方文档：

四、PyQt5 基本小部件：

一、信号与槽机制：

PyQt5中的信号和槽机制是一种事件驱动编程范式，允许小部件（如按钮和菜单项）在特定用户交互发生时发出信号，并将这些信号连接到槽函数，即定义好的响应动作，从而实现用户界面与程序逻辑的松耦合和交互响应。

PyQt中的小部件作为事件源，通过继承QObject类获得发出信号的能力。信号是事件通知，而槽是响应这些事件的函数。响应事件函数可以为任意可调用的python函数。

信号与槽机制具有以下特点。

一个信号可以连接到多个槽。
一个信号也可以连接到另一个信号。
Signal 参数可以是任何 Python 类型。
一个槽可以连接到许多信号。
连接可以是直接的（即同步的）或排队的（即异步的）。
可以跨线程建立连接。
信号可能会断开连接。

二、信号与槽使用方法：

（1）使用Qt Designer 的信号与槽编辑器：

首先先创建Qt Designer 文件，并在窗口内添加小部件如下：

【PyQt5教程一】Qt Designer 安装及其使用方法说明，附程序源码

然后，点击信号与槽编辑器的+号，添加信号与槽：

添加过程

添加完成后保存.ui文件，并使用：

pyuic5 -x Signalandslot.ui -o Signalandslot.py

转化为对应的.py文件。Signalandslot.py如下：

# -*- coding: utf-8 -*-

# Form implementation generated from reading ui file 'Signalandslot.ui'
#
# Created by: PyQt5 UI code generator 5.15.11
#
# WARNING: Any manual changes made to this file will be lost when pyuic5 is
# run again.  Do not edit this file unless you know what you are doing.


from PyQt5 import QtCore, QtGui, QtWidgets


class Ui_MainWindow(object):
    def setupUi(self, MainWindow):
        MainWindow.setObjectName("MainWindow")
        MainWindow.resize(800, 600)
        self.centralwidget = QtWidgets.QWidget(MainWindow)
        self.centralwidget.setObjectName("centralwidget")
        self.Button1 = QtWidgets.QPushButton(self.centralwidget)
        self.Button1.setGeometry(QtCore.QRect(140, 450, 93, 28))
        self.Button1.setObjectName("Button1")
        self.Button2 = QtWidgets.QPushButton(self.centralwidget)
        self.Button2.setGeometry(QtCore.QRect(540, 450, 93, 28))
        self.Button2.setObjectName("Button2")
        self.line_text = QtWidgets.QLineEdit(self.centralwidget)
        self.line_text.setGeometry(QtCore.QRect(290, 190, 171, 41))
        self.line_text.setObjectName("line_text")
        MainWindow.setCentralWidget(self.centralwidget)
        self.menubar = QtWidgets.QMenuBar(MainWindow)
        self.menubar.setGeometry(QtCore.QRect(0, 0, 800, 26))
        self.menubar.setObjectName("menubar")
        MainWindow.setMenuBar(self.menubar)
        self.statusbar = QtWidgets.QStatusBar(MainWindow)
        self.statusbar.setObjectName("statusbar")
        MainWindow.setStatusBar(self.statusbar)

        self.retranslateUi(MainWindow)
        self.Button1.clicked.connect(self.line_text.clear) # type: ignore
        self.Button2.clicked.connect(MainWindow.close) # type: ignore
        QtCore.QMetaObject.connectSlotsByName(MainWindow)

    def retranslateUi(self, MainWindow):
        _translate = QtCore.QCoreApplication.translate
        MainWindow.setWindowTitle(_translate("MainWindow", "MainWindow"))
        self.Button1.setText(_translate("MainWindow", "清空"))
        self.Button2.setText(_translate("MainWindow", "退出"))


if __name__ == "__main__":
    import sys
    app = QtWidgets.QApplication(sys.argv)
    MainWindow = QtWidgets.QMainWindow()
    ui = Ui_MainWindow()
    ui.setupUi(MainWindow)
    MainWindow.show()
    sys.exit(app.exec_())

运行结果：

运行结果

（2）使用固定语法直接建立信号槽连接：

widget.signal.connect(slot_function)

widget为对应触发信号的小部件，signal为信号类型，connect(slot_function)为连接到的槽函数，其中slot_function可以为任意可调用的python函数。

例如之前.ui生成的.py中有：

self.Button1.clicked.connect(self.line_text.clear) # type: ignore
self.Button2.clicked.connect(MainWindow.close) # type: ignore

Button1，Button2为触发信号的小部件，clicked为触发的信号（即单击按钮），触发后执行槽函数，self.line_text.clear（清空line_text中的文本），MainWindow.close（关闭主窗口）。

三、PyQt小部件及其触发信号：

PyQt中的信号和槽机制允许小部件（Widgets）在特定事件发生时发出信号，并将这些信号连接到槽函数上，以便执行相应的操作。

（1）常见PyQt小部件及其触发信号：

QPushButton（按钮）:

clicked 信号：当按钮被点击时触发。可以传递一个布尔值，表示按钮是否被按下。
```
btn.clicked.connect(lambda: some_function(True))
```
pressed 信号：当鼠标按下按钮时触发。
```
btn.pressed.connect(some_function)
```
released 信号：当鼠标释放按钮时触发。
```
btn.released.connect(some_function)
```

QCheckBox（复选框）：

stateChanged 信号：当复选框的选中状态改变时触发。传递一个整数参数，表示新的复选框状态（0表示未选中，2表示选中）。
```
checkbox.stateChanged.connect(some_function)
```

QRadioButton（单选按钮）：

toggled 信号：当单选按钮的选中状态改变时触发。传递一个布尔值参数，表示当前是否被选中。
```
radiobutton.toggled.connect(some_function)
```

QSlider（滑动条）：

valueChanged 信号：当滑动条的值改变时触发。传递一个整数参数，表示滑动条的新值。
```
slider.valueChanged.connect(some_function)
```
rangeChanged 信号：当滑动条的范围改变时触发。
```
slider.rangeChanged.connect(some_function)
```

QListWidget（列表控件）：

itemClicked 信号：当列表中的项被点击时触发。传递一个列表项对象作为参数。
```
listwidget.itemClicked.connect(some_function)
```
itemDoubleClicked 信号：当列表中的项被双击时触发。
```
listwidget.itemDoubleClicked.connect(some_function)
```

QComboBox（下拉列表框）：

currentIndexChanged 信号：当下拉列表框的当前选中项改变时触发。传递一个整数参数，表示新的当前选中项的索引。
```
combobox.currentIndexChanged.connect(some_function)
```
currentTextChanged 信号：当当前选中项的文本改变时触发。
```
combobox.currentTextChanged.connect(some_function)
```

QLineEdit（文本输入框）：

textChanged 信号：当文本框的内容改变时触发。传递一个字符串参数，表示文本框的新内容。
```
lineedit.textChanged.connect(some_function)
```
editingFinished 信号：当编辑完成时触发，通常在用户按下回车键或离开编辑框时。
```
lineedit.editingFinished.connect(some_function)
```

QTableWidget / QTreeView（表格和树视图）：

itemClicked 信号：当表格或树中的项被点击时触发。
```
table.itemClicked.connect(some_function)
```
itemDoubleClicked 信号：当表格或树中的项被双击时触发。
```
table.itemDoubleClicked.connect(some_function)
```

QMainWindow / QDialog（主窗口 / 对话框）：

accepted 信号：当对话框被接受时触发（例如，用户点击了OK按钮）。
```
dialog.accepted.connect(some_function)
```
rejected 信号：当对话框被拒绝时触发（例如，用户点击了Cancel按钮）。
```
dialog.rejected.connect(some_function)
```