Home · All Classes · Main Classes · Grouped Classes · Modules · Functions

Описание Класса QStackedLayout
^{^{[модуль QtGui]}}

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

#include <QStackedLayout>

Наследует QLayout.

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

Свойства

count : const int
currentIndex : int

3 свойства, унаследованные от QLayout
1 свойство, унаследованное от QObject

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

QStackedLayout ()
QStackedLayout ( QWidget * parent )
QStackedLayout ( QLayout * parentLayout )
~QStackedLayout ()
int addWidget ( QWidget * widget )
virtual int count () const
int currentIndex () const
QWidget * currentWidget () const
int insertWidget ( int index, QWidget * widget )
QWidget * widget ( int index ) const

26 открытых функций, унаследованных от QLayout
28 открытых функций, унаследованных от QObject
16 открытых функций, унаследованных от QLayoutItem

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

void setCurrentIndex ( int index )
void setCurrentWidget ( QWidget * widget )

1 открытый слот, унаследованный от QObject

Сигналы

void currentChanged ( int index )
void widgetRemoved ( int index )

1 сигнал, унаследованный от QObject

Дополнительные Унаследованные Члены

1 статический открытый член, унаследованный от QLayout
4 статических открытых члена, унаследованных от QObject
3 защищенные функции, унаследованные от QLayout
7 защищенных функций, унаследованных от QObject

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

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

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

QStackedLayout можно заселить множеством дочерних виджетов ("страниц"):

    QWidget *firstPageWidget = new QWidget;
    QWidget *secondPageWidget = new QWidget;
    QWidget *thirdPageWidget = new QWidget;
    ...

    QStackedLayout *layout = new QStackedLayout;
    layout->addWidget(firstPageWidget);
    layout->addWidget(secondPageWidget);
    layout->addWidget(thirdPageWidget);
    setLayout(layout);

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

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)),
            layout, SLOT(setCurrentIndex(int)));

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

Описание Свойств

count : const int

Данное свойство содержит количество виджетов, содержащихся в компоновщике.

Функции доступа:

virtual int count () const

currentIndex : int

Данное свойство содержит индекс видимого в данный момент виджета.

Если текущего виджета нет, то текущий индекс будет равен -1.

Функции доступа:

int currentIndex () const
void setCurrentIndex ( int index )

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

Описание Функций-Членов

QStackedLayout::QStackedLayout ()

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

Прежде, чем начать работать, данный QStackedLayout должен быть добавлен в другой компоновщик.

QStackedLayout::QStackedLayout ( QWidget * parent )

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

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

QStackedLayout::QStackedLayout ( QLayout * parentLayout )

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

QStackedLayout::~QStackedLayout ()

Разрушает данный QStackedLayout.

Управляемые виджеты не разрушаются.

int QStackedLayout::addWidget ( QWidget * widget )

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

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

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

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

Данный сигнал испускается при смене текущего виджета. index содержит индекс нового текущего виджета.

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

QWidget * QStackedLayout::currentWidget () const

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

Эквивалентно widget(currentIndex()).

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

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

Вставляет виджет widget в данный QStackedLayout в позицию index. Если index вне диапазона виджетов, то виджет добавляется в конец. Возвращает актуальный индекс вставленного виджета.

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

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

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

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

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

QWidget * QStackedLayout::widget ( int index ) const

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