qStackedWidget的使用详解

NCYTC • 2025-02-17 17:02 • 编程

一、基本概念

在 Qt 的界面开发中，我们经常需要隐藏或显示一些窗口部件。如果我们使用多个 QWidget，切换时需要通过 show() 和 hide() 来显示和隐藏，这样就会比较麻烦。

qStackedWidget 是 Qt 提供的一个窗口部件，它可以用来管理多个窗口部件，并可以轻松地进行切换。qStackedWidget 隐藏了不在当前使用的子部件，只显示激活的子部件。qStackedWidget 的最大优点是可以方便地管理所有的子部件，同时可以通过 setIndex（）方法来进行子部件之间的切换。

二、使用场景

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，可以方便地实现多个窗口部件间的切换，提高了开发效率。

原创文章，作者：NCYTC，如若转载，请注明出处：https://www.506064.com/n/351803.html