Класс QStackedWidget

Класс QStackedWidget предоставляет стек виджетов, где только один виджет виден в каждый момент времени. Подробнее...

• Список всех членов, включая наследуемые

Свойства

• count : const int
• currentIndex : int

Открытые функции

Открытые слоты

Сигналы

Переопределённые защищённые функции

Подробное описание

QStackedWidget может использоваться для создания пользовательского интерфейса, аналогичного интерфейсу QTabWidget. Это виджет-макет, созданный поверх класса QStackedLayout.

Как и QStackedLayout, QStackedWidget можно создать и заполнить несколькими дочерними виджетами («страницами»):

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

QStackedWidget не предоставляет встроенных средств для пользователя по переключению страниц. Это обычно выполняется с помощью QComboBox или QListWidget, которые хранят заголовки страниц QStackedWidget. Например:

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

При заполнении виджета стека виджеты добавляются во внутренний список. Функция indexOf() возвращает индекс виджета в этом списке. Виджеты можно добавить в конец списка с помощью функции addWidget() или вставить на заданный индекс с помощью функции insertWidget(). Функция removeWidget() удаляет виджет из стека виджетов. Количество виджетов в стеке виджетов можно получить с помощью функции count().

Функция widget() возвращает виджет по заданному индексу. Индекс виджета, отображаемого на экране, задаётся свойством currentIndex(), и может быть изменён с помощью setCurrentIndex(). Аналогичным образом, текущий отображаемый виджет может быть получен с помощью функции currentWidget(), и изменён с помощью функции setCurrentWidget().

Всякий раз, когда текущий виджет в стеке виджетов меняется или виджет удаляется из стека виджетов, соответственно, генерируются сигналы currentChanged() и widgetRemoved().

См. также QStackedLayout и QTabWidget.

Документация по функциям-членам

QStackedWidget::QStackedWidget(QWidget *parent = nullptr)

Конструирует QStackedWidget с заданным parent.

См. также addWidget() и insertWidget().

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

Этот сигнал генерируется всякий раз, когда текущий виджет меняется.

Параметр содержит индекс нового текущего виджета или -1, если нового виджета нет (например, если в QStackedWidget нет виджетов).

Примечание: Сигнал уведомления для свойства currentIndex.

См. также currentWidget() и setCurrentWidget().

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

Устанавливает текущий виджет в указанный widget. Новый текущий виджет должен уже быть частью этого виджета стека.

См. также currentWidget() и setCurrentIndex().

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

Этот сигнал генерируется всякий раз, когда виджет удаляется. В качестве параметра передаётся индекс index виджета.

См. также removeWidget().

[virtual] QStackedWidget::~QStackedWidget()

Удаляет этот виджет стека и освобождает выделенные ресурсы.

int QStackedWidget::addWidget(QWidget *widget)

Добавляет заданный widget в QStackedWidget и возвращает позицию индекса. Владение widget передаётся QStackedWidget.

Если QStackedWidget пуст перед вызовом этой функции, widget становится текущим виджетом.

См. также insertWidget(), removeWidget() и 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, или -1, если заданный widget не является дочерним элементом QStackedWidget.

См. также currentIndex() и widget().

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

Вставляет заданный widget в заданный index в QStackedWidget. Владение widget передаётся QStackedWidget. Если index вне диапазона, widget добавляется в конец (в этом случае возвращается фактический индекс widget).

Если QStackedWidget был пустым до вызова этой функции, заданный widget становится текущим.

Вставка нового виджета в индекс, меньший или равный текущему индексу, увеличит текущий индекс, но сохранит текущий виджет.

См. также addWidget(), removeWidget() и setCurrentWidget().

void QStackedWidget::removeWidget(QWidget *widget)

Удаляет widget из QStackedWidget. То есть, widget не удаляется, а просто удаляется из структурированного макета, что приводит к его скрытию.

См. также addWidget(), insertWidget() и currentWidget().

QWidget *QStackedWidget::widget(int index) const

Возвращает виджет по заданному index, или nullptr если такого виджета нет.

См. также currentWidget() и indexOf().