Класс QAbstractItemView

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

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

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

Свойства

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

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

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

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

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

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

Сигналы

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

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

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

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

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

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

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

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

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

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

Класс 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(), в то время как другие — обработчики событий клавиатуры и мыши.

Примечание: Если вы наследуете от 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 = Q_NULLPTR)

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

QAbstractItemView::~QAbstractItemView()

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

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

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

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

[slot] void QAbstractItemView::clearSelection()

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

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

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

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

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

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

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

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

void QAbstractItemView::closePersistentEditor(const QModelIndex &index)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

[protected] void QAbstractItemView::executeDelayedItemsLayout()

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

void QAbstractItemView::openPersistentEditor(const QModelIndex &index)

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

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

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

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

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

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

[virtual slot] void QAbstractItemView::reset()

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

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

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

Переопределено из QWidget::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, 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 = Q_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, передавая права владения виджету в представление.

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

Свойство autoFillBackground заданного widget должно быть установлено в значение true, иначе фон виджета будет прозрачным, показывая как данные модели, так и элемент по указанному 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)

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

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

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

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

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

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

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

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

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

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

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

При реализации собственного виджета itemview функция 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(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] State QAbstractItemView::state() const

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

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

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

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

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

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

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

Обновляет область, занимаемую заданным 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().

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

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

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

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

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

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