Класс QItemSelection

Класс QItemSelection управляет информацией о выбранных элементах в модели. Подробнее...

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

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

Статические открытые члены

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

QItemSelection описывает элементы в модели, которые были выбраны пользователем. QItemSelection, по сути, представляет собой список областей выбора, см. QItemSelectionRange. Он предоставляет функции для создания и обработки выборов, а также для выбора диапазона элементов из модели.

Класс QItemSelection является одним из классов Модель/Вид и входит в состав фреймворка модель/вид Qt.

Выбранный элемент можно создать и инициализировать, чтобы он содержал диапазон элементов из существующей модели. В следующем примере создается выбор, который содержит диапазон элементов из данной model, начинающийся с topLeft, и заканчивающийся bottomRight.

QItemSelection *selection = new QItemSelection(topLeft, bottomRight);

Можно создать пустой выбор и затем заполнить его по мере необходимости. Таким образом, если модель будет недоступна при создании выбора, можно переписать приведенный выше код следующим образом:

QItemSelection *selection = new QItemSelection();
...
selection->select(topLeft, bottomRight);

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

Используйте merge(), чтобы объединить один выбор в другой, не создавая перекрывающихся диапазонов. Используйте split(), чтобы разделить один диапазон выбора на более мелкие диапазоны на основе другого диапазона выбора.

См. также Программирование Модель/Вид и QItemSelectionModel.

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

QItemSelection::QItemSelection(const QModelIndex &topLeft, const QModelIndex &bottomRight)

Создает выбор элемента, который простирается от верхнего левого элемента модели, указанного индексом topLeft, до нижнего правого элемента, указанного индексом bottomRight.

QItemSelection::QItemSelection()

Создает пустой выбор.

bool QItemSelection::contains(const QModelIndex &index) const

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

QModelIndexList QItemSelection::indexes() const

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

void QItemSelection::merge(const QItemSelection &other, QItemSelectionModel::SelectionFlags command)

Объединяет выбор other с этим QItemSelection с использованием заданного command. Этот метод гарантирует, что никакие диапазоны не перекрываются.

Обратите внимание, что поддерживаются только QItemSelectionModel::Select, QItemSelectionModel::Deselect и QItemSelectionModel::Toggle.

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

void QItemSelection::select(const QModelIndex &topLeft, const QModelIndex &bottomRight)

Добавляет элементы в диапазон, который простирается от верхнего левого элемента модели, указанного индексом topLeft, до нижнего правого элемента, указанного индексом bottomRight, в список.

Примечание: topLeft и bottomRight должны иметь одного и того же родителя.

[static] void QItemSelection::split(const QItemSelectionRange &range, const QItemSelectionRange &other, QItemSelection *result)

Разделяет выбор range с использованием диапазона выбора other. Удаляет все элементы в other из range и помещает результат в result. Это можно сравнить с семантикой операции вычитания множества.

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