Spec-Zone.ru › Qt 6.1

Тип 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API