pyqt中细分:信号与槽_pyqt5信号与槽
1、分类
信号分为:内置信号和自定义信号;
槽函数分为:内置槽函数和自定义槽函数;
根据排列组合规律,可分为4中情况,如下:
(1)内置信号和内置槽函数
(2)内置信号与自定义槽函数
(3)自定义信号与内置槽函数
(4)自定义信号与自定义槽函数
2、定义解释
(1)内置信号
在 PyQt 中,内置信号是指由 PyQt 框架提供的预定义信号,这些信号通常与用户界面的交互动作相关。内置信号使得开发者能够轻松地连接到特定的用户操作,并在这些操作发生时执行相应的处理。
内置信号通常由 PyQt 中的各种用户界面组件(如按钮、文本框、滑块等)发出,这些组件可以是 PyQt 提供的标准组件,也可以是自定义的组件。每个组件都有其特定的内置信号。
以下是一些常见的 PyQt 内置信号以及它们的解释:
- clicked():当按钮被点击时发出的信号。
- pressed():当按钮被按下时发出的信号。
- released():当按钮被释放时发出的信号。
- textChanged():当文本框内容发生变化时发出的信号。
- currentIndexChanged():当下拉框(ComboBox)的当前选项发生变化时发出的信号。
- valueChanged():当滑块(Slider)的值发生变化时发出的信号。
- editingFinished():当编辑框(LineEdit)的编辑完成时发出的信号。
- toggled():当复选框(CheckBox)状态切换时发出的信号。
连接内置信号到槽函数的方式通常是使用 connect() 方法。例如:
button.clicked.connect(self.on_button_clicked)
这行代码将按钮的 clicked() 信号连接到了一个名为 on_button_clicked() 的槽函数上。
(2)自定义信号
在 PyQt 中,你可以创建自定义信号以实现更高级的用户界面交互。自定义信号允许你在你的应用程序中定义特定事件,并在这些事件发生时发射信号,让其他部分能够捕获并做出响应。这种机制非常有用,因为它使得不同组件之间的通信变得更加灵活和高效。
要创建自定义信号,你需要使用 QtCore 模块中的 pyqtSignal() 方法。以下是一个简单的例子:
from PyQt5.QtCore import QObject, pyqtSignal
class MyObject(QObject):
# 定义一个自定义信号,参数类型为字符串
my_signal = pyqtSignal(str)
def __init__(self):
super().__init__()
def do_something(self):
# 当执行某些操作时,发射自定义信号,并传递参数
self.my_signal.emit("Custom signal emitted!")
(3)内置槽函数
在 PyQt 中,内置槽函数是一组预定义的方法,用于处理用户界面中的各种事件和操作。这些内置槽函数可以直接应用于 PyQt 提供的各种控件,例如按钮、文本框、滑块等,以便执行特定的功能。
以下是一些常见的 PyQt 内置槽函数及其功能:
- setText(text: str):设置控件的文本内容。
- setEnabled(enabled: bool):设置控件是否可用。
- setVisible(visible: bool):设置控件是否可见。
- clicked(bool checked = False):处理按钮点击事件。参数 checked 指示按钮是否被选中。
- show():显示控件。
- hide():隐藏控件。
- clear():清除控件中的内容,如清除文本框中的文本。
- valueChanged(int value):处理控件值的变化事件,比如滑块的值发生变化。
这些槽函数可以通过控件对象直接调用,也可以与信号连接,以便在信号触发时自动调用。例如,将按钮的 clicked() 信号连接到一个槽函数:
button.clicked.connect(self.on_button_clicked)
当按钮被点击时,on_button_clicked 槽函数就会被调用。
(4)自定义槽函数
在 PyQt 中,自定义槽函数是用户定义的用于处理信号的函数,使用关键字(如 def)定义。槽函数是普通的 Python 方法,它们可以连接到 PyQt 控件发出的信号,并在信号触发时执行特定的操作。
要定义一个自定义槽函数,只需在你的类中创建一个普通的方法,并将其用作槽函数。然后,你可以使用 connect() 方法将该槽函数与信号关联起来,以便在信号触发时自动调用该函数。
自定义槽函数 的命名规则通常遵循以下约定:
- 以 on_ 开头
- 接着是控件的名称
- 然后是下划线
- 最后是信号的名称
以下是一个简单的示例,展示了如何在 PyQt 中定义和使用自定义槽函数:
from PyQt5.QtWidgets import QApplication, QMainWindow, QPushButton
class MyWindow(QMainWindow):
def __init__(self):
super().__init__()
self.setWindowTitle("PyQt Example")
# 创建一个按钮
self.button = QPushButton('Click me', self)
self.button.setGeometry(100, 100, 100, 50)
# 连接按钮的 clicked 信号到自定义的槽函数
self.button.clicked.connect(self.on_button_clicked)
# 自定义的槽函数
def on_button_clicked(self):
print('Custom slot called!')
if __name__ == '__main__':
app = QApplication([])
window = MyWindow()
window.show()
app.exec_()
在这个示例中,我们定义了一个名为 on_button_clicked的自定义槽函数,并将按钮的 clicked 信号连接到它上面。当按钮被点击时,on_button_clicked 槽函数就会被调用,并输出 "Custom slot called!"。
3、举例说明
(1)内置信号和自定义槽函数
import sys
from PyQt5.QtWidgets import QApplication, QMainWindow, QLineEdit, QPushButton
class QmyWindow(QMainWindow):
def __init__(self):
super().__init__()
self.setWindowTitle("内置信号和内置槽函数示例") # 设置窗口标题
self.setGeometry(100, 100, 400, 200) # 设置窗口大小
self.button = QPushButton("click me", self) # 创建一个按钮, 按钮上显示"click me"
self.button.setGeometry(150, 50, 100, 30) # 设置按钮的位置和大小
self.textbox = QLineEdit(self) # 创建一个文本框
self.textbox.setGeometry(100, 100, 200, 30) # 设置文本框的位置和大小
# 将按钮的内置clicked信号连接到内置槽函数setText()
self.button.clicked.connect(lambda: self.textbox.setText("Button Clicked"))
if __name__ == "__main__":
app = QApplication(sys.argv)
myWin = QmyWindow()
myWin.show()
sys.exit(app.exec_())
(2)内置函数和自定义槽函数
import sys
from PyQt5.QtWidgets import QApplication, QMainWindow, QLineEdit, QPushButton
class QmyWindow(QMainWindow):
def __init__(self):
super().__init__()
self.setWindowTitle("内置信号和内置槽函数示例") # 设置窗口标题
self.setGeometry(100, 100, 400, 200) # 设置窗口大小
self.button = QPushButton("click me", self) # 创建一个按钮, 按钮上显示"click me"
self.button.setGeometry(150, 50, 100, 30) # 设置按钮的位置和大小
self.textbox = QLineEdit(self) # 创建一个文本框
self.textbox.setGeometry(100, 100, 200, 30) # 设置文本框的位置和大小
self.button.clicked.connect(self.on_button_clicked) # 将按钮的clicked信号连接到on_button_clicked槽函数
self.textbox.textChanged.connect(self.on_textbox_textChanged) # 将文本框的textChanged信号连接到text_changed槽函数
def on_button_clicked(self): # 内置槽函数on_button_clicked()
print("button clicked") # 打印"button clicked"
def on_textbox_textChanged(self): # 自定义槽函数text_changed()
print("text changed") # 打印"text changed"
if __name__ == "__main__":
app = QApplication(sys.argv)
myWin = QmyWindow()
myWin.show()
sys.exit(app.exec_())
(3)自定义信号和内置槽函数
import sys
from PyQt5.QtWidgets import QApplication, QMainWindow, QPushButton,QLineEdit
from PyQt5.QtCore import QObject, pyqtSignal
class QmyObject(QObject):
mySignal = pyqtSignal(str) # 创建一个信号对象mySignal
def some_method(self):
self.mySignal.emit("custom signal,emitted") # 发射信号
class QmyWindow(QMainWindow):
def __init__(self):
super().__init__()
self.setWindowTitle("自定义信号和内置槽函数示例") # 设置窗口标题
self.setGeometry(100, 100, 400, 200) # 设置窗口大小
self.button = QPushButton("click me", self) # 创建一个按钮, 按钮上显示"click me"
self.button.setGeometry(150, 50, 100, 30) # 设置按钮的位置和大小
self.textbox = QLineEdit(self) # 创建一个文本框
self.textbox.setGeometry(100, 100, 200, 30)
self.obj = QmyObject() # 创建一个QmyObject对象obj
# 将obj的mySignal自定义信号连接到lambda表达式, lambda表达式将text设置为文本框的文本,setText()是内置槽函数
self.obj.mySignal.connect(lambda text: self.textbox.setText(text))
# 将按钮的内置clicked信号连接到obj的some_method自定义槽函数
self.button.clicked.connect(self.obj.some_method)
if __name__ == "__main__":
app = QApplication(sys.argv)
myWin = QmyWindow()
myWin.show()
sys.exit(app.exec_())
4、自定义信号和自定义槽函数
import sys
from PyQt5.QtWidgets import QApplication, QMainWindow, QPushButton, QLineEdit
from PyQt5.QtCore import QObject, pyqtSignal
class QmyObject(QObject):
mySignal = pyqtSignal(str) # 创建一个信号对象mySignal
def some_method(self):
self.mySignal.emit("custom signal,emitted") # 发射信号
class QmyWindow(QMainWindow):
def __init__(self):
super().__init__()
self.setWindowTitle("自定义信号和自定义槽函数示例") # 设置窗口标题
self.setGeometry(100, 100, 400, 200) # 设置窗口大小
self.button = QPushButton("click me", self) # 创建一个按钮, 按钮上显示"click me"
self.button.setGeometry(150, 50, 100, 30) # 设置按钮的位置和大小
self.textbox = QLineEdit(self) # 创建一个文本框
self.textbox.setGeometry(100, 100, 200, 30)
# 创建一个QmyObject对象obj
self.obj = QmyObject()
# 自定义信号与自定义槽函数的连接
self.obj.mySignal.connect(self.on_mySignal)
# 将按钮的内置clicked信号连接到obj的some_method自定义槽函数
self.button.clicked.connect(self.obj.some_method)
# 将按钮的内置clicked信号连接到lambda表达式, lambda表达式将text设置为文本框的文本,setText()是内置槽函数
self.button.clicked.connect(lambda: self.textbox.setText("Button Clicked"))
def on_mySignal(self, message): # 自定义槽函数on_mySignal()
print("receive:", message) # 打印message
if __name__ == "__main__":
app = QApplication(sys.argv)
myWin = QmyWindow()
myWin.show()
sys.exit(app.exec_())