一、基本概念

在 Qt 的界面开发中，我们经常需要隐藏或显示一些窗口部件。如果我们使用多个 QWidget，切换时需要通过 show() 和 hide() 来显示和隐藏，这样就会比较麻烦。 qStackedWidget 是 Qt 提供的一个窗口部件，它可以用来管理多个窗口部件，并可以轻松地进行切换。qStackedWidget 隐藏了不在当前使用的子部件，只显示激活的子部件。qStackedWidget 的最大优点是可以方便地管理所有的子部件，同时可以通过 setCurrentIndex() 方法来进行子部件之间的切换。

二、使用场景

qStackedWidget 常用于需要多个窗口互相切换的场景，例如一个设置窗口中，有多个设置项，可以使用 qStackedWidget 将所有设置项进行管理。另外，当使用表格中的某一行时，可能需要显示更多详细信息的信息时，可以在 qStackedWidget 里放置更多信息的窗口，并在表格中设置槽函数，点击时进行切换。

三、如何使用 qStackedWidget

1. 创建 qStackedWidget

QStackedWidget *stackedWidget = new QStackedWidget(this);

2. 添加页面

使用 addWidget() 函数添加页面，函数返回的是该页面的索引。

QWidget *page1 = new QWidget();
QWidget *page2 = new QWidget();
int index1 = stackedWidget->addWidget(page1);
int index2 = stackedWidget->addWidget(page2);

3. 切换页面

可以使用 setCurrentIndex() 函数或者 setCurrentWidget() 函数来进行切换。

stackedWidget->setCurrentIndex(1); // 切换到第二个页面
// 或者
stackedWidget->setCurrentWidget(page2); // 切换到第二个页面

4. 获取当前页面

可以使用 currentIndex() 函数或者 currentWidget() 函数来获取当前页面的索引或者指针。

int currentIndex = stackedWidget->currentIndex();
// 或者
QWidget *currentPage = stackedWidget->currentWidget();

四、其它操作

1. 设置页面间的切换动画

可以使用 setWidget() 函数来设置操作界面：

stackedWidget->setWidget(index, newWidget);

2. 获取页面数量

int count = stackedWidget->count();

3. 图标数量

qStackedWidget 也支持添加图标，可以使用 setIconSize() 函数来设置图标大小。可以使用 setTabIcon() 函数来为指定索引的页面设置图标。

stackedWidget->setIconSize(QSize(30, 30));
stackedWidget->setTabIcon(0, QIcon(":/img/image1.png"));
stackedWidget->setTabIcon(1, QIcon(":/img/image2.png"));

五、总结

本文介绍了 qStackedWidget 的基本概念及使用，通过使用 qStackedWidget，可以方便地实现多个窗口部件间的切换，提高了开发效率。

qStackedWidget的使用详解