Класс QItemSelectionRange

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

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

Общедоступные функции

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

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

Объект QItemSelectionRange содержит информацию о диапазоне выделенных элементов в модели. Диапазон элементов — это непрерывный массив элементов модели, охватывающий несколько смежных строк и столбцов с общим родительским элементом; это можно представить как двумерный блок ячеек в таблице. Диапазон выделения имеет top(), left(), bottom(), right() и parent().

Класс QItemSelectionRange относится к классам модели/представления и является частью фреймворка Qt модель/представление.

Элементы модели, содержащиеся в диапазоне выделения, могут быть получены с помощью функции indexes(). Используйте QItemSelectionModel::selectedIndexes() для получения списка всех выделенных элементов для представления.

Вы можете определить, находится ли данный элемент модели в определённом диапазоне, используя функцию contains(). Диапазоны также можно сравнивать с помощью перегруженных операторов равенства и неравенства, а функция intersects() позволяет определить, перекрываются ли два диапазона.

См. также Моделирование/программирование представления, QAbstractItemModel, QItemSelection и QItemSelectionModel.

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

QItemSelectionRange::QItemSelectionRange()

Создаёт пустой диапазон выделения.

QItemSelectionRange::QItemSelectionRange(const QItemSelectionRange &other)

Копирующий конструктор. Создаёт новый диапазон выделения с теми же данными, что и у заданного диапазона other.

QItemSelectionRange::QItemSelectionRange(QItemSelectionRange &&other)

Конструктор перемещения.

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

Создаёт новый диапазон выделения, содержащий только указанный индекс topLeft и индекс bottomRight.

QItemSelectionRange::QItemSelectionRange(const QModelIndex &index)

Создаёт новый диапазон выделения, содержащий только элемент модели, указанный индексом модели index.

int QItemSelectionRange::bottom() const

Возвращает индекс строки, соответствующей нижней выделенной строке в диапазоне выделения.

const QPersistentModelIndex &QItemSelectionRange::bottomRight() const

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

См. также bottom(), right() и topLeft().

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

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

bool QItemSelectionRange::contains(int row, int column, const QModelIndex &parentIndex) const

Это перегруженная функция.

Возвращает true, если элемент модели, указанный (row, column) и с parentIndex в качестве родительского элемента, находится в диапазоне выделенных элементов; в противном случае возвращает false.

int QItemSelectionRange::height() const

Возвращает количество выбранных строк в диапазоне выделения.

QModelIndexList QItemSelectionRange::indexes() const

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

QItemSelectionRange QItemSelectionRange::intersected(const QItemSelectionRange &other) const

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

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

bool QItemSelectionRange::intersects(const QItemSelectionRange &other) const

Возвращает true если этот диапазон выделения пересекается (перекрывается) с заданным диапазоном other; в противном случае возвращает false.

bool QItemSelectionRange::isEmpty() const

Возвращает true если диапазон выделения не содержит ни одного выбираемого элемента.

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

bool QItemSelectionRange::isValid() const

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

int QItemSelectionRange::left() const

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

const QAbstractItemModel *QItemSelectionRange::model() const

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

QModelIndex QItemSelectionRange::parent() const

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

int QItemSelectionRange::right() const

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

void QItemSelectionRange::swap(QItemSelectionRange &other)

Меняет содержимое этого диапазона выделения с other. Эта функция очень быстрая и никогда не терпит неудачу.

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

int QItemSelectionRange::top() const

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

const QPersistentModelIndex &QItemSelectionRange::topLeft() const

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

См. также top(), left() и bottomRight().

int QItemSelectionRange::width() const

Возвращает количество выделенных столбцов в диапазоне выделения.

bool QItemSelectionRange::operator!=(const QItemSelectionRange &other) const

Возвращает true если диапазон выделения отличается от заданного диапазона other; в противном случае возвращает false.

bool QItemSelectionRange::operator<(const QItemSelectionRange &other) const

Возвращает true если диапазон выделения меньше, чем заданный диапазон other; в противном случае возвращает false.

Вычисление "меньше чем" не имеет непосредственной практической пользы для разработчиков — способ сравнения диапазонов с разными родителями не определен. Этот оператор существует только для того, чтобы класс можно было использовать с QMap.

QItemSelectionRange &QItemSelectionRange::operator=(QItemSelectionRange &&other)

Оператор перемещающей присваивания.

QItemSelectionRange &QItemSelectionRange::operator=(const QItemSelectionRange &other)

Оператор копирующей присваивания.

bool QItemSelectionRange::operator==(const QItemSelectionRange &other) const

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