QStandardItem Class Reference
[QtGui module]
该QStandardItem类提供的项目与使用QStandardItemModel类。More…
Types
enum ItemType { Type, UserType }
Methods
__init__ (self)
__init__ (self, QString text)
__init__ (self, QIcon icon, QString text)
__init__ (self, int rows, int columns = 1)
__init__ (self, QStandardItem other)
QString accessibleDescription (self)
QString accessibleText (self)
appendColumn (self, list-of-QStandardItem aitems)
appendRow (self, list-of-QStandardItem aitems)
appendRow (self, QStandardItem aitem)
appendRows (self, list-of-QStandardItem aitems)
QBrush background (self)
Qt.CheckState checkState (self)
QStandardItem child (self, int row, int column = 0)
QStandardItem clone (self)
int column (self)
int columnCount (self)
QVariant data (self, int role = Qt.UserRole+1)
emitDataChanged (self)
Qt.ItemFlags flags (self)
QFont font (self)
QBrush foreground (self)
bool hasChildren (self)
QIcon icon (self)
QModelIndex index (self)
insertColumn (self, int column, list-of-QStandardItem items)
insertColumns (self, int column, int count)
insertRow (self, int row, list-of-QStandardItem items)
insertRow (self, int arow, QStandardItem aitem)
insertRows (self, int row, int count)
insertRows (self, int row, list-of-QStandardItem items)
bool isCheckable (self)
bool isDragEnabled (self)
bool isDropEnabled (self)
bool isEditable (self)
bool isEnabled (self)
bool isSelectable (self)
bool isTristate (self)
QStandardItemModel model (self)
QStandardItem parent (self)
read (self, QDataStream in)
removeColumn (self, int column)
removeColumns (self, int column, int count)
removeRow (self, int row)
removeRows (self, int row, int count)
int row (self)
int rowCount (self)
setAccessibleDescription (self, QString aaccessibleDescription)
setAccessibleText (self, QString aaccessibleText)
setBackground (self, QBrush abrush)
setCheckable (self, bool checkable)
setCheckState (self, Qt.CheckState acheckState)
setChild (self, int row, int column, QStandardItem item)
setChild (self, int arow, QStandardItem aitem)
setColumnCount (self, int columns)
setData (self, QVariant value, int role = Qt.UserRole+1)
setDragEnabled (self, bool dragEnabled)
setDropEnabled (self, bool dropEnabled)
setEditable (self, bool editable)
setEnabled (self, bool enabled)
setFlags (self, Qt.ItemFlags flags)
setFont (self, QFont afont)
setForeground (self, QBrush abrush)
setIcon (self, QIcon aicon)
setRowCount (self, int rows)
setSelectable (self, bool selectable)
setSizeHint (self, QSize asizeHint)
setStatusTip (self, QString astatusTip)
setText (self, QString atext)
setTextAlignment (self, Qt.Alignment atextAlignment)
setToolTip (self, QString atoolTip)
setTristate (self, bool tristate)
setWhatsThis (self, QString awhatsThis)
QSize sizeHint (self)
sortChildren (self, int column, Qt.SortOrder order = Qt.AscendingOrder)
QString statusTip (self)
QStandardItem takeChild (self, int row, int column = 0)
list-of-QStandardItem takeColumn (self, int column)
list-of-QStandardItem takeRow (self, int row)
QString text (self)
Qt.Alignment textAlignment (self)
QString toolTip (self)
int type (self)
QString whatsThis (self)
write (self, QDataStream out)
Special Methods
bool __ge__ (self, QStandardItem other)
bool __lt__ (self, QStandardItem other)
Detailed Description
该QStandardItem类提供的项目与使用QStandardItemModel类。
项目通常包含文字,图标或复选框。
每个项目都可以有自己的背景刷子设置与setBackground()函数。当前的背景刷可以找到background( ) 。每个项目的文本标籤可以有自己的字体和笔刷渲染。这些都与指定setFont()和setForeground()函数,并读取与font()和foreground( ) 。
默认情况下,项目的启用,可编辑,可选择辨认的,可同时用作拖动的来源又是释放的操作和放置目标。每个项目的标志可以通过调用改变setFlags( ) 。辨认的项目可以选中和未选中的setCheckState()函数。相应的checkState( )函数表示该项目目前是否已选中。
你可以通过调用一个项目存储应用程序特定的数据setData( ) 。
每个项目可以有一个二维子项表。这使得它可以构建项目的层次结构。典型的分层结构是树,在这种情况下,子表是一个表,用一个柱(列表)。
子表的尺寸可以与设置setRowCount()和setColumnCount( ) 。物品可以放置在子表setChild( ) 。获取一个指针,指向一个子项与child( ) 。儿童的新的行和列,也可以插入insertRow()和insertColumn(),或者追加appendRow()和appendColumn( ) 。当使用append和插入函数,子表的尺寸根据需要将增长。
儿童的现有行可以被删除removeRow()或takeRow();相应地,一列可以具有去除removeColumn()或takeColumn( ) 。
一个项目的孩子可以通过调用进行排序sortChildren( ) 。
Subclassing
当子类QStandardItem提供自定义项目,可以为他们定义新类型,使他们能够从基类区别开来。该type()函数应该被重新实现返回一个新的类型的值等于或大于UserType。
重新实现data()和setData( )如果要执行数据查询的自定义处理和/或控制项的数据是如何表示的。
重新实现clone( )如果你想QStandardItemModel要能够根据需要创建自定义项目类的实例(见QStandardItemModel.setItemPrototype())。
重新实现read()和write( )如果你想控制项目如何代表他们的序列化形式。
重新实现operator<( )如果你想控制项目比较的语义。operator<( )确定排序顺序与排序项目时,sortChildren()或与QStandardItemModel.sort( ) 。
Type Documentation
QStandardItem.ItemType
这个枚举变量描述了用于描述标准的项目的类型。
Constant | Value | Description |
---|---|---|
QStandardItem.Type |
0 |
默认类型为标准的项目。 |
QStandardItem.UserType |
1000 |
对于自定义类型的最小值。以下用户等级和积分值被Qt保留。 |
您可以定义新的用户类型QStandardItem子类以确保自定义项目经过特殊处理,例如,当项目进行排序。
See also type( ) 。
Method Documentation
QStandardItem.__init__ (self)
构造一个项目。
QStandardItem.__init__ (self, QString text)
构造具有给定的项目text。
QStandardItem.__init__ (self, QIcon icon, QString text)
构造具有给定的项目icon和text。
QStandardItem.__init__ (self, int rows, int columns = 1)
构造与项目rows行和columns子项的列。
QStandardItem.__init__ (self, QStandardItem other)
构造的副本other。需要注意的是model( )不会被复制。
重新实现时,此功能非常有用clone( ) 。
QString QStandardItem.accessibleDescription (self)
返回该项目的可访问的描述。
可访问的说明是使用辅助技术(即谁不能用互动的传统方式用户) 。
See also setAccessibleDescription()和accessibleText( ) 。
QString QStandardItem.accessibleText (self)
返回该项目的访问的文本。
在访问的文本所使用的辅助技术(即谁不能使用交互的常规手段的用户) 。
See also setAccessibleText()和accessibleDescription( ) 。
QStandardItem.appendColumn (self, list-of-QStandardItem aitems)
该aitems说法有它的所有权转移给Qt的。
含追加一列items。如果有必要,该行数将增加至大小items。
See also insertColumn( ) 。
QStandardItem.appendRow (self, list-of-QStandardItem aitems)
该aitems说法有它的所有权转移给Qt的。
含追加的行items。如果需要的话,列计数值增加到的大小items。
See also insertRow( ) 。
QStandardItem.appendRow (self, QStandardItem aitem)
该aitem说法有它的所有权转移给Qt的。
这是一个重载函数。
含追加的行item。
当建立一个列表,或者只有一列树,该功能提供了一种方便的方式来追加新的单一项目。
QStandardItem.appendRows (self, list-of-QStandardItem aitems)
该aitems说法有它的所有权转移给Qt的。
含追加行items。列计数不会改变。
See also insertRow( ) 。
QBrush QStandardItem.background (self)
[
返回用于呈现项的背景的画笔。
]($docs-qbrush.html)
See also foreground()和setBackground( ) 。
Qt.CheckState QStandardItem.checkState (self)
[
返回项目的选中状态。
]($docs-qt.html#CheckState-enum)
See also setCheckState()和isCheckable( ) 。
QStandardItem QStandardItem.child (self, int row, int column = 0)
[
返回位于(子项row,column)如果已设置,否则返回0 。
]($docs-qstandarditem.html)
See also setChild( )takeChild()和parent( ) 。
QStandardItem QStandardItem.clone (self)
[
返回此文件的副本。该项目的孩子不会被复制。
]($docs-qstandarditem.html)
当子类QStandardItem,你可以重新实现此功能提供QStandardItemModel用它可以用来创建随需应变的新项目工厂。
See also QStandardItemModel.setItemPrototype()和operator=( ) 。
int QStandardItem.column (self)
返回列该项目位于其父的子表,或-1,如果该项目没有父。
int QStandardItem.columnCount (self)
返回子项列,该项目具有数量。
See also setColumnCount()和rowCount( ) 。
QVariant QStandardItem.data (self, int role = Qt.UserRole+1)
返回的项目的数据为给定的role,或无效QVariant如果不存在数据的作用。
Note:默认实现对待Qt.EditRole和Qt.DisplayRole为是指相同的数据。
See also setData( ) 。
QStandardItem.emitDataChanged (self)
原因与此文件相关的模型发出dataChanged()信号为这个项目。
你通常只需要调用这个函数,如果你有子类QStandardItem并重新实现data( )和/或setData( ) 。
此功能被引入Qt的4.4 。
See also setData( ) 。
Qt.ItemFlags QStandardItem.flags (self)
[
返回项标志的项目。
项目标志确定用户如何能够与项目交互。
默认情况下,项目的启用,可编辑,可选择辨认的,可同时用作拖动的来源又是释放的操作和放置目标。
]($docs-index.htm)
QFont QStandardItem.font (self)
[
返回用于呈现项的文本的字体。
]($docs-qfont.html)
QBrush QStandardItem.foreground (self)
[
返回用于呈现项目的前景(如文字)的笔刷。
]($docs-qbrush.html)
See also setForeground()和background( ) 。
bool QStandardItem.hasChildren (self)
返回True如果资料有任何子女;否则返回False。
See also rowCount( )columnCount()和child( ) 。
QIcon QStandardItem.icon (self)
[
返回该项目的图标。
]($docs-qicon.html)
QModelIndex QStandardItem.index (self)
返回QModelIndex与此文件相关。
当你需要调用一个功能项QModelIndex的API (例如QAbstractItemView) ,你可以调用这个函数来获得与该项目的位置在模型中的索引。
如果该项目没有与模型,无效的关联QModelIndex返回。
See also model()和QStandardItemModel.itemFromIndex( ) 。
QStandardItem.insertColumn (self, int column, list-of-QStandardItem items)
该items说法有它的所有权转移给Qt的。
在插入一列column containing items。如果有必要,该行数将增加至大小items。
See also insertColumns()和insertRow( ) 。
QStandardItem.insertColumns (self, int column, int count)
Inserts count在柱子项的列column。
See also insertColumn()和insertRows( ) 。
QStandardItem.insertRow (self, int row, list-of-QStandardItem items)
该items说法有它的所有权转移给Qt的。
插入一个一行row containing items。如果需要的话,列计数值增加到的大小items。
See also insertRows()和insertColumn( ) 。
QStandardItem.insertRow (self, int arow, QStandardItem aitem)
该aitem说法有它的所有权转移给Qt的。
这是一个重载函数。
插入一个一行row containing item。
当建立一个列表,或者只有一列树,该功能提供了一种方便的方式来插入一个新的项目。
QStandardItem.insertRows (self, int row, int count)
Inserts items在row。列计数不会改变。
See also insertRow()和insertColumn( ) 。
QStandardItem.insertRows (self, int row, list-of-QStandardItem items)
该items说法有它的所有权转移给Qt的。
Inserts count在一行行的子项row。
See also insertRow()和insertColumns( ) 。
bool QStandardItem.isCheckable (self)
返回该项目是否是用户可选中。
默认值是False 。
See also setCheckable( )checkState()和isTristate( ) 。
bool QStandardItem.isDragEnabled (self)
返回该项目是否启用拖动。一个项目,是拖拉启用可以由用户进行拖动。
默认值是True 。
请注意,项目必须拖着在视图中启用拖放到工作;看QAbstractItemView.dragEnabled。
See also setDragEnabled( )isDropEnabled()和flags( ) 。
bool QStandardItem.isDropEnabled (self)
返回该项目是否下降启用。当一个项目是下拉使能时,它可以作为一个放置目标。
默认值是True 。
See also setDropEnabled( )isDragEnabled()和flags( ) 。
bool QStandardItem.isEditable (self)
返回是否该项目可以由用户进行编辑。
当一个项目是可编辑的(并启用) ,用户可以通过调用视图的编辑触发器中的一个编辑的项目;见QAbstractItemView.editTriggers。
默认值是True 。
See also setEditable()和flags( ) 。
bool QStandardItem.isEnabled (self)
返回该项是否已启用。
当一个项目被启用,用户可以与它进行交互。可能的类型的交互是由其它产品的标志,如指定isEditable()和isSelectable( ) 。
默认值是True 。
See also setEnabled()和flags( ) 。
bool QStandardItem.isSelectable (self)
返回该产品是否是由用户选择的。
默认值是True 。
See also setSelectable()和flags( ) 。
bool QStandardItem.isTristate (self)
该项目的回报是否是三态的,也就是说,如果它是可复用三个分开的状态。
默认值是False 。
See also setTristate( )isCheckable()和checkState( ) 。
QStandardItemModel QStandardItem.model (self)
返回QStandardItemModel此项目属于。
如果该项目不属于模型的另一个项目的一个孩子,这个函数返回0 。
See also index( ) 。
QStandardItem QStandardItem.parent (self)
[
返回该项目的父项目,或者0,如果该项目没有父。
]($docs-qstandarditem.html)
QStandardItem.read (self, QDataStream in)
从流中读取的项目in。唯一的项的数据和标志读,而不是子项。
See also write( ) 。
QStandardItem.removeColumn (self, int column)
删除给定的column。这是该列中的项被删除。
See also takeColumn( )removeColumns()和removeRow( ) 。
QStandardItem.removeColumns (self, int column, int count)
移除count在列的列column。这是这些列中的项将被删除。
See also removeColumn()和removeRows( ) 。
QStandardItem.removeRow (self, int row)
删除给定的row。这是该行中的项目被删除。
See also takeRow( )removeRows()和removeColumn( ) 。
QStandardItem.removeRows (self, int row, int count)
移除count在一行行row。这是在这些行中的项目都将被删除。
See also removeRow()和removeColumn( ) 。
int QStandardItem.row (self)
返回该行所在的项目位于其父的子表,或-1,如果该项目没有父。
int QStandardItem.rowCount (self)
返回该项目具有子项的行数。
See also setRowCount()和columnCount( ) 。
QStandardItem.setAccessibleDescription (self, QString aaccessibleDescription)
设置项目的访问描述为字符串由指定的accessibleDescription。
可访问的说明是使用辅助技术(即谁不能用互动的传统方式用户) 。
See also accessibleDescription()和setAccessibleText( ) 。
QStandardItem.setAccessibleText (self, QString aaccessibleText)
设置项目的访问的文本由指定的字符串accessibleText。
在访问的文本所使用的辅助技术(即谁不能使用交互的常规手段的用户) 。
See also accessibleText()和setAccessibleDescription( ) 。
QStandardItem.setBackground (self, QBrush abrush)
设置项的背景刷到指定的brush。
See also background()和setForeground( ) 。
QStandardItem.setCheckable (self, bool checkable)
设置项是否是用户可选中。如果checkable诚然,该项目可以由用户进行检查,否则用户无法检查的项目。
该项目委讬将呈现辨认的项目与项目旁边的文本的复选框。
See also isCheckable( )setCheckState()和setTristate( ) 。
QStandardItem.setCheckState (self, Qt.CheckState acheckState)
设置为项目的选中状态state。
See also checkState()和setCheckable( ) 。
QStandardItem.setChild (self, int row, int column, QStandardItem item)
该item说法有它的所有权转移给Qt的。
设置在子项(row,column)至item。此产品(父项)需要的所有权item。如果必要,行数和列数都增加,以适应产品。
See also child( ) 。
QStandardItem.setChild (self, int arow, QStandardItem aitem)
该aitem说法有它的所有权转移给Qt的。
这是一个重载函数。
设定孩子row至item。
QStandardItem.setColumnCount (self, int columns)
设置子项的列数columns。如果它小于columnCount() ,在不需要的列中的数据将被丢弃。
See also columnCount()和setRowCount( ) 。
QStandardItem.setData (self, QVariant value, int role = Qt.UserRole+1)
设置项的数据为给定的role到指定的value。
如果子类QStandardItem并且重新实现这个功能,你重新实现应该调用emitDataChanged( )如果你不使用setData调用的基实现( ) 。这将确保如使用模型视图通知的变化。
Note:默认实现对待Qt.EditRole和Qt.DisplayRole为是指相同的数据。
See also Qt.ItemDataRole,data()和setFlags( ) 。
QStandardItem.setDragEnabled (self, bool dragEnabled)
设置项是否启用拖动。如果dragEnabled诚然,该项目可以由用户拖动,否则,用户无法拖曳项目。
请注意,您还需要确保该项目拖动在视图中启用;见QAbstractItemView.dragEnabled。
See also isDragEnabled( )setDropEnabled()和setFlags( ) 。
QStandardItem.setDropEnabled (self, bool dropEnabled)
设置项是否下降启用。如果dropEnabled诚然,该项目可作为放置目标,否则不能。
请注意,您还需要确保滴在视图中启用;见QWidget.acceptDrops(); ,且该模型支持所需的放置动作;见QAbstractItemModel.supportedDropActions( ) 。
See also isDropEnabled( )setDragEnabled()和setFlags( ) 。
QStandardItem.setEditable (self, bool editable)
设置项是否可以编辑。如果editable诚然,该项目可以由用户进行编辑,否则用户无法编辑的项目。
如何通过视图的编辑触发器来确定用户可以编辑视图中的项目;见QAbstractItemView.editTriggers。
See also isEditable()和setFlags( ) 。
QStandardItem.setEnabled (self, bool enabled)
设置该项是否已启用。如果enabled为真,则该项目被使能,这意味着用户可以与产品进行交互;若enabled为假,则用户不能与项目交互。
此标志优先于其他项目的标志;如如果项目没有被启用,它不能由用户选择的,即使Qt.ItemIsSelectable标志已设置。
See also isEnabled( )Qt.ItemIsEnabled和setFlags( ) 。
QStandardItem.setFlags (self, Qt.ItemFlags flags)
设置项标志的项目flags。
项目标志确定用户如何能够与项目交互。这通常被用于禁用的项目。
QStandardItem.setFont (self, QFont afont)
设置用于显示项目的文字给定的字体font。
See also font( )setText()和setForeground( ) 。
QStandardItem.setForeground (self, QBrush abrush)
设置用于显示项目的前景(如文本)给定的画笔brush。
See also foreground( )setBackground()和setFont( ) 。
QStandardItem.setIcon (self, QIcon aicon)
设置项的图标icon规定。
See also icon( ) 。
QStandardItem.setRowCount (self, int rows)
设置的子项目行数rows。如果它小于rowCount() ,在不需要的行中的数据将被丢弃。
See also rowCount()和setColumnCount( ) 。
QStandardItem.setSelectable (self, bool selectable)
设置项是否可选。如果selectable诚然,该项目可以由用户来选择,否则,用户无法选择该项目。
您可以通过操纵自己的视图属性控制选择行为和模式,见QAbstractItemView.selectionMode和QAbstractItemView.selectionBehavior。
See also isSelectable()和setFlags( ) 。
QStandardItem.setSizeHint (self, QSize asizeHint)
设置尺寸暗示该项目是size。如果没有大小的提示设置,基于项目数据的项目代表将计算尺寸暗示。
See also sizeHint( ) 。
QStandardItem.setStatusTip (self, QString astatusTip)
设置项目的状态提示由指定的字符串statusTip。
See also statusTip( )setToolTip()和setWhatsThis( ) 。
QStandardItem.setText (self, QString atext)
设置项的文字到text规定。
See also text( )setFont()和setForeground( ) 。
QStandardItem.setTextAlignment (self, Qt.Alignment atextAlignment)
设置文本对齐方式为项目的文字到alignment规定。
See also textAlignment( ) 。
QStandardItem.setToolTip (self, QString atoolTip)
设置项的提示通过指定的字符串toolTip。
See also toolTip( )setStatusTip()和setWhatsThis( ) 。
QStandardItem.setTristate (self, bool tristate)
设置项是否为三态。如果tristate诚然,该项目是可复用三个独立的状态,否则,该项目是可复用两种状态。 (请注意,这也要求产品可复见isCheckable( ) 。 )
See also isTristate( )setCheckable()和setCheckState( ) 。
QStandardItem.setWhatsThis (self, QString awhatsThis)
设置项的“这是什么? ”有助于通过指定的字符串whatsThis。
See also whatsThis( )setStatusTip()和setToolTip( ) 。
QSize QStandardItem.sizeHint (self)
返回该项目的尺寸暗示组,或无效QSize如果没有尺寸暗示已定。
如果没有大小提示已设置的基础上,项目数据的项目代表将计算尺寸暗示。
See also setSizeHint( ) 。
QStandardItem.sortChildren (self, int column, Qt.SortOrder order = Qt.AscendingOrder)
排序的项目的使用给定的孩子order通过在给定的值column。
Note:这个函数是递归的,因此它排序的项目,其孙子女,等孩子们
See also operator<( ) 。
QString QStandardItem.statusTip (self)
返回项目的状态提示。
See also setStatusTip( )toolTip()和whatsThis( ) 。
QStandardItem QStandardItem.takeChild (self, int row, int column = 0)
[
The QStandardItem result
删除的子项(row,column)而不删除它,并返回一个指向的项目。如果没有孩子在给定的位置,那么这个函数返回0 。
]($docs-qstandarditem.html)
注意,这个函数,不象takeRow()和takeColumn( ) ,不影响子表的尺寸。
See also child( )takeRow()和takeColumn( ) 。
list-of-QStandardItem QStandardItem.takeColumn (self, int column)
该list-of-QStandardItem结果
移除column不删除的列项,并返回指针列表的删除的项。在尚未设定的列项,列表中的相应指针将是0 。
See also removeColumn( )insertColumn()和takeRow( ) 。
list-of-QStandardItem QStandardItem.takeRow (self, int row)
该list-of-QStandardItem结果
移除row不删除的行项目,并返回指针列表的删除的项目。对于没有被设置的行中的项目,列表中的相应指针将是0 。
See also removeRow( )insertRow()和takeColumn( ) 。
QString QStandardItem.text (self)
返回项的文本。这是这是呈现给用户在视图中的文本。
See also setText( ) 。
Qt.Alignment QStandardItem.textAlignment (self)
[
返回文本对齐方式项的文本。
]($docs-index.htm)
See also setTextAlignment( ) 。
QString QStandardItem.toolTip (self)
返回该项目的工具提示。
See also setToolTip( )statusTip()和whatsThis( ) 。
int QStandardItem.type (self)
返回此项目的类型。该类型用于从基类区分自定义项目。当子类QStandardItem,你应该重新实现这个函数,并返回一个新的值大于或等于UserType。
See also QStandardItem.Type。
QString QStandardItem.whatsThis (self)
返回该项目的“这是什么? ”帮助。
See also setWhatsThis( )toolTip()和statusTip( ) 。
QStandardItem.write (self, QDataStream out)
写入流的项目out。该项目的唯一的数据和标志都写,不是孩子的项目。
See also read( ) 。
bool QStandardItem.__ge__ (self, QStandardItem other)
bool QStandardItem.__lt__ (self, QStandardItem other)