Qt中QGraphicsItem右键菜单后鼠标异常移动问题求解

你遇到的异常是因为右键菜单操作干扰了QGraphicsItem的鼠标事件状态，导致Qt的拖拽机制误判了鼠标操作的目标。以下是两种实现的具体修正方案：

第一种Square实现（自定义拖拽逻辑） #

原代码的问题在于：

• 未区分左键/右键点击，右键菜单操作后item的鼠标状态未正确重置
• 拖拽逻辑直接使用事件的场景位置，导致移动异常
• 未调用父类的鼠标事件方法，破坏了Qt的事件传递链

修正后的代码：

class Square : public QObject, public QGraphicsItem
{
    Q_OBJECT

public:
    explicit Square(QObject* parent = nullptr) : QObject(parent), QGraphicsItem(), m_leftButtonPressed(false) {}
    ~Square() {}

private:
    QRectF boundingRect() const override { return {-3,-3,6,6}; }
    bool m_leftButtonPressed; // 记录左键是否按下

    void paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget) override
    {
        painter->setPen(Qt::black);
        painter->setBrush(Qt::green);
        painter->drawSquare(-3,-3,6,6);
        Q_UNUSED(option);
        Q_UNUSED(widget);
    }

    void mousePressEvent(QGraphicsSceneMouseEvent *event) override 
    {
        if (event->button() == Qt::LeftButton) {
            m_leftButtonPressed = true;
        }
        QGraphicsItem::mousePressEvent(event); // 必须调用父类方法，维护事件状态
    }

    void mouseReleaseEvent(QGraphicsSceneMouseEvent* event) override 
    {
        if (event->button() == Qt::LeftButton) {
            m_leftButtonPressed = false;
        }
        QGraphicsItem::mouseReleaseEvent(event);
    }

    void mouseMoveEvent(QGraphicsSceneMouseEvent *event) override
    {
        if (m_leftButtonPressed) {
            // 计算鼠标偏移量，实现平滑拖拽
            QPointF clickPosInScene = mapToScene(event->buttonDownPos(Qt::LeftButton));
            QPointF currentPosInScene = mapToScene(event->pos());
            QPointF delta = currentPosInScene - clickPosInScene;
            setPos(pos() + delta);
        }
        QGraphicsItem::mouseMoveEvent(event);
    }
};

第二种Square实现（使用ItemIsMovable） #

原代码的问题在于：右键点击时未调用父类的mousePressEvent，也未正确处理事件状态，导致Qt的内置拖拽机制误以为左键仍处于按下状态。

修正后的代码：

class Square : public QObject, public QGraphicsItem
{
    Q_OBJECT

public:
    explicit Square(QObject* parent = nullptr) : QObject(parent), QGraphicsItem()
    { setFlag(ItemIsMovable); }
    ~Square(){}

private:
    QRectF boundingRect() const override { return {-3,-3,6,6}; }

    void paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget) override
    {
        painter->setPen(Qt::black);
        painter->setBrush(Qt::green);
        painter->drawRect(-3,-3,6,6);
        Q_UNUSED(option);
        Q_UNUSED(widget);
    }

    void mousePressEvent(QGraphicsSceneMouseEvent *event) override
    {
        if (event->button() == Qt::RightButton) {
            QMenu contextMenu;
            QAction *action1 = contextMenu.addAction("Action 1");
            QAction *action2 = contextMenu.addAction("Action 2");

            connect(action1, &QAction::triggered, this, [this]() {
                qDebug() << "Action 1 triggered";
            });

            connect(action2, &QAction::triggered, this, [this]() {
                qDebug() << "Action 2 triggered";
            });
            contextMenu.exec(event->screenPos());
            event->accept(); // 明确标记右键事件已处理，避免父类误触发拖拽逻辑
        } else {
            // 左键点击交给父类处理内置拖拽
            QGraphicsItem::mousePressEvent(event);
        }
    }
};

额外说明 #

• 无论哪种实现，都必须调用父类的鼠标事件方法，确保Qt维护正确的事件状态和拖拽上下文
• 自定义拖拽时，必须通过鼠标按下位置和当前位置的偏移量计算移动，避免直接设置场景位置导致的跳动
• 右键菜单处理时，要明确标记事件已被接受，防止事件传递到父类引发意外行为

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