pyqt事件过滤器eventFilter

PyQt事件过滤器详解

eventFilter 是PyQt中一个强大的事件处理机制，它允许你在事件到达目标对象之前拦截并处理这些事件。这在以下场景中特别有用：

• 监控或修改其他对象的事件
• 实现全局快捷键或特殊输入处理
• 为多个控件提供统一的事件处理逻辑
• 创建无需子类化的自定义行为

基本原理

事件过滤器基于以下几个核心概念：

1. 事件传递链：PyQt中的事件首先由QApplication对象接收，然后传递到目标对象
2. 事件过滤器：是一个接收事件并可以选择拦截或继续传递的对象
3. 安装过滤器：通过obj.installEventFilter(filterObj)将过滤器应用到目标对象
4. eventFilter方法：必须在过滤器对象中实现，用于处理拦截到的事件

eventFilter方法签名

def eventFilter(self, obj: QObject, event: QEvent) -> bool:
    # 处理事件
    return True  # 事件已处理，不再继续传递
    # 或
    return False  # 事件继续传递给目标对象

关键参数和返回值

• obj：目标对象，即事件原本要到达的对象
• event：拦截到的事件对象，包含事件类型和相关数据
• 返回值：
  • True：事件被拦截，不再传递给目标对象
  • False：事件继续正常传递给目标对象

实际应用示例

下面是一个完整的示例，展示了事件过滤器的几种常见用法：

import sys
from PyQt5.QtWidgets import *
from PyQt5.QtCore import *
from PyQt5.QtGui import *

class MyEventFilter(QObject):
    """自定义事件过滤器类"""
    
    def __init__(self, parent=None):
        super().__init__(parent)
        self.click_count = 0
        
    def eventFilter(self, obj, event):
        # 处理不同类型的事件
        if event.type() == QEvent.MouseButtonPress:
            # 拦截鼠标点击事件
            self.click_count += 1
            print(f"拦截到鼠标点击事件 #{
     
     self.click_count} 目标: {
     
     obj.objectName()}")
            
            # 可以基于条件决定是否继续传递事件
            if self.click_count % 3 ==