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()も参照してください 。