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

#include <qtreewidget.h>

Collaboration diagram for QTreeWidgetItem:

Public Types
enum	ItemType { Type = 0 , UserType = 1000 }
	This enum describes the types that are used to describe tree widget items. More...
enum	ChildIndicatorPolicy { ShowIndicator , DontShowIndicator , DontShowIndicatorWhenChildless }
	\value ShowIndicator The controls for expanding and collapsing will be shown for this item even if there are no children. More...

Public Member Functions
	QTreeWidgetItem (int type=Type)
	Constructs a tree widget item of the specified type.
	QTreeWidgetItem (const QStringList &strings, int type=Type)
	Constructs a tree widget item of the specified type.
	QTreeWidgetItem (QTreeWidget *treeview, int type=Type)
	Constructs a tree widget item of the specified type and appends it to the items in the given parent.
	QTreeWidgetItem (QTreeWidget *treeview, const QStringList &strings, int type=Type)
	Constructs a tree widget item of the specified type and appends it to the items in the given parent.
	QTreeWidgetItem (QTreeWidget treeview, QTreeWidgetItem after, int type=Type)
	Constructs a tree widget item of the specified type and inserts it into the given parent after the preceding item.
	QTreeWidgetItem (QTreeWidgetItem *parent, int type=Type)
	Constructs a tree widget item and append it to the given parent.
	QTreeWidgetItem (QTreeWidgetItem *parent, const QStringList &strings, int type=Type)
	Constructs a tree widget item and append it to the given parent.
	QTreeWidgetItem (QTreeWidgetItem parent, QTreeWidgetItem after, int type=Type)
	Constructs a tree widget item of the specified type that is inserted into the parent after the preceding child item.
	QTreeWidgetItem (const QTreeWidgetItem &other)
	Constructs a copy of other.
virtual	~QTreeWidgetItem ()
	Destroys this tree widget item.
virtual QTreeWidgetItem *	clone () const
	Creates a deep copy of the item and of its children.
QTreeWidget *	treeWidget () const
	Returns the tree widget that contains the item.
void	setSelected (bool select)
	Sets the selected state of the item to select.
bool	isSelected () const
	Returns `true` if the item is selected, otherwise returns `false`.
void	setHidden (bool hide)
	Hides the item if hide is true, otherwise shows the item.
bool	isHidden () const
	Returns `true` if the item is hidden, otherwise returns `false`.
void	setExpanded (bool expand)
	Expands the item if expand is true, otherwise collapses the item.
bool	isExpanded () const
	Returns `true` if the item is expanded, otherwise returns `false`.
void	setFirstColumnSpanned (bool span)
	Sets the first section to span all columns if span is true; otherwise all item sections are shown.
bool	isFirstColumnSpanned () const
	Returns `true` if the item is spanning all the columns in a row; otherwise returns `false`.
void	setDisabled (bool disabled)
	Disables the item if disabled is true; otherwise enables the item.
bool	isDisabled () const
	Returns `true` if the item is disabled; otherwise returns `false`.
void	setChildIndicatorPolicy (QTreeWidgetItem::ChildIndicatorPolicy policy)
	Sets the item indicator policy.
QTreeWidgetItem::ChildIndicatorPolicy	childIndicatorPolicy () const
	Returns the item indicator policy.
Qt::ItemFlags	flags () const
	Returns the flags used to describe the item.
void	setFlags (Qt::ItemFlags flags)
	Sets the flags for the item to the given flags.
QString	text (int column) const
	Returns the text in the specified column.
void	setText (int column, const QString &text)
	Sets the text to be displayed in the given column to the given text.
QIcon	icon (int column) const
	Returns the icon that is displayed in the specified column.
void	setIcon (int column, const QIcon &icon)
	Sets the icon to be displayed in the given column to icon.
QString	statusTip (int column) const
	Returns the status tip for the contents of the given column.
void	setStatusTip (int column, const QString &statusTip)
	Sets the status tip for the given column to the given statusTip.
QFont	font (int column) const
	Returns the font used to render the text in the specified column.
void	setFont (int column, const QFont &font)
	Sets the font used to display the text in the given column to the given font.
Qt::Alignment	textAlignment (int column) const
void	setTextAlignment (int column, Qt::Alignment alignment)
	\obsolete [6.4] Use the overload that takes a Qt::Alignment argument.
QBrush	background (int column) const
	Returns the brush used to render the background of the specified column.
void	setBackground (int column, const QBrush &brush)
	Sets the background brush of the label in the given column to the specified brush.
QBrush	foreground (int column) const
	Returns the brush used to render the foreground (e.g.
void	setForeground (int column, const QBrush &brush)
	Sets the foreground brush of the label in the given column to the specified brush.
Qt::CheckState	checkState (int column) const
	Returns the check state of the label in the given column.
void	setCheckState (int column, Qt::CheckState state)
	Sets the item in the given column check state to be state.
QSize	sizeHint (int column) const
	Returns the size hint set for the tree item in the given column (see \l{QSize}).
void	setSizeHint (int column, const QSize &size)
	Sets the size hint for the tree item in the given column to be size.
virtual QVariant	data (int column, int role) const
	Returns the value for the item's column and role.
virtual void	setData (int column, int role, const QVariant &value)
	Sets the value for the item's column and role to the given value.
virtual bool	operator< (const QTreeWidgetItem &other) const
	Returns `true` if the text in the item is less than the text in the other item, otherwise returns `false`.
virtual void	read (QDataStream &in)
	Reads the item from stream in.
virtual void	write (QDataStream &out) const
	Writes the item to stream out.
QTreeWidgetItem &	operator= (const QTreeWidgetItem &other)
	Assigns other's data and flags to this item.
QTreeWidgetItem *	parent () const
	Returns the item's parent.
QTreeWidgetItem *	child (int index) const
	Returns the item at the given index in the list of the item's children.
int	childCount () const
	Returns the number of child items.
int	columnCount () const
	Returns the number of columns in the item.
int	indexOfChild (QTreeWidgetItem *child) const
	Returns the index of the given child in the item's list of children.
void	addChild (QTreeWidgetItem *child)
	Appends the child item to the list of children.
void	insertChild (int index, QTreeWidgetItem *child)
	Inserts the child item at index in the list of children.
void	removeChild (QTreeWidgetItem *child)
	Removes the given item indicated by child.
QTreeWidgetItem *	takeChild (int index)
	Removes the item at index and returns it, otherwise return 0.
void	addChildren (const QList< QTreeWidgetItem * > &children)
	Appends the given list of children to the item.
void	insertChildren (int index, const QList< QTreeWidgetItem * > &children)
	Inserts the given list of children into the list of the item children at index .
QList< QTreeWidgetItem * >	takeChildren ()
	Removes the list of children and returns it, otherwise returns an empty list.
int	type () const
	Returns the type passed to the QTreeWidgetItem constructor.
void	sortChildren (int column, Qt::SortOrder order)
	Sorts the children of the item using the given order, by the values in the given column.

Protected Member Functions
void	emitDataChanged ()
	Causes the model associated with this item to emit a \l{QAbstractItemModel::dataChanged()}{dataChanged}() signal for this item.

Friends
class	QTreeModel
class	QTreeWidget
class	QTreeWidgetPrivate
class	QTreeWidgetItemIterator
class	QTreeWidgetItemPrivate

Related Symbols
(Note that these are not member symbols.)
QDataStream &	operator<< (QDataStream &out, const QTreeWidgetItem &item)
	Writes the tree widget item item to stream out.
QDataStream &	operator>> (QDataStream &in, QTreeWidgetItem &item)
	Reads a tree widget item from stream in into item.

Detailed Description

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

\inmodule QtWidgets

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 \l{Qt::ItemFlags}). Checkable items can be checked and unchecked with the setCheckState() function. The corresponding checkState() function indicates whether the item is currently checked.

Definition at line 23 of file qtreewidget.h.

Member Enumeration Documentation

◆ ChildIndicatorPolicy

enum QTreeWidgetItem::ChildIndicatorPolicy

\value ShowIndicator The controls for expanding and collapsing will be shown for this item even if there are no children.

\value DontShowIndicator 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. \value DontShowIndicatorWhenChildless The controls for expanding and collapsing will be shown if the item contains children.

Enumerator
ShowIndicator
DontShowIndicator
DontShowIndicatorWhenChildless

Definition at line 62 of file qtreewidget.h.

◆ ItemType

enum QTreeWidgetItem::ItemType

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

\value Type The default type for tree widget items. \value UserType 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()

Enumerator
Type
UserType

Definition at line 31 of file qtreewidget.h.

Constructor & Destructor Documentation

◆ QTreeWidgetItem() [1/9]

QTreeWidgetItem::QTreeWidgetItem ( int type = Type )

explicit

Constructs a tree widget item of the specified type.

The item must be inserted into a tree widget.

See also: type()

Definition at line 1379 of file qtreewidget.cpp.

◆ QTreeWidgetItem() [2/9]

QTreeWidgetItem::QTreeWidgetItem	(	const QStringList &	strings,
		int	type = Type )

explicit

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()

Definition at line 1389 of file qtreewidget.cpp.

◆ QTreeWidgetItem() [3/9]

QTreeWidgetItem::QTreeWidgetItem	(	QTreeWidget *	parent,
		int	type = Type )

explicit

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

See also: type()

Definition at line 1405 of file qtreewidget.cpp.

◆ QTreeWidgetItem() [4/9]

QTreeWidgetItem::QTreeWidgetItem	(	QTreeWidget *	parent,
		const QStringList &	strings,
		int	type = Type )

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()

Definition at line 1425 of file qtreewidget.cpp.

◆ QTreeWidgetItem() [5/9]

QTreeWidgetItem::QTreeWidgetItem	(	QTreeWidget *	parent,
		QTreeWidgetItem *	preceding,
		int	type = Type )

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

See also: type()

Definition at line 1445 of file qtreewidget.cpp.

◆ QTreeWidgetItem() [6/9]

QTreeWidgetItem::QTreeWidgetItem	(	QTreeWidgetItem *	parent,
		int	type = Type )

explicit

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

See also: type()

Definition at line 1461 of file qtreewidget.cpp.

◆ QTreeWidgetItem() [7/9]

QTreeWidgetItem::QTreeWidgetItem	(	QTreeWidgetItem *	parent,
		const QStringList &	strings,
		int	type = Type )

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()

Definition at line 1474 of file qtreewidget.cpp.

◆ QTreeWidgetItem() [8/9]

QTreeWidgetItem::QTreeWidgetItem	(	QTreeWidgetItem *	parent,
		QTreeWidgetItem *	preceding,
		int	type = Type )

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

See also: type()

Definition at line 1491 of file qtreewidget.cpp.

◆ QTreeWidgetItem() [9/9]

QTreeWidgetItem::QTreeWidgetItem ( const QTreeWidgetItem & other )

Constructs a copy of other.

Note that type() and treeWidget() are not copied.

This function is useful when reimplementing clone().

See also: data(), flags()

Definition at line 1899 of file qtreewidget.cpp.

◆ ~QTreeWidgetItem()

QTreeWidgetItem::~QTreeWidgetItem ( )

virtual

Destroys this tree widget item.

The item will be removed from \l{QTreeWidget}s to which it has been added. This makes it safe to delete an item at any time.

Definition at line 1508 of file qtreewidget.cpp.

Member Function Documentation

◆ addChild()

void QTreeWidgetItem::addChild ( QTreeWidgetItem * child )

Appends the child item to the list of children.

See also: insertChild(), takeChild()

Definition at line 1930 of file qtreewidget.cpp.

◆ addChildren()

void QTreeWidgetItem::addChildren ( const QList< QTreeWidgetItem * > & children )

Appends the given list of children to the item.

See also: insertChildren(), takeChildren()

Definition at line 2031 of file qtreewidget.cpp.

◆ background()

QBrush QTreeWidgetItem::background ( int column ) const

inline

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

See also: foreground()

Definition at line 114 of file qtreewidget.h.

◆ checkState()

Qt::CheckState QTreeWidgetItem::checkState ( int column ) const

inline

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

See also: Qt::CheckState

Definition at line 124 of file qtreewidget.h.

◆ child()

QTreeWidgetItem * QTreeWidgetItem::child ( int index ) const

inline

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

See also: parent()

Definition at line 146 of file qtreewidget.h.

◆ childCount()

int QTreeWidgetItem::childCount ( ) const

inline

Returns the number of child items.

Definition at line 152 of file qtreewidget.h.

◆ childIndicatorPolicy()

QTreeWidgetItem::ChildIndicatorPolicy QTreeWidgetItem::childIndicatorPolicy ( ) const

Returns the item indicator policy.

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

See also: setChildIndicatorPolicy()

Definition at line 1617 of file qtreewidget.cpp.

◆ clone()

QTreeWidgetItem * QTreeWidgetItem::clone ( ) const

virtual

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

Definition at line 1556 of file qtreewidget.cpp.

◆ columnCount()

int QTreeWidgetItem::columnCount ( ) const

inline

Returns the number of columns in the item.

Definition at line 153 of file qtreewidget.h.

◆ data()

QVariant QTreeWidgetItem::data	(	int	column,
		int	role ) const

virtual

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

Definition at line 1814 of file qtreewidget.cpp.

◆ emitDataChanged()

void QTreeWidgetItem::emitDataChanged ( )

protected

Causes the model associated with this item to emit a \l{QAbstractItemModel::dataChanged()}{dataChanged}() signal for this item.

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

See also: setData()

Definition at line 2219 of file qtreewidget.cpp.

◆ flags()

Qt::ItemFlags QTreeWidgetItem::flags ( ) const

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 | Qt::ItemIsDropEnabled.

See also: setFlags()

Definition at line 1721 of file qtreewidget.cpp.

◆ font()

QFont QTreeWidgetItem::font ( int column ) const

inline

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

See also: setFont()

Definition at line 93 of file qtreewidget.h.

◆ foreground()

QBrush QTreeWidgetItem::foreground ( int column ) const

inline

Returns the brush used to render the foreground (e.g.

text) of the specified column. Setting a default-constructed brush will let the view use the default color from the style.

See also: background()

Definition at line 119 of file qtreewidget.h.

◆ icon()

QIcon QTreeWidgetItem::icon ( int column ) const

inline

Returns the icon that is displayed in the specified column.

See also: setIcon(), {QAbstractItemView::iconSize}{iconSize}

Definition at line 73 of file qtreewidget.h.

◆ indexOfChild()

int QTreeWidgetItem::indexOfChild ( QTreeWidgetItem * child ) const

inline

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

Definition at line 216 of file qtreewidget.h.

◆ insertChild()

void QTreeWidgetItem::insertChild	(	int	index,
		QTreeWidgetItem *	child )

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

If the child has already been inserted somewhere else it won't be inserted again.

Definition at line 1943 of file qtreewidget.cpp.

◆ insertChildren()

void QTreeWidgetItem::insertChildren	(	int	index,
		const QList< QTreeWidgetItem * > &	children )

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

Children that have already been inserted somewhere else won't be inserted.

Definition at line 2041 of file qtreewidget.cpp.

◆ isDisabled()

bool QTreeWidgetItem::isDisabled ( ) const

inline

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

See also: setFlags()

Definition at line 349 of file qtreewidget.h.

◆ isExpanded()

bool QTreeWidgetItem::isExpanded ( ) const

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

See also: setExpanded()

Definition at line 1079 of file qtreewidget.cpp.

◆ isFirstColumnSpanned()

bool QTreeWidgetItem::isFirstColumnSpanned ( ) const

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

See also: setFirstColumnSpanned()

Definition at line 1112 of file qtreewidget.cpp.

◆ isHidden()

bool QTreeWidgetItem::isHidden ( ) const

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

See also: setHidden()

Definition at line 1042 of file qtreewidget.cpp.

◆ isSelected()

bool QTreeWidgetItem::isSelected ( ) const

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

See also: setSelected()

Definition at line 1004 of file qtreewidget.cpp.

◆ operator<()

bool QTreeWidgetItem::operator< ( const QTreeWidgetItem & other ) const

virtual

Returns true if the text in the item is less than the text in the other item, otherwise returns false.

Definition at line 1844 of file qtreewidget.cpp.

◆ operator=()

QTreeWidgetItem & QTreeWidgetItem::operator= ( const QTreeWidgetItem & other )

Assigns other's data and flags to this item.

Note that type() and treeWidget() are not copied.

This function is useful when reimplementing clone().

See also: data(), flags()

Definition at line 1916 of file qtreewidget.cpp.

◆ parent()

QTreeWidgetItem * QTreeWidgetItem::parent ( ) const

inline

Returns the item's parent.

See also: child()

Definition at line 145 of file qtreewidget.h.

◆ read()

void QTreeWidgetItem::read ( QDataStream & in )

virtual

Reads the item from stream in.

This only reads data into a single item.

See also: write()

Definition at line 1859 of file qtreewidget.cpp.

◆ removeChild()

void QTreeWidgetItem::removeChild ( QTreeWidgetItem * child )

Removes the given item indicated by child.

The removed item will not be deleted.

Definition at line 1985 of file qtreewidget.cpp.

◆ setBackground()

void QTreeWidgetItem::setBackground	(	int	column,
		const QBrush &	brush )

inline

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

Setting a default-constructed brush will let the view use the default color from the style.

Note: If \l{Qt Style Sheets} are used on the same widget as setBackground(), style sheets will take precedence if the settings conflict.

See also: setForeground()

Definition at line 116 of file qtreewidget.h.

◆ setCheckState()

void QTreeWidgetItem::setCheckState	(	int	column,
		Qt::CheckState	state )

inline

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

See also: checkState()

Definition at line 126 of file qtreewidget.h.

◆ setChildIndicatorPolicy()

void QTreeWidgetItem::setChildIndicatorPolicy ( QTreeWidgetItem::ChildIndicatorPolicy policy )

Sets the item indicator policy.

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

See also: childIndicatorPolicy()

Definition at line 1599 of file qtreewidget.cpp.

◆ setData()

void QTreeWidgetItem::setData	(	int	column,
		int	role,
		const QVariant &	value )

virtual

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.

Note: The default implementation treats Qt::EditRole and Qt::DisplayRole as referring to the same data.

Definition at line 1736 of file qtreewidget.cpp.

◆ setDisabled()

void QTreeWidgetItem::setDisabled ( bool disabled )

inline

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

See also: setFlags()

Definition at line 346 of file qtreewidget.h.

◆ setExpanded()

void QTreeWidgetItem::setExpanded ( bool expand )

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

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

See also: isExpanded()

Definition at line 1063 of file qtreewidget.cpp.

◆ setFirstColumnSpanned()

void QTreeWidgetItem::setFirstColumnSpanned ( bool span )

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

See also: isFirstColumnSpanned()

Definition at line 1096 of file qtreewidget.cpp.

◆ setFlags()

void QTreeWidgetItem::setFlags ( Qt::ItemFlags flags )

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()

Definition at line 1630 of file qtreewidget.cpp.

◆ setFont()

void QTreeWidgetItem::setFont	(	int	column,
		const QFont &	font )

inline

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

See also: font(), setText(), setForeground()

Definition at line 213 of file qtreewidget.h.

◆ setForeground()

void QTreeWidgetItem::setForeground	(	int	column,
		const QBrush &	brush )

inline

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

See also: setBackground()

Definition at line 121 of file qtreewidget.h.

◆ setHidden()

void QTreeWidgetItem::setHidden ( bool hide )

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

Note: A call to this function has no effect if the item is not currently in a view. In particular, calling setHidden(true) on an item and only then adding it to a view will result in a visible item.

See also: isHidden()

Definition at line 1020 of file qtreewidget.cpp.

◆ setIcon()

void QTreeWidgetItem::setIcon	(	int	column,
		const QIcon &	icon )

inline

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

See also: icon(), setText(), {QAbstractItemView::iconSize}{iconSize}

Definition at line 195 of file qtreewidget.h.

◆ setSelected()

void QTreeWidgetItem::setSelected ( bool select )

Sets the selected state of the item to select.

See also: isSelected()

Definition at line 985 of file qtreewidget.cpp.

◆ setSizeHint()

void QTreeWidgetItem::setSizeHint	(	int	column,
		const QSize &	size )

inline

Sets the size hint for the tree item in the given column to be size.

If no size hint is set or size is invalid, the item delegate will compute the size hint based on the item data.

Definition at line 131 of file qtreewidget.h.

◆ setStatusTip()

void QTreeWidgetItem::setStatusTip	(	int	column,
		const QString &	statusTip )

inline

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(), setWhatsThis()

◆ setText()

void QTreeWidgetItem::setText	(	int	column,
		const QString &	text )

inline

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

See also: text(), setFont(), setForeground()

Definition at line 192 of file qtreewidget.h.

◆ setTextAlignment()

void QTreeWidgetItem::setTextAlignment	(	int	column,
		Qt::Alignment	alignment )

inline

\obsolete [6.4] Use the overload that takes a Qt::Alignment argument.

Sets the text alignment for the label in the given column to the alignment specified.

See also: Qt::Alignment

Since: 6.4

Sets the text alignment for the label in the given column to the alignment specified.

Definition at line 111 of file qtreewidget.h.

◆ sizeHint()

QSize QTreeWidgetItem::sizeHint ( int column ) const

inline

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

Definition at line 129 of file qtreewidget.h.

◆ sortChildren()

void QTreeWidgetItem::sortChildren	(	int	column,
		Qt::SortOrder	order )

inline

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.

Definition at line 166 of file qtreewidget.h.

◆ statusTip()

QString QTreeWidgetItem::statusTip ( int column ) const

inline

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

See also: setStatusTip()

Definition at line 77 of file qtreewidget.h.

◆ takeChild()

QTreeWidgetItem * QTreeWidgetItem::takeChild ( int index )

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

Definition at line 1993 of file qtreewidget.cpp.

◆ takeChildren()

QList< QTreeWidgetItem * > QTreeWidgetItem::takeChildren ( )

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

Definition at line 2092 of file qtreewidget.cpp.

◆ text()

QString QTreeWidgetItem::text ( int column ) const

inline

Returns the text in the specified column.

See also: setText()

Definition at line 69 of file qtreewidget.h.

◆ textAlignment()

Qt::Alignment QTreeWidgetItem::textAlignment ( int column ) const

inline

Returns the text alignment for the label in the given column.

Note: This function returns an int for historical reasons. It will be corrected to return Qt::Alignment in Qt 7.

See also: Qt::Alignment

Definition at line 101 of file qtreewidget.h.

◆ treeWidget()

QTreeWidget * QTreeWidgetItem::treeWidget ( ) const

inline

Returns the tree widget that contains the item.

Definition at line 45 of file qtreewidget.h.

◆ type()

int QTreeWidgetItem::type ( ) const

inline

Returns the type passed to the QTreeWidgetItem constructor.

Definition at line 165 of file qtreewidget.h.

◆ write()

void QTreeWidgetItem::write ( QDataStream & out ) const

virtual

Writes the item to stream out.

This only writes data from one single item.

See also: read()

Definition at line 1885 of file qtreewidget.cpp.

◆ operator<<()

QDataStream & operator<<	(	QDataStream &	out,
		const QTreeWidgetItem &	item )

Writes the tree widget item item to stream out.

This operator uses QTreeWidgetItem::write().

See also: {Serializing Qt Data Types}

Definition at line 2264 of file qtreewidget.cpp.

◆ operator>>()

QDataStream & operator>>	(	QDataStream &	in,
		QTreeWidgetItem &	item )

Reads a tree widget item from stream in into item.

This operator uses QTreeWidgetItem::read().

See also: {Serializing Qt Data Types}

Definition at line 2279 of file qtreewidget.cpp.

◆ QTreeModel

friend class QTreeModel

friend

Definition at line 25 of file qtreewidget.h.

◆ QTreeWidget

friend class QTreeWidget

friend

Definition at line 26 of file qtreewidget.h.

◆ QTreeWidgetItemIterator

friend class QTreeWidgetItemIterator

friend

Definition at line 28 of file qtreewidget.h.

◆ QTreeWidgetItemPrivate

friend class QTreeWidgetItemPrivate

friend

Definition at line 29 of file qtreewidget.h.

◆ QTreeWidgetPrivate

friend class QTreeWidgetPrivate

friend

Definition at line 27 of file qtreewidget.h.

The documentation for this class was generated from the following files:

qtbase/src/widgets/itemviews/qtreewidget.h (824c333aac9265fe457658d77c36b6f600fcf8e5)
qtbase/src/widgets/itemviews/qtreewidget.cpp (87806f5cad6e4ce75a899598c15c126995682562)

Public Types

Public Member Functions

Protected Member Functions

Friends

Related Symbols

Detailed Description

Member Enumeration Documentation

◆ ChildIndicatorPolicy

◆ ItemType

Constructor & Destructor Documentation

◆ QTreeWidgetItem() [1/9]

◆ QTreeWidgetItem() [2/9]

◆ QTreeWidgetItem() [3/9]

◆ QTreeWidgetItem() [4/9]

◆ QTreeWidgetItem() [5/9]

◆ QTreeWidgetItem() [6/9]

◆ QTreeWidgetItem() [7/9]

◆ QTreeWidgetItem() [8/9]

◆ QTreeWidgetItem() [9/9]

◆ ~QTreeWidgetItem()

Member Function Documentation

◆ addChild()

◆ addChildren()

◆ background()

◆ checkState()

◆ child()

◆ childCount()

◆ childIndicatorPolicy()

◆ clone()

◆ columnCount()

◆ data()

◆ emitDataChanged()

◆ flags()

◆ font()

◆ foreground()

◆ icon()

◆ indexOfChild()

◆ insertChild()

◆ insertChildren()

◆ isDisabled()

◆ isExpanded()

◆ isFirstColumnSpanned()

◆ isHidden()

◆ isSelected()

◆ operator<()

◆ operator=()

◆ parent()

◆ read()

◆ removeChild()

◆ setBackground()

◆ setCheckState()

◆ setChildIndicatorPolicy()

◆ setData()

◆ setDisabled()

◆ setExpanded()

◆ setFirstColumnSpanned()

◆ setFlags()

◆ setFont()

◆ setForeground()

◆ setHidden()

◆ setIcon()

◆ setSelected()

◆ setSizeHint()

◆ setStatusTip()

◆ setText()

◆ setTextAlignment()

◆ sizeHint()

◆ sortChildren()

◆ statusTip()

◆ takeChild()

◆ takeChildren()

◆ text()

◆ textAlignment()

◆ treeWidget()

◆ type()

◆ write()

Friends And Related Symbol Documentation

◆ operator<<()

◆ operator>>()

◆ QTreeModel