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

销毁此堆叠控件，并释放所有已分配的资源。

int QStackedWidget::addWidget(QWidget *widget)

将给定的widget 追加到QStackedWidget 中，并返回其索引位置。widget 的所有权将转移给QStackedWidget 。

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

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

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

每当当前小部件发生变化时，都会发出此信号。

该参数包含新当前小部件的index ，若无新小部件（例如，当QStackedWidget 中没有小部件时），则返回-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)

将给定的widget 插入到QStackedWidget 中给定的index 位置。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 。新的当前控件必须已包含在此堆叠控件中。

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

QWidget *QStackedWidget::widget(int index) const

返回位于指定坐标index 处的小部件，如果不存在该小部件，则返回nullptr 。

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

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

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

该函数于 Qt 6.9 版本中引入。

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

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

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

另请参阅 removeWidget()。