如何使用eventFilter和installEventFilter实现PyQt5删除QTreeWidget选中项

代码失效的核心原因 #

你写的事件过滤器不生效，有两个核心问题：

• 事件过滤器实例没有持久化引用：treeWidget.installEventFilter(EventFilter())这里创建的EventFilter是临时对象，执行完安装语句后会被Python垃圾回收机制销毁，自然无法触发后续的事件回调。
• 事件处理完成后没有拦截：如果你要自定义处理Delete按键逻辑，处理完后需要返回True拦截事件继续传递，否则事件会交给控件默认逻辑处理。

事件过滤器的正确使用方式 #

第一步：修改过滤器实现 #

from PyQt5.QtCore import QObject, QEvent
from PyQt5.QtGui import QKeySequence

class DeleteEventFilter(QObject):
    def eventFilter(self, watched: 'QObject', event: 'QEvent') -> bool:
        if event.type() == QEvent.KeyPress and event.matches(QKeySequence.Delete):
            # 只处理树控件的事件
            tree_widget = watched
            # 遍历删除所有选中项
            for item in tree_widget.selectedItems():
                parent = item.parent()
                if parent:
                    # 删除子项
                    parent.removeChild(item)
                else:
                    # 删除顶层项
                    tree_widget.takeTopLevelItem(tree_widget.indexOfTopLevelItem(item))
            # 拦截事件，阻止继续传递
            return True
        # 其他事件走默认处理逻辑
        return super().eventFilter(watched, event)

第二步：正确安装过滤器 #

需要把过滤器实例存为窗口类的属性，避免被GC回收，在你的QMainWindow初始化逻辑中添加如下代码：

# 存为实例属性，生命周期和主窗口一致
self.delete_filter = DeleteEventFilter()
# 给树控件安装过滤器
self.treeWidget.installEventFilter(self.delete_filter)

更简单的替代方案 #

如果不想用事件过滤器，推荐用快捷键绑定的方案，代码更少、不易出错：

from PyQt5.QtWidgets import QShortcut
from PyQt5.QtGui import QKeySequence

# 在主窗口初始化逻辑中添加
delete_shortcut = QShortcut(QKeySequence.Delete, self.treeWidget)
delete_shortcut.activated.connect(self.delete_selected_tree_items)

# 实现删除槽函数
def delete_selected_tree_items(self):
    for item in self.treeWidget.selectedItems():
        parent = item.parent()
        if parent:
            parent.removeChild(item)
        else:
            self.treeWidget.takeTopLevelItem(self.treeWidget.indexOfTopLevelItem(item))

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