PyQt6 QGraphicsView事件过滤器未触发问题求助

问题根源 #

• 事件过滤器安装对象错误：你把过滤器绑定在了QGraphicsScene实例上，但鼠标点击事件首先会传递给QGraphicsView的viewport部件，而非场景（scene）。场景的鼠标事件是由viewport转发的，只有拦截viewport的事件才能在更早阶段捕获。
• 事件过滤器返回值逻辑不当：原代码无条件返回True，会强制拦截所有事件，且未区分事件来源，容易影响QGraphicsView的其他功能（如滚动、缩放）。

修改后的代码 #

from PyQt6 import QtWidgets
from PyQt6.QtCore import QEvent, Qt

class display(QtWidgets.QGraphicsView):
    def __init__(self, parent):
        super(display, self).__init__(parent)
        self._scene = QtWidgets.QGraphicsScene(self)
        self.setScene(self._scene)
        # 给viewport安装事件过滤器，而非scene
        self.viewport().installEventFilter(self)

    def eventFilter(self, obj, event):
        # 仅处理viewport的鼠标点击事件
        if obj is self.viewport() and event.type() == QEvent.Type.MouseButtonPress:
            if event.button() == Qt.MouseButton.RightButton:
                print("右键被拦截")
            elif event.button() == Qt.MouseButton.LeftButton:
                print("左键被拦截")
            # 返回True表示拦截该事件，不再向下传递
            return True
        # 其他事件交给父类处理，不拦截
        return super().eventFilter(obj, event)

    def mousePressEvent(self, event):
        print("触发了mousePressEvent")
        super(display, self).mousePressEvent(event)

class Window(QtWidgets.QWidget):
    def __init__(self):
        super(Window, self).__init__()
        self.viewer = display(self)
        VBlayout = QtWidgets.QVBoxLayout(self)
        VBlayout.addWidget(self.viewer)
        self.setLayout(VBlayout)

if __name__ == '__main__':
    import sys
    app = QtWidgets.QApplication(sys.argv)
    window = Window()
    window.setGeometry(500, 300, 800, 600)
    window.show()
    sys.exit(app.exec())

关键修改说明 #

1. 更换事件过滤器绑定目标：将self._scene.installEventFilter(self)改为self.viewport().installEventFilter(self)，确保过滤器监听的是直接接收鼠标事件的viewport部件。
2. 优化事件处理逻辑：
   • 先判断事件来源为viewport，避免处理无关对象的事件。
   • 仅在捕获到目标鼠标点击事件时返回True拦截，其他事件调用父类的eventFilter方法让事件正常传递，避免破坏QGraphicsView的原有功能。
   • 使用elif替代多个独立if，减少冗余判断。

修改后，鼠标点击事件会被事件过滤器拦截，不会触发mousePressEvent。如果需要放行特定事件，只需在对应条件下返回False或父类处理结果即可。

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