Класс QListView

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

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

Типы публичного доступа

Свойства

• 16 свойств унаследовано от QAbstractItemView
• 3 свойства унаследовано от QAbstractScrollArea
• 6 свойств унаследовано от QFrame
• 59 свойств унаследовано от QWidget
• 1 свойство унаследовано от QObject

Общедоступные функции

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

• 60 общедоступных функций унаследовано от QAbstractItemView
• 20 общедоступных функций унаследовано от QAbstractScrollArea
• 14 общедоступных функций унаследовано от QFrame
• 214 общедоступных функций унаследовано от QWidget
• 31 общедоступных функций унаследовано от QObject
• 14 общедоступных функций унаследовано от QPaintDevice

Сигналы

• 7 сигналов унаследовано от QAbstractItemView
• 3 сигнала унаследовано от QWidget
• 2 сигнала унаследовано от QObject

Статические публичные члены

• 5 статических публичных членов унаследовано от QWidget
• 9 статических публичных членов унаследовано от QObject

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

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

• 38 защищённых функций унаследовано от QAbstractItemView
• 20 защищённых функций унаследовано от QAbstractScrollArea
• 4 защищённых функций унаследовано от QFrame
• 35 защищённых функций унаследовано от QWidget
• 9 защищённых функций унаследовано от QObject
• 1 защищённая функция унаследовано от QPaintDevice

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

• 9 публичных слотов унаследовано от QAbstractItemView
• 19 публичных слотов унаследовано от QWidget
• 1 публичный слот унаследовано от QObject
• 9 защищённых слотов унаследовано от QAbstractItemView
• 1 защищённый слот унаследовано от QWidget

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

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

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

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

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

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

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

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

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

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

Повышение производительности

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

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

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

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

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

См. также batchSize.

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

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

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

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

QListView::QListView(QWidget *parent = nullptr)

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

[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().

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

Переопределено из QAbstractItemView::dataChanged().

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

Переопределено из QAbstractItemView::dragLeaveEvent().

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

Переопределено из QAbstractItemView::dragMoveEvent().

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

Переопределено из QAbstractItemView::dropEvent().

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

Переопределено из QAbstractItemView::event().

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

Переопределено из QAbstractItemView::horizontalOffset().

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

Переопределено из QAbstractItemView::indexAt().

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

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

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

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

Переопределено из QAbstractItemView::isIndexHidden().

bool QListView::isRowHidden(int row) const

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

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

Переопределено из QAbstractItemView::mouseMoveEvent().

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

Переопределено из QAbstractItemView::mouseReleaseEvent().

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

Переопределено из QAbstractItemView::moveCursor().

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

Переопределено из QAbstractScrollArea::paintEvent().

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

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

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

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

Переопределено из QAbstractItemView::resizeEvent().

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

Переопределено из QAbstractItemView::rowsAboutToBeRemoved().

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

Переопределено из QAbstractItemView::rowsInserted().

[override virtual] void QListView::scrollTo(const QModelIndex &индекс, QAbstractItemView::ScrollHint сдвиг = EnsureVisible)

Переопределено из QAbstractItemView::scrollTo().

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

Переопределено из QAbstractItemView::selectedIndexes().

[override virtual protected] void QListView::selectionChanged(const QItemSelection &выделенные, const QItemSelection &снятые_с_выделения)

Переопределено из QAbstractItemView::selectionChanged().

[protected] void QListView::setPositionForIndex(const QPoint &позиция, const QModelIndex &индекс)

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

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

void QListView::setRowHidden(int строка, bool скрыть)

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

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

[override virtual protected] void QListView::setSelection(const QRect &прямоугольник, QItemSelectionModel::SelectionFlags команда)

Переопределено из QAbstractItemView::setSelection().

[override virtual protected] void QListView::startDrag(Qt::DropActions поддерживаемыеДействия)

Переопределено из QAbstractItemView::startDrag().

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

Переопределено из QAbstractItemView::timerEvent().

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

Переопределено из QAbstractItemView::updateGeometries().

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

Переопределено из QAbstractItemView::verticalOffset().

[override virtual protected] QStyleOptionViewItem QListView::viewOptions() const

Переопределено из QAbstractItemView::viewOptions().

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

Переопределено из QAbstractItemView::viewportSizeHint().

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

[override virtual] QRect QListView::visualRect(const QModelIndex &индекс) const

Переопределено из QAbstractItemView::visualRect().

[override virtual protected] QRegion QListView::visualRegionForSelection(const QItemSelection &выбор) const

Переопределено из QAbstractItemView::visualRegionForSelection().

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

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

Переопределено из QAbstractScrollArea::wheelEvent().