Qt中event()与eventFilter()的适用场景区别解析

我对何时使用event()与eventFilter()来修改组件行为存在困惑。以下是两个可正常工作的示例，但互换方法后无法运行，想明确两者的区别：

示例1：禁用自身工具提示的自定义按钮 #

class PButton(QPushButton):
    def __init__(self, *args):
        super().__init__(*args)
        self.tt_enabled = False

    def event(self, event: QEvent):
        if event.type() == QEvent.Type.ToolTip and not self.tt_enabled:
            return True
        return super().event(event)

示例2：阻止回车键关闭编辑器的Delegate #

class Delegate(QStyledItemDelegate):
    def eventFilter(self, obj, event: QEvent):
        if event.type() == QEvent.Type.KeyPress and event.key() in (0x01000004, 0x01000005):  # Return, Enter
            return False
        return super().eventFilter(obj, event)

核心区别解析 #

1. 作用对象完全不同 #

• event()是组件自身的事件处理函数，仅处理当前类实例自己收到的事件。示例1中PButton重写event()，直接拦截自己的ToolTip事件，逻辑闭环在组件内部。
• eventFilter()是事件过滤器，处理的是被安装过滤器的目标组件的事件。示例2中Delegate的eventFilter()处理的是编辑器（obj参数）的按键事件，而非Delegate自身的事件。

2. 事件处理流程不同 #

• event()流程：事件直接传递到组件的event()函数，返回True表示事件已被处理，不再向下传递；返回False则交由父类的event()继续处理。
• eventFilter()流程：必须先通过installEventFilter()将过滤器安装到目标组件上，事件到达目标组件前会先经过过滤器的eventFilter()。返回True会拦截事件，目标组件不会收到；返回False则事件继续传递到目标组件的event()处理。

3. 适用场景差异 #

• 当需要修改自身组件的事件行为时，优先重写event()，逻辑更直接简洁，比如示例1的自定义按钮 tooltip 控制。
• 当需要修改第三方/内部组件的事件行为，且无法修改该组件源码时，使用eventFilter()。示例2中编辑器是Qt内部创建的（如QLineEdit），Delegate通过过滤器拦截其回车键事件，无需修改编辑器类的代码。

为什么互换方法后无效？ #

• 若示例1用eventFilter()：需要将过滤器安装到按钮自身，虽能实现但冗余，且若未正确调用installEventFilter()则完全不生效，远不如直接重写event()合理。
• 若示例2用event()：Delegate本身不是编辑器组件，不会收到编辑器的按键事件，重写event()根本拦截不到目标事件，自然无效。

内容的提问来源于stack exchange，提问作者mahkitah