Класс QAbstractItemView

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

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

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

Свойства

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

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

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

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

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

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

Сигналы

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

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

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

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

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

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

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

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

• 1 защищенный слот, унаследованный от QWidget

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

Класс 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 и Пример диаграммы.

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

enum QAbstractItemView::CursorAction

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

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

enum QAbstractItemView::DragDropMode

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

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

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

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

enum QAbstractItemView::DropIndicatorPosition

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

enum QAbstractItemView::EditTriggerflags QAbstractItemView::EditTriggers

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

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

enum QAbstractItemView::ScrollHint

enum QAbstractItemView::ScrollMode

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

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

enum QAbstractItemView::SelectionBehavior

enum QAbstractItemView::SelectionMode

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

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

enum QAbstractItemView::State

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

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

QAbstractItemView::QAbstractItemView(QWidget *parent = nullptr)

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

[virtual] QAbstractItemView::~QAbstractItemView()

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

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

void QAbstractItemView::closePersistentEditor(const QModelIndex &index)

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

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

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

QModelIndex QAbstractItemView::currentIndex() const

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

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

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

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

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

[protected] QPoint QAbstractItemView::dirtyRegionOffset() const

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Переопределено из QAbstractScrollArea::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().

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

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

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

Переопределено из QWidget::focusNextPrevChild().

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

Переопределено из QWidget::focusOutEvent().

Эта функция вызывается со значением 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.

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

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

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

Переопределено из QWidget::inputMethodEvent().

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

Переопределено из QWidget::inputMethodQuery().

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

Возвращает true если элемент, на который ссылается заданный index, скрыт в виджете, в противном случае возвращает 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

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

QAbstractItemDelegate *QAbstractItemView::itemDelegateForColumn(int column) const

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

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

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

QAbstractItemDelegate *QAbstractItemView::itemDelegateForRow(int row) const

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Эта функция вызывается с заданным событием 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().

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

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

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

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

[virtual slot] void QAbstractItemView::reset()

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

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

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

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

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

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

QModelIndex QAbstractItemView::rootIndex() const

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

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

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

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

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

[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] QModelIndexList QAbstractItemView::selectedIndexes() const

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

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

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

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

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

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

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

Переопределите эту функцию, чтобы определить собственное поведение выделения.

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

QItemSelectionModel *QAbstractItemView::selectionModel() const

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Эта функция была добавлена в 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)

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

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

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

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

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

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

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

Устанавливает модель для представления вью.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

[signal] void QAbstractItemView::viewportEntered()

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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