Класс 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. Это можно сравнить с операцией subtract набора.

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