Тип QML ItemSelectionModel
Создаёт QItemSelectionModel для использования совместно с QAbstractItemModel и любым представлением, поддерживающим его. Подробнее...
| Оператор импорта: | import QtQml.Models 2.0 |
| С версии: | 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)
Этот сигнал генерируется при изменении текущего элемента. Предыдущий индекс модели элемента заменяется текущим индексом в качестве текущего элемента выделения.
Обратите внимание, что этот сигнал не будет генерироваться при сбросе модели элементов.
Примечание: Соответствующий обработчик — 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().
Действительные значения команды описаны в select(индекс, команда).
void select(QModelIndex индекс, SelectionFlags команда)
Выбирает элемент модели индекс с помощью указанной команды и генерирует selectionChanged().
Допустимые значения параметра команда:
| Постоянная | Описание |
|---|---|
NoUpdate |
Выделение не будет выполнено. |
Clear |
Полное выделение будет очищено. |
Select |
Все указанные индексы будут выбраны. |
Deselect |
Все указанные индексы будут сняты с выделения. |
Toggle |
Все указанные индексы будут выбраны или сняты с выделения в зависимости от их текущего состояния. |
Current |
Текущее выделение будет обновлено. |
Rows |
Все индексы будут расширены для охвата строк. |
Columns |
Все индексы будут расширены для охвата столбцов. |
SelectCurrent |
Комбинация Select и Current для удобства. |
ToggleCurrent |
Комбинация Toggle и Current для удобства. |
ClearAndSelect |
Комбинация Clear и Select для удобства. |
QModelIndexList selectedColumns(int строка)
Возвращает индексы в данной строке для столбцов, где все строки выбраны.
См. также selectedRows().
QModelIndexList selectedRows(int столбец)
Возвращает индексы в данном столбце для строк, где все столбцы выбраны.
См. также selectedColumns().
void setCurrentIndex(QModelIndex индекс, SelectionFlags команда)
Устанавливает элемент модели индекс в качестве текущего элемента и генерирует currentChanged(). Текущий элемент используется для навигации с клавиатуры и индикации фокуса; он независим от выбранных элементов, хотя выбранный элемент также может быть текущим элементом.
В зависимости от указанной команды, индекс также может стать частью текущего выделения.
Действительные значения команды описаны в select(индекс, команда).
См. также select().
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.0/qml-qtqml-models-itemselectionmodel.html