PyQt5中mouseReleaseEvent未正常触发的问题解决问询

问题原因 #

调用super().mousePressEvent(event)时，父类QGraphicsEllipseItem的默认实现会检查item的标记（如ItemIsMovable或ItemIsSelectable）。如果没有这些标记，它不会主动抓取鼠标焦点，导致后续的mouseReleaseEvent无法被当前item接收，而是直接发送到场景或视图层面。

反之，当你不调用父类的mousePressEvent时，事件未被父类处理，Qt会默认让item保持对鼠标事件的跟踪，因此release事件能正常触发。

解决方案 #

不需要设置ItemIsMovable或ItemIsSelectable标记，只需在mousePressEvent中手动调用grabMouse()强制抓取鼠标，确保后续的release事件能被当前item接收；同时在mouseReleaseEvent中调用ungrabMouse()释放鼠标，避免影响其他交互逻辑。

修改后的完整代码：

from PyQt5.QtWidgets import QApplication, QMainWindow, QGraphicsScene, QGraphicsView, QGraphicsEllipseItem, \
    QGraphicsItem, QGraphicsSceneMouseEvent
import sys


class EllipseItem(QGraphicsEllipseItem):
    def __init__(self):
        super().__init__(0, 0, 100, 100)

    def mousePressEvent(self, event: 'QGraphicsSceneMouseEvent') -> None:
        super().mousePressEvent(event)
        self.grabMouse()  # 手动抓取鼠标焦点
        print("Mouse Pressed")

    def mouseReleaseEvent(self, event: 'QGraphicsSceneMouseEvent') -> None:
        super().mouseReleaseEvent(event)
        self.ungrabMouse()  # 释放鼠标焦点
        print("Mouse Released")


class Window(QMainWindow):
    def __init__(self):
        super(Window, self).__init__()

        self.title = "mouse Release"
        self.width = 800
        self.height = 600

        # 初始化UI
        self.canvas = QGraphicsScene()
        self.graphics_view = QGraphicsView(self.canvas, self)
        self.graphics_view.setGeometry(0, 0, self.width, self.height)

        self.canvas.addItem(EllipseItem())

        self.setWindowTitle(self.title)
        self.setGeometry(0, 0, 800, 600)
        self.show()


def main():
    app = QApplication(sys.argv)
    window = Window()
    sys.exit(app.exec())


if __name__ == '__main__':
    main()

补充说明 #

• grabMouse()会让当前item成为鼠标事件的唯一接收者，直到调用ungrabMouse()或其他item抢占鼠标焦点。
• 这种方式既保留了父类mousePressEvent的默认行为，又确保release事件能正确触发，同时无需开启移动或选中标记，满足自定义交互的需求。

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