如何使QGraphicsItem进入模拟左键按住拖动的移动状态？

要实现点击“添加”按钮后，新元素立即进入拖动状态（模拟用户按住左键拖动的效果），不需要用风险较高的鼠标捕获操作，Qt有两种更安全的实现方式：

方法一：模拟原生鼠标事件触发拖动 #

利用Qt的事件发送机制，给新添加的item发送鼠标按下、移动、释放事件，完全复用Qt自带的拖动逻辑：

1. 确保item可移动：创建item时开启ItemIsMovable标志
2. 发送鼠标按下事件：添加item后，构造QGraphicsSceneMouseEvent并发送给item，让其认为被左键按下
3. 跟进鼠标移动事件：在场景的鼠标移动事件中，持续给当前拖动的item发送移动事件
4. 处理鼠标释放：鼠标松开时发送释放事件，结束拖动状态

代码示例 #

按钮点击槽函数（添加item并触发拖动）

void YourWidget::on_addBtn_clicked() {
    // 创建示例item（可替换为自定义QGraphicsItem）
    QGraphicsRectItem* item = new QGraphicsRectItem(QRectF(-20, -20, 40, 40));
    item->setFlag(QGraphicsItem::ItemIsMovable, true);
    item->setBrush(Qt::red);
    m_scene->addItem(item);

    // 获取当前鼠标在场景中的位置
    QGraphicsView* view = m_scene->views().first();
    QPointF mouseScenePos = view->mapToScene(QCursor::pos());
    item->setPos(mouseScenePos);

    // 构造并发送鼠标按下事件
    QGraphicsSceneMouseEvent pressEvent(QEvent::GraphicsSceneMousePress);
    pressEvent.setButton(Qt::LeftButton);
    pressEvent.setScenePos(mouseScenePos);
    pressEvent.setScreenPos(QCursor::pos());
    pressEvent.setPos(item->mapFromScene(mouseScenePos)); // 转换为item局部坐标
    QCoreApplication::sendEvent(item, &pressEvent);

    // 记录当前拖动的item（需在类中声明成员变量QGraphicsItem* m_currentDraggingItem;）
    m_currentDraggingItem = item;
}

重写场景的鼠标事件（处理拖动过程）

void YourGraphicsScene::mouseMoveEvent(QGraphicsSceneMouseEvent* event) {
    QGraphicsScene::mouseMoveEvent(event); // 保留原生场景事件处理

    if (m_currentDraggingItem) {
        QGraphicsSceneMouseEvent moveEvent(QEvent::GraphicsSceneMouseMove);
        moveEvent.setButton(Qt::LeftButton);
        moveEvent.setScenePos(event->scenePos());
        moveEvent.setScreenPos(event->screenPos());
        moveEvent.setPos(m_currentDraggingItem->mapFromScene(event->scenePos()));
        QCoreApplication::sendEvent(m_currentDraggingItem, &moveEvent);
    }
}

void YourGraphicsScene::mouseReleaseEvent(QGraphicsSceneMouseEvent* event) {
    QGraphicsScene::mouseReleaseEvent(event);

    if (m_currentDraggingItem) {
        QGraphicsSceneMouseEvent releaseEvent(QEvent::GraphicsSceneMouseRelease);
        releaseEvent.setButton(Qt::LeftButton);
        releaseEvent.setScenePos(event->scenePos());
        releaseEvent.setScreenPos(event->screenPos());
        releaseEvent.setPos(m_currentDraggingItem->mapFromScene(event->scenePos()));
        QCoreApplication::sendEvent(m_currentDraggingItem, &releaseEvent);
        
        m_currentDraggingItem = nullptr; // 清空拖动标记
    }
}

方法二：自定义item的拖动逻辑 #

如果需要更灵活的拖动行为（比如限制拖动范围、修改拖动速度），可以直接在自定义QGraphicsItem中实现拖动逻辑：

自定义Item代码 #

class DraggableItem : public QGraphicsRectItem {
public:
    DraggableItem(QRectF rect, QGraphicsItem* parent = nullptr) 
        : QGraphicsRectItem(rect, parent) {
        setFlag(ItemIsMovable, true);
        m_isDragging = false;
    }

    // 外部调用此方法启动拖动
    void startDragging(QPointF scenePos) {
        m_isDragging = true;
        m_lastMousePos = mapFromScene(scenePos);
    }

protected:
    void mouseMoveEvent(QGraphicsSceneMouseEvent* event) override {
        if (m_isDragging) {
            // 计算鼠标偏移量，移动item
            QPointF delta = event->pos() - m_lastMousePos;
            moveBy(delta.x(), delta.y());
            m_lastMousePos = event->pos();
        } else {
            QGraphicsRectItem::mouseMoveEvent(event); // 保留原生行为
        }
    }

    void mouseReleaseEvent(QGraphicsSceneMouseEvent* event) override {
        m_isDragging = false;
        QGraphicsRectItem::mouseReleaseEvent(event);
    }

private:
    bool m_isDragging;
    QPointF m_lastMousePos;
};

按钮点击槽函数（启动自定义拖动） #

void YourWidget::on_addBtn_clicked() {
    DraggableItem* item = new DraggableItem(QRectF(-20, -20, 40, 40));
    item->setBrush(Qt::blue);
    m_scene->addItem(item);

    QGraphicsView* view = m_scene->views().first();
    QPointF mouseScenePos = view->mapToScene(QCursor::pos());
    item->setPos(mouseScenePos);
    
    // 直接调用item的方法启动拖动
    item->startDragging(mouseScenePos);
}

注意事项 #

• 两种方法都不需要使用grabMouse()这类强捕获鼠标的操作，不会导致鼠标锁定或异常行为
• 方法一完全复用Qt原生拖动逻辑，和用户手动拖动的体验一致；方法二更适合需要定制拖动行为的场景
• 如果场景有多个view，需要确保获取的是当前激活的view来转换鼠标坐标

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