当前位置：首页 > news >正文

PyQt入门指南四事件处理机制详解

news 2025/7/1 17:48:45

1. 事件处理概述

在PyQt中，事件处理是实现交互性的关键部分。事件可以是用户的操作（如点击按钮、键盘输入），也可以是系统的通知（如窗口最小化、定时器超时）。PyQt使用信号（Signals）和槽（Slots）机制来处理这些事件。

2. 信号与槽

信号和槽是Qt的核心特性，也是PyQt中处理事件的主要方式。

信号（Signal）：当某个特定事件发生时，一个对象会发出一个信号。
槽（Slot）：槽是普通的Python函数或方法，当与之相连的信号被触发时，槽会被调用。

3. 常用信号与槽示例

3.1 按钮点击事件

from PyQt5.QtWidgets import QApplication, QPushButton, QWidget

def on_button_click():
    print("按钮被点击了！")

app = QApplication([])
window = QWidget()
button = QPushButton("点击我", window)
button.clicked.connect(on_button.push_button)
window.show()
app.exec_()

在这个例子中，QPushButton 的 clicked 信号连接到了 on_button_click 槽。

3.2 自定义信号

除了使用内置信号，你还可以定义自己的信号：

from PyQt5.QtCore import QObject, pyqtSignal

class MyClass(QObject):
    my_signal = pyqtSignal(str)

    def emit_signal(self, message):
        self.my_signal.emit(message)

def on_my_signal(message):
    print(f"接收到自定义信号: {message}")

obj = MyClass()
obj.my_signal.connect(on_my_signal)
obj.emit_signal("Hello, PyQt!")

4. 事件过滤器

除了信号和槽，PyQt还提供了事件过滤器机制，允许你在事件到达目标对象之前拦截和处理事件。

4.1 使用事件过滤器

from PyQt5.QtWidgets import QApplication, QLabel, QWidget
from PyQt5.QtCore import Qt, QEvent

class MyWidget(QWidget):
    def __init__(self):
        super().__init__()
        self.label = QLabel("鼠标悬停在这里", self)
        self.label.setAlignment(Qt.AlignCenter)

    def eventFilter(self, watched, event):
        if event.type() == QEvent.Enter:
            self.label.setText("鼠标进来了！")
        elif event.type() == QEvent.Leave:
            self.label.setText("鼠标离开了！")
        return super().eventFilter(watched, event)

app = QApplication([])
window = MyWidget()
window.installEventFilter(window)  # 安装事件过滤器
window.show()
app.exec_()

在这个例子中，我们通过重写 eventFilter 方法来拦截鼠标进入和离开事件，并相应地更新标签的文本。

5. 定时器事件

PyQt中的 QTimer 可以用来定期触发事件。

from PyQt5.QtWidgets import QApplication, QLabel, QWidget
from PyQt5.QtCore import QTimer

class TimerWidget(QWidget):
    def __init__(self):
        super().__init__()
        self.label = QLabel("0", self)
        self.label.setAlignment(Qt.AlignCenter)
        self.timer = QTimer(self)
        self.timer.timeout.connect(self.update_label)
        self.timer.start(1000)  # 每秒触发一次
        self.counter = 0

    def update_label(self):
        self.counter += 1
        self.label.setText(str(self.counter))

app = QApplication([])
window = TimerWidget()
window.show()
app.exec_()

在这个例子中，QTimer 每秒触发一次 timeout 信号，槽函数 update_label 更新标签显示的时间。