Класс QAbstractItemView

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

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

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

Свойства

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

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

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

Сигналы

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

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

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

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

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

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

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

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

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

enum 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. Способ активации элементов зависит от платформы; например, одиночным или двойным щелчком мыши по элементу или нажатием клавиши Ввод, когда элемент является текущим.

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

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

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

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

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

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

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

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

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

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

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

[virtual] void QAbstractItemView::setModel(QAbstractItemModel *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 будет заменён созданным представлением.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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