Класс QListView

Класс QListView предоставляет вид списка или значков для модели. Подробнее...

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

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

Свойства

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

Переопределённые публичные функции

Сигналы

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

Переопределённые защищённые функции

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

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

Класс QListView является одним из классов модели/представления и входит в состав фреймворка Qt модель/представление.

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

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

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

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

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

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

Улучшение производительности

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

См. также Классы представлений, Пример пазлов для представлений элементов, QTreeView, QTableView и QListWidget.

Документация типов членов

перечисление QListView::Flow

перечисление QListView::LayoutMode

См. также batchSize.

перечисление QListView::Movement

перечисление QListView::ResizeMode

перечисление QListView::ViewMode

Документация по членам-функциям

QListView::QListView(QWidget *parent = nullptr)

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

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

Этот сигнал излучается, когда указанные indexes перемещаются в представлении.

[virtual] QListView::~QListView()

Удаляет представление.

void QListView::clearPropertyFlags()

Очищает QListView-специфические флаги свойств. См. viewMode.

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

[override virtual protected] void QListView::currentChanged(const QModelIndex &current, const QModelIndex &previous)

Переопределяет: QAbstractItemView::currentChanged(const QModelIndex &current, const QModelIndex &previous).

[override virtual protected] void QListView::dataChanged(const QModelIndex &topLeft, const QModelIndex &bottomRight, const QList<int> &roles = QList<int>())

Переопределяет: QAbstractItemView::dataChanged(const QModelIndex &topLeft, const QModelIndex &bottomRight, const QList<int> &roles).

[override virtual protected] void QListView::dragLeaveEvent(QDragLeaveEvent *e)

Переопределяет: QAbstractItemView::dragLeaveEvent(QDragLeaveEvent *event).

[override virtual protected] void QListView::dragMoveEvent(QDragMoveEvent *e)

Переопределяет: QAbstractItemView::dragMoveEvent(QDragMoveEvent *event).

[override virtual protected] void QListView::dropEvent(QDropEvent *event)

Переопределяет: QAbstractItemView::dropEvent(QDropEvent *event).

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

Переопределяет: QAbstractItemView::event(QEvent *event).

[override virtual protected] int QListView::horizontalOffset() const

Переопределяет: QAbstractItemView::horizontalOffset() const.

[override virtual] QModelIndex QListView::indexAt(const QPoint &p) const

Переопределяет: QAbstractItemView::indexAt(const QPoint &point) const.

[override virtual protected] void QListView::initViewItemOption(QStyleOptionViewItem *option) const

Переопределяет: QAbstractItemView::initViewItemOption(QStyleOptionViewItem *option) const.

[override virtual protected] bool QListView::isIndexHidden(const QModelIndex &index) const

Переопределяет: QAbstractItemView::isIndexHidden(const QModelIndex &index) const.

bool QListView::isRowHidden(int row) const

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

[override virtual protected] void QListView::mouseMoveEvent(QMouseEvent *e)

Переопределяет: QAbstractItemView::mouseMoveEvent(QMouseEvent *event).

[override virtual protected] void QListView::mouseReleaseEvent(QMouseEvent *e)

Переопределяет: QAbstractItemView::mouseReleaseEvent(QMouseEvent *event).

[override virtual protected] QModelIndex QListView::moveCursor(QAbstractItemView::CursorAction cursorAction, Qt::KeyboardModifiers modifiers)

Переопределяет: QAbstractItemView::moveCursor(QAbstractItemView::CursorAction cursorAction, Qt::KeyboardModifiers modifiers).

[override virtual protected] void QListView::paintEvent(QPaintEvent *e)

Переопределяет: QAbstractScrollArea::paintEvent(QPaintEvent *event).

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

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

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

[override virtual protected] void QListView::resizeEvent(QResizeEvent *e)

Переопределяет: QAbstractItemView::resizeEvent(QResizeEvent *event).

[override virtual protected] void QListView::rowsAboutToBeRemoved(const QModelIndex &parent, int start, int end)

Переопределяет: QAbstractItemView::rowsAboutToBeRemoved(const QModelIndex &parent, int start, int end).

[override virtual protected] void QListView::rowsInserted(const QModelIndex &parent, int start, int end)

Переопределяет: QAbstractItemView::rowsInserted(const QModelIndex &parent, int start, int end).

[override virtual protected] void QListView::scrollContentsBy(int dx, int dy)

Переопределяет: QAbstractScrollArea::scrollContentsBy(int dx, int dy).

Прокрутить содержимое представления на dx и dy.

[override virtual] void QListView::scrollTo(const QModelIndex &index, QAbstractItemView::ScrollHint hint = EnsureVisible)

Переопределяет: QAbstractItemView::scrollTo(const QModelIndex &index, QAbstractItemView::ScrollHint hint).

[override virtual protected] QModelIndexList QListView::selectedIndexes() const

Переопределяет: QAbstractItemView::selectedIndexes() const.

[override virtual protected] void QListView::selectionChanged(const QItemSelection &selected, const QItemSelection &deselected)

Переопределяет: QAbstractItemView::selectionChanged(const QItemSelection &selected, const QItemSelection &deselected).

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

Устанавливает положение содержимого элемента по индексу index в модели до заданного position. Если режим перемещения списка равен Статический или его режим отображения — ListView, эта функция не повлияет.

[override virtual] void QListView::setRootIndex(const QModelIndex &index)

Переопределяет: QAbstractItemView::setRootIndex(const QModelIndex &index).

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

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

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

[override virtual protected] void QListView::setSelection(const QRect &rect, QItemSelectionModel::SelectionFlags command)

Переопределяет: QAbstractItemView::setSelection(const QRect &rect, QItemSelectionModel::SelectionFlags flags).

[override virtual protected] void QListView::startDrag(Qt::DropActions supportedActions)

Переопределяет: QAbstractItemView::startDrag(Qt::DropActions supportedActions).

[override virtual protected] void QListView::timerEvent(QTimerEvent *e)

Переопределяет: QAbstractItemView::timerEvent(QTimerEvent *event).

[override virtual protected] void QListView::updateGeometries()

Переопределяет: QAbstractItemView::updateGeometries().

[override virtual protected] int QListView::verticalOffset() const

Переопределяет: QAbstractItemView::verticalOffset() const.

[override virtual protected, since 5.2] QSize QListView::viewportSizeHint() const

Переопределяет: QAbstractItemView::viewportSizeHint() const.

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

[override virtual] QRect QListView::visualRect(const QModelIndex &index) const

Переопределяет: QAbstractItemView::visualRect(const QModelIndex &index) const.

[override virtual protected] QRegion QListView::visualRegionForSelection(const QItemSelection &selection) const

Переопределяет: QAbstractItemView::visualRegionForSelection(const QItemSelection &selection) const.

Начиная с версии 4.7, возвращаемая область содержит только прямоугольники, пересекающие (или содержащие) область просмотра.

[override virtual protected] void QListView::wheelEvent(QWheelEvent *e)

Переопределяет: QAbstractScrollArea::wheelEvent(QWheelEvent *e).