桌面应用 / 系统课时
用堆叠窗口切换功能页面
用堆叠窗口切换功能页面
当一个桌面程序需要在同一主窗口里呈现“首页、设置、关于”等不同功能页时,不必反复创建和销毁窗口。QStackedWidget 可以同时管理多个页面,并通过索引或页面对象切换当前显示内容,适合制作侧边导航、设置中心和多步骤工作区。
学习目标
- 理解
QStackedWidget保存多个页面但一次只显示一个页面的机制。 - 使用按钮连接页面切换逻辑,并避免依赖脆弱的固定索引。
- 能根据页面数量和导航方式判断何时适合使用堆叠窗口。
堆叠窗口怎样管理页面
QStackedWidget 本身是一个容器。通过 addWidget() 加入的每个 QWidget 都成为一个页面,但任一时刻只有当前页面可见。调用 setCurrentIndex() 可以按索引切换,也可以用 setCurrentWidget() 直接指定页面对象。

这种结构与多个独立窗口不同:页面共享同一个父窗口、菜单和整体尺寸,切换时通常不会销毁页面,因此输入框内容、滚动位置等页面状态可以继续保留。
用按钮完成页面切换
下面示例创建两个页面和两个导航按钮。程序将页面对象直接保存下来,再通过 setCurrentWidget() 切换,避免以后调整页面添加顺序时导致索引失效。
#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();
}预期结果
程序打开后显示“这里是首页”。
点击“设置”后,同一窗口的内容区域切换为“这里是设置页”。
再次点击“首页”后恢复首页,主窗口不会被重新创建。选择索引还是页面对象
setCurrentIndex(0) 适合页面顺序固定、索引本身具有明确含义的简单界面。工程中如果导航项可能增删或重新排序,优先保存页面指针并使用 setCurrentWidget(),代码与具体页面的对应关系更直观。
需要读取当前状态时,可以用 currentIndex() 获取当前索引,或用 currentWidget() 获得当前页面。页面尚未加入堆叠容器时,不应直接把它作为目标传给 setCurrentWidget()。
什么时候使用堆叠页面
当多个功能页属于同一个主窗口,并且用户主要通过侧边栏、工具栏或菜单在它们之间切换时,QStackedWidget 很合适。如果页面需要同时并排展示,就应使用普通布局;如果页面应作为独立顶层窗口存在,则应创建单独的窗口或对话框,而不是塞进堆叠容器。
页面较多时,还可以让导航项保存对应页面指针或业务标识,把“选择导航项”和“显示页面”集中到一个切换函数中。这样扩展新页面时只需注册一次映射关系,不必在多个槽函数里维护重复的索引判断。