QT6.5中QGraphicsView居中图像时无法显示外部空白的问题求助

需求与现状 #

• 点击绿色矩形后，将该矩形居中显示在视图中
• 当绿色矩形靠近图像（场景）边界时，视图中未显示图像的区域需显示白色空白（预期效果如图1）
• 当前问题：使用centerOn()方法居中时，无法实现上述空白显示效果（当前效果如图2）

现有代码 #

自定义GraphicsView（重载鼠标点击事件） #

class CustomGraphicsView : public QGraphicsView {
    Q_OBJECT
public:
    CustomGraphicsView(QWidget* parent = nullptr) : QGraphicsView(parent) {
        setBackgroundBrush(Qt::white);
    }
signals:
    void mouseClicked(const QPointF& pos);
protected:
   
    void mousePressEvent(QMouseEvent* event) override {
        QPoint viewportPos = event->pos();
        QPointF scenePos = mapToScene(viewportPos);
        emit mouseClicked(scenePos);
        QGraphicsView::mousePressEvent(event);
    }
};

鼠标点击信号处理函数 #

void MainWindow::onMouseClicked(const QPointF& pos)
{
    qDebug() << "Mouse clicked at scene position:" << pos;

    QString textContent = ui->textEdit->toPlainText();
    QTextStream stream(&textContent);
    // 程序中可能存在多个矩形
    // xe、ye为矩形左上角坐标，rectWidthe、rectHighte为矩形的宽高
    for(int i = 0;i<xe.size();i++)
    {
        if(pos.x()>=xe[i] && pos.x()<=xe[i]+rectWidthe[i])
            if(pos.y()>=ye[i] && pos.y()<=ye[i]+rectHighte[i])
            {
                QPointF pos1;
                // pos1为矩形的中心点
                pos1.setX(xe[i]+rectWidthe[i]/2);
                pos1.setY(ye[i]+rectHighte[i]/2);
                ui->Image->centerOn(pos1);
                return;
            }
    }
}

解决方案 #

默认的centerOn()方法会自动调整视图，尽可能让场景内容填满视图区域，因此无法显示场景外的空白。需要手动计算视图滚动位置，允许视图部分区域超出场景边界，从而显示背景空白。

修改鼠标点击处理函数如下：

void MainWindow::onMouseClicked(const QPointF& pos)
{
    qDebug() << "Mouse clicked at scene position:" << pos;

    QString textContent = ui->textEdit->toPlainText();
    QTextStream stream(&textContent);
    // 程序中可能存在多个矩形
    // xe、ye为矩形左上角坐标，rectWidthe、rectHighte为矩形的宽高
    for(int i = 0;i<xe.size();i++)
    {
        if(pos.x()>=xe[i] && pos.x()<=xe[i]+rectWidthe[i]
        && pos.y()>=ye[i] && pos.y()<=ye[i]+rectHighte[i])
        {
            QGraphicsView* view = ui->Image;
            // 计算矩形中心点
            QPointF rectCenter(xe[i] + rectWidthe[i]/2, ye[i] + rectHighte[i]/2);
            
            // 获取视图可视区域的场景坐标尺寸
            QRectF viewSceneRect = view->mapToScene(view->viewport()->rect()).boundingRect();
            qreal viewHalfWidth = viewSceneRect.width() / 2;
            qreal viewHalfHeight = viewSceneRect.height() / 2;
            
            // 计算视图左上角需要移动到的场景坐标
            qreal targetViewLeft = rectCenter.x() - viewHalfWidth;
            qreal targetViewTop = rectCenter.y() - viewHalfHeight;
            
            // 设置视图对齐方式为左上，取消自动居中适配
            view->setAlignment(Qt::AlignLeft | Qt::AlignTop);
            
            // 计算滚动条目标位置（基于场景左上角偏移）
            QRectF sceneRect = view->scene()->sceneRect();
            int hScrollValue = qRound(targetViewLeft - sceneRect.left());
            int vScrollValue = qRound(targetViewTop - sceneRect.top());
            
            // 应用滚动条位置
            view->horizontalScrollBar()->setValue(hScrollValue);
            view->verticalScrollBar()->setValue(vScrollValue);
            
            return;
        }
    }
}

说明 #

1. 取消视图的自动居中对齐，改为左上对齐，避免centerOn()的自动适配逻辑干扰
2. 手动计算视图需要滚动到的位置，确保矩形中心点位于视图中心
3. 当矩形靠近场景边界时，视图的部分区域会超出场景范围，此时视图会显示已设置的白色背景，即需求中的空白效果

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