|  | Home · All Classes · Modules

# QTreeWidgetItem Class Reference
[QtGui module]

The QTreeWidgetItem class provides an item for use with the QTreeWidget convenience class. 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, unknown-type 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, unknown-type 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)
- unknown-type 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

The QTreeWidgetItem class provides an item for use with the QTreeWidget convenience class.

Tree widget items are used to hold rows of information for tree widgets. Rows usually contain several columns of data, each of which can contain a text label and an icon.

The QTreeWidgetItem class is a convenience class that replaces the QListViewItem class in Qt 3. It provides an item for use with the QTreeWidget class.

Items are usually constructed with a parent that is either a QTreeWidget (for top-level items) or a QTreeWidgetItem (for items on lower levels of the tree). For example, the following code constructs a top-level item to represent cities of the world, and adds a entry for Oslo as a child item:

         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"));

Items can be added in a particular order by specifying the item they follow when they are constructed:

         QTreeWidgetItem *planets = new QTreeWidgetItem(treeWidget, cities);
         planets->setText(0, tr("Planets"));

Each column in an item can have its own background brush which is set with the setBackground() function. The current background brush can be found with background(). The text label for each column can be rendered with its own font and brush. These are specified with the setFont() and setForeground() functions, and read with font() and foreground().

The main difference between top-level items and those in lower levels of the tree is that a top-level item has no parent(). This information can be used to tell the difference between items, and is useful to know when inserting and removing items from the tree. Children of an item can be removed with takeChild() and inserted at a given index in the list of children with the insertChild() function.

By default, items are enabled, selectable, checkable, and can be the source of a drag and drop operation. Each item's flags can be changed by calling setFlags() with the appropriate value (see Qt.ItemFlags). Checkable items can be checked and unchecked with the setCheckState() function. The corresponding checkState() function indicates whether the item is currently checked.

### Subclassing

When subclassing QTreeWidgetItem to provide custom items, it is possible to define new types for them so that they can be distinguished from standard items. The constructors for subclasses that require this feature need to call the base class constructor with a new type value equal to or greater than UserType.

## Type Documentation

### QTreeWidgetItem.ChildIndicatorPolicy

Constant | Value | Description
--- | --- | ---
`QTreeWidgetItem.ShowIndicator` | `0` | The controls for expanding and collapsing will be shown for this item even if there are no children.
`QTreeWidgetItem.DontShowIndicator` | `1` | The controls for expanding and collapsing will never be shown even if there are children. If the node is forced open the user will not be able to expand or collapse the item.
`QTreeWidgetItem.DontShowIndicatorWhenChildless` | `2` | The controls for expanding and collapsing will be shown if the item contains children.

This enum was introduced or modified in Qt 4.3.

### QTreeWidgetItem.ItemType

This enum describes the types that are used to describe tree widget items.

Constant | Value | Description
--- | --- | ---
`QTreeWidgetItem.Type` | `0` | The default type for tree widget items.
`QTreeWidgetItem.UserType` | `1000` | The minimum value for custom types. Values below UserType are reserved by Qt.

You can define new user types in QTreeWidgetItem subclasses to ensure that custom items are treated specially; for example, when items are sorted.

See also type().

## Method Documentation

### QTreeWidgetItem.__init__ (self, int type = QTreeWidgetItem.Type)

Constructs a tree widget item of the specified type. The item must be inserted into a tree widget.

See also type().

### QTreeWidgetItem.__init__ (self, QStringList strings, int type = QTreeWidgetItem.Type)

Constructs a tree widget item of the specified type. The item must be inserted into a tree widget. The given list of strings will be set as the item text for each column in the item.

See also type().

### QTreeWidgetItem.__init__ (self, QTreeWidget parent, int type = QTreeWidgetItem.Type)

The parent argument, if not None, causes self to be owned by Qt instead of PyQt.

Constructs a tree widget item of the specified type and appends it to the items in the given parent.

See also type().

### QTreeWidgetItem.__init__ (self, QTreeWidget parent, QStringList strings, int type = QTreeWidgetItem.Type)

The parent argument, if not None, causes self to be owned by Qt instead of PyQt.

Constructs a tree widget item of the specified type and appends it to the items in the given parent. The given list of strings will be set as the item text for each column in the item.

See also type().

### QTreeWidgetItem.__init__ (self, QTreeWidget parent, QTreeWidgetItem preceding, int type = QTreeWidgetItem.Type)

The parent argument, if not None, causes self to be owned by Qt instead of PyQt.

Constructs a tree widget item of the specified type and inserts it into the given parent after the preceding item.

See also type().

### QTreeWidgetItem.__init__ (self, QTreeWidgetItem parent, int type = QTreeWidgetItem.Type)

The parent argument, if not None, causes self to be owned by Qt instead of PyQt.

Constructs a tree widget item and append it to the given parent.

See also type().

### QTreeWidgetItem.__init__ (self, QTreeWidgetItem parent, QStringList strings, int type = QTreeWidgetItem.Type)

The parent argument, if not None, causes self to be owned by Qt instead of PyQt.

Constructs a tree widget item and append it to the given parent. The given list of strings will be set as the item text for each column in the item.

See also type().

### QTreeWidgetItem.__init__ (self, QTreeWidgetItem parent, QTreeWidgetItem preceding, int type = QTreeWidgetItem.Type)

The parent argument, if not None, causes self to be owned by Qt instead of PyQt.

Constructs a tree widget item of the specified type that is inserted into the parent after the preceding child item.

See also type().

### QTreeWidgetItem.__init__ (self, QTreeWidgetItem other)

Constructs a copy of other. Note that type() and treeWidget() are not copied.

This function is useful when reimplementing clone().

This function was introduced in Qt 4.1.

See also data() and flags().

### QTreeWidgetItem.addChild (self, QTreeWidgetItem child)

The child argument has it's ownership transferred to Qt.

Appends the child item to the list of children.

See also insertChild() and takeChild().

### QTreeWidgetItem.addChildren (self, unknown-type children)

The children argument has it's ownership transferred to Qt.

Appends the given list of children to the item.

This function was introduced in Qt 4.1.

See also insertChildren() and takeChildren().

### QBrush QTreeWidgetItem.background (self, int column)

Returns the brush used to render the background of the specified column.

This function was introduced in Qt 4.2.

See also setBackground() and foreground().

### QColor QTreeWidgetItem.backgroundColor (self, int column)

### Qt.CheckState QTreeWidgetItem.checkState (self, int column)

Returns the check state of the label in the given column.

See also setCheckState() and Qt.CheckState.

### QTreeWidgetItem QTreeWidgetItem.child (self, int index)

Returns the item at the given index in the list of the item's children.

See also parent().

### int QTreeWidgetItem.childCount (self)

Returns the number of child items.

### ChildIndicatorPolicy QTreeWidgetItem.childIndicatorPolicy (self)

Returns the item indicator policy. This policy decides when the tree branch expand/collapse indicator is shown.

See also setChildIndicatorPolicy().

### QTreeWidgetItem QTreeWidgetItem.clone (self)

Creates a deep copy of the item and of its children.

### int QTreeWidgetItem.columnCount (self)

Returns the number of columns in the item.

### QVariant QTreeWidgetItem.data (self, int column, int role)

Returns the value for the item's column and role.

See also setData().

### QTreeWidgetItem.emitDataChanged (self)

Causes the model associated with this item to emit a dataChanged() signal for this item.

You normally only need to call this function if you have subclassed QTreeWidgetItem and reimplemented data() and/or setData().

This function was introduced in Qt 4.5.

See also setData().

### Qt.ItemFlags QTreeWidgetItem.flags (self)

Returns the flags used to describe the item. These determine whether the item can be checked, edited, and selected.

The default value for flags is Qt.ItemIsSelectable | Qt.ItemIsUserCheckable | Qt.ItemIsEnabled | Qt.ItemIsDragEnabled. If the item was constructed with a parent, flags will in addition contain Qt.ItemIsDropEnabled.

See also setFlags().

### QFont QTreeWidgetItem.font (self, int column)

Returns the font used to render the text in the specified column.

See also setFont().

### QBrush QTreeWidgetItem.foreground (self, int column)

Returns the brush used to render the foreground (e.g. text) of the specified column.

This function was introduced in Qt 4.2.

See also setForeground() and background().

### QIcon QTreeWidgetItem.icon (self, int column)

Returns the icon that is displayed in the specified column.

See also setIcon() and iconSize.

### int QTreeWidgetItem.indexOfChild (self, QTreeWidgetItem achild)

Returns the index of the given child in the item's list of children.

### QTreeWidgetItem.insertChild (self, int index, QTreeWidgetItem child)

The child argument has it's ownership transferred to Qt.

Inserts the child item at index in the list of children.

If the child has already been inserted somewhere else it wont be inserted again.

### QTreeWidgetItem.insertChildren (self, int index, unknown-type children)

The children argument has it's ownership transferred to Qt.

Inserts the given list of children into the list of the item children at index .

Children that have already been inserted somewhere else wont be inserted.

This function was introduced in Qt 4.1.

### bool QTreeWidgetItem.isDisabled (self)

Returns true if the item is disabled; otherwise returns false.

This function was introduced in Qt 4.3.

See also setFlags().

### bool QTreeWidgetItem.isExpanded (self)

Returns true if the item is expanded, otherwise returns false.

This function was introduced in Qt 4.2.

See also setExpanded().

### bool QTreeWidgetItem.isFirstColumnSpanned (self)

Returns true if the item is spanning all the columns in a row; otherwise returns false.

This function was introduced in Qt 4.3.

See also setFirstColumnSpanned().

### bool QTreeWidgetItem.isHidden (self)

Returns true if the item is hidden, otherwise returns false.

This function was introduced in Qt 4.2.

See also setHidden().

### bool QTreeWidgetItem.isSelected (self)

Returns true if the item is selected, otherwise returns false.

This function was introduced in Qt 4.2.

See also setSelected().

### QTreeWidgetItem QTreeWidgetItem.parent (self)

Returns the item's parent.

See also child().

### QTreeWidgetItem.read (self, QDataStream in)

Reads the item from stream in. This only reads data into a single item.

See also write().

### QTreeWidgetItem.removeChild (self, QTreeWidgetItem child)

The child argument

Removes the given item indicated by child. The removed item will not be deleted.

### QTreeWidgetItem.setBackground (self, int column, QBrush brush)

Sets the background brush of the label in the given column to the specified brush.

This function was introduced in Qt 4.2.

See also background() and setForeground().

### QTreeWidgetItem.setBackgroundColor (self, int column, QColor color)

### QTreeWidgetItem.setCheckState (self, int column, Qt.CheckState state)

Sets the item in the given column check state to be state.

See also checkState().

### QTreeWidgetItem.setChildIndicatorPolicy (self, ChildIndicatorPolicy policy)

Sets the item indicator policy. This policy decides when the tree branch expand/collapse indicator is shown. The default value is ShowForChildren.

See also childIndicatorPolicy().

### QTreeWidgetItem.setData (self, int column, int role, QVariant value)

Sets the value for the item's column and role to the given value.

The role describes the type of data specified by value, and is defined by the Qt.ItemDataRole enum.

See also data().

### QTreeWidgetItem.setDisabled (self, bool disabled)

Disables the item if disabled is true; otherwise enables the item.

This function was introduced in Qt 4.3.

See also isDisabled() and setFlags().

### QTreeWidgetItem.setExpanded (self, bool aexpand)

Expands the item if expand is true, otherwise collapses the item.

Warning: The QTreeWidgetItem must be added to the QTreeWidget before calling this function.

This function was introduced in Qt 4.2.

See also isExpanded().

### QTreeWidgetItem.setFirstColumnSpanned (self, bool aspan)

Sets the first section to span all columns if span is true; otherwise all item sections are shown.

This function was introduced in Qt 4.3.

See also isFirstColumnSpanned().

### QTreeWidgetItem.setFlags (self, Qt.ItemFlags aflags)

Sets the flags for the item to the given flags. These determine whether the item can be selected or modified. This is often used to disable an item.

See also flags().

### QTreeWidgetItem.setFont (self, int column, QFont afont)

Sets the font used to display the text in the given column to the given font.

See also font(), setText(), and setForeground().

### QTreeWidgetItem.setForeground (self, int column, QBrush brush)

Sets the foreground brush of the label in the given column to the specified brush.

This function was introduced in Qt 4.2.

See also foreground() and setBackground().

### QTreeWidgetItem.setHidden (self, bool ahide)

Hides the item if hide is true, otherwise shows the item.

This function was introduced in Qt 4.2.

See also isHidden().

### QTreeWidgetItem.setIcon (self, int column, QIcon aicon)

Sets the icon to be displayed in the given column to icon.

See also icon(), setText(), and iconSize.

### QTreeWidgetItem.setSelected (self, bool aselect)

Sets the selected state of the item to select.

This function was introduced in Qt 4.2.

See also isSelected().

### QTreeWidgetItem.setSizeHint (self, int column, QSize size)

Sets the size hint for the tree item in the given column to be size. If no size hint is set, the item delegate will compute the size hint based on the item data.

This function was introduced in Qt 4.1.

See also sizeHint().

### QTreeWidgetItem.setStatusTip (self, int column, QString astatusTip)

Sets the status tip for the given column to the given statusTip. QTreeWidget mouse tracking needs to be enabled for this feature to work.

See also statusTip(), setToolTip(), and setWhatsThis().

### QTreeWidgetItem.setText (self, int column, QString atext)

Sets the text to be displayed in the given column to the given text.

See also text(), setFont(), and setForeground().

### QTreeWidgetItem.setTextAlignment (self, int column, int alignment)

Sets the text alignment for the label in the given column to the alignment specified (see Qt.AlignmentFlag).

See also textAlignment().

### QTreeWidgetItem.setTextColor (self, int column, QColor color)

### QTreeWidgetItem.setToolTip (self, int column, QString atoolTip)

Sets the tooltip for the given column to toolTip.

See also toolTip(), setStatusTip(), and setWhatsThis().

### QTreeWidgetItem.setWhatsThis (self, int column, QString awhatsThis)

Sets the "What's This?" help for the given column to whatsThis.

See also whatsThis(), setStatusTip(), and setToolTip().

### QSize QTreeWidgetItem.sizeHint (self, int column)

Returns the size hint set for the tree item in the given column (see QSize).

This function was introduced in Qt 4.1.

See also setSizeHint().

### QTreeWidgetItem.sortChildren (self, int column, Qt.SortOrder order)

Sorts the children of the item using the given order, by the values in the given column.

Note: This function does nothing if the item is not associated with a QTreeWidget.

This function was introduced in Qt 4.2.

### QString QTreeWidgetItem.statusTip (self, int column)

Returns the status tip for the contents of the given column.

See also setStatusTip().

### QTreeWidgetItem QTreeWidgetItem.takeChild (self, int index)

The QTreeWidgetItem result

Removes the item at index and returns it, otherwise return 0.

### unknown-type QTreeWidgetItem.takeChildren (self)

The unknown-type result

Removes the list of children and returns it, otherwise returns an empty list.

This function was introduced in Qt 4.1.

### QString QTreeWidgetItem.text (self, int column)

Returns the text in the specified column.

See also setText().

### int QTreeWidgetItem.textAlignment (self, int column)

Returns the text alignment for the label in the given column (see Qt.AlignmentFlag).

See also setTextAlignment().

### QColor QTreeWidgetItem.textColor (self, int column)

### QString QTreeWidgetItem.toolTip (self, int column)

Returns the tool tip for the given column.

See also setToolTip().

### QTreeWidget QTreeWidgetItem.treeWidget (self)

Returns the tree widget that contains the item.

### int QTreeWidgetItem.type (self)

Returns the type passed to the QTreeWidgetItem constructor.

### QString QTreeWidgetItem.whatsThis (self, int column)

Returns the "What's This?" help for the contents of the given column.

See also setWhatsThis().

### QTreeWidgetItem.write (self, QDataStream out)

Writes the item to stream out. This only writes data from one single item.

See also read().

### bool QTreeWidgetItem.__ge__ (self, QTreeWidgetItem other)

### bool QTreeWidgetItem.__lt__ (self, QTreeWidgetItem other)