Класс QAbstractItemView

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

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

Типы публичного интерфейса

Свойства

Публичные функции

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

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

Сигналы

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

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

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

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

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

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

Обратите внимание, что таблица выше предполагает, что режим выбора (selectionMode) позволяет эти операции. Например, вы не можете выбрать элементы, если режим выбора — 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().

перечисление QAbstractItemView::DragDropMode

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

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

Это перечисление было введено или изменено в Qt 4.2.

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

перечисление QAbstractItemView::DropIndicatorPosition

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

перечисление QAbstractItemView::EditTriggerфлаги QAbstractItemView::EditTriggers

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

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

перечисление QAbstractItemView::ScrollHint

перечисление QAbstractItemView::ScrollMode

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

Это перечисление было введено или изменено в Qt 4.2.

перечисление QAbstractItemView::SelectionBehavior

перечисление QAbstractItemView::SelectionMode

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

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

enum QAbstractItemView::State

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

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

QAbstractItemView::QAbstractItemView(QWidget *parent = nullptr)

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

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

Этот сигнал испускается, когда пользователь активирует элемент, указанный индексом index. Способ активации элементов зависит от платформы; например, это может быть щелчок по элементу один раз или дважды, или нажатие клавиш Return или 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 QVector<int> &roles = QVector<int>())

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

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

[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. Сигнал испускается только в том случае, если индекс действителен.

Используйте функцию QApplication::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()

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

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

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

[slot] void QAbstractItemView::scrollToTop()

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

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

См. также 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.

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

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

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

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

[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

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

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

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

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

Действие, вызвавшее процесс редактирования, описывается параметром trigger, а связанное событие — event.

Редактирование может быть принудительно выполнено, если задать триггер как 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)

[protected] void QAbstractItemView::executeDelayedItemsLayout()

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

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

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

Переопределяет: QWidget::focusInEvent(QFocusEvent *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).

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

См. также 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

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

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

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

[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 если элемент, на который указывает заданный индекс, скрыт в представлении, в противном случае возвращает false.

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

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

bool QAbstractItemView::isPersistentEditorOpen(const QModelIndex &index) const

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

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

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

QAbstractItemDelegate *QAbstractItemView::itemDelegate() const

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

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

QAbstractItemDelegate *QAbstractItemView::itemDelegate(const QModelIndex &index) const

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

QAbstractItemDelegate *QAbstractItemView::itemDelegateForColumn(int column) const

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

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

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

QAbstractItemDelegate *QAbstractItemView::itemDelegateForRow(int row) const

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

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

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

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

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

Этот метод вызывается с заданным событием, когда событие нажатия клавиши отправляется виджету. Базовая реализация обрабатывает основные перемещения курсора, например, Вверх, Вниз, Влево, Вправо, Домой, Вверх страницы и Вниз страницы; сигнал activated() генерируется, если текущий индекс действителен и нажата клавиша активации (например, Enter или Return в зависимости от платформы). В этом методе происходит инициирование редактирования нажатием клавиши, например, если нажата клавиша 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).

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

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

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

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

[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 как грязную и планирует её обновление. Вызывать этот метод необходимо только в случае реализации собственного подкласса представления.

Этот метод был представлен в Qt 4.1.

См. также 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 вместо этого.

Этот метод был представлен в Qt 4.1.

См. также 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() и пытаться получить доступ, изменить или закрыть редактор, который уже был закрыт.

Этот метод был представлен в Qt 4.2.

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

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

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

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

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

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

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

См. также 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().

[virtual protected] QStyleOptionViewItem QAbstractItemView::viewOptions() const

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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