管理器Widgets(06)：【类】QStackedWidget [官翻]

最新推荐文章于 2024-09-23 16:40:39 发布

hitzsf

最新推荐文章于 2024-09-23 16:40:39 发布

阅读量425

点赞数 1

CC 4.0 BY-SA版权

分类专栏： # Qt Widgets

本文链接：https://blog.youkuaiyun.com/hitzsf/article/details/113486951

Qt Widgets 专栏收录该内容

67 篇文章

订阅专栏

本文详细介绍了QStackedWidget类，它提供了一种在用户界面中实现类似QTabWidget的堆叠式小部件管理。讲解了构造、属性操作、增删查、信号重写以及受保护函数等内容，适用于创建动态切换的界面组件。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

QStackedWidget 类

QStackedWidget类提供了一个小部件堆栈，其中一次只能看到一个小部件。

Header	#include < QStackedWidget >
qmake	QT += widgets
Inherits	QFrame
Inherited By

详细说明

QStackedWidget可用于创建类似于QTabWidget提供的用户界面。它是构建在QStackedLayout类之上的一个方便的布局小部件。

与QStackedLayout一样，QStackedWidget可以构造并填充许多子Widget（“pages”）：

     QWidget *firstPageWidget = new QWidget;
     QWidget *secondPageWidget = new QWidget;
     QWidget *thirdPageWidget = new QWidget;

     QStackedWidget *stackedWidget = new QStackedWidget;
     stackedWidget->addWidget(firstPageWidget);
     stackedWidget->addWidget(secondPageWidget);
     stackedWidget->addWidget(thirdPageWidget);

     QVBoxLayout *layout = new QVBoxLayout;
     layout->addWidget(stackedWidget);
     setLayout(layout);

QStackedWidget不提供用户切换页面的内在方法。这通常是通过QComboBox或QListWidget来完成的，QListWidget存储QStackedWidget页面的标题。例如：

     QComboBox *pageComboBox = new QComboBox;
     pageComboBox->addItem(tr("Page 1"));
     pageComboBox->addItem(tr("Page 2"));
     pageComboBox->addItem(tr("Page 3"));
     connect(pageComboBox, QOverload<int>::of(&QComboBox::activated),
             stackedWidget, &QStackedWidget::setCurrentIndex);

填充堆叠的小部件时，这些小部件被添加到内部列表中。函数的作用是：返回列表中小部件的索引。这些小部件可以使用addWidget() 函数添加到列表的末尾，也可以使用insertWidget() 函数插入到给定的索引中。函数的作用是：从堆叠的小部件中移除一个小部件。堆叠小部件中包含的小部件数量可以使用count() 函数获得。

函数的作用是：返回给定索引位置的小部件。屏幕上显示的小部件的索引由currentIndex() 给定，可以使用setCurrentIndex() 更改。以类似的方式，可以使用currentWidget() 函数检索当前显示的小部件，并使用setCurrentWidget() 函数进行更改。

每当堆叠小部件中的当前小部件发生更改或从堆叠小部件中移除小部件时，将分别发出currentChanged() 和widgetRemoved() 信号。

属性

count: const int 此堆叠小部件包含的小部件数

默认情况下，此属性包含值0。
- int count() const
currentIndex: int 可见小部件的索引位置

如果没有当前小部件，则当前索引为-1。

默认情况下，此属性包含值-1，因为堆栈最初为空。
- int currentIndex() const
- void setCurrentIndex(int index)
信号
- void currentChanged(int index)