桌面应用 / 系统课时

用堆叠窗口切换功能页面

用堆叠窗口切换功能页面

当一个桌面程序需要在同一主窗口里呈现“首页、设置、关于”等不同功能页时,不必反复创建和销毁窗口。QStackedWidget 可以同时管理多个页面,并通过索引或页面对象切换当前显示内容,适合制作侧边导航、设置中心和多步骤工作区。

学习目标

  • 理解 QStackedWidget 保存多个页面但一次只显示一个页面的机制。
  • 使用按钮连接页面切换逻辑,并避免依赖脆弱的固定索引。
  • 能根据页面数量和导航方式判断何时适合使用堆叠窗口。

堆叠窗口怎样管理页面

QStackedWidget 本身是一个容器。通过 addWidget() 加入的每个 QWidget 都成为一个页面,但任一时刻只有当前页面可见。调用 setCurrentIndex() 可以按索引切换,也可以用 setCurrentWidget() 直接指定页面对象。

QStackedWidget页面与导航切换关系

这种结构与多个独立窗口不同:页面共享同一个父窗口、菜单和整体尺寸,切换时通常不会销毁页面,因此输入框内容、滚动位置等页面状态可以继续保留。

用按钮完成页面切换

下面示例创建两个页面和两个导航按钮。程序将页面对象直接保存下来,再通过 setCurrentWidget() 切换,避免以后调整页面添加顺序时导致索引失效。

cpp
#include <QApplication>
#include <QHBoxLayout>
#include <QLabel>
#include <QPushButton>
#include <QStackedWidget>
#include <QVBoxLayout>
#include <QWidget>

int main(int argc, char *argv[])
{
    QApplication app(argc, argv);

    QWidget window;
    window.setWindowTitle("Stacked Pages");

    auto *homeButton = new QPushButton("首页");
    auto *settingsButton = new QPushButton("设置");

    auto *homePage = new QLabel("这里是首页");
    homePage->setAlignment(Qt::AlignCenter);
    auto *settingsPage = new QLabel("这里是设置页");
    settingsPage->setAlignment(Qt::AlignCenter);

    auto *stack = new QStackedWidget;
    stack->addWidget(homePage);
    stack->addWidget(settingsPage);

    auto *navigation = new QVBoxLayout;
    navigation->addWidget(homeButton);
    navigation->addWidget(settingsButton);
    navigation->addStretch();

    auto *layout = new QHBoxLayout(&window);
    layout->addLayout(navigation);
    layout->addWidget(stack, 1);

    // 导航直接指向页面对象,不依赖页面索引的固定顺序。
    QObject::connect(homeButton, &QPushButton::clicked, stack,
                     [stack, homePage] { stack->setCurrentWidget(homePage); });
    QObject::connect(settingsButton, &QPushButton::clicked, stack,
                     [stack, settingsPage] { stack->setCurrentWidget(settingsPage); });

    window.resize(560, 320);
    window.show();
    return app.exec();
}

预期结果

text
程序打开后显示“这里是首页”。
点击“设置”后,同一窗口的内容区域切换为“这里是设置页”。
再次点击“首页”后恢复首页,主窗口不会被重新创建。

选择索引还是页面对象

setCurrentIndex(0) 适合页面顺序固定、索引本身具有明确含义的简单界面。工程中如果导航项可能增删或重新排序,优先保存页面指针并使用 setCurrentWidget(),代码与具体页面的对应关系更直观。

需要读取当前状态时,可以用 currentIndex() 获取当前索引,或用 currentWidget() 获得当前页面。页面尚未加入堆叠容器时,不应直接把它作为目标传给 setCurrentWidget()。

什么时候使用堆叠页面

当多个功能页属于同一个主窗口,并且用户主要通过侧边栏、工具栏或菜单在它们之间切换时,QStackedWidget 很合适。如果页面需要同时并排展示,就应使用普通布局;如果页面应作为独立顶层窗口存在,则应创建单独的窗口或对话框,而不是塞进堆叠容器。

页面较多时,还可以让导航项保存对应页面指针或业务标识,把“选择导航项”和“显示页面”集中到一个切换函数中。这样扩展新页面时只需注册一次映射关系,不必在多个槽函数里维护重复的索引判断。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用堆叠窗口切换功能页面

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通