PyQt5 QGraphicsScene实现单击拾取移动、再次单击放置图元问题

QGraphicsScene 默认的鼠标事件逻辑支持通过按住鼠标拖动（按下-按住移动-释放）的操作移动场景内的图元（Item）。我尝试重写 QGraphicsScene 的鼠标事件函数，实现单击一次拾取图元、无需按住鼠标即可跟随光标移动、再次单击放置图元的交互效果，最初编写的代码如下：

self.moving = False
def mousePressEvent(self, event):
    if event.button() == Qt.LeftButton:
        if self.moving == False: # 第一次点击，拾取图元，开始移动
            super().mousePressEvent(event)
            self.moving = True
        else:                    # 第二次点击，放置图元，结束移动
            super().mouseReleaseEvent(event)
            self.moving = False    

def mouseMoveEvent(self, event):      
    if self.moving == True:
        super().mousePressEvent(event)
        super().mouseMoveEvent(event)

def mouseReleaseEvent(self, event):      
    pass

上述代码无法正常实现拾取移动图元的效果，存在两个疑问：

• 这段代码的逻辑存在什么问题？
• 可以从什么渠道获取 QGraphicsScene 鼠标事件函数的原生实现代码？

代码逻辑的错误点 #

你的实现完全误解了Qt图形视图框架的拖拽状态机制，核心问题有3个：

• 原生的按住拖拽逻辑依赖连续的事件状态：第一次点击调用super().mousePressEvent(event)后，框架会等待后续的鼠标移动、释放事件完成完整拖拽流程，但你在mouseReleaseEvent中直接写了pass，没有把第一次点击后的释放事件传递给父类，框架会直接终止拖拽状态，根本不会进入移动流程。
• 移动阶段每次触发mouseMoveEvent都额外调用一次super().mousePressEvent(event)是完全错误的操作，会反复触发新的图元选中、拖拽启动逻辑，打乱框架内部的事件状态机。
• 第二次点击时你给父类传入的是鼠标按压事件，却调用super().mouseReleaseEvent(event)，事件类型、坐标、状态都和原生释放逻辑要求的参数不匹配，根本无法触发正确的放置逻辑。

不要强行适配原生的按住拖拽逻辑，自己维护移动状态即可，可参考以下实现：

from PyQt5.QtGui import QTransform

# 类内初始化
self.moving = False
self.moving_item = None
self.item_offset = None

def mousePressEvent(self, event):
    if event.button() == Qt.LeftButton:
        if not self.moving:
            # 拾取阶段：获取点击位置的图元
            target_item = self.itemAt(event.scenePos(), QTransform())
            if target_item:
                self.moving = True
                self.moving_item = target_item
                # 记录偏移量，避免图元直接跳转到光标锚点位置
                self.item_offset = event.scenePos() - target_item.pos()
        else:
            # 放置阶段：清空移动状态
            self.moving = False
            self.moving_item = None
            self.item_offset = None
    # 非移动操作走默认事件逻辑
    super().mousePressEvent(event)

def mouseMoveEvent(self, event):
    if self.moving and self.moving_item:
        # 移动状态下直接更新图元坐标，不需要调用原生拖拽逻辑
        self.moving_item.setPos(event.scenePos() - self.item_offset)
        return
    super().mouseMoveEvent(event)

def mouseReleaseEvent(self, event):
    # 移动状态下屏蔽默认释放逻辑，避免干扰原生状态
    if not self.moving:
        super().mouseReleaseEvent(event)

获取原生实现代码的渠道 #

• 安装Qt时勾选源码组件，就可以在本地Qt安装目录下的Src/qtbase/src/widgets/graphicsview/qgraphicsscene.cpp文件中找到QGraphicsScene所有鼠标事件函数的完整实现，不同Qt版本的逻辑差异也可以通过对比本地源码确认。
• Qt是开源项目，对应版本的源码也可以在Qt官方开源代码仓库中找到。

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