Тип QML ItemSelectionModel
Инициализирует QItemSelectionModel, предназначенный для использования совместно с QAbstractItemModel и любым представлением, поддерживающим его. Подробнее...
| Заявление об импорте: | import QtQml.Models |
| С момента: | Qt 5.5 |
| Инициализирует: | QItemSelectionModel |
Свойства
- currentIndex : QModelIndex
- hasSelection : bool
- model : QAbstractItemModel
- selectedIndexes : QModelIndexList
- selection : object
Сигналы
- currentChanged(QModelIndex current, QModelIndex previous)
- selectionChanged(QItemSelection selected, QItemSelection deselected)
Методы
- void clear()
- void clearCurrentIndex()
- void clearSelection()
- bool columnIntersectsSelection(int column, QModelIndex parent)
- bool isColumnSelected(int column, QModelIndex parent)
- bool isRowSelected(int row, QModelIndex parent)
- bool isSelected(QModelIndex index)
- void reset()
- bool rowIntersectsSelection(int row, QModelIndex parent)
- void select(QItemSelection selection, SelectionFlags command)
- void select(QModelIndex index, SelectionFlags command)
- QModelIndexList selectedColumns(int row)
- QModelIndexList selectedRows(int column)
- void setCurrentIndex(QModelIndex index, SelectionFlags command)
Подробное описание
См. также QItemSelectionModel и Модели и представления в Qt Quick.
Документация по свойствам
[только чтение] currentIndex : QModelIndex
Используйте setCurrentIndex(), чтобы установить его значение.
См. также setCurrentIndex() и currentChanged().
[только чтение] hasSelection : bool
Это вызовет обновление привязки свойств каждый раз, когда selectionChanged() будет сгенерирован, даже если его значение не изменилось.
См. также selection, selectedIndexes, select() и selectionChanged().
model : QAbstractItemModel
Значение этого свойства должно совпадать с моделью представления.
[только чтение] selectedIndexes : QModelIndexList
Содержит список всех индексов в модели выбора.
[только чтение] selection : object
Хранит диапазоны выделения, хранящиеся в модели выделения.
Документация по сигналам
currentChanged(QModelIndex current, QModelIndex previous)
Этот сигнал генерируется всякий раз, когда изменяется текущий элемент. Предыдущий индекс модели элемента заменяется индексом current в качестве текущего элемента выделения.
Обратите внимание, что этот сигнал не будет сгенерирован при сбросе модели элементов.
Примечание: Соответствующий обработчик — onCurrentChanged.
См. также currentIndex, setCurrentIndex() и selectionChanged().
selectionChanged(QItemSelection selected, QItemSelection deselected)
Этот сигнал генерируется всякий раз, когда изменяется выделение. Изменение выделения представлено как выделение элементов deselected и выделение элементов selected.
Обратите внимание, что текущий индекс изменяется независимо от выделения. Также обратите внимание, что этот сигнал не будет сгенерирован при сбросе модели элементов.
Примечание: Соответствующий обработчик — onSelectionChanged.
См. также select() и currentChanged().
Документация по методам
void clear()
Очищает модель выделения. Вызывает selectionChanged() и currentChanged().
void clearCurrentIndex()
Очищает текущий индекс. Вызывает currentChanged().
void clearSelection()
Очищает выделение в модели выделения. Вызывает selectionChanged().
bool columnIntersectsSelection(int column, QModelIndex parent)
Возвращает true, если какие-либо элементы выделены в столбце column с заданным parent.
bool isColumnSelected(int column, QModelIndex parent)
Возвращает true, если все элементы выделены в столбце column с заданным parent.
Обратите внимание, что эта функция обычно быстрее, чем вызов isSelected() для всех элементов в том же столбце, и что невыделяемые элементы игнорируются.
bool isRowSelected(int row, QModelIndex parent)
Возвращает true, если все элементы выделены в строке row с заданным parent.
Обратите внимание, что эта функция обычно быстрее, чем вызов isSelected() для всех элементов в той же строке, и что невыделяемые элементы игнорируются.
bool isSelected(QModelIndex index)
Возвращает true, если заданный элемент модели index выделен.
void reset()
Очищает модель выделения. Не генерирует сигналы.
bool rowIntersectsSelection(int row, QModelIndex parent)
Возвращает true, если какие-либо элементы выделены в строке row с заданным parent.
void select(QItemSelection selection, SelectionFlags command)
Выделяет элемент selection с использованием указанного command и генерирует selectionChanged().
Допустимые значения command описаны в select(index, command).
void select(QModelIndex index, SelectionFlags command)
Выбирает элемент модели index с помощью указанного command и излучает selectionChanged().
Допустимые значения для параметра command:
| Константа | Описание |
|---|---|
NoUpdate |
Выбор не будет произведён. |
Clear |
Полный выбор будет очищен. |
Select |
Все указанные индексы будут выбраны. |
Deselect |
Все указанные индексы будут сняты с выбора. |
Toggle |
Все указанные индексы будут выбраны или сняты с выбора в зависимости от их текущего состояния. |
Current |
Текущий выбор будет обновлён. |
Rows |
Все индексы будут расширены, чтобы охватывать строки. |
Columns |
Все индексы будут расширены, чтобы охватывать столбцы. |
SelectCurrent |
Сочетание Select и Current для удобства. |
ToggleCurrent |
Сочетание Toggle и Current для удобства. |
ClearAndSelect |
Сочетание Clear и Select для удобства. |
QModelIndexList selectedColumns(int row)
Возвращает индексы в заданной row для столбцов, где все строки выбраны.
См. также selectedRows().
QModelIndexList selectedRows(int column)
Возвращает индексы в заданном column для строк, где все столбцы выбраны.
См. также selectedColumns().
void setCurrentIndex(QModelIndex index, SelectionFlags command)
Устанавливает элемент модели index в качестве текущего элемента и излучает currentChanged(). Текущий элемент используется для навигации с помощью клавиатуры и индикации фокуса; он независим от выбранных элементов, хотя выбранный элемент также может быть текущим.
В зависимости от указанного command, index также может стать частью текущего выбора.
Допустимые значения command описаны в select(index, command).
См. также select().
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.2/qml-qtqml-models-itemselectionmodel.html