Класс QAbstractItemView

Класс QAbstractItemView предоставляет базовые возможности для классов представления элементов. Подробнее...

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

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

Свойства

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

Реализованные публичные функции

Публичные слоты

Сигналы

Защищенные типы

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

Реализованные защищенные функции

Защищенные слоты

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

Класс QAbstractItemView — базовый класс для всех стандартных представлений, использующих QAbstractItemModel. QAbstractItemView — абстрактный класс и не может быть напрямую инстанцирован. Он предоставляет стандартный интерфейс для взаимодействия с моделями через механизм сигналов и слотов, позволяя подклассам оставаться синхронизированными с изменениями в их моделях. Этот класс обеспечивает стандартную поддержку навигации по клавиатуре и мыши, прокрутки области просмотра, редактирования элементов и выбора. Навигация по клавиатуре реализует эту функциональность:

Обратите внимание, что приведенная выше таблица предполагает, что режим выбора позволяет выполнять эти операции. Например, вы не можете выбрать элементы, если режим выбора — QAbstractItemView::NoSelection.

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

Классы представлений, наследующие от QAbstractItemView, должны реализовывать только свою специфичную для представления функциональность, например, отрисовку элементов, возврат геометрии элементов, поиск элементов и т. д.

QAbstractItemView предоставляет общие слоты, такие как edit() и setCurrentIndex(). Также предоставляется множество защищенных слотов, включая dataChanged(), rowsInserted(), rowsAboutToBeRemoved(), selectionChanged() и currentChanged().

Корневой элемент возвращается методом rootIndex(), а текущий элемент — методом currentIndex(). Чтобы убедиться, что элемент виден, используйте scrollTo().

Некоторые функции QAbstractItemView связаны со скроллингом, например, setHorizontalScrollMode() и setVerticalScrollMode(). Чтобы установить диапазон полос прокрутки, вы можете, например, переопределить функцию resizeEvent() представления:

void MyView::resizeEvent(QResizeEvent *event) {
    horizontalScrollBar()->setRange(0, realWidth - width());
    ...
}

Обратите внимание, что диапазон обновляется только после отображения виджета.

Некоторые другие функции связаны с управлением выбором; например, setSelectionMode() и setSelectionBehavior(). Этот класс предоставляет модель выбора по умолчанию (selectionModel()), но её можно заменить, используя setSelectionModel() с экземпляром QItemSelectionModel.

Для полного контроля над отображением и редактированием элементов можно указать делегата с помощью setItemDelegate().

QAbstractItemView предоставляет множество защищенных функций. Некоторые связаны с редактированием, например edit() и commitData(), а другие — с обработкой событий клавиатуры и мыши.

Примечание: Если вы наследуете QAbstractItemView и намереваетесь обновить содержимое области просмотра, используйте viewport->update() вместо update(), так как все операции рисования выполняются в области просмотра.

См. также Классы представлений, Программирование с помощью моделей/представлений, QAbstractItemModel и Пример диаграммы.

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

Перечисление QAbstractItemView::CursorAction

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

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

enum QAbstractItemView::DragDropMode

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

Обратите внимание, что используемая модель должна обеспечивать поддержку операций перетаскивания и перемещения.

См. также setDragDropMode() и Использование перетаскивания и перемещения с представлениями элементов.

enum QAbstractItemView::DropIndicatorPosition

Это перечисление указывает положение индикатора перемещения относительно индекса в текущем положении мыши:

enum QAbstractItemView::EditTriggerflags QAbstractItemView::EditTriggers

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

Тип EditTriggers — это псевдоним для QFlags<EditTrigger>. Он хранит результат побитового ИЛИ значений EditTrigger.

enum QAbstractItemView::ScrollHint

enum QAbstractItemView::ScrollMode

Описывает поведение полосы прокрутки. При установке режима прокрутки ScrollPerPixel размер одного шага будет автоматически корректироваться, если он не был явно установлен с помощью setSingleStep(). Автоматическая корректировка может быть восстановлена путём установки размера шага в -1.

enum QAbstractItemView::SelectionBehavior

enum QAbstractItemView::SelectionMode

Это перечисление указывает, как представление реагирует на пользовательские выделения:

Наиболее часто используемые режимы — SingleSelection и ExtendedSelection.

enum QAbstractItemView::State

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

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

QAbstractItemView::QAbstractItemView(QWidget *parent = nullptr)

Создаёт абстрактное представление элементов с заданным parent.

[signal] void QAbstractItemView::activated(const QModelIndex &index)

Этот сигнал испускается, когда пользователь активирует элемент, указанный индексом index. Способ активации элементов зависит от платформы; например, при одиночном или двойном щелчке элемента, или при нажатии клавиши Ввод или Enter, когда элемент является текущим.

См. также clicked(), doubleClicked(), entered() и pressed().

[slot] void QAbstractItemView::clearSelection()

Снимает выделение со всех выделенных элементов. Текущий индекс не изменится.

См. также setSelection() и selectAll().

[signal] void QAbstractItemView::clicked(const QModelIndex &index)

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

См. также activated(), doubleClicked(), entered() и pressed().

[virtual protected slot] void QAbstractItemView::closeEditor(QWidget *editor, QAbstractItemDelegate::EndEditHint hint)

Закрывает предоставленный editor и освобождает его. hint используется для указания, как представление должно отреагировать на окончание операции редактирования. Например, подсказка может указывать, что следующий элемент в представлении должен быть открыт для редактирования.

См. также edit() и commitData().

[virtual protected slot] void QAbstractItemView::commitData(QWidget *editor)

Сохраняет данные из editor в модель.

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

[virtual protected slot] void QAbstractItemView::currentChanged(const QModelIndex &current, const QModelIndex &previous)

Этот слот вызывается, когда новый элемент становится текущим элементом. Предыдущий текущий элемент задаётся индексом previous, а новый — индексом current.

Если вы хотите узнать об изменениях элементов, обратитесь к сигналу dataChanged().

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

Этот слот вызывается, когда элементы с заданными roles изменяются в модели. Изменённые элементы находятся от topLeft до bottomRight включительно. Если изменяется только один элемент, topLeft == bottomRight.

roles, которые были изменены, могут быть пустым контейнером (что означает, что всё изменилось), или непустым контейнером с подмножеством ролей, которые были изменены.

Примечание: Qt::ToolTipRole не обрабатывается dataChanged() в представлениях, предоставляемых Qt.

[signal] void QAbstractItemView::doubleClicked(const QModelIndex &index)

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

См. также clicked() и activated().

[slot] void QAbstractItemView::edit(const QModelIndex &index)

Начинает редактирование элемента, соответствующего заданному index, если он редактируемый.

Обратите внимание, что эта функция не изменяет текущий индекс. Поскольку текущий индекс определяет следующие и предыдущие элементы для редактирования, пользователи могут обнаружить, что навигация с помощью клавиатуры не работает как ожидается. Для обеспечения согласованного поведения навигации, вызовите setCurrentIndex() перед этой функцией с тем же индексом модели.

См. также QModelIndex::flags().

[virtual protected slot] void QAbstractItemView::editorDestroyed(QObject *editor)

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

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

[signal] void QAbstractItemView::entered(const QModelIndex &index)

Этот сигнал испускается, когда указатель мыши входит в элемент, заданный индексом index. Для работы этой функции необходимо включить отслеживание перемещения мыши.

См. также viewportEntered(), activated(), clicked(), doubleClicked() и pressed().

[signal] void QAbstractItemView::pressed(const QModelIndex &index)

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

Используйте функцию QGuiApplication::mouseButtons() для получения состояния кнопок мыши.

См. также activated(), clicked(), doubleClicked() и entered().

[virtual slot] void QAbstractItemView::reset()

Сбрасывает внутреннее состояние представления.

Предупреждение: Эта функция сбросит открытые редакторы, позиции полосы прокрутки, выделения и т. д. Существующие изменения не будут сохранены. Если вы хотите сохранить свои изменения при сбросе представления, вы можете переопределить эту функцию, сохранить свои изменения и затем вызвать реализацию суперкласса.

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

Этот слот вызывается, когда строки собираются удалить. Удаляемые строки находятся под заданным parent с start до end включительно.

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

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

Этот слот вызывается, когда строки вставляются. Новые строки находятся под заданным parent с start до end включительно. Реализация базового класса вызывает fetchMore() в модели для проверки наличия дополнительных данных.

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

[slot] void QAbstractItemView::scrollToBottom()

Прокручивает представление вниз до самого низа.

См. также scrollTo() и scrollToTop().

[slot] void QAbstractItemView::scrollToTop()

Прокручивает представление до верха.

См. также scrollTo() и scrollToBottom().

[virtual slot] void QAbstractItemView::selectAll()

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

См. также setSelection(), selectedIndexes() и clearSelection().

[virtual protected slot] void QAbstractItemView::selectionChanged(const QItemSelection &selected, const QItemSelection &deselected)

Этот слот вызывается при изменении выделения. Предыдущее выделение (которое может быть пустым) задается deselected, а новое — selected.

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

[slot] void QAbstractItemView::setCurrentIndex(const QModelIndex &index)

Устанавливает текущий элемент в элемент по индексу index.

Если режим текущего выделения не NoSelection, элемент также будет выделен. Обратите внимание, что эта функция также обновляет начальную позицию для всех новых выделений, которые пользователь производит.

Чтобы установить элемент в качестве текущего без его выделения, вызовите

selectionModel()->setCurrentIndex(index, QItemSelectionModel::NoUpdate);

См. также currentIndex(), currentChanged() и selectionMode.

[virtual slot] void QAbstractItemView::setRootIndex(const QModelIndex &index)

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

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

[slot] void QAbstractItemView::update(const QModelIndex &index)

Обновляет область, занимаемую данным index.

[virtual protected slot] void QAbstractItemView::updateGeometries()

Обновляет геометрию дочерних виджетов представления.

[signal] void QAbstractItemView::viewportEntered()

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

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

[virtual] QAbstractItemView::~QAbstractItemView()

Уничтожает представление.

void QAbstractItemView::closePersistentEditor(const QModelIndex &index)

Закрывает постоянный редактор для элемента по заданному index.

См. также openPersistentEditor() и isPersistentEditorOpen().

QModelIndex QAbstractItemView::currentIndex() const

Возвращает индекс модели текущего элемента.

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

[protected] QPoint QAbstractItemView::dirtyRegionOffset() const

Возвращает смещение грязных областей в представлении.

Если вы используете scrollDirtyRegion() и реализуете paintEvent() в подклассе QAbstractItemView, вы должны перевести область, задаваемую событием рисования, на смещение, возвращаемое этой функцией.

См. также scrollDirtyRegion() и setDirtyRegion().

[override virtual protected] void QAbstractItemView::dragEnterEvent(QDragEnterEvent *event)

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

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

См. также dropEvent() и startDrag().

[override virtual protected] void QAbstractItemView::dragLeaveEvent(QDragLeaveEvent *event)

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

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

[override virtual protected] void QAbstractItemView::dragMoveEvent(QDragMoveEvent *event)

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

Эта функция непрерывно вызывается с данным event во время операции перетаскивания и отпускания над виджетом. Она может вызвать прокрутку представления, если, например, пользователь перетаскивает выделение к правому или нижнему краю представления. В этом случае событие будет принято; в противном случае оно будет проигнорировано.

См. также dropEvent() и startDrag().

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

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

Эта функция вызывается с данным event, когда происходит событие отпускания над виджетом. Если модель принимает позицию события отпускания, событие отпускания принимается; в противном случае оно игнорируется.

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

[protected] QAbstractItemView::DropIndicatorPosition QAbstractItemView::dropIndicatorPosition() const

Возвращает позицию индикатора отпускания по отношению к ближайшему элементу.

[virtual protected] bool QAbstractItemView::edit(const QModelIndex &index, QAbstractItemView::EditTrigger trigger, QEvent *event)

Начинает редактирование элемента по индексу index, создавая редактор при необходимости, и возвращает true если состояние представления State теперь EditingState; в противном случае возвращает false. Действие, вызвавшее процесс редактирования, описывается trigger, а связанное событие задается event.

Редактирование можно принудительно выполнить, указав trigger как QAbstractItemView::AllEditTriggers.

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

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

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

[override virtual protected] bool QAbstractItemView::eventFilter(QObject *object, QEvent *event)

Переопределяет: QObject::eventFilter(QObject *watched, QEvent *event).

[protected] void QAbstractItemView::executeDelayedItemsLayout()

Выполняет запланированные макеты элементов без ожидания начала обработки событий.

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

[override virtual protected] void QAbstractItemView::focusInEvent(QFocusEvent *event)

Переопределяет: QWidget::focusInEvent(QFocusEvent *event).

Этот метод вызывается с заданным событием event, когда виджет получает фокус. По умолчанию событие игнорируется.

См. также setFocus() и focusOutEvent().

[override virtual protected] bool QAbstractItemView::focusNextPrevChild(bool next)

Переопределяет: QWidget::focusNextPrevChild(bool next).

[override virtual protected] void QAbstractItemView::focusOutEvent(QFocusEvent *event)

Переопределяет: QWidget::focusOutEvent(QFocusEvent *event).

Этот метод вызывается с заданным событием event, когда виджет теряет фокус. По умолчанию событие игнорируется.

См. также clearFocus() и focusInEvent().

[pure virtual protected] int QAbstractItemView::horizontalOffset() const

Возвращает горизонтальный сдвиг представления.

В базовом классе это чистая виртуальная функция.

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

[pure virtual] QModelIndex QAbstractItemView::indexAt(const QPoint &point) const

Возвращает индекс модели элемента в координатах области просмотра point.

В базовом классе это чистая виртуальная функция.

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

QWidget *QAbstractItemView::indexWidget(const QModelIndex &index) const

Возвращает виджет для элемента с заданным индексом index.

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

[virtual protected, since 6.0] void QAbstractItemView::initViewItemOption(QStyleOptionViewItem *option) const

Инициализирует структуру option палитрой, шрифтом, состоянием, выравниванием и другими параметрами представления.

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

Этот метод был введен в Qt 6.0.

[override virtual protected] void QAbstractItemView::inputMethodEvent(QInputMethodEvent *event)

Переопределяет: QWidget::inputMethodEvent(QInputMethodEvent *event).

[override virtual] QVariant QAbstractItemView::inputMethodQuery(Qt::InputMethodQuery query) const

Переопределяет: QWidget::inputMethodQuery(Qt::InputMethodQuery query) const.

[pure virtual protected] bool QAbstractItemView::isIndexHidden(const QModelIndex &index) const

Возвращает true если элемент, на который ссылается заданный индекс index, скрыт в представлении, в противном случае возвращает false.

Скрытие — функция, специфичная для представления. Например, в TableView столбец может быть помечен как скрытый, или строка в TreeView.

В базовом классе это чистая виртуальная функция.

[since 5.10] bool QAbstractItemView::isPersistentEditorOpen(const QModelIndex &index) const

Возвращает значение, указывающее, открыт ли постоянный редактор для элемента с индексом index.

Этот метод был введен в Qt 5.10.

См. также openPersistentEditor() и closePersistentEditor().

QAbstractItemDelegate *QAbstractItemView::itemDelegate() const

Возвращает делегат элементов, используемый этим представлением и моделью. Это либо делегат, установленный с помощью setItemDelegate(), либо по умолчанию.

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

QAbstractItemDelegate *QAbstractItemView::itemDelegateForColumn(int column) const

Возвращает делегат элементов, используемый этим представлением и моделью для данного столбца column. Вы можете вызвать itemDelegate(), чтобы получить указатель на текущий делегат для данного индекса.

См. также setItemDelegateForColumn(), itemDelegateForRow(), и itemDelegate().

[virtual, since 6.0] QAbstractItemDelegate *QAbstractItemView::itemDelegateForIndex(const QModelIndex &index) const

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

Этот метод был введен в Qt 6.0.

См. также setItemDelegate(), setItemDelegateForRow(), и setItemDelegateForColumn().

QAbstractItemDelegate *QAbstractItemView::itemDelegateForRow(int row) const

Возвращает делегат элементов, используемый этим представлением и моделью для данной строки row, или nullptr если делегат не был назначен. Вы можете вызвать itemDelegate(), чтобы получить указатель на текущий делегат для данного индекса.

См. также setItemDelegateForRow(), itemDelegateForColumn(), и setItemDelegate().

[override virtual protected] void QAbstractItemView::keyPressEvent(QKeyEvent *event)

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

Этот метод вызывается с заданным событием event, когда событие нажатия клавиши отправляется в виджет. Базовая реализация обрабатывает основные перемещения курсора (например, Вверх, Вниз, Влево, Вправо, Домой, PageUp и PageDown); сигнал activated() генерируется, если текущий индекс допустим и нажата клавиша активации (например, Enter или Возврат, в зависимости от платформы). В этом методе инициируется редактирование при нажатии клавиши, например, если нажата F2.

См. также edit(), moveCursor(), keyboardSearch(), и tabKeyNavigation.

[virtual] void QAbstractItemView::keyboardSearch(const QString &search)

Перемещает и выбирает элемент, наилучшим образом соответствующий строке search. Если элемент не найден, ничего не происходит.

В базовой реализации поиск сбрасывается, если search пуста или интервал времени с момента последнего поиска превысил QApplication::keyboardInputInterval().

QAbstractItemModel *QAbstractItemView::model() const

Возвращает модель, которую представляет это представление.

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

[override virtual protected] void QAbstractItemView::mouseDoubleClickEvent(QMouseEvent *event)

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

Этот метод вызывается с заданным событием event при двойном щелчке кнопкой мыши внутри виджета. Если двойной щелчок выполнен по допустимому элементу, генерируется сигнал doubleClicked() и вызывается edit() для элемента.

[override virtual protected] void QAbstractItemView::mouseMoveEvent(QMouseEvent *event)

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

Этот метод вызывается с заданным событием event при поступлении события перемещения мыши в виджет. Если выполняется выделение, а новые элементы перемещаются поверх выделения, выделение расширяется; если выполняется перетаскивание, оно продолжается.

[override virtual protected] void QAbstractItemView::mousePressEvent(QMouseEvent *event)

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

Этот метод вызывается с заданным событием event при нажатии кнопки мыши, когда курсор находится внутри виджета. Если нажат допустимый элемент, он становится текущим элементом. Этот метод излучает сигнал pressed().

[override virtual protected] void QAbstractItemView::mouseReleaseEvent(QMouseEvent *event)

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

Этот метод вызывается с заданным событием event при отпускании кнопки мыши после события нажатия мыши на виджете. Если пользователь нажимает мышь внутри вашего виджета, а затем перетаскивает мышь в другое место перед отпусканием кнопки мыши, ваш виджет получает событие отпускания. Метод излучит сигнал clicked() если элемент находился в состоянии нажатия.

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

Возвращает объект QModelIndex, указывающий на следующий объект в представлении на основе заданного cursorAction и модификаторов клавиатуры, указанных modifiers.

В базовом классе это чистая виртуальная функция.

void QAbstractItemView::openPersistentEditor(const QModelIndex &index)

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

См. также closePersistentEditor() и isPersistentEditorOpen().

[override virtual protected] void QAbstractItemView::resizeEvent(QResizeEvent *event)

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

Этот метод вызывается с заданным событием event при поступлении события изменения размера виджета.

См. также QWidget::resizeEvent().

QModelIndex QAbstractItemView::rootIndex() const

Возвращает индекс модели корневого элемента модели. Корневой элемент — это родительский элемент для элементов верхнего уровня представления. Корень может быть недействительным.

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

[protected] void QAbstractItemView::scheduleDelayedItemsLayout()

Планирует макет элементов в представлении для выполнения при запуске обработки событий.

Даже если scheduleDelayedItemsLayout() вызывается несколько раз до обработки событий, представление выполнит макет только один раз.

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

[protected] void QAbstractItemView::scrollDirtyRegion(int dx, int dy)

Подготавливает представление к прокрутке на (dx,dy) пикселей, перемещая грязные области в противоположном направлении. Вам нужно вызывать эту функцию только в том случае, если вы реализуете прокручиваемый область просмотра в вашем подклассе представления.

Если вы реализуете scrollContentsBy() в подклассе QAbstractItemView, вызовите этот метод перед вызовом QWidget::scroll() на области просмотра. В качестве альтернативы, просто вызовите update().

См. также scrollContentsBy(), dirtyRegionOffset() и setDirtyRegion().

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

Прокручивает представление при необходимости, чтобы убедиться, что элемент по index виден. Представление попытается расположить элемент в соответствии с заданным hint.

В базовом классе это чистая виртуальная функция.

[virtual protected] QModelIndexList QAbstractItemView::selectedIndexes() const

Эта функция-помощник возвращает список всех выделенных и не скрытых индексов элементов в представлении. Список не содержит дубликатов и не отсортирован.

См. также QItemSelectionModel::selectedIndexes().

[virtual protected] QItemSelectionModel::SelectionFlags QAbstractItemView::selectionCommand(const QModelIndex &index, const QEvent *event = nullptr) const

Возвращает SelectionFlags, которые следует использовать при обновлении выделения для включения указанного index. event — это событие пользовательского ввода, такое как событие мыши или клавиатуры.

Переопределите этот метод, чтобы определить собственное поведение выделения.

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

QItemSelectionModel *QAbstractItemView::selectionModel() const

Возвращает текущую модель выделения.

См. также setSelectionModel() и selectedIndexes().

[protected] void QAbstractItemView::setDirtyRegion(const QRegion &region)

Помечает заданную region как повреждённую и планирует её обновление. Вам нужно вызывать эту функцию только в том случае, если вы реализуете свой собственный подкласс представления.

См. также scrollDirtyRegion() и dirtyRegionOffset().

void QAbstractItemView::setIndexWidget(const QModelIndex &index, QWidget *widget)

Устанавливает заданный widget для элемента по заданному index, передавая владение виджетом области просмотра.

Если index недействителен (например, если вы передаёте индекс корня), этот метод ничего не сделает.

Свойство autoFillBackground заданного widget должно быть установлено в значение true, в противном случае фон виджета будет прозрачным, показывая данные модели и элемент по заданному index.

Если виджет A заменяется виджетом B, виджет A будет удалён. Например, в приведенном ниже фрагменте кода объект QLineEdit будет удалён.

setIndexWidget(index, new QLineEdit);
...
setIndexWidget(index, new QTextEdit);

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

См. также indexWidget() и Классы-делегаты.

void QAbstractItemView::setItemDelegate(QAbstractItemDelegate *delegate)

Устанавливает делегата элемента для этого представления и его модели в delegate. Это полезно, если вы хотите полностью контролировать редактирование и отображение элементов.

Любой существующий делегат будет удалён, но не удалён. QAbstractItemView не принимает владение delegate.

Предупреждение: Не следует использовать один и тот же экземпляр делегата для нескольких представлений. Это может привести к неправильному или неинтуитивному поведению редактирования, так как каждое представление, связанное с данным делегатом, может получить сигнал closeEditor() и попытаться получить доступ к, изменить или закрыть редактор, который уже был закрыт.

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

void QAbstractItemView::setItemDelegateForColumn(int column, QAbstractItemDelegate *delegate)

Устанавливает заданный делегат элементов, используемый этим представлением и моделью для заданного column. Все элементы в column будут отрисованы и управляться delegate вместо использования стандартного делегата (т.е. itemDelegate()).

Любой существующий делегат столбца для column будет удалён, но не удалён. QAbstractItemView не принимает владение delegate.

Примечание: Если делегат был назначен как строке, так и столбцу, делегат строки будет иметь приоритет и управлять перекрывающимся индексом ячейки.

Предупреждение: Не следует использовать один и тот же экземпляр делегата для нескольких представлений. Это может привести к неправильному или неинтуитивному поведению редактирования, так как каждое представление, связанное с данным делегатом, может получить сигнал closeEditor() и попытаться получить доступ к, изменить или закрыть редактор, который уже был закрыт.

См. также itemDelegateForColumn(), setItemDelegateForRow(), и itemDelegate().

void QAbstractItemView::setItemDelegateForRow(int row, QAbstractItemDelegate *delegate)

Устанавливает заданный делегат элемента delegate, используемый этим представлением и моделью для заданного row. Все элементы в row будут отрисованы и управляться delegate вместо использования стандартного делегата (т.е., itemDelegate()).

Любой существующий делегат строки для row будет удалён, но не удалён. QAbstractItemView не берет на себя владение delegate.

Примечание: Если делегат назначен как для строки, так и для столбца, делегат строки (т.е., этот делегат) будет иметь приоритет и управлять пересекающимся индексом ячейки.

Предупреждение: Не следует использовать один и тот же экземпляр делегата между представлениями. Это может привести к некорректной или неинтуитивной поведению редактирования, так как каждое представление, подключенное к данному делегату, может получить сигнал closeEditor() и попытаться получить доступ, изменить или закрыть редактор, который уже был закрыт.

См. также itemDelegateForRow(), setItemDelegateForColumn(), и itemDelegate().

[virtual] void QAbstractItemView::setModel(QAbstractItemModel *model)

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

Эта функция создаст и установит новую модель выделения, заменив любую модель, которая была ранее установлена с помощью setSelectionModel(). Однако старая модель выделения не будет удалена, так как она может быть разделена между несколькими представлениями. Рекомендуется удалить старую модель выделения, если она больше не требуется. Это делается с помощью следующего кода:

QItemSelectionModel *m = view->selectionModel();
view->setModel(new model);
delete m;

Если и старая модель, и старая модель выделения не имеют родителей или если их родители являются долгоживущими объектами, предпочтительнее вызвать их функции deleteLater(), чтобы явно удалить их.

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

См. также model(), selectionModel(), и setSelectionModel().

[pure virtual protected] void QAbstractItemView::setSelection(const QRect &rect, QItemSelectionModel::SelectionFlags flags)

Применяет флаги выделения flags к элементам в прямоугольнике или касающимся прямоугольника rect.

При реализации собственного представления элементов функция setSelection должна вызвать selectionModel()->select(selection, flags), где selection — это либо пустой QModelIndex, либо QItemSelection, содержащая все элементы, находящиеся внутри rect.

См. также selectionCommand() и selectedIndexes().

[virtual] void QAbstractItemView::setSelectionModel(QItemSelectionModel *selectionModel)

Устанавливает текущую модель выделения на заданную selectionModel.

Обратите внимание, что если вы вызываете setModel() после этой функции, заданная selectionModel будет заменена созданной представлением.

Примечание: Приложение должно удалить старую модель выделения, если она больше не нужна; например, если она не используется другими представлениями. Это произойдёт автоматически при удалении родительского объекта. Однако, если у него нет родителя или родитель является долгоживущим объектом, предпочтительнее вызвать его функцию deleteLater() для явного удаления.

См. также selectionModel(), setModel() и clearSelection().

[protected] void QAbstractItemView::setState(QAbstractItemView::State state)

Устанавливает состояние представления элемента на заданное state.

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

[virtual] int QAbstractItemView::sizeHintForColumn(int column) const

Возвращает рекомендуемый размер ширины для указанного column или -1, если модели нет.

Эта функция используется в представлениях с горизонтальной заголовкой для определения рекомендуемого размера раздела заголовка на основе содержимого заданного column.

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

QSize QAbstractItemView::sizeHintForIndex(const QModelIndex &index) const

Возвращает рекомендуемый размер для элемента с указанным index или недопустимый размер для недопустимых индексов.

См. также sizeHintForRow() и sizeHintForColumn().

[virtual] int QAbstractItemView::sizeHintForRow(int row) const

Возвращает рекомендуемый размер высоты для указанной row или -1, если модели нет.

Возвращаемая высота вычисляется с использованием рекомендуемых размеров элементов данной row, т.е. возвращаемое значение — максимальная высота среди элементов. Обратите внимание, что для управления высотой строки необходимо переопределить функцию QAbstractItemDelegate::sizeHint().

Эта функция используется в представлениях с вертикальной заголовкой для определения рекомендуемого размера раздела заголовка на основе содержимого заданной row.

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

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

Запускает перетаскивание, вызвав drag->exec() с заданными supportedActions.

[protected] QAbstractItemView::State QAbstractItemView::state() const

Возвращает состояние представления элемента.

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

[override virtual protected] void QAbstractItemView::timerEvent(QTimerEvent *event)

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

Эта функция вызывается с заданным event при отправке события таймера в виджет.

См. также QObject::timerEvent().

[pure virtual protected] int QAbstractItemView::verticalOffset() const

Возвращает вертикальное смещение представления.

В базовом классе это чистая виртуальная функция.

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

[override virtual protected] bool QAbstractItemView::viewportEvent(QEvent *event)

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

Эта функция используется для обработки всплывающих подсказок и режима «Что это?», если заданное event является QEvent::ToolTip или QEvent::WhatsThis. Все остальные события передаются обработчику viewportEvent() базового класса.

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

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

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

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

[pure virtual] QRect QAbstractItemView::visualRect(const QModelIndex &index) const

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

Если ваш элемент отображается в нескольких областях, visualRect должен возвращать основную область, которая содержит индекс, а не всю область, которую индекс может охватывать, касаться или вызывать отрисовку.

В базовом классе это чистая виртуальная функция.

См. также indexAt() и visualRegionForSelection().

[pure virtual protected] QRegion QAbstractItemView::visualRegionForSelection(const QItemSelection &selection) const

Возвращает область просмотра элементов в заданном selection.

В базовом классе это чистая виртуальная функция.

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