QGraphicsView模拟左键触发ScrollHandDrag时滚动条重置问题

核心问题分析 #

1. 坐标系统不匹配：你构造模拟左键事件时使用了场景坐标（event->pos()/event->scenePos()），但QGraphicsView的viewport需要自身局部坐标系下的位置。这会导致视图错误计算拖动起点，进而触发滚动条跳变。
2. 未处理鼠标释放事件：仅模拟左键按下而不释放，会导致视图认为左键始终处于按下状态，后续操作可能异常，且拖动模式无法自动重置。
3. 未拦截原中键事件：原中键事件未被接受，Qt默认的中键操作（如滚轮滚动）可能与自定义逻辑冲突，加剧视图跳变。

修正后的代码实现 #

重写mousePressEvent

void YourScene::mousePressEvent(QGraphicsSceneMouseEvent *event)
{
    switch (event->button()) {
    case Qt::MiddleButton: {
        QGraphicsView* view = views().first();
        if (!view) break;

        view->setDragMode(QGraphicsView::ScrollHandDrag);

        // 构造正确的左键按下事件（使用viewport局部坐标）
        QMouseEvent leftPressEvent(
            QEvent::MouseButtonPress,
            event->viewportPos().toPoint(), // viewport局部位置
            event->screenPos().toPoint(),   // 窗口位置
            event->screenPos().toPoint(),   // 全局位置
            Qt::LeftButton,
            Qt::LeftButton,
            Qt::NoModifier
        );
        QApplication::sendEvent(view->viewport(), &leftPressEvent);

        event->accept();
        return;
    }
    default:
        break;
    }
    QGraphicsScene::mousePressEvent(event);
}

重写mouseReleaseEvent

void YourScene::mouseReleaseEvent(QGraphicsSceneMouseEvent *event)
{
    switch (event->button()) {
    case Qt::MiddleButton: {
        QGraphicsView* view = views().first();
        if (!view) break;

        // 构造左键释放事件
        QMouseEvent leftReleaseEvent(
            QEvent::MouseButtonRelease,
            event->viewportPos().toPoint(),
            event->screenPos().toPoint(),
            event->screenPos().toPoint(),
            Qt::LeftButton,
            Qt::NoButton,
            Qt::NoModifier
        );
        QApplication::sendEvent(view->viewport(), &leftReleaseEvent);

        view->setDragMode(QGraphicsView::NoDrag);
        event->accept();
        return;
    }
    default:
        break;
    }
    QGraphicsScene::mouseReleaseEvent(event);
}

关键说明 #

• 使用event->viewportPos()获取viewport局部坐标，确保模拟事件的位置与用户实际点击位置匹配。
• 调用event->accept()阻止Qt对中键事件的默认处理，避免冲突。
• 在mouseReleaseEvent中同步模拟左键释放并重置拖动模式，保证操作的完整性。

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