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

Описание Класса QListView
[модуль QtGui]

Класс QListView представляет отображение списка или пиктограммы для модели. Далее...

#include <QListView>

Наследует QAbstractItemView.

Наследуется QListWidget.

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

Свойства

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

Защищенные Функции

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


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

Класс QListView представляет отображение списка или пиктограммы для модели.

QListView представляет записи, хранящиеся в модели, в виде простого, не иерархического, списка или в виде коллекции пиктограмм. Данный класс используется для представления в виде списка и пиктокрамм там, где раньше использовались классы QListBox и QIconView, но использует более гибкий подход, предоставляемый архитектурой модель/представление Qt.

Класс QListView является одним из Классов Модель/Представление и частью структуры модель/представление Qt.

Это представление не отображает горизонтальных и вертикальных заголовков; для отображения списка записей с заголовками, используйте вместо него QTreeView.

QListView реализует интерфейсы, определенные в классе QAbstractItemView, чтобы обеспечить отображение информации, предоставляемой классом QAbstractItemModel.

Записи в списке могут быть по разному представлены в зависимости от режима представления: В режиме ListMode записи отображаются в виде простого списка; в режиме IconMode в списке отображаются пиктограммы каждой из записей, подобно изображениям файлов в файловом менеджере. По умолчанию список имеет режим отображения, равный ListMode. Для изменения режима представления используйте функцию setViewMode(), а для определения текущего режима представления используйте viewMode().

Записи в списке размещаются в направлении, заданном flow() списка. Записи могут быть как закрепленными на месте, так и свободно перемещаться в зависимости от свойства movement() списка.

Если записи не могут полностью поместиться в отведенных им границах в направлении размещения, то, в зависимости от значения свойства isWrapping(), они могут быть перенесены по краю виджета. Данное свойство полезно, когда записи представляются в виде пиктограмм.

resizeMode() и layoutMode() управляют тем как и когда размещаются записи. Записи размещаются через интервалы spacing() и могут размещаться в пределах ячейки установленного в gridSize() размера. Записи могут быть представлены в виде больших или маленьких пиктограмм, в зависимости от их iconSize().

См. также Программирование Модель/Представление, QTreeView, QTableView и QListWidget.


Описание Типов Членов

enum QListView::Flow

КонстантаЗначениеОписание
QListView::LeftToRight0Записи располагаются в списке слева направо.
QListView::TopToBottom1Записи располагаются в списке сверху вниз.

enum QListView::LayoutMode

КонстантаЗначениеОписание
QListView::SinglePass0Все записи размещаются сразу.
QListView::Batched1Записи размещаются партиями по 100 штук.

enum QListView::Movement

КонстантаЗначениеОписание
QListView::Static0Пользователь не может перемещать записи.
QListView::Free1Пользователь может свободно перемещать записи.
QListView::Snap2При перемещении, записи привязываются к сетке; см. setGridSize().

enum QListView::ResizeMode

КонстантаЗначениеОписание
QListView::Fixed0Записи будут компоноваться только при первом отображении представления.
QListView::Adjust1Записи будут компоноваться каждый раз, когда изменяется размер представления.

enum QListView::ViewMode

КонстантаЗначениеОписание
QListView::ListMode0Записи компонуются в соответствии с направлением компоновки TopToBottom, с размером Small и расположением Static.
QListView::IconMode1Записи компонуются в соответствии с направлением компоновки LeftToRight, с размером Large и расположением Free.

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

flow : Flow

Данное свойство указывает, в каком направлении должно происходить расположение записей.

Если данное свойство равно LeftToRight, то записи будут располагаться слева направо. Если свойство isWrapping равно true, то по достижении правого края видимой области при компоновке, записи будут переносться. Если данное свойство равно TopToBottom, то записи будут размещаться сверху вниз, переносясь при достижении нижнего края видимой области.

Изменение данного свойства в то время, когда список видим на экране, приведет к повторной компоновке записей.

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

gridSize : QSize

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

Данное свойство содержит размер ячеек сетки, по которой выравниваются записи при компоновке. Значение по умолчанию - нулевой размер, что означает отсутсвие сетки и что выраравнивания по сетке не производится. Установка данного свойства в непустое значение приводит к повторной компоновке записей. (Если производится выравнивание по сетке, свойство spacing игнорируется.)

Изменение данного свойства в то время, когда список видим на экране, приведет к повторной компоновке записей.

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

isWrapping : bool

Данное свойство указывает, могут ли записи переноситься при компоновке.

Данное свойство указывает, должны ли записи переноситься, если в видимой области больше нет места. Граница переноса зависит от свойства flow.

Изменение данного свойства в то время, когда список видим на экране, приведет к повторной компоновке записей.

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

layoutMode : LayoutMode

Данное свойство указывает, должна ли компоновка элементов производиться немедленно, или быть отложена.

Данное свойство содержит режим компоновки элементов. Если режим равен SinglePass (по умолчанию), то элементы располагаются все сразу. Если режим равен Batched, то записи располагаются партиями по 100 штук, пока обрабатываются сообщения. Это дает возможность видеть и взаимодействовать с видимыми записями, пока другие размещаются.

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

modelColumn : int

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

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

movement : Movement

Данное свойство указывает, могут ли записи перемещаться свободно, перемещаться с привязкой к сетке, или вообще не могут перемещаться.

Данное свойство указывает, как пользователь может перемещать записи. Static означает, что пользователь не может перемещать записи в списке. Free означает, что пользователь может свободно перемещать записи в списке с помощью механизма drag-and-drop в любую позицию. Snap означает, что пользователь может перемещать записи в списке с помощью механизма drag-and-drop, но только к позициям, заданным с помощью сетки, определенной свойством gridSize.

Изменение данного свойства в то время, когда список видим на экране, приведет к повторной компоновке записей.

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

См. также gridSize.

resizeMode : ResizeMode

Данное свойство указывает, производится ли заново компоновка записей при изменении размеров списка.

Если данное свойство равно Adjust, то, при изменении размера списка, записи будут снова компоноваться. Если значение свойства равно Fixed, то, при изменении размера списка, записи заново компоноваться не будут.

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

spacing : int

Данное свойство содержит расстояние между записями при компоновке.

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

Изменение данного свойства в то время, когда список видим на экране, приведет к повторной компоновке записей.

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

uniformItemSizes : bool

Данное свойство указывает, имеют-ли все элементы представления одинаковый размер.

Данное свойство следует устанавливать в true только в том случае, если Вы уверены, что все элементы имеют одинаковый размер. Это позволит несколько оптимизировать работу.

Данное свойство добавлено в Qt 4.1.

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

viewMode : ViewMode

Данное свойство содержит режим отображения QListView.

При установке данного свойства другие свойства изменятся, чтобы они соответствовали режиму отображения. Если не вызвана функция clearPropertyFlags(), установленные свойства не будут изменены.

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


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

QListView::QListView ( QWidget * parent = 0 )

Создает новый QListView с родителем parent для отображения информации модели. Для установки модели используйте setModel().

QListView::~QListView ()

Разрушает представление.

void QListView::clearPropertyFlags ()

Очищает флаги свойств. См. viewMode.

bool QListView::event ( QEvent * e )   [virtual protected]

bool QListView::isRowHidden ( int row ) const

Возвращает true если строка с номером row скрыта, в противном случае возвращает false.

QRect QListView::rectForIndex ( const QModelIndex & index ) const   [protected]

Возвращает прямоугольник элемента, имеющего индекс в модели, равный index. Прямоугольник задается в координатах виджета.

void QListView::setPositionForIndex ( const QPoint & position, const QModelIndex & index )   [protected]

Устанавливает позицию элемента модели с индексом index в позицию position. Если режим перемещения представления списка равен Static, то вызов данной функций ни на что не влияет.

Данная функция добавлена в Qt 4.1.

void QListView::setRowHidden ( int row, bool hide )

Если hide равно true, то строка с номером row будет скрыта, в противном случае строка с номером row будет отображена.

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


Copyright © 2005 Trolltech Trademarks
Qt 4.1.0
Hosted by uCoz