Описание класса QListView
|
|
|
Класс 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. |
Возможно показать подсказки о данных, это необходимо, в основном, для повышения эффективности при показе большого количества элементов. Один из подходов, который может быть принят во внимание, заключается в показе элементов с равными размерами и установленным в true свойством uniformItemSizes.
Смотрите также View Classes, QTreeView, QTableView и QListWidget.
Константа | Значение | Описание |
---|---|---|
QListView::LeftToRight | 0 | Элементы располагаются в представлении слева направо. |
QListView::TopToBottom | 1 | Элементы располагаются в представлении сверху вниз. |
Константа | Значение | Описание |
---|---|---|
QListView::SinglePass | 0 | Элементы размещаются все сразу. |
QListView::Batched | 1 | Элементы размещаются блоками по batchSize элементов. |
Смотрите также batchSize.
Константа | Значение | Описание |
---|---|---|
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 |
Данное свойство содержит количество виджетов, содержащихся в компоновщике.
Значение по умолчанию равно 100.
Это свойство было введено в Qt 4.2.
Функции доступа:
Это свойство содержит значение, в каком направлении должно происходить расположение.
Если это свойство равно LeftToRight, элементы будут размещены слева направо. Если свойство isWrapping равно true, размещение будет переносится, когда оно достигнет правой стороны видимой области. Если это свойство равно TopToBottom, элементы будут размещаться от верхней части видимой области, переносясь, когда оно достигнет нижней части.
Установка этого свойства, когда представление видимо, приведет к повторному размещению элементов.
По умолчанию, это свойство установлено в TopToBottom.
Функции доступа:
Смотрите также viewMode.
Это свойство содержит шаг сетки размещения.
Это свойство есть шаг сетки, в которой размещаются элементы. По умолчанию размер пустой, что означает, что нет сетки и размещение делается не по сетке. Установка этого свойства в непустой размер приводит к размещению по сетке. (Когда действует размещение по сетке свойство spacing игнорируется.)
Установка этого свойства, когда представление видимо, приведет к повторному размещению элементов.
Функции доступа:
Смотрите также viewMode.
Это свойство указывает, могут ли элементы переноситься при размещении.
Это свойство указывает, должно ли размещение переносится, когда нет больше места в видимой области. Точка, в которой размещение переносится, зависит от свойства flow.
Установка этого свойства, когда представление видимо, приведет к повторному размещению элементов.
По умолчанию, это свойство равно false.
Функции доступа:
Смотрите также viewMode.
Это свойство определяет, должно ли размещение элементов происходить немедленно или должно быть отложено.
Это свойство содержит режим размещения для элементов. При режиме SinglePass (по умолчанию) элементы размещаются все сразу. При режиме Batched элементы размещаются блоками по batchSize элементов. Это делает возможным немедленно просматривать и взаимодействовать с видимыми элементами, пока размещаются остальные.
Функции доступа:
Смотрите также viewMode.
Это свойство содержит номер отображаемого столбца в модели.
По умолчанию, это свойство содержит 0, указывая на то, что первый столбец в модели должен быть показан.
Функции доступа:
Это свойство указывает, могут ли элементы быть свободно перемещены, привязаны ли они к сетке или не могут быть перемещены вообще.
Это свойство определяет, как пользователь может перемещать элементы в представлении. Static означает, что элементы не могут быть перемещены пользователем. Free означает, что пользователь может перетаскивать элементы в любую позицию в представлении. Snap означает, что пользователь может перетаскивать элементы, но только в позиции воображаемой сетки, заданной свойством gridSize.
Установка этого свойства, когда представление видимо, приведет к повторному размещению элементов.
По умолчанию, это свойство установлено в Static.
Функции доступа:
Смотрите также gridSize, resizeMode и viewMode.
Это свойство указывает, должны ли элементы размещаться снова, когда представление изменяет размер.
Если это свойство равно Adjust, элементы будут размещаться снова, когда представление изменяет размер. Если установлено значение Fixed, элементы не будут размещаться, когда представление изменяет размер.
По умолчанию, это свойство установлено в Fixed.
Функции доступа:
Смотрите также movement, gridSize и viewMode.
Это свойство указывает, должен ли быть видимым прямоугольник выделения.
Если данное свойство равно true, то прямоугольник является видимым; в противном случае он скрыт.
Замечание: Прямоугольник выделения отображается только в режиме, когда возможно выбрать более одного элемента, т.е. он не будет отображаться в режиме выбора QAbstractItemView::SingleSelection.
По умолчанию, это свойство равно false.
Это свойство было введено в Qt 4.3.
Функции доступа:
Это свойство содержит расстояние между элементами в размещении.
Это свойство есть шаг сетки, в которой размещаются элементы.
Установка этого свойства, когда представление видимо, приведет к повторному размещению элементов.
По умолчанию, это свойство содержит значение равное 0.
Функции доступа:
Смотрите также viewMode.
Это свойство указывает, имеют ли все элементы в представлении одинаковый размер.
Это свойство устанавливается в true только если оно гарантирует, что все элементы в представлении имеют одинаковый размер. Это позволяет представлению производить некоторую оптимизацию в целях улучшения производительности.
По умолчанию, это свойство равно false.
Это свойство было введено в Qt 4.1.
Функции доступа:
Это свойство содержит режим отображения QListView.
Это свойство изменит другие неустановленные свойства, чтобы соответствовать установленному режиму отображения. Характерные для QListView свойства, которые были уже установлены, не будут изменяться, пока не установлен флаг clearPropertyFlags().
Установка этого режима включает или выключает режим перетаскивания (drag and drop), основанные на движении при выделении. Для ListMode по умолчанию режим перемещения равен Static (drag and drop выключен); для IconMode по умолчанию этот режим равен Free (drag and drop включён).
Функции доступа:
Смотрите также isWrapping, spacing, gridSize, flow, movement и resizeMode.
Это свойство отвечает за политику переноса текста в элементах.
Если оно равно true, происходит перенос по непосредственному окончанию слов; в противном случае переноса нет вообще. Свойство равно false по умолчанию.
Пожалуйста обратите внимание на то, что даже если разрешен перенос строк, ячейка не будет увеличена для предоставления места для текста. Оно будет печатать многточие для текста, который не может быть показан, согласно режима представления textElideMode.
Это свойство было введено в Qt 4.2.
Функции доступа:
Создает новый QListView с заданным родителем parent, чтобы отобразить модель. Используйте setModel(), чтобы задать модель.
Разрушает представление.
Очищает характерные для QListView флаги свойств. Смотрите viewMode.
Свойства, унаследованные от QAbstractItemView, не управляются флагами свойств. Точнее, dragEnabled и acceptsDrops вычисляются QListView при вызове setMovement() или setViewMode().
Данный сигнал испускается, когда определённые indexes передвигаются в представлении.
Эта функция была введена в Qt 4.2.
Возвращает true, если row скрыт; в противном случае возвращает false.
Возвращает прямоугольник элементов для позиции index в модели. Прямоугольник состоит из координат.
Смотрите также visualRect().
Устанавливает положение содержимого элемента модели с индексом index в позицию заданную с помощью position. Если режим перемещения представления Static, то эта функция не имеет эффекта.
Эта функция была введена в Qt 4.1.
Если hide равен true, переданный row будет скрыт; в противном случае row будет показан.
Смотрите также isRowHidden().
Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies) | Торговые марки | Qt 4.5.3 |
Попытка перевода Qt документации. Если есть желание присоединиться, или если есть замечания или пожелания, то заходите на форум: Перевод Qt документации на русский язык... Люди внесшие вклад в перевод: Команда переводчиков |