QModelIndex Class

成员函数文档

[constexpr noexcept] QModelIndex::QModelIndex()

创建一个新的空模型索引。此类模型索引用于指示模型中的该位置无效。

另请参阅 isValid() 和QAbstractItemModel 。

[constexpr noexcept] int QModelIndex::column() const

返回该模型索引所指的列。

[noexcept] const void *QModelIndex::constInternalPointer() const

返回一个const void * 指针，该指针由模型用于将索引与内部数据结构关联起来。

另请参阅 QAbstractItemModel::createIndex()。

QVariant QModelIndex::data(int role = Qt::DisplayRole) const

返回给定role 中由索引所指项目的数据；如果该模型索引为invalid ，则返回一个默认构造的QVariant 。

Qt::ItemFlags QModelIndex::flags() const

返回索引所指向的项目的标志。

[constexpr noexcept] quintptr QModelIndex::internalId() const

返回一个quintptr 对象，该对象由模型用于将索引与内部数据结构建立关联。

另请参阅 QAbstractItemModel::createIndex()。

[noexcept] void *QModelIndex::internalPointer() const

返回一个void * 指针，该指针由模型用于将索引与内部数据结构关联起来。

另请参阅 QAbstractItemModel::createIndex()。

[constexpr noexcept] bool QModelIndex::isValid() const

如果该模型索引有效，则返回true ；否则返回false 。

有效的索引属于某个模型，且其行号和列号均为非负数。

另请参阅 model()、row() 和column()。

[constexpr noexcept] const QAbstractItemModel *QModelIndex::model() const

返回指向包含该索引所指项的模型的指针。

返回的是该模型的 const 指针，因为调用该模型的非 const 函数可能会使模型索引失效，从而可能导致应用程序崩溃。

[since 6.0] void QModelIndex::multiData(QModelRoleDataSpan roleDataSpan) const

为索引所指向的项目填充指定的roleDataSpan 。

该函数于 Qt 6.0 中引入。

QModelIndex QModelIndex::parent() const

返回模型索引的父节点；如果该索引没有父节点，则返回QModelIndex()。

另请参阅 sibling() 和model()。

[constexpr noexcept] int QModelIndex::row() const

返回该模型索引所指的行。

QModelIndex QModelIndex::sibling(int row, int column) const

返回位于row 和column 的同级元素。如果该位置不存在同级元素，则返回一个无效的QModelIndex 。

另请参阅 parent()、siblingAtColumn() 和siblingAtRow()。

QModelIndex QModelIndex::siblingAtColumn(int column) const

返回当前行在column 位置处的同级元素。如果该位置没有同级元素，则返回一个无效的QModelIndex 。

另请参阅 sibling() 和siblingAtRow()。

QModelIndex QModelIndex::siblingAtRow(int row) const

返回当前列在row 处的兄弟节点。如果该位置不存在兄弟节点，则返回一个无效的QModelIndex 。

另请参阅 sibling() 和siblingAtColumn()。