Главная · Все классы · Основные классы · Классы по группам · Модули · Функции

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

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

 #include <QListView>

Унаследован от QAbstractItemView.

Является базовым для QListWidget и QUndoView.

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

Свойства

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

Сигналы

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

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


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

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

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

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

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

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

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

Элементы в этих представлениях размещаются в направлении, определённом функцией представления flow(). В зависимости от состояния movement() представления элементы могут быть зафиксированы на месте или иметь возможность перемещаться.

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

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

Снимок экрана представления списка в стиле Windows XPСнимок экрана представления списка в стиле MacintoshСнимок экрана представления списка в стиле Plastique
Представление списка в стиле Windows XP.Представление списка в стиле Macintosh.Представление списка в стиле Plastique.

Повышение эффективности

Возможно показать подсказки о данных, это необходимо, в основном, для повышения эффективности при показе большого количества элементов. Один из подходов, который может быть принят во внимание, заключается в показе элементов с равными размерами и установленным в true свойством uniformItemSizes.

Смотрите также View Classes, QTreeView, QTableView и QListWidget.


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

enum QListView::Flow

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

enum QListView::LayoutMode

КонстантаЗначениеОписание
QListView::SinglePass0Элементы размещаются все сразу.
QListView::Batched1Элементы размещаются блоками по batchSize элементов.

Смотрите также batchSize.

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


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

batchSize : int

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

Значение по умолчанию равно 100.

Это свойство было введено в Qt 4.2.

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

flow : Flow

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

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

Установка этого свойства, когда представление видимо, приведет к повторному размещению элементов.

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

Смотрите также viewMode.

gridSize : QSize

Это свойство содержит шаг сетки размещения.

Это свойство есть шаг сетки, в которой размещаются элементы. По умолчанию размер пустой, что означает, что нет сетки и размещение делается не по сетке. Установка этого свойства в непустой размер приводит к размещению по сетке. (Когда действует размещение по сетке свойство spacing игнорируется.)

Установка этого свойства, когда представление видимо, приведет к повторному размещению элементов.

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

Смотрите также viewMode.

isWrapping : bool

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

Это свойство указывает, должно ли размещение переносится, когда нет больше места в видимой области. Точка, в которой размещение переносится, зависит от свойства flow.

Установка этого свойства, когда представление видимо, приведет к повторному размещению элементов.

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

Смотрите также viewMode.

layoutMode : LayoutMode

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

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

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

Смотрите также viewMode.

modelColumn : int

Это свойство содержит номер отображаемого столбца в модели.

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

movement : Movement

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

Это свойство определяет, как пользователь может перемещать элементы в представлении. Static означает, что элементы не могут быть перемещены пользователем. Free означает, что пользователь может перетаскивать элементы в любую позицию в представлении. Snap означает, что пользователь может перетаскивать элементы, но только в позиции воображаемой сетки, заданной свойством gridSize.

Установка этого свойства, когда представление видимо, приведет к повторному размещению элементов.

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

Смотрите также gridSize и viewMode.

resizeMode : ResizeMode

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

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

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

Смотрите также viewMode.

selectionRectVisible : bool

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

Если данное свойство равно true, то прямоугольник является видимым; в противном случае он скрыт. Помните, что прямоугольник выделения отображается только в режиме, когда возможно выбрать более одного элемента, т.е. он не будет отображаться в режиме QAbstractItemView::SingleSelection.

Это свойство было введено в Qt 4.3.

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

spacing : int

Это свойство содержит расстояние между элементами в размещении.

Это свойство есть шаг сетки, в которой размещаются элементы.

Установка этого свойства, когда представление видимо, приведет к повторному размещению элементов.

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

Смотрите также viewMode.

uniformItemSizes : bool

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

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

Это свойство было введено в Qt 4.1.

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

viewMode : ViewMode

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

Это свойство изменит другие неустановленные свойства, чтобы соответствовать установленному режиму отображения. Характерные для QListView свойства, которые были уже установлены, не будут изменяться, пока не установлен флаг clearPropertyFlags().

Установка этого режима включает или выключает режим перетаскивания (drag and drop), основанные на движении при выделении. Для ListMode по умолчанию режим перемещения равен Static (drag and drop выключен); для IconMode по умолчанию этот режим равен Free (drag and drop включён).

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

Смотрите также isWrapping, spacing, gridSize, flow, movement и resizeMode.

wordWrap : bool

Это свойство отвечает за политику переноса текста в элементах.

Если оно равно true, происходит перенос по непосредственному окончанию слов; в противном случае переноса нет вообще. Свойство равно false по умолчанию.

Это свойство было введено в Qt 4.2.

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


Описание функций-членов

QListView::QListView ( QWidget * parent = 0 )

Создает новый QListView с заданным родителем parent, чтобы отобразить модель. Используйте setModel(), чтобы задать модель.

QListView::~QListView ()

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

void QListView::clearPropertyFlags ()

Очищает характерные для QListView флаги свойств. Смотрите viewMode.

Свойства, унаследованные от QAbstractItemView, не управляются флагами свойств. Например, dragEnabled и acceptDrops автоматически изменяются классом QListView при вызове setMovement() или setViewMode().

void QListView::indexesMoved ( const QModelIndexList & indexes )   [signal]

Данный сигнал испускается, когда определённые indexes передвигаются в представлении.

Эта функция была введена в Qt 4.2.

bool QListView::isRowHidden ( int row ) const

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

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

Возвращает прямоугольник элементов для позиции index в модели. Прямоугольник состоит из координат.

Смотрите также visualRect().

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 © 2008 Trolltech Торговые марки
Qt 4.3.5