QT中QStackedWidget控件功能及应用

一.概述

1.介绍

QStackedWidget 是 Qt 中一个非常重要的容器控件，它允许你在同一区域显示多个页面（子部件），但每次只显示其中一个页面。

StackedWidget 是 Qt 中实现多页面应用的强大工具，特别适合需要复杂页面切换逻辑的场景。

2.核心特性

二.代码示例

1.基本功能

QVBoxLayout *mainLayout = new QVBoxLayout(this);

// 创建 Stacked Widget

QStackedWidget *stackedWidget = new QStackedWidget(this);

stackedWidget->setGeometry(50, 150, 100, 100); //控件绝对位置，长、宽

// 创建多个页面并添加到 Stacked Widget

// 页面1：欢迎页面

QWidget *page1 = new QWidget(this);

QVBoxLayout *layout1 = new QVBoxLayout(page1);

layout1->addWidget(new QLabel("欢迎使用我的应用!"));

QPushButton *toPage2Btn = new QPushButton("前往设置");

layout1->addWidget(toPage2Btn);

stackedWidget->addWidget(page1); // 索引0

// 页面2：设置页面

QWidget *page2 = new QWidget(this);

page2->setStyleSheet("background-color: green;" );// 背景色

QVBoxLayout *layout2 = new QVBoxLayout(page2);

layout2->addWidget(new QLabel("应用设置"));

QPushButton *toPage1Btn = new QPushButton(this);

toPage1Btn->setText("返回首页");

layout2->addWidget(toPage1Btn);

stackedWidget->addWidget(page2); // 索引1

// 页面3：关于页面

QWidget *page3 = new QWidget(this);

page3->setStyleSheet("background-color: red;" );// 背景色

QVBoxLayout *layout3 = new QVBoxLayout(page3);

layout3->addWidget(new QLabel("关于我们"));

QPushButton *toPage1Btn2 = new QPushButton(this);

toPage1Btn2->setText("返回首页1");

layout3->addWidget(toPage1Btn2);

stackedWidget->addWidget(page3); // 索引2

// 添加控制按钮

QHBoxLayout *controlLayout = new QHBoxLayout(this);

QPushButton *prevBtn = new QPushButton(this);

prevBtn->setGeometry(250, 150, 80, 50); //控件绝对位置，长、宽

prevBtn->setText("上一页");

QPushButton *nextBtn = new QPushButton(this);

nextBtn->setGeometry(350, 150, 80, 50); //控件绝对位置，长、宽

nextBtn->setText("下一页");

controlLayout->addWidget(prevBtn);

controlLayout->addWidget(nextBtn);

// 组装界面

mainLayout->addWidget(stackedWidget);

mainLayout->addLayout(controlLayout);

// 连接信号槽

QObject::connect(toPage2Btn, &QPushButton::clicked, stackedWidget() {

stackedWidget->setCurrentIndex(1); // 切换到设置页面

});

QObject::connect(toPage1Btn, &QPushButton::clicked, stackedWidget() {

stackedWidget->setCurrentIndex(0); // 切换回首页

});

QObject::connect(toPage1Btn2, &QPushButton::clicked, stackedWidget() {

stackedWidget->setCurrentIndex(0); // 切换回首页

});

QObject::connect(prevBtn, &QPushButton::clicked, stackedWidget() {

int current = stackedWidget->currentIndex();

int count = stackedWidget->count();

stackedWidget->setCurrentIndex((current - 1 + count) % count);

});

QObject::connect(nextBtn, &QPushButton::clicked, stackedWidget() {

int current = stackedWidget->currentIndex();

int count = stackedWidget->count();

stackedWidget->setCurrentIndex((current + 1) % count);

});

2.常用方法详解

（1）页面管理方法

// 添加页面

int index1 = stackedWidget->addWidget(pageWidget); // 返回页面索引

// 插入页面

int index2 = stackedWidget->insertWidget(1, anotherWidget); // 在指定位置插入

// 移除页面（不删除部件）

stackedWidget->removeWidget(pageWidget);

// 获取页面数量

int pageCount = stackedWidget->count();

// 获取指定索引的页面

QWidget *widget = stackedWidget->widget(2);

// 获取页面索引

int index = stackedWidget->indexOf(pageWidget);

（2）页面切换方法

// 通过索引切换

stackedWidget->setCurrentIndex(2);

// 通过部件指针切换

stackedWidget->setCurrentWidget(pageWidget);

// 获取当前页面索引

int currentIndex = stackedWidget->currentIndex();

// 获取当前页面部件

QWidget *currentWidget = stackedWidget->currentWidget();

三.与 QTabWidget 的对比