QTreeWidgetItem Class Reference
[QtGui module]
该QTreeWidgetItem类提供的项目与使用QTreeWidget方便的类。More…
Types
enum ChildIndicatorPolicy { ShowIndicator, DontShowIndicator, DontShowIndicatorWhenChildless }
enum ItemType { Type, UserType }
Methods
__init__ (self, int type = QTreeWidgetItem.Type)
__init__ (self, QStringList strings, int type = QTreeWidgetItem.Type)
__init__ (self, QTreeWidget parent, int type = QTreeWidgetItem.Type)
__init__ (self, QTreeWidget parent, QStringList strings, int type = QTreeWidgetItem.Type)
__init__ (self, QTreeWidget parent, QTreeWidgetItem preceding, int type = QTreeWidgetItem.Type)
__init__ (self, QTreeWidgetItem parent, int type = QTreeWidgetItem.Type)
__init__ (self, QTreeWidgetItem parent, QStringList strings, int type = QTreeWidgetItem.Type)
__init__ (self, QTreeWidgetItem parent, QTreeWidgetItem preceding, int type = QTreeWidgetItem.Type)
__init__ (self, QTreeWidgetItem other)
addChild (self, QTreeWidgetItem child)
addChildren (self, list-of-QTreeWidgetItem children)
QBrush background (self, int column)
QColor backgroundColor (self, int column)
Qt.CheckState checkState (self, int column)
QTreeWidgetItem child (self, int index)
int childCount (self)
ChildIndicatorPolicy childIndicatorPolicy (self)
QTreeWidgetItem clone (self)
int columnCount (self)
QVariant data (self, int column, int role)
emitDataChanged (self)
Qt.ItemFlags flags (self)
QFont font (self, int column)
QBrush foreground (self, int column)
QIcon icon (self, int column)
int indexOfChild (self, QTreeWidgetItem achild)
insertChild (self, int index, QTreeWidgetItem child)
insertChildren (self, int index, list-of-QTreeWidgetItem children)
bool isDisabled (self)
bool isExpanded (self)
bool isFirstColumnSpanned (self)
bool isHidden (self)
bool isSelected (self)
QTreeWidgetItem parent (self)
read (self, QDataStream in)
removeChild (self, QTreeWidgetItem child)
setBackground (self, int column, QBrush brush)
setBackgroundColor (self, int column, QColor color)
setCheckState (self, int column, Qt.CheckState state)
setChildIndicatorPolicy (self, ChildIndicatorPolicy policy)
setData (self, int column, int role, QVariant value)
setDisabled (self, bool disabled)
setExpanded (self, bool aexpand)
setFirstColumnSpanned (self, bool aspan)
setFlags (self, Qt.ItemFlags aflags)
setFont (self, int column, QFont afont)
setForeground (self, int column, QBrush brush)
setHidden (self, bool ahide)
setIcon (self, int column, QIcon aicon)
setSelected (self, bool aselect)
setSizeHint (self, int column, QSize size)
setStatusTip (self, int column, QString astatusTip)
setText (self, int column, QString atext)
setTextAlignment (self, int column, int alignment)
setTextColor (self, int column, QColor color)
setToolTip (self, int column, QString atoolTip)
setWhatsThis (self, int column, QString awhatsThis)
QSize sizeHint (self, int column)
sortChildren (self, int column, Qt.SortOrder order)
QString statusTip (self, int column)
QTreeWidgetItem takeChild (self, int index)
list-of-QTreeWidgetItem takeChildren (self)
QString text (self, int column)
int textAlignment (self, int column)
QColor textColor (self, int column)
QString toolTip (self, int column)
QTreeWidget treeWidget (self)
int type (self)
QString whatsThis (self, int column)
write (self, QDataStream out)
Special Methods
bool __ge__ (self, QTreeWidgetItem other)
bool __lt__ (self, QTreeWidgetItem other)
Detailed Description
该QTreeWidgetItem类提供的项目与使用QTreeWidget方便的类。
树部件项目用于容纳的行信息树窗口小部件。行通常包含若干列的数据,每一个都可以包含一个文本标籤和一个图标。
该QTreeWidgetItem类是替换QListViewItem类的Qt 3一个方便的类。它提供了一种用于产品的使用QTreeWidget类。
货品一般构造与父母,要么是一个QTreeWidget(顶级项目)或QTreeWidgetItem (关于树的下级项目) 。例如,下面的代码构造一个顶级项目,代表了世界城市,并增加了对奥斯陆的一个子项一个条目:
QTreeWidgetItem *cities = new QTreeWidgetItem(treeWidget);
cities->setText(0, tr("Cities"));
QTreeWidgetItem *osloItem = new QTreeWidgetItem(cities);
osloItem->setText(0, tr("Oslo"));
osloItem->setText(1, tr("Yes"));
项目可以在一个特定的顺序添加指定他们也跟着当他们建造的项目:
QTreeWidgetItem *planets = new QTreeWidgetItem(treeWidget, cities);
planets->setText(0, tr("Planets"));
在一个项目的每一列都可以有其自己的背景刷子设置与setBackground()函数。当前的背景刷可以找到background( ) 。对每一列中的文本标籤可以与它自己的字体和刷子来呈现。这些都与指定setFont()和setForeground()函数,并读取与font()和foreground( ) 。
顶级项目以及在该树的下级之间的主要区别在于,一个顶级项目没有parent( ) 。此信息可以用来告诉项目之间的差异,并且是要知道从树插入和取出物品时非常有用。一个项目的孩子们可以与被删除takeChild() ,并插入一个给定的索引中的儿童用的清单insertChild()函数。
默认情况下,项目的启用,可选择,可复,可一拖源和拖放操作。每个项目的标志可以通过调用改变setFlags( )用适当的值(见Qt.ItemFlags) 。辨认的项目可以选中和未选中的setCheckState()函数。相应的checkState( )函数表示该项目目前是否已选中。
Subclassing
当子类QTreeWidgetItem提供自定义项目,可以为他们定义新类型,使他们能够从标准的项目区别开来。该构造函数需要此功能的子类需要调用基类的构造函数有一个新的类型值等于或大于UserType。
Type Documentation
QTreeWidgetItem.ChildIndicatorPolicy
Constant | Value | Description |
---|---|---|
QTreeWidgetItem.ShowIndicator |
0 |
用于展开和折叠的控件将显示此项目,即使有没有孩子。 |
QTreeWidgetItem.DontShowIndicator |
1 |
将永远不会被显示为展开和折叠的控制,即使有孩子。如果节点被强行打开,用户将无法展开或折叠的项目。 |
QTreeWidgetItem.DontShowIndicatorWhenChildless |
2 |
用于展开和折叠的控件将显示,如果该项目包含了孩子。 |
这个枚举被引入或修改的Qt 4.3 。
QTreeWidgetItem.ItemType
这个枚举变量描述了用于描述树形控件项目的类型。
Constant | Value | Description |
---|---|---|
QTreeWidgetItem.Type |
0 |
默认类型为树部件项目。 |
QTreeWidgetItem.UserType |
1000 |
对于自定义类型的最小值。以下用户等级和积分值被Qt保留。 |
您可以定义新的用户类型QTreeWidgetItem子类以确保自定义项目经过特殊处理,例如,当项目进行排序。
See also type( ) 。
Method Documentation
QTreeWidgetItem.__init__ (self, int type = QTreeWidgetItem.Type)
构造一个指定的树部件项目type。该项目必须被插入到树部件。
See also type( ) 。
QTreeWidgetItem.__init__ (self, QStringList strings, int type = QTreeWidgetItem.Type)
构造一个指定的树部件项目type。该项目必须被插入到树部件。给定列表strings将被设置为项的文本项中的每一列。
See also type( ) 。
QTreeWidgetItem.__init__ (self, QTreeWidget parent, int type = QTreeWidgetItem.Type)
该parent的说法,如果不是没有,原因self通过Qt的,而不是PyQt的拥有。
构造一个指定的树部件项目type和附加到它在给定的项目parent。
See also type( ) 。
QTreeWidgetItem.__init__ (self, QTreeWidget parent, QStringList strings, int type = QTreeWidgetItem.Type)
该parent的说法,如果不是没有,原因self通过Qt的,而不是PyQt的拥有。
构造一个指定的树部件项目type和附加到它在给定的项目parent。给定列表strings将被设置为项的文本项中的每一列。
See also type( ) 。
QTreeWidgetItem.__init__ (self, QTreeWidget parent, QTreeWidgetItem preceding, int type = QTreeWidgetItem.Type)
该parent的说法,如果不是没有,原因self通过Qt的,而不是PyQt的拥有。
构造一个指定的树部件项目type并将其插入到给定的parent后preceding项目。
See also type( ) 。
QTreeWidgetItem.__init__ (self, QTreeWidgetItem parent, int type = QTreeWidgetItem.Type)
该parent的说法,如果不是没有,原因self通过Qt的,而不是PyQt的拥有。
构造一个树形控件项目,并将其附加到给定parent。
See also type( ) 。
QTreeWidgetItem.__init__ (self, QTreeWidgetItem parent, QStringList strings, int type = QTreeWidgetItem.Type)
该parent的说法,如果不是没有,原因self通过Qt的,而不是PyQt的拥有。
构造一个树形控件项目,并将其附加到给定parent。给定列表strings将被设置为项的文本项中的每一列。
See also type( ) 。
QTreeWidgetItem.__init__ (self, QTreeWidgetItem parent, QTreeWidgetItem preceding, int type = QTreeWidgetItem.Type)
该parent的说法,如果不是没有,原因self通过Qt的,而不是PyQt的拥有。
构造一个指定的树部件项目type该插入parent后preceding子项。
See also type( ) 。
QTreeWidgetItem.__init__ (self, QTreeWidgetItem other)
构造的副本other。需要注意的是type()和treeWidget( )不会被复制。
重新实现时,此功能非常有用clone( ) 。
这个函数是Qt 4.1中引入。
QTreeWidgetItem.addChild (self, QTreeWidgetItem child)
该child说法有它的所有权转移给Qt的。
追加child项子项列表。
See also insertChild()和takeChild( ) 。
QTreeWidgetItem.addChildren (self, list-of-QTreeWidgetItem children)
该children说法有它的所有权转移给Qt的。
附加的给定列表children到该项目。
这个函数是Qt 4.1中引入。
See also insertChildren()和takeChildren( ) 。
QBrush QTreeWidgetItem.background (self, int column)
[
返回用于呈现指定的背景刷column。
这个函数中引入了Qt 4.2中。
]($docs-qbrush.html)
See also setBackground()和foreground( ) 。
QColor QTreeWidgetItem.backgroundColor (self, int column)
Qt.CheckState QTreeWidgetItem.checkState (self, int column)
[
返回指定标籤的检查状态column。
]($docs-qt.html#CheckState-enum)
See also setCheckState()和Qt.CheckState。
QTreeWidgetItem QTreeWidgetItem.child (self, int index)
[
返回在给定的项目index在该项目的孩子列表。
]($docs-qtreewidgetitem.html)
int QTreeWidgetItem.childCount (self)
返回子项的数量。
ChildIndicatorPolicy QTreeWidgetItem.childIndicatorPolicy (self)
[
返回该项指标的政策。这一政策决定时,树枝展开/折叠指示器。
]($docs-qtreewidgetitem.html#ChildIndicatorPolicy-enum)
See also setChildIndicatorPolicy( ) 。
QTreeWidgetItem QTreeWidgetItem.clone (self)
[
创建其子项的项目和深拷贝。
int QTreeWidgetItem.columnCount (self)
返回列中的项数。
QVariant QTreeWidgetItem.data (self, int column, int role)
返回该项目的价值column和role。
]($docs-qtreewidgetitem.html)
QTreeWidgetItem.emitDataChanged (self)
原因与此文件相关的模型发出dataChanged()信号为这个项目。
你通常只需要调用这个函数,如果你有子类QTreeWidgetItem并重新实现data( )和/或setData( ) 。
此功能被引入Qt的4.5 。
See also setData( ) 。
Qt.ItemFlags QTreeWidgetItem.flags (self)
[
返回用于描述产品的标志。这些判断项目是否可以被检查,编辑和选择。
]($docs-index.htm)
为标志的缺省值是Qt.ItemIsSelectable|Qt.ItemIsUserCheckable|Qt.ItemIsEnabled|Qt.ItemIsDragEnabled。如果该项目是与父构造,标志将除了含有Qt.ItemIsDropEnabled。
See also setFlags( ) 。
QFont QTreeWidgetItem.font (self, int column)
[
返回用于呈现在指定的文本的字体column。
]($docs-qfont.html)
QBrush QTreeWidgetItem.foreground (self, int column)
[
返回指定的用于呈现的前景(例如,文本)的刷column。
这个函数中引入了Qt 4.2中。
]($docs-qbrush.html)
See also setForeground()和background( ) 。
QIcon QTreeWidgetItem.icon (self, int column)
[
返回显示在所指定的图标column。
]($docs-qicon.html)
int QTreeWidgetItem.indexOfChild (self, QTreeWidgetItem achild)
返回给定索引child在儿童的项目的列表。
QTreeWidgetItem.insertChild (self, int index, QTreeWidgetItem child)
该child说法有它的所有权转移给Qt的。
插入child在项目index在孩子的列表。
如果孩子已经插入别的地方它不会被再次插入。
QTreeWidgetItem.insertChildren (self, int index, list-of-QTreeWidgetItem children)
该children说法有它的所有权转移给Qt的。
插入的给定列表children入项目的儿童在列表index。
那些已经被插入其他地方的孩子不会被插入。
这个函数是Qt 4.1中引入。
bool QTreeWidgetItem.isDisabled (self)
返回True如果该项目被禁用,否则返回False 。
此功能被引入Qt的4.3 。
See also setFlags( ) 。
bool QTreeWidgetItem.isExpanded (self)
返回True ,如果该项目被扩展,否则返回False 。
这个函数中引入了Qt 4.2中。
See also setExpanded( ) 。
bool QTreeWidgetItem.isFirstColumnSpanned (self)
返回True如果该项目跨越行中的所有列,否则返回False 。
此功能被引入Qt的4.3 。
See also setFirstColumnSpanned( ) 。
bool QTreeWidgetItem.isHidden (self)
返回True如果该项目被隐藏,否则返回False 。
这个函数中引入了Qt 4.2中。
See also setHidden( ) 。
bool QTreeWidgetItem.isSelected (self)
返回True如果该项目被选中,否则返回False 。
这个函数中引入了Qt 4.2中。
See also setSelected( ) 。
QTreeWidgetItem QTreeWidgetItem.parent (self)
[
返回该项目的父。
]($docs-qtreewidgetitem.html)
QTreeWidgetItem.read (self, QDataStream in)
从流中读取的项目in。这只能读取数据到一个单一的项目。
See also write( ) 。
QTreeWidgetItem.removeChild (self, QTreeWidgetItem child)
该child争论
删除所指示的给定项目child。拆下的项目不会被删除。
QTreeWidgetItem.setBackground (self, int column, QBrush brush)
设置标籤的背景刷子在给定的column到指定的brush。
这个函数中引入了Qt 4.2中。
See also background()和setForeground( ) 。
QTreeWidgetItem.setBackgroundColor (self, int column, QColor color)
QTreeWidgetItem.setCheckState (self, int column, Qt.CheckState state)
设置在给定的项目column检查状态是state。
See also checkState( ) 。
QTreeWidgetItem.setChildIndicatorPolicy (self, ChildIndicatorPolicy policy)
设置项指标policy。这一政策决定时,树枝展开/折叠指示器。默认值是ShowForChildren 。
See also childIndicatorPolicy( ) 。
QTreeWidgetItem.setData (self, int column, int role, QVariant value)
设置项目的价值column和role为给定的value。
该role描述了通过指定数据的类型value,并且由所定义的Qt.ItemDataRole枚举。
See also data( ) 。
QTreeWidgetItem.setDisabled (self, bool disabled)
禁用的项目,如果disabled为True,否则使该项目。
此功能被引入Qt的4.3 。
See also isDisabled()和setFlags( ) 。
QTreeWidgetItem.setExpanded (self, bool aexpand)
扩展项目,如果expand为True,否则崩溃的项目。
Warning:该QTreeWidgetItem必须被添加到该QTreeWidget之前调用这个函数。
这个函数中引入了Qt 4.2中。
See also isExpanded( ) 。
QTreeWidgetItem.setFirstColumnSpanned (self, bool aspan)
设置首节以跨越所有列,如果span是真的,否则所有项目的部分都显示。
此功能被引入Qt的4.3 。
See also isFirstColumnSpanned( ) 。
QTreeWidgetItem.setFlags (self, Qt.ItemFlags aflags)
设置标志的项,以给定的flags。这些决定了项目是否可以选择或修改。这通常被用于禁用的项目。
See also flags( ) 。
QTreeWidgetItem.setFont (self, int column, QFont afont)
设置用于在给定的显示文本的字体column为给定的font。
See also font( )setText()和setForeground( ) 。
QTreeWidgetItem.setForeground (self, int column, QBrush brush)
设置标籤的前景刷子在给定的column到指定的brush。
这个函数中引入了Qt 4.2中。
See also foreground()和setBackground( ) 。
QTreeWidgetItem.setHidden (self, bool ahide)
隐藏的项目,如果hide为True,否则显示的项目。
这个函数中引入了Qt 4.2中。
See also isHidden( ) 。
QTreeWidgetItem.setIcon (self, int column, QIcon aicon)
设置要显示在给定的图标column至icon。
See also icon( )setText()和iconSize。
QTreeWidgetItem.setSelected (self, bool aselect)
设置项的选择状态,以select。
这个函数中引入了Qt 4.2中。
See also isSelected( ) 。
QTreeWidgetItem.setSizeHint (self, int column, QSize size)
设置尺寸暗示的树项目在给定的column要size。如果没有大小的提示设置,基于项目数据的项目代表将计算尺寸暗示。
这个函数是Qt 4.1中引入。
See also sizeHint( ) 。
QTreeWidgetItem.setStatusTip (self, int column, QString astatusTip)
设置状态提示为给定的column为给定的statusTip。QTreeWidget鼠标跟踪需要启用此功能工作。
See also statusTip( )setToolTip()和setWhatsThis( ) 。
QTreeWidgetItem.setText (self, int column, QString atext)
设置要显示在给定的文本column为给定的text。
See also text( )setFont()和setForeground( ) 。
QTreeWidgetItem.setTextAlignment (self, int column, int alignment)
设置在给定的文本对齐方式为标籤column到alignment规定(见Qt.AlignmentFlag) 。
See also textAlignment( ) 。
QTreeWidgetItem.setTextColor (self, int column, QColor color)
QTreeWidgetItem.setToolTip (self, int column, QString atoolTip)
设置工具提示为给定的column至toolTip。
See also toolTip( )setStatusTip()和setWhatsThis( ) 。
QTreeWidgetItem.setWhatsThis (self, int column, QString awhatsThis)
设置“这是什么? ”帮助对于给定的column至whatsThis。
See also whatsThis( )setStatusTip()和setToolTip( ) 。
QSize QTreeWidgetItem.sizeHint (self, int column)
返回树项目的大小设置提示在给定的column(见QSize) 。
这个函数是Qt 4.1中引入。
See also setSizeHint( ) 。
QTreeWidgetItem.sortChildren (self, int column, Qt.SortOrder order)
排序的项目的使用给定的孩子order通过在给定的值column。
Note:这个函数不执行任何操作,如果该项目不与相关的QTreeWidget。
这个函数中引入了Qt 4.2中。
QString QTreeWidgetItem.statusTip (self, int column)
返回状态提示为给定的内容column。
See also setStatusTip( ) 。
QTreeWidgetItem QTreeWidgetItem.takeChild (self, int index)
[
该QTreeWidgetItem结果
在删除的项目index并返回它,否则返回0 。
list-of-QTreeWidgetItem QTreeWidgetItem.takeChildren (self)
该list-of-QTreeWidgetItem结果
消除儿童的列表,并返回它,否则返回空列表。
这个函数是Qt 4.1中引入。
QString QTreeWidgetItem.text (self, int column)
在指定返回文本column。
]($docs-qtreewidgetitem.html)
int QTreeWidgetItem.textAlignment (self, int column)
返回给定文本的对齐方式为标籤column(见Qt.AlignmentFlag) 。
See also setTextAlignment( ) 。
QColor QTreeWidgetItem.textColor (self, int column)
[
QString QTreeWidgetItem.toolTip (self, int column)
返回刀尖对于给定的column。
]($docs-qcolor.html)
See also setToolTip( ) 。
QTreeWidget QTreeWidgetItem.treeWidget (self)
[
返回树部件包含该项目。
int QTreeWidgetItem.type (self)
]($docs-qtreewidget.html)
QString QTreeWidgetItem.whatsThis (self, int column)
返回“这是什么? ”有助于对给定的内容column。
See also setWhatsThis( ) 。
QTreeWidgetItem.write (self, QDataStream out)
写入流的项目out。这只能从一个单一的项目写入数据。
See also read( ) 。
bool QTreeWidgetItem.__ge__ (self, QTreeWidgetItem other)
bool QTreeWidgetItem.__lt__ (self, QTreeWidgetItem other)