QStackedWidget 是 Qt 框架中的一个容器小部件，它允许你将多个子小部件（通常是 QWidget 对象）堆叠起来，但是每次只能显示其中一个。它类似于一个标签页式的界面，用户可以通过点击不同的标签来切换显示不同的内容。
1.基本概念
以下是一些关于 QStackedWidget 的关键点：
属性
currentIndex: 当前显示的子小部件的索引。count:QStackedWidget中包含的子小部件的数量。
方法
addWidget(QWidget *widget): 向QStackedWidget中添加一个新的子小部件。removeWidget(QWidget *widget): 从QStackedWidget中移除一个子小部件。setCurrentIndex(int index): 设置当前显示的子小部件的索引。setCurrentWidget(QWidget *widget): 设置当前显示的子小部件，通过小部件指针。
信号
currentChanged(int index): 当当前显示的子小部件的索引改变时发出。
示例
以下是一个简单的例子，展示了如何使用 QStackedWidget：
#include <QApplication>
#include <QStackedWidget>
#include <QWidget>
#include <QPushButton>
#include <QVBoxLayout>
int main(int argc, char *argv[]) {
QApplication app(argc, argv);
// 创建 QStackedWidget 实例
QStackedWidget stackedWidget;
// 创建第一个页面
QWidget *page1 = new QWidget;
QVBoxLayout *layout1 = new QVBoxLayout(page1);
layout1->addWidget(new QPushButton("按钮1"));
layout1->addWidget(new QPushButton("按钮2"));
stackedWidget.addWidget(page1);
// 创建第二个页面
QWidget *page2 = new QWidget;
QVBoxLayout *layout2 = new QVBoxLayout(page2);
layout2->addWidget(new QPushButton("按钮3"));
layout2->addWidget(new QPushButton("按钮4"));
stackedWidget.addWidget(page2);
// 显示 QStackedWidget
stackedWidget.show();
return app.exec();
}
在这个例子中，我们创建了一个 QStackedWidget，并向其中添加了两个页面。每个页面包含两个按钮。由于 QStackedWidget 只显示当前索引对应的页面，所以用户可以通过 setCurrentIndex 方法来切换显示不同的页面。
动画效果
QStackedWidget 支持在页面切换时添加动画效果。你可以通过设置 QStackedWidget 的 animation 属性来实现：
stackedWidget.setAnimationOptions(QStackedWidget::SlideLeft);
这将使页面切换时向左滑动。
QStackedWidget 是 Qt 中的一个类，它是一个用于在多个布局容器之间切换的容器。它类似于一个堆栈，每次只能显示一个布局。用户可以通过调用 setCurrentIndex() 方法来改变当前显示的布局。下面是如何使用 QStackedWidget 的一些基本步骤：
2.进阶内容
定义和初始化 QStackedWidget
首先，你需要在你的 Qt 项目中包含 QStackedWidget：
#include <QStackedWidget>
然后在你的类中初始化 QStackedWidget：
QStackedWidget *stackedWidget = new QStackedWidget(this);
添加页面到 QStackedWidget
你可以通过调用 addWidget() 方法来向 QStackedWidget 添加页面。每个页面通常是一个 QWidget 的实例：
QWidget *page1 = new QWidget();
QWidget *page2 = new QWidget();
// 添加页面到 QStackedWidget
stackedWidget->addWidget(page1);
stackedWidget->addWidget(page2);
设置当前页面
你可以通过调用 setCurrentIndex() 方法来改变当前显示的页面。索引从 0 开始，表示第一个添加的页面：
stackedWidget->setCurrentIndex(0); // 显示 page1
stackedWidget->setCurrentIndex(1); // 显示 page2
信号和槽
QStackedWidget 提供了一些与页面切换相关的信号，你可以通过连接这些信号到槽来实现更复杂的行为：
-
currentChanged(int index)：当页面改变时触发，参数为新的索引值。connect(stackedWidget, &QStackedWidget::currentChanged, [this](int index) {
qDebug() << "切换到页面: " << index;
});
在布局中使用 QStackedWidget
你可以在 QMainWindow 或其他布局容器中使用 QStackedWidget。例如，将 QStackedWidget 添加到 QMainWindow 的中央布局中：
QMainWindow *mainWindow = new QMainWindow();
QVBoxLayout *centralLayout = new QVBoxLayout;
centralLayout->addWidget(stackedWidget);
mainWindow->setCentralWidget(new QWidget(mainWindow));
mainWindow->setLayout(centralLayout);
使用 QStackedWidget 的额外功能
- 添加动画：可以使用
QPropertyAnimation来为页面切换添加动画效果。 - 隐藏/显示页面：通过设置
QWidget的isVisible()属性来控制页面的可见性。 - 页面的布局：每个添加到
QStackedWidget的页面可以有自己的布局，例如QVBoxLayout或QHBoxLayout。
示例完整代码
#include <QMainWindow>
#include <QVBoxLayout>
#include <QStackedWidget>
#include <QWidget>
int main(int argc, char *argv[]) {
QApplication app(argc, argv);
QMainWindow *mainWindow = new QMainWindow();
QVBoxLayout *centralLayout = new QVBoxLayout;
centralLayout->setContentsMargins(0, 0, 0, 0); // 设置布局的内边距
QWidget *page1 = new QWidget();
QVBoxLayout *layout1 = new QVBoxLayout(page1);
layout1->addWidget(new QLabel("这是页面1"));
QWidget *page2 = new QWidget();
QVBoxLayout *layout2 = new QVBoxLayout(page2);
layout2->addWidget(new QLabel("这是页面2"));
QStackedWidget *stackedWidget = new QStackedWidget();
stackedWidget->addWidget(page1);
stackedWidget->addWidget(page2);
centralLayout->addWidget(stackedWidget);
mainWindow->setCentralWidget(new QWidget(mainWindow));
mainWindow->setLayout(centralLayout);
mainWindow->show();
return app.exec();
}
这个例子展示了如何创建一个简单的 QMainWindow，其中包含一个 QStackedWidget，并添加了两个页面。每个页面包含一个 QLabel，用于显示文本。
