Класс QStackedLayout

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

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

Типы публичного доступа

Свойства

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

• 2 свойства унаследованы от QLayout
• 1 свойство унаследовано от QObject

Функции публичного доступа

Переопределённые функции публичного доступа

• 37 функций публичного доступа унаследовано от QLayout
• 31 функция публичного доступа унаследовано от QObject
• 17 функций публичного доступа унаследовано от QLayoutItem

Слот публичного доступа

• 1 слот публичного доступа унаследован от QObject

Сигналы

• 2 сигнала унаследовано от QObject

Статические члены публичного доступа

• 1 статический член публичного доступа унаследован от QLayout
• 9 статических членов публичного доступа унаследовано от QObject

Дополнительные унаследованные члены

• 4 защищённых функции унаследовано от QLayout
• 9 защищённых функций унаследовано от QObject

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

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

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, SIGNAL(activated(int)),
            stackedLayout, SLOT(setCurrentIndex(int)));

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

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

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

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

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

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

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

Это перечисление было добавлено или изменено в Qt 4.4.

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

QStackedLayout::QStackedLayout()

Создает QStackedLayout без родителя.

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

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

QStackedLayout::QStackedLayout(QWidget *parent)

Создает новый QStackedLayout с заданным parent.

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

QStackedLayout::QStackedLayout(QLayout *parentLayout)

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

[virtual] QStackedLayout::~QStackedLayout()

Уничтожает этот QStackedLayout. Обратите внимание, что виджеты макета не уничтожаются.

[override virtual] void QStackedLayout::addItem(QLayoutItem *item)

Переопределяет QLayout::addItem().

int QStackedLayout::addWidget(QWidget *widget)

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

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

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

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

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

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

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

QWidget *QStackedLayout::currentWidget() const

Возвращает текущий виджет или 0, если в этом макете нет виджетов.

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

[override virtual] bool QStackedLayout::hasHeightForWidth() const

Переопределяет QLayoutItem::hasHeightForWidth().

[override virtual] int QStackedLayout::heightForWidth(int width) const

Переопределяет QLayoutItem::heightForWidth().

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

[override virtual] QSize QStackedLayout::minimumSize() const

Переопределяет QLayout::minimumSize().

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

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

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

[override virtual] void QStackedLayout::setGeometry(const QRect &rect)

Переопределяет QLayout::setGeometry().

[override virtual] QSize QStackedLayout::sizeHint() const

Переопределяет QLayoutItem::sizeHint().

[override virtual] QLayoutItem *QStackedLayout::takeAt(int index)

Переопределяет QLayout::takeAt().

QWidget *QStackedLayout::widget(int index) const

Возвращает виджет в заданном index или 0, если виджета в данной позиции нет.

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

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

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

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