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)

QStackedWidget 의 지정된 index 위치에 지정된 widget 을 삽입합니다. widget 의 소유권은 QStackedWidget 로 이전됩니다. index 가 범위를 벗어난 경우, widget 가 추가됩니다(이 경우 반환되는 값은 widget 의 실제 인덱스입니다).

이 함수가 호출되기 전에 ` QStackedWidget `가 비어 있었다면, 지정된 ` widget `가 현재 위젯이 됩니다.

현재 인덱스 이하인 위치에 새 위젯을 삽입하면 현재 인덱스가 증가하지만, 현재 위젯은 유지됩니다.

addWidget(), removeWidget(), setCurrentWidget()도 참조하십시오 .

void QStackedWidget::removeWidget(QWidget *widget)

QStackedWidget 에서 widget 를 제거합니다. 즉, 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()도 참조하십시오 .