如何在QWidget中切换两个QGraphicsView？问题排查及优化方案

问题描述 #

需要在QWidget窗口中展示两个绑定独立QGraphicsScene的QGraphicsView，通过点击按钮实现视图切换。当前实现代码如下：

void toggleUi(bool type){
    QGraphicsView* currentView;
    
    if(type){
     currentView = getFirstView(); // 返回第一种类型的QGraphicsView
    }
    else{
     currentView = getSecondView(); // 返回第二种类型的QGraphicsView
    }

    QLayout* layout = widget->layout ();
    if (layout != 0)
    {
    QLayoutItem *item;
    while ((item = layout->takeAt(0)) != 0)
        layout->removeItem (item);
    delete layout;
    }

   QVBoxLayout *layout = new QVBoxLayout(this);
   layout->addWidget(currentView);
}

遇到的问题：切换视图时两个视图重叠显示，无切换操作时各自可正常渲染。

当前代码的问题分析 #

1. 变量重定义：先后两次声明layout变量，属于语法错误，且新布局绑定到了this而非目标widget，导致布局未正确关联到目标窗口。
2. 视图未移除：删除旧布局时仅移除了布局项，但旧的QGraphicsView仍是widget的子控件，未被隐藏或移除，因此会与新视图重叠。
3. 布局反复重建：频繁删除和创建布局属于低效操作，容易引发控件管理问题。

优化实现方案 #

方案一：使用QStackedWidget（推荐） #

QStackedWidget是Qt专为视图切换设计的控件，内部自动处理视图的显示、隐藏与布局管理，代码简洁且不易出错。

步骤1：初始化视图与StackedWidget

在类的成员变量中声明：

QStackedWidget* m_stackedWidget;
QGraphicsView* m_view1;
QGraphicsView* m_view2;

在构造函数或初始化函数中完成控件创建与布局：

// 初始化两个视图及对应Scene
m_view1 = getFirstView();
m_view2 = getSecondView();

// 创建StackedWidget并添加视图
m_stackedWidget = new QStackedWidget(widget);
m_stackedWidget->addWidget(m_view1);
m_stackedWidget->addWidget(m_view2);

// 将StackedWidget设置为widget的布局
QVBoxLayout* layout = new QVBoxLayout(widget);
layout->addWidget(m_stackedWidget);

步骤2：实现切换逻辑

void toggleUi(bool type){
    if(type){
        m_stackedWidget->setCurrentWidget(m_view1);
    } else {
        m_stackedWidget->setCurrentWidget(m_view2);
    }
}

方案二：手动控制视图显示与隐藏 #

无需修改布局，仅通过show()和hide()方法控制视图可见性，逻辑简单直接。

步骤1：初始化视图与布局

成员变量声明：

QGraphicsView* m_view1;
QGraphicsView* m_view2;

初始化代码：

m_view1 = getFirstView();
m_view2 = getSecondView();

// 将两个视图都添加到布局中
QVBoxLayout* layout = new QVBoxLayout(widget);
layout->addWidget(m_view1);
layout->addWidget(m_view2);

// 默认显示第一个视图，隐藏第二个
m_view2->hide();

步骤2：实现切换逻辑

void toggleUi(bool type){
    if(type){
        m_view1->show();
        m_view2->hide();
    } else {
        m_view1->hide();
        m_view2->show();
    }
}

原代码修复（不推荐） #

如果一定要保留原有的布局重建思路，需修正以下问题：

void toggleUi(bool type){
    QGraphicsView* currentView = type ? getFirstView() : getSecondView();

    QLayout* oldLayout = widget->layout();
    if (oldLayout != nullptr) {
        // 遍历布局项，移除并隐藏旧视图
        QLayoutItem* item;
        while ((item = oldLayout->takeAt(0)) != nullptr) {
            if (QWidget* w = item->widget()) {
                w->hide();
                w->setParent(nullptr); // 从widget中移除子控件
            }
            delete item;
        }
        delete oldLayout;
    }

    // 创建新布局并绑定到widget
    QVBoxLayout* newLayout = new QVBoxLayout(widget);
    newLayout->addWidget(currentView);
    currentView->show();
}

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