Home · All Classes · Main Classes · Grouped Classes · Modules · Functions |
Класс 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.
Константа | Значение | Описание |
---|---|---|
QListView::LeftToRight | 0 | Записи располагаются в списке слева направо. |
QListView::TopToBottom | 1 | Записи располагаются в списке сверху вниз. |
Константа | Значение | Описание |
---|---|---|
QListView::SinglePass | 0 | Все записи размещаются сразу. |
QListView::Batched | 1 | Записи размещаются партиями по 100 штук. |
Константа | Значение | Описание |
---|---|---|
QListView::Static | 0 | Пользователь не может перемещать записи. |
QListView::Free | 1 | Пользователь может свободно перемещать записи. |
QListView::Snap | 2 | При перемещении, записи привязываются к сетке; см. setGridSize(). |
Константа | Значение | Описание |
---|---|---|
QListView::Fixed | 0 | Записи будут компоноваться только при первом отображении представления. |
QListView::Adjust | 1 | Записи будут компоноваться каждый раз, когда изменяется размер представления. |
Константа | Значение | Описание |
---|---|---|
QListView::ListMode | 0 | Записи компонуются в соответствии с направлением компоновки TopToBottom, с размером Small и расположением Static. |
QListView::IconMode | 1 | Записи компонуются в соответствии с направлением компоновки LeftToRight, с размером Large и расположением Free. |
Данное свойство указывает, в каком направлении должно происходить расположение записей.
Если данное свойство равно LeftToRight, то записи будут располагаться слева направо. Если свойство isWrapping равно true, то по достижении правого края видимой области при компоновке, записи будут переносться. Если данное свойство равно TopToBottom, то записи будут размещаться сверху вниз, переносясь при достижении нижнего края видимой области.
Изменение данного свойства в то время, когда список видим на экране, приведет к повторной компоновке записей.
Функции доступа:
Данное свойство содержит размер ячеек сетки выравнивания.
Данное свойство содержит размер ячеек сетки, по которой выравниваются записи при компоновке. Значение по умолчанию - нулевой размер, что означает отсутсвие сетки и что выраравнивания по сетке не производится. Установка данного свойства в непустое значение приводит к повторной компоновке записей. (Если производится выравнивание по сетке, свойство spacing игнорируется.)
Изменение данного свойства в то время, когда список видим на экране, приведет к повторной компоновке записей.
Функции доступа:
Данное свойство указывает, могут ли записи переноситься при компоновке.
Данное свойство указывает, должны ли записи переноситься, если в видимой области больше нет места. Граница переноса зависит от свойства flow.
Изменение данного свойства в то время, когда список видим на экране, приведет к повторной компоновке записей.
Функции доступа:
Данное свойство указывает, должна ли компоновка элементов производиться немедленно, или быть отложена.
Данное свойство содержит режим компоновки элементов. Если режим равен SinglePass (по умолчанию), то элементы располагаются все сразу. Если режим равен Batched, то записи располагаются партиями по 100 штук, пока обрабатываются сообщения. Это дает возможность видеть и взаимодействовать с видимыми записями, пока другие размещаются.
Функции доступа:
Данное свойство содержит номер отображаемой колонки модели.
Функции доступа:
Данное свойство указывает, могут ли записи перемещаться свободно, перемещаться с привязкой к сетке, или вообще не могут перемещаться.
Данное свойство указывает, как пользователь может перемещать записи. Static означает, что пользователь не может перемещать записи в списке. Free означает, что пользователь может свободно перемещать записи в списке с помощью механизма drag-and-drop в любую позицию. Snap означает, что пользователь может перемещать записи в списке с помощью механизма drag-and-drop, но только к позициям, заданным с помощью сетки, определенной свойством gridSize.
Изменение данного свойства в то время, когда список видим на экране, приведет к повторной компоновке записей.
Функции доступа:
См. также gridSize.
Данное свойство указывает, производится ли заново компоновка записей при изменении размеров списка.
Если данное свойство равно Adjust, то, при изменении размера списка, записи будут снова компоноваться. Если значение свойства равно Fixed, то, при изменении размера списка, записи заново компоноваться не будут.
Функции доступа:
Данное свойство содержит расстояние между записями при компоновке.
Данное свойство содержит ширину пустого пространства, оставляемого между записями при компоновке.
Изменение данного свойства в то время, когда список видим на экране, приведет к повторной компоновке записей.
Функции доступа:
Данное свойство указывает, имеют-ли все элементы представления одинаковый размер.
Данное свойство следует устанавливать в true только в том случае, если Вы уверены, что все элементы имеют одинаковый размер. Это позволит несколько оптимизировать работу.
Данное свойство добавлено в Qt 4.1.
Функции доступа:
Данное свойство содержит режим отображения QListView.
При установке данного свойства другие свойства изменятся, чтобы они соответствовали режиму отображения. Если не вызвана функция clearPropertyFlags(), установленные свойства не будут изменены.
Функции доступа:
Создает новый QListView с родителем parent для отображения информации модели. Для установки модели используйте setModel().
Разрушает представление.
Очищает флаги свойств. См. viewMode.
Возвращает true если строка с номером row скрыта, в противном случае возвращает false.
Возвращает прямоугольник элемента, имеющего индекс в модели, равный index. Прямоугольник задается в координатах виджета.
Устанавливает позицию элемента модели с индексом index в позицию position. Если режим перемещения представления списка равен Static, то вызов данной функций ни на что не влияет.
Данная функция добавлена в Qt 4.1.
Если hide равно true, то строка с номером row будет скрыта, в противном случае строка с номером row будет отображена.
См. также isRowHidden().
Copyright © 2005 Trolltech | Trademarks | Qt 4.1.0 |