QTreeWidgetItem Class Reference

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)