您的位置:

qStackedWidget的使用详解

一、基本概念

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