QStackedWidget Class

    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);

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

成员函数文档

[explicit] QStackedWidget::QStackedWidget(QWidget *parent = nullptr)

使用给定的parent 构建一个 QStackedWidget。

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

[virtual noexcept] QStackedWidget::~QStackedWidget()

销毁堆叠的 widget，并释放已分配的资源。

int QStackedWidget::addWidget(QWidget *widget)

将给定的widget 追加到QStackedWidget ，并返回索引位置。widget 的所有权将传递给QStackedWidget 。

如果在调用此函数前QStackedWidget 为空，则widget 将成为当前部件。

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

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

每当当前 widget 发生变化时，就会发出该信号。

参数为当前新 widget 的index ，如果没有新的 widget（例如，如果QStackedWidget 中没有 widget），则为-1。

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

QWidget *QStackedWidget::currentWidget() const

返回当前部件，如果没有子部件，则返回nullptr 。

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

[override virtual protected] bool QStackedWidget::event(QEvent *e)

重实现：QFrame::event(QEvent *e)。

int QStackedWidget::indexOf(const QWidget *widget) const

返回给定widget 的索引，如果给定的widget 不是QStackedWidget 的子节点，则返回-1。

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

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

在QStackedWidget 中给定的index 处插入给定的widget 。widget 的所有权将传递给QStackedWidget 。如果index 不在范围内，则附加widget （在这种情况下，返回的是widget 的实际索引）。

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

如果在小于或等于当前索引的位置插入新部件，则会递增当前索引，但保留当前部件。

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

void QStackedWidget::removeWidget(QWidget *widget)

将widget 从QStackedWidget 中移除。也就是说，widget 并未删除，只是从堆叠布局中移除，使其隐藏。

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

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

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

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

QWidget *QStackedWidget::widget(int index) const

返回给定index 上的 widget，如果没有该 widget，则返回nullptr 。

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

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

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

该函数在 Qt 6.9 中引入。

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

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

每当移除一个 widget 时，就会发出该信号。widget 的index 作为参数传递。

另请参见 removeWidget().