QItemSelectionRange 类

QItemSelectionRange 类管理模型中选中项范围的信息。更多信息...

头文件	#include <QItemSelectionRange>
CMake	find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake	QT += core

包括继承成员的所有成员列表

公共函数

	QItemSelectionRange()
	QItemSelectionRange(const QModelIndex &topLeft, const QModelIndex &bottomRight)
	QItemSelectionRange(const QModelIndex &index)
int	bottom() const
const QPersistentModelIndex &	bottomRight() const
bool	contains(const QModelIndex &index) const
bool	contains(int row, int column, const QModelIndex &parentIndex) const
int	height() const
QModelIndexList	indexes() const
QItemSelectionRange	intersected(const QItemSelectionRange &other) const
bool	intersects(const QItemSelectionRange &other) const
bool	isEmpty() const
bool	isValid() const
int	left() const
const QAbstractItemModel *	model() const
QModelIndex	parent() const
int	right() const
void	swap(QItemSelectionRange &other)
int	top() const
const QPersistentModelIndex &	topLeft() const
int	width() const
bool	operator!=(const QItemSelectionRange &other) const
bool	operator==(const QItemSelectionRange &other) const

详细描述

A QItemSelectionRange contains information about a range of selected items in a model. A range of items is a contiguous array of model items, extending to cover a number of adjacent rows and columns with a common parent item; this can be visualized as a two-dimensional block of cells in a table. A selection range has a top(), left() a bottom(), right() and a parent().

The QItemSelectionRange 类是模型/视图类之一，也是 Qt 的模型/视图框架的组成部分。

可以使用 indexes() 函数获取选择范围内的模型项。使用 QItemSelectionModel::selectedIndexes() 获取一个视图所有选中项的列表。

您可以使用 contains() 函数确定给定的模型项是否位于特定范围内。范围也可以使用重载的操作符进行比较，并且 intersects() 函数允许您确定两个范围是否有重叠。

另请参阅模型/视图编程、QAbstractItemModel、QItemSelection 和 QItemSelectionModel。

成员函数文档

`[noexcept]` QItemSelectionRange::QItemSelectionRange()

构建一个空的选择范围。

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

构建一个新选择范围，它只包含由 topLeft 和 bottomRight 指定的索引。

`[explicit]` 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

如果由 index 指定的模型项位于选中项的范围内，则返回 true；否则返回 false。

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

这是一个重载函数。

如果由 (row、column) 指定并且带有 parentIndex 作为父项目的模型项位于选中项的范围内，则返回 true；否则返回 false。

int QItemSelectionRange::height() const

返回选择范围内选中行的数量。

QModelIndexList QItemSelectionRange::indexes() const

返回在选中项中存储的模型索引项列表。

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

返回一个新的选择范围，它仅包含在所选范围和其他选择范围内都找到的项。

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

如果此选择范围与给定的其他范围相交（重叠），则返回true；否则返回false。

bool QItemSelectionRange::isEmpty() const

如果选择范围包含没有任何项或者仅包含已禁用或标记为不可选的项，则返回true。

bool QItemSelectionRange::isValid() const

如果选择范围有效，则返回true；否则返回false。

int QItemSelectionRange::left() const

返回选择范围内最左侧选中列对应的列索引。

const QAbstractItemModel *QItemSelectionRange::model() const

返回选择范围内项所属的模型。

QModelIndex QItemSelectionRange::parent() const

返回选择范围内项父模型项索引。

int QItemSelectionRange::right() const

返回选择范围内最右侧选中列对应的列索引。

`[noexcept]` void QItemSelectionRange::swap(QItemSelectionRange &other)

交换此选择范围的内容与其他。此函数非常快速，从不失败。

int QItemSelectionRange::top() const

返回选择范围内最顶部选中行对应的行索引。

const QPersistentModelIndex &QItemSelectionRange::topLeft() const

返回选择范围左上角项的索引。

另请参阅top、left和bottomRight。

int QItemSelectionRange::width() const

返回选择范围内所选列的数量。

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

如果选择范围与前一个指定的范围不同，则返回 true；否则返回 false。

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

如果选择范围与前一个指定的范围完全相同，则返回 true；否则返回 false。