Тип QML ItemSelectionModel
Создает QItemSelectionModel для использования совместно с QAbstractItemModel и любым представлением, поддерживающим его. Подробнее...
| Заявление об импорте: | import QtQml.Models 2.1 |
| С момента: | 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.1/qml-qtqml-models-itemselectionmodel.html