QModelIndex Class Reference

[QtCore module]

该QModelIndex类用于定位数据的数据模型。More…

Methods

  • __init__ (self)
  • __init__ (self, QModelIndex other)
  • __init__ (self, QPersistentModelIndex)
  • QModelIndex child (self, int arow, int acolumn)
  • int column (self)
  • QVariant data (self, int role = Qt.DisplayRole)
  • Qt.ItemFlags flags (self)
  • int internalId (self)
  • object internalPointer (self)
  • bool isValid (self)
  • QAbstractItemModel model (self)
  • QModelIndex parent (self)
  • int row (self)
  • QModelIndex sibling (self, int arow, int acolumn)

Special Methods

  • bool __eq__ (self, QModelIndex other)
  • bool __ge__ (self, QModelIndex other)
  • int __hash__ (self)
  • bool __lt__ (self, QModelIndex other)
  • bool __ne__ (self, QModelIndex other)

Detailed Description

该QModelIndex类用于定位数据的数据模型。

这个类被用作源自一个索引项的模型QAbstractItemModel。该指数是由项目的意见，委讬和选择模型来定位模型中的项目。

新QModelIndex目的是通过使用模型创建的QAbstractItemModel.createIndex（）函数。一个invalid模型索引可以用QModelIndex构造函数来构造。参考模型中的顶级项目时无效索引经常被用作父索引。

型号索引参考模型中的项目，并包含所有需要指定在这些模型及其位置的信息。每个索引位于一个给定行和列中，并且可以具有一个父索引;使用row（ ）column（）和parent（ ）来获取这些信息。模型中的每个顶级项目是由不具有父指数模型指数表示 - 在这种情况下，parent（ ）将返回一个无效的模型索引，相当于用的零参数的形式构建的指数QModelIndex（ ）构造函数。

要获取是指在模型中的现有项目的模型索引，调用QAbstractItemModel.index（ ）所要求的行和列的值，与母公司的模型索引。当提到​​在一个模型中，供应顶级项目QModelIndex（ ）作为主指数。

该model（ ）函数返回模型的索引引用作为QAbstractItemModel。该child（ ）函数用于检查模型中的指数下举行的项目。该sibling（ ）函数允许您遍历在同一水平作为指标在模型中的项目。

Note:型号索引应立即再丢弃使用。你不应该依赖于索引调用该改变模型的结构或删除项目模型函数后仍然有效。如果你需要保持一个模型索引随着时间的推移使用QPersistentModelIndex。

Method Documentation

  1. QModelIndex.__init__ (self)

创建一个新的空模型索引。这种类型的模型索引被用来表示模型中的位置是无效的。

See also isValid（）和QAbstractItemModel。

  1. QModelIndex.__init__ (self, QModelIndex other)

创建一个新的模型索引是的副本other模型索引。

  1. QModelIndex.__init__ (self, QPersistentModelIndex)
  1. QModelIndex QModelIndex.child (self, int arow, int acolumn)

[

返回该模型索引被存储在给定的子row和column。

Note:此功能不适用于其经常被用来作为根索引无效的模型索引工作。

]($docs-qmodelindex.html)

See also parent（）和sibling（ ） 。

  1. int QModelIndex.column (self)

返回此模型索引是指该列。

  1. QVariant QModelIndex.data (self, int role = Qt.DisplayRole)

返回数据为给定的role该项目由索引引用。

  1. Qt.ItemFlags QModelIndex.flags (self)

[

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

这个函数中引入了Qt 4.2中。

  1. int QModelIndex.internalId (self)

返回long所使用的模型的索引与内部数据结构相关联。

]($docs-index.htm)

See also QAbstractItemModel.createIndex（ ） 。

  1. object QModelIndex.internalPointer (self)

返回void *指针所使用的模型，以该指数与内部数据结构相关联。

See also QAbstractItemModel.createIndex（ ） 。

  1. bool QModelIndex.isValid (self)

返回True如果这个模型索引是有效的，否则返回False 。

一个有效的指标属于一个模型，并具有非负的行数和列数。

See also model（ ）row（）和column（ ） 。

  1. QAbstractItemModel QModelIndex.model (self)

[

返回一个指向包含该指标是指项目的模型。

的常量指针模型返回，因为调用模型的非const函数可能失效模型索引，并可能引起程序崩溃。

]($docs-qabstractitemmodel.html)

  1. QModelIndex QModelIndex.parent (self)

返回模型索引的父母，或QModelIndex（ ） ，如果它没有父。

See also child（ ）sibling（）和model（ ） 。

  1. int QModelIndex.row (self)

返回此模型索引是指该行。

  1. QModelIndex QModelIndex.sibling (self, int arow, int acolumn)

返回在同级row和column。如果没有兄弟在这个位置上，​​一个无效的QModelIndex返回。

See also parent（）和child（ ） 。

  1. bool QModelIndex.__eq__ (self, QModelIndex other)
  1. bool QModelIndex.__ge__ (self, QModelIndex other)
  1. int QModelIndex.__hash__ (self)
  1. bool QModelIndex.__lt__ (self, QModelIndex other)
  1. bool QModelIndex.__ne__ (self, QModelIndex other)