Класс QItemSelectionRange

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

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

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

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

QItemSelectionRange содержит информацию о диапазоне выбранных элементов в модели. Диапазон элементов — это непрерывный массив элементов модели, охватывающий несколько смежных строк и столбцов с общим родительским элементом; это можно визуализировать как двухмерный блок ячеек в таблице. Диапазон выбора имеет верхнюю, левую, нижнюю, правую границы и родителя.

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

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

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

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

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

QItemSelectionRange::QItemSelectionRange(const QModelIndex &index)

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

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

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

QItemSelectionRange::QItemSelectionRange(const QItemSelectionRange &other)

Конструктор копирования. Создает новый диапазон выбора с таким же содержимым, как и заданный диапазон other.

QItemSelectionRange::QItemSelectionRange()

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

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.

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

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