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 は、新しい現在のウィジェットのインデックスを指定します。新しいウィジェットがない場合（たとえば、QStackedLayout にウィジェットが存在しない場合など）は-1となります。

関連項目: ` 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)

このQStackedLayout において、指定されたindex の位置に、指定されたwidget を挿入します。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()も参照してください 。