Класс QStackedLayout

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

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

Открытые типы

Свойства

• count : const int
• currentIndex : int
• stackingMode : StackingMode

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

Переопределённые открытые функции

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

Сигналы

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

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

QStackedLayout может быть заполнен несколькими дочерними виджетами («страницами»). Например:

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

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

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

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

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

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

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

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

Перечисление QStackedLayout::StackingMode

Это перечисление определяет, как макет обрабатывает свои дочерние виджеты относительно их видимости.

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

QStackedLayout::QStackedLayout(QLayout *parentLayout)

Создаёт новый QStackedLayout и вставляет его в указанный parentLayout.

QStackedLayout::QStackedLayout(QWidget *parent)

Создаёт новый QStackedLayout с указанным parent.

Этот макет установит себя на виджет parent и будет управлять геометрией своих дочерних элементов.

QStackedLayout::QStackedLayout()

Создаёт QStackedLayout без родительского элемента.

Этот QStackedLayout должен быть установлен на виджет позже, чтобы стать эффективным.

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

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

Этот сигнал испускается всякий раз, когда текущий виджет в макете изменяется. index указывает индекс нового текущего виджета или -1, если нового нет (например, если в QStackedLayout нет виджетов).

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

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

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

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

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

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

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

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

[virtual] 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().

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)

Вставляет указанный widget в заданный index в этом QStackedLayout. Если 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.

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