QStackedLayout Class

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

QStackedLayout *stackedLayout = new QStackedLayout;
stackedLayout->addWidget(firstPageWidget);
stackedLayout->addWidget(secondPageWidget);
stackedLayout->addWidget(thirdPageWidget);

QVBoxLayout *mainLayout = new QVBoxLayout;
mainLayout->addLayout(stackedLayout);
setLayout(mainLayout);

QComboBox *pageComboBox = new QComboBox;
pageComboBox->addItem(tr("Page 1"));
pageComboBox->addItem(tr("Page 2"));
pageComboBox->addItem(tr("Page 3"));
connect(pageComboBox, &QComboBox::activated,
        stackedLayout, &QStackedLayout::setCurrentIndex);

成员函数文档

QStackedLayout::QStackedLayout()

创建一个没有父控件的 QStackedLayout。

该 QStackedLayout 必须在后续将其安装到某个小部件上才能生效。

另请参阅 addWidget() 和insertWidget()。

[explicit] QStackedLayout::QStackedLayout(QLayout *parentLayout)

创建一个新的 QStackedLayout，并将其插入到指定的parentLayout 中。

[explicit] QStackedLayout::QStackedLayout(QWidget *parent)

根据给定的parent ，构建一个新的QStackedLayout。

该布局将自身安装在parent 控件上，并管理其子控件的几何布局。

[virtual noexcept] QStackedLayout::~QStackedLayout()

销毁此QStackedLayout 。请注意，布局中的控件不会被销毁。

[override virtual] void QStackedLayout::addItem(QLayoutItem *item)

重写了：QLayout::addItem(QLayoutItem *item)。

int QStackedLayout::addWidget(QWidget *widget)

将给定的widget 添加到该布局的末尾，并返回widget 的索引位置。

如果在调用此函数之前QStackedLayout 为空，则给定的widget 将成为当前控件。

另请参阅 insertWidget()、removeWidget() 和setCurrentWidget()。

[signal] void QStackedLayout::currentChanged(int index)

每当布局中的当前小部件发生变化时，都会触发此信号。index 指定新当前小部件的索引，如果没有新的小部件，则返回 -1（例如，当QStackedLayout 中没有小部件时）

另请参阅 currentWidget() 和setCurrentWidget()。

QWidget *QStackedLayout::currentWidget() const

返回当前控件；如果该布局中没有控件，则返回nullptr 。

另请参阅 currentIndex() 和setCurrentWidget()。

[override virtual] bool QStackedLayout::hasHeightForWidth() const

重新实现了：QLayoutItem::hasHeightForWidth() const。

[override virtual] int QStackedLayout::heightForWidth(int width) const

重新实现了：QLayoutItem::heightForWidth(int) const。

int QStackedLayout::insertWidget(int index, QWidget *widget)

将给定的widget 插入到此QStackedLayout 中给定的index 处。如果index 超出范围，则将该控件追加到末尾（此时返回的是widget 的实际索引）。

如果在调用此函数之前QStackedLayout 为空，则给定的widget 将成为当前小部件。

在小于或等于当前索引的位置插入一个新小部件将递增当前索引，但保留当前小部件。

另请参阅 addWidget()、removeWidget() 和setCurrentWidget()。

[override virtual] QLayoutItem *QStackedLayout::itemAt(int index) const

重新实现了：QLayout::itemAt(int index) const。

[override virtual] QSize QStackedLayout::minimumSize() const

重新实现了：QLayout::minimumSize() const。

[slot] void QStackedLayout::setCurrentWidget(QWidget *widget)

将当前小部件设置为指定的widget 。新的当前小部件必须已包含在此堆叠布局中。

另请参阅 setCurrentIndex() 和currentWidget()。

[override virtual] void QStackedLayout::setGeometry(const QRect &rect)

重新实现了：QLayout::setGeometry(const QRect &r)。

[override virtual] QSize QStackedLayout::sizeHint() const

重新实现了：QLayoutItem::sizeHint() const。

[override virtual] QLayoutItem *QStackedLayout::takeAt(int index)

重写了：QLayout::takeAt(int index)。

QWidget *QStackedLayout::widget(int index) const

返回位于指定坐标index 处的小部件，如果该位置没有小部件，则返回nullptr 。

另请参阅 currentWidget() 和indexOf()。

[signal, since 6.9] void QStackedLayout::widgetAdded(int index)

每当添加或插入一个控件时，都会触发此信号。控件的index 将作为参数传递。

该函数自 Qt 6.9 起引入。

另请参阅 addWidget() 和insertWidget()。

[signal] void QStackedLayout::widgetRemoved(int index)

每当布局中移除一个控件时，都会触发此信号。控件的index 将作为参数传递。

另请参阅 removeWidget()。