当前位置：网站首页 > IT知识 > 正文

pyqt中细分:信号与槽（pyqt自定义信号和槽）

liuian 2025-07-17 20:35 63 浏览

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_())

pyqt combobox