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 必须稍后安装到 widget 上才能生效。

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

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

构建新的 QStackedLayout 并将其插入给定的parentLayout 中。

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

使用给定的parent 构建一个新的 QStackedLayout。

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

[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 将成为当前 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 将被添加（在这种情况下，返回的是widget 的实际索引）。

如果在调用此函数前QStackedLayout 为空，则给定的widget 将成为当前 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 设置为指定的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 位置的 widget，如果给定位置没有 widget，则返回nullptr 。

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

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

每当添加或插入一个部件时，就会发出该信号。widget 的index 将作为参数传递。

该函数在 Qt 6.9 中引入。

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

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

每当一个部件从布局中移除时，就会发出这个信号。widget 的index 作为参数传递。

另请参见 removeWidget().