Класс QItemSelectionModel

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

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

Типы

Свойства

• selectedIndexes : const QModelIndexList

• 1 свойство унаследовано от QObject

Открытые функции

• 31 открытая функция унаследована от QObject

Открытые слоты

• 1 открытый слот унаследован от QObject

Сигналы

• 2 сигнала унаследованы от QObject

Защищённые функции

• 9 защищённых функций унаследованы от QObject

Дополнительные унаследованные члены

• 11 статических открытых членов унаследованы от QObject

Подробное описание

Класс QItemSelectionModel отслеживает выбранные элементы в представлении.

Класс QItemSelectionModel отслеживает выбранные элементы в представлении или в нескольких представлениях, связанных с одним и тем же моделью. Он также отслеживает текущий выбранный элемент в представлении.

Класс QItemSelectionModel является одним из классов модели/представления и входит в фреймворк модели/представления Qt.

Выбранные элементы хранятся в виде диапазонов. Для изменения выбранных элементов используйте select(), передавая либо QItemSelection, либо QModelIndex и QItemSelectionModel::SelectionFlag.

Класс QItemSelectionModel использует двухслойный подход к управлению выделением, обрабатывая как подтверждённые выбранные элементы, так и элементы, входящие в текущий выбор. Текущие выбранные элементы являются частью текущего интерактивного выделения (например, выделение с помощью резиновой ленты или выделение с помощью клавиш Shift).

Для обновления текущих выбранных элементов используйте побитовое ИЛИ QItemSelectionModel::Current и любой другой SelectionFlags. Если вы опустите команду QItemSelectionModel::Current, будет создано новое текущее выделение, а предыдущее будет добавлено в общее выделение. Все функции работают с обоими слоями; например, selecteditems() вернёт элементы из обоих слоёв.

Примечание: С версии 5.5 model, hasSelection и currentIndex являются свойствами метаобъектов.

См. также Модель/Представление, QAbstractItemModel и Пример диаграммы.

Документация по типу членов

enum QItemSelectionModel::SelectionFlagflags QItemSelectionModel::SelectionFlags

Этот перечисление описывает способ обновления модели выделения.

Тип SelectionFlags — это typedef для QFlags<SelectionFlag>. Он хранит логическое ИЛИ сочетание значений SelectionFlag.

Документация по членам-функциям

QItemSelectionModel::QItemSelectionModel(QAbstractItemModel *model = Q_NULLPTR)

Создает модель выделения, которая работает с указанной моделью элементов model.

QItemSelectionModel::QItemSelectionModel(QAbstractItemModel *model, QObject *parent)

Создаёт модель выделения, которая работает с указанной моделью элементов model и родительским объектом parent.

[virtual] QItemSelectionModel::~QItemSelectionModel()

Удаляет модель выделения.

[virtual slot] void QItemSelectionModel::clear()

Очищает модель выделения. Вызывает selectionChanged() и currentChanged().

[virtual slot] void QItemSelectionModel::clearCurrentIndex()

Очищает текущий индекс. Вызывает currentChanged().

[slot] void QItemSelectionModel::clearSelection()

Очищает выделение в модели выделения. Вызывает selectionChanged().

Эта функция была введена в Qt 4.2.

bool QItemSelectionModel::columnIntersectsSelection(int column, const QModelIndex &parent) const

Возвращает true, если в заданном column с данным parent выделены какие-либо элементы.

[signal] void QItemSelectionModel::currentChanged(const QModelIndex &current, const QModelIndex &previous)

Этот сигнал генерируется всякий раз, когда текущий элемент изменяется. Предыдущий индекс модели элемента заменяется индексом current в качестве текущего элемента выделения.

Обратите внимание, что этот сигнал не будет генерироваться при сбросе модели элементов.

См. также currentIndex(), setCurrentIndex() и selectionChanged().

[signal] void QItemSelectionModel::currentColumnChanged(const QModelIndex &current, const QModelIndex &previous)

Этот сигнал генерируется, если текущий элемент изменяется, и его столбец отличается от столбца предыдущего текущего элемента.

Обратите внимание, что этот сигнал не будет генерироваться при сбросе модели элементов.

См. также currentChanged(), currentRowChanged(), currentIndex() и setCurrentIndex().

QModelIndex QItemSelectionModel::currentIndex() const

Возвращает индекс модели элемента для текущего элемента или недействительный индекс, если текущего элемента нет.

См. также setCurrentIndex().

[signal] void QItemSelectionModel::currentRowChanged(const QModelIndex &current, const QModelIndex &previous)

Этот сигнал генерируется, если текущий элемент изменяется, и его строка отличается от строки предыдущего текущего элемента.

Обратите внимание, что этот сигнал не будет генерироваться при сбросе модели элементов.

См. также currentChanged(), currentColumnChanged(), currentIndex() и setCurrentIndex().

[protected] void QItemSelectionModel::emitSelectionChanged(const QItemSelection &newSelection, const QItemSelection &oldSelection)

Сравнивает два выделения newSelection и oldSelection и вызывает selectionChanged() с невыделенными и выделенными элементами.

bool QItemSelectionModel::hasSelection() const

Возвращает true, если модель выделения содержит какие-либо диапазоны выделения; в противном случае возвращает false.

Эта функция была введена в Qt 4.2.

bool QItemSelectionModel::isColumnSelected(int column, const QModelIndex &parent) const

Возвращает true, если все элементы выделены в указанном column с данным parent.

Обратите внимание, что эта функция обычно быстрее, чем вызов isSelected() для всех элементов в том же столбце, и невыделяемые элементы игнорируются.

bool QItemSelectionModel::isRowSelected(int row, const QModelIndex &parent) const

Возвращает true, если все элементы выделены в указанной row с данным parent.

Обратите внимание, что эта функция обычно быстрее, чем вызов isSelected() для всех элементов в той же строке, и невыделяемые элементы игнорируются.

bool QItemSelectionModel::isSelected(const QModelIndex &index) const

Возвращает true, если данный элемент модели index выделен.

const QAbstractItemModel *QItemSelectionModel::model() const

Возвращает модель элементов, с которой работает модель выделения.

См. также setModel().

QAbstractItemModel *QItemSelectionModel::model()

Возвращает модель элементов, с которой работает модель выделения.

Эта функция была введена в Qt 5.5.

[signal] void QItemSelectionModel::modelChanged(QAbstractItemModel *model)

Этот сигнал испускается, когда модель model успешно установлена с помощью setModel().

Эта функция была добавлена в Qt 5.5.

См. также model() и setModel().

[virtual slot] void QItemSelectionModel::reset()

Очищает модель выделения. Не испускает никаких сигналов.

bool QItemSelectionModel::rowIntersectsSelection(int row, const QModelIndex &parent) const

Возвращает true если в строке row с заданным parent выбраны какие-либо элементы.

[virtual slot] void QItemSelectionModel::select(const QModelIndex &index, QItemSelectionModel::SelectionFlags command)

Выделяет элемент модели index с использованием указанного command и испускает selectionChanged().

См. также QItemSelectionModel::SelectionFlags.

[virtual slot] void QItemSelectionModel::select(const QItemSelection &selection, QItemSelectionModel::SelectionFlags command)

Выделяет элементы selection с использованием указанного command и испускает selectionChanged().

См. также QItemSelectionModel::SelectionFlag.

QModelIndexList QItemSelectionModel::selectedColumns(int row = 0) const

Возвращает индексы в заданной row для столбцов, где все строки выделены.

Эта функция была добавлена в Qt 4.2.

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

QModelIndexList QItemSelectionModel::selectedIndexes() const

Возвращает список всех выделенных индексов элементов модели. Список не содержит дубликатов и не отсортирован.

Примечание: Функция-получатель для свойства selectedIndexes.

QModelIndexList QItemSelectionModel::selectedRows(int column = 0) const

Возвращает индексы в заданном column для строк, где все столбцы выделены.

Эта функция была добавлена в Qt 4.2.

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

const QItemSelection QItemSelectionModel::selection() const

Возвращает диапазоны выделения, сохранённые в модели выделения.

[signal] void QItemSelectionModel::selectionChanged(const QItemSelection &selected, const QItemSelection &deselected)

Этот сигнал испускается всякий раз, когда происходит изменение выделения. Изменение выделения представлено выделением элементов deselected и выделением элементов selected.

Обратите внимание, что текущий индекс изменяется независимо от выделения. Также обратите внимание, что этот сигнал не будет испущен при сбросе модели элементов.

Примечание: Сигнал-уведомление для свойства selectedIndexes.

См. также select() и currentChanged().

[virtual slot] void QItemSelectionModel::setCurrentIndex(const QModelIndex &index, QItemSelectionModel::SelectionFlags command)

Устанавливает элемент модели index в качестве текущего элемента и испускает currentChanged(). Текущий элемент используется для навигации с клавиатуры и индикации фокуса; он независим от выделенных элементов, хотя выделенный элемент также может быть текущим.

В зависимости от указанного command, index также может стать частью текущего выделения.

См. также currentIndex() и select().

void QItemSelectionModel::setModel(QAbstractItemModel *model)

Устанавливает модель в model. Будет испущен сигнал modelChanged().

Эта функция была добавлена в Qt 5.5.

См. также model() и modelChanged().