Класс QAbstractItemView

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

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

Типы

Свойства

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

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

Реализованные общедоступные функции

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

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

• 19 public slots унаследованных от QWidget
• 1 public slot унаследованного от QObject

Сигналы

• 3 signals унаследованных от QWidget
• 2 signals унаследованных от 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

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

См. также 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, передавая владение 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)

Устанавливает 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 должен возвращать основную область, содержащую индекс, а не всю область, которую индекс может охватывать, касаться или вызывать отрисовку.

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

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

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

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

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

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