QTreeWidgetItem 類

QTreeWidgetItem 類提供項為用於 QTreeWidget 方便類。 更多...

頭：	#include <QTreeWidgetItem>
CMake:	find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake:	QT += widgets

• 所有成員列錶，包括繼承成員
• Deprecated members

公共類型

enum	ChildIndicatorPolicy { ShowIndicator, DontShowIndicator, DontShowIndicatorWhenChildless }
enum	ItemType { Type, UserType }

公共函數

	QTreeWidgetItem (int type = Type)
	QTreeWidgetItem (const QStringList & strings , int type = Type)
	QTreeWidgetItem (QTreeWidget * parent , int type = Type)
	QTreeWidgetItem (QTreeWidget * parent , const QStringList & strings , int type = Type)
	QTreeWidgetItem (QTreeWidget * parent , QTreeWidgetItem * preceding , int type = Type)
	QTreeWidgetItem (QTreeWidgetItem * parent , int type = Type)
	QTreeWidgetItem (QTreeWidgetItem * parent , const QStringList & strings , int type = Type)
	QTreeWidgetItem (QTreeWidgetItem * parent , QTreeWidgetItem * preceding , int type = Type)
	QTreeWidgetItem (const QTreeWidgetItem & other )
virtual	~QTreeWidgetItem ()
void	addChild (QTreeWidgetItem * child )
void	addChildren (const QList<QTreeWidgetItem *> & children )
QBrush	background (int column ) const
Qt::CheckState	checkState (int column ) const
QTreeWidgetItem *	child (int index ) const
int	childCount () const
QTreeWidgetItem::ChildIndicatorPolicy	childIndicatorPolicy () const
virtual QTreeWidgetItem *	clone () const
int	columnCount () const
virtual QVariant	data (int column , int role ) const
Qt::ItemFlags	flags () const
QFont	font (int column ) const
QBrush	foreground (int column ) const
QIcon	icon (int column ) const
int	indexOfChild (QTreeWidgetItem * child ) const
void	insertChild (int index , QTreeWidgetItem * child )
void	insertChildren (int index , const QList<QTreeWidgetItem *> & children )
bool	isDisabled () const
bool	isExpanded () const
bool	isFirstColumnSpanned () const
bool	isHidden () const
bool	isSelected () const
QTreeWidgetItem *	parent () const
virtual void	read (QDataStream & in )
void	removeChild (QTreeWidgetItem * child )
void	setBackground (int column , const QBrush & brush )
void	setCheckState (int column , Qt::CheckState state )
void	setChildIndicatorPolicy (QTreeWidgetItem::ChildIndicatorPolicy policy )
virtual void	setData (int column , int role , const QVariant & value )
void	setDisabled (bool disabled )
void	setExpanded (bool expand )
void	setFirstColumnSpanned (bool span )
void	setFlags (Qt::ItemFlags flags )
void	setFont (int column , const QFont & font )
void	setForeground (int column , const QBrush & brush )
void	setHidden (bool hide )
void	setIcon (int column , const QIcon & icon )
void	setSelected (bool select )
void	setSizeHint (int column , const QSize & size )
void	setStatusTip (int column , const QString & statusTip )
void	setText (int column , const QString & text )
void	setTextAlignment (int column , Qt::Alignment alignment )
void	setToolTip (int column , const QString & toolTip )
void	setWhatsThis (int column , const QString & whatsThis )
QSize	sizeHint (int column ) const
void	sortChildren (int column , Qt::SortOrder order )
QString	statusTip (int column ) const
QTreeWidgetItem *	takeChild (int index )
QList<QTreeWidgetItem *>	takeChildren ()
QString	text (int column ) const
int	textAlignment (int column ) const
QString	toolTip (int column ) const
QTreeWidget *	treeWidget () const
int	type () const
QString	whatsThis (int column ) const
virtual void	write (QDataStream & out ) const
virtual bool	operator< (const QTreeWidgetItem & other ) const
QTreeWidgetItem &	operator= (const QTreeWidgetItem & other )

保護函數

void	emitDataChanged ()

相關非成員

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

詳細描述

樹 Widget 項用於保持樹小部件的信息行。行通常包含幾列數據，每列數據可以包含文本標簽和圖標。

QTreeWidgetItem 類是替換 Qt 3 的 QListViewItem 類的方便類。它提供的項用於 QTreeWidget 類。

項構造通常采用的父級要麼是 QTreeWidget (對於頂層項) 要麼是 QTreeWidgetItem (對於較低級樹項)。例如，以下代碼構造頂級項來錶示世界城市，並添加 Oslo 條目作為子級項：

    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 () 函數指示項目前是否被復選。

子類化

當子類化 QTreeWidgetItem 以提供自定義項時，為它們定義新類型以便區分它們與標準項是可能的。需要此特徵的子類構造函數要求調用基類構造函數，采用新類型值 >= UserType .

另請參閱 QTreeWidget , QTreeWidgetItemIterator , 模型/視圖編程 , QListWidgetItem ，和 QTableWidgetItem .

成員類型文檔編製

enum QTreeWidgetItem:: ChildIndicatorPolicy

常量	值	描述
QTreeWidgetItem::ShowIndicator	0	將展示此項的展開和摺疊控件，即使沒有子級。
QTreeWidgetItem::DontShowIndicator	1	從不展示用於展開和摺疊的控件，即使有子級。若節點被強製打開，用戶將無法展開或摺疊項。
QTreeWidgetItem::DontShowIndicatorWhenChildless	2	將展示用於展開和摺疊的控件，若項包含子級。

enum QTreeWidgetItem:: ItemType

此枚舉描述用於描述樹 Widget 項的類型。

常量	值	描述
QTreeWidgetItem::Type	0	用於樹 Widget 項的默認類型。
QTreeWidgetItem::UserType	1000	用於自定義類型的最小值。低於 UserType 的值由 Qt 預留。

可以定義新用戶類型在 QTreeWidgetItem 子類以確保自定義項得到特殊處理；例如，當排序項時。

另請參閱 type ().

成員函數文檔編製

[explicit] QTreeWidgetItem:: QTreeWidgetItem ( int type = Type)

構造樹 Widget 項采用指定 type 。項必須被插入樹 Widget。

另請參閱 type ().

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

構造樹 Widget 項采用指定 type 。項必須被插入樹小部件。給定列錶的 strings 將被設置作為項中每列的項文本。

另請參閱 type ().

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

構造樹 Widget 項采用指定 type 並將其追加到項在給定 parent .

另請參閱 type ().

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

構造樹 Widget 項采用指定 type 並將其追加到項在給定 parent 。給定列錶 strings 將被設置作為項中每列的項文本。

另請參閱 type ().

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

構造樹 Widget 項采用指定 type 並將其插入給定 parent 後於 preceding 項。

另請參閱 type ().

[explicit] QTreeWidgetItem:: QTreeWidgetItem ( QTreeWidgetItem * parent , int type = Type)

構造樹 Widget 項並將其追加到給定 parent .

另請參閱 type ().

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

構造樹 Widget 項並將其追加到給定 parent 。給定列錶 strings 將被設置作為項中每列的項文本。

另請參閱 type ().

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

構造樹 Widget 項采用指定 type 其被插入 parent 後於 preceding 子級項。

另請參閱 type ().

QTreeWidgetItem:: QTreeWidgetItem (const QTreeWidgetItem & other )

構造副本為 other 。注意， type () 和 treeWidget () 不拷貝。

此函數是有用的，當重實現 clone ().

另請參閱 data () 和 flags ().

[虛擬] QTreeWidgetItem:: ~QTreeWidgetItem ()

銷毀此樹 Widget 項。

項將被移除從 QTreeWidget 若它已被添加。這使之可安全地隨時刪除項。

void QTreeWidgetItem:: addChild ( QTreeWidgetItem * child )

追加 child 項到子級列錶。

另請參閱 insertChild () 和 takeChild ().

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

追加給定列錶 children 到項。

另請參閱 insertChildren () 和 takeChildren ().

QBrush QTreeWidgetItem:: background ( int column ) const

返迴用於渲染背景的筆刷為指定 column .

另請參閱 setBackground () 和 foreground ().

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

返迴標簽的校驗狀態在給定 column .

另請參閱 setCheckState () 和 Qt::CheckState .

QTreeWidgetItem *QTreeWidgetItem:: child ( int index ) const

返迴項位於給定 index 在項的子級列錶中。

另請參閱 parent ().

int QTreeWidgetItem:: childCount () const

返迴子級項數。

QTreeWidgetItem::ChildIndicatorPolicy QTreeWidgetItem:: childIndicatorPolicy () const

返迴項指示符策略。此策略決定何時展示樹分支展開/摺疊指示符。

另請參閱 setChildIndicatorPolicy ().

[虛擬] QTreeWidgetItem *QTreeWidgetItem:: clone () const

創建項及其子級的深拷貝。

int QTreeWidgetItem:: columnCount () const

返迴項中的列數。

[虛擬] QVariant QTreeWidgetItem:: data ( int column , int role ) const

返迴值對於項的 column and role .

另請參閱 setData ().

[protected] void QTreeWidgetItem:: emitDataChanged ()

促使關聯此項的模型發射 dataChanged () 信號對於此項。

通常隻需調用此函數若有子類化 QTreeWidgetItem 並重實現 data () 和/或 setData ().

另請參閱 setData ().

Qt::ItemFlags QTreeWidgetItem:: flags () const

返迴用於描述項的標誌。這些確定項是否可以被復選、編輯及選擇。

標誌的默認值為 Qt::ItemIsSelectable | Qt::ItemIsUserCheckable | Qt::ItemIsEnabled | Qt::ItemIsDragEnabled | Qt::ItemIsDropEnabled .

另請參閱 setFlags ().

QFont QTreeWidgetItem:: font ( int column ) const

返迴用於渲染文本的字體在指定 column .

另請參閱 setFont ().

QBrush QTreeWidgetItem:: foreground ( int column ) const

返迴用於渲染前景 (如：文本) 的筆刷為指定 column 。設置默認構造的筆刷將使視圖使用來自樣式的默認顔色。

另請參閱 setForeground () 和 background ().

QIcon QTreeWidgetItem:: icon ( int column ) const

返迴的圖標顯示在指定 column .

另請參閱 setIcon () 和 iconSize .

int QTreeWidgetItem:: indexOfChild ( QTreeWidgetItem * child ) const

返迴索引為給定 child 在項的子級列錶中。

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

插入 child 項在 index 在子級列錶。

不會再次插入子級，若已插入在某些地方。

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

插入給定列錶為 children 進項子級列錶在 index .

已插入其它地方的子級不會被插入。

bool QTreeWidgetItem:: isDisabled () const

返迴 true 若項被禁用；否則返迴 false .

另請參閱 setFlags ().

bool QTreeWidgetItem:: isExpanded () const

返迴 true 若項被展開，否則返迴 false .

另請參閱 setExpanded ().

bool QTreeWidgetItem:: isFirstColumnSpanned () const

返迴 true 若項跨行中所有列；否則返迴 false .

另請參閱 setFirstColumnSpanned ().

bool QTreeWidgetItem:: isHidden () const

返迴 true 若項被隱藏，否則返迴 false .

另請參閱 setHidden ().

bool QTreeWidgetItem:: isSelected () const

返迴 true 若項被選中，否則返迴 false .

另請參閱 setSelected ().

QTreeWidgetItem *QTreeWidgetItem:: parent () const

返迴項的父級。

另請參閱 child ().

[虛擬] void QTreeWidgetItem:: read ( QDataStream & in )

讀取項從流 in 。這隻將數據讀取到單項。

另請參閱 write ().

void QTreeWidgetItem:: removeChild ( QTreeWidgetItem * child )

刪除給定項指示通過 child 。移除項不會被刪除。

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

設置標簽背景筆刷在給定 column 到指定 brush 。設置默認構造的筆刷將使視圖使用來自樣式的默認顔色。

注意： 若 Qt 樣式錶 用於如 setBackground() 的相同 Widget，樣式錶優先若設置衝突。

另請參閱 background () 和 setForeground ().

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

設置項在給定 column 復選狀態為 state .

另請參閱 checkState ().

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

設置項指示器 policy 。此策略決定何時展示樹分支展開/摺疊指示符。默認值為 DontShowIndicatorWhenChildless .

另請參閱 childIndicatorPolicy ().

[虛擬] void QTreeWidgetItem:: setData ( int column , int role , const QVariant & value )

設置值對於項的 column and role 到給定 value .

The role 描述數據類型指定通過 value ，和定義通過 Qt::ItemDataRole 枚舉。

注意： 默認實現視 Qt::EditRole and Qt::DisplayRole 為引用相同數據。

另請參閱 data ().

void QTreeWidgetItem:: setDisabled ( bool disabled )

禁用項若 disabled 為 true；否則啓用項。

另請參閱 isDisabled () 和 setFlags ().

void QTreeWidgetItem:: setExpanded ( bool expand )

展開項若 expand 為 true，否則摺疊項。

警告： The QTreeWidgetItem 必須被添加到 QTreeWidget 在調用此函數之前。

另請參閱 isExpanded ().

void QTreeWidgetItem:: setFirstColumnSpanned ( bool span )

把第 1 區間設為跨所有列若 span 為 true；否則展示所有項區間。

另請參閱 isFirstColumnSpanned ().

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

將項的標誌設為給定 flags 。這些確定是否可以選擇或修改項。這經常用於禁用項。

另請參閱 flags ().

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

設置用於顯示文本的字體在給定 column 到給定 font .

另請參閱 font (), setText ()，和 setForeground ().

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

設置標簽的前景筆刷在給定 column 到指定 brush .

另請參閱 foreground () 和 setBackground ().

void QTreeWidgetItem:: setHidden ( bool hide )

隱藏項若 hide 為 True，否則展示項。

注意： 調用此函數不起作用，若項目前不在視圖中。尤其，調用 setHidden(true) 在項，然後纔將它添加到視圖會導緻項可見。

另請參閱 isHidden ().

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

設置要顯示的圖標在給定 column to icon .

另請參閱 icon (), setText ()，和 iconSize .

void QTreeWidgetItem:: setSelected ( bool select )

將項的選定狀態設為 select .

另請參閱 isSelected ().

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

設置樹項大小提示在給定 column 到 size 。若未設置大小提示或 size 無效，項委托將基於項數據計算大小提示。

另請參閱 sizeHint ().

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

設置狀態提示為給定 column 到給定 statusTip . QTreeWidget 需要啓用鼠標追蹤，為使此特徵能工作。

另請參閱 statusTip (), setToolTip ()，和 setWhatsThis ().

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

設置要顯示的文本在給定 column 到給定 text .

另請參閱 text (), setFont ()，和 setForeground ().

[since 6.4] void QTreeWidgetItem:: setTextAlignment ( int column , Qt::Alignment alignment )

設置標簽的文本對齊方式在給定 column 到 alignment 指定。

This function was introduced in Qt 6.4.

void QTreeWidgetItem:: setToolTip ( int column , const QString & toolTip )

設置工具提示為給定 column to toolTip .

另請參閱 toolTip (), setStatusTip ()，和 setWhatsThis ().

void QTreeWidgetItem:: setWhatsThis ( int column , const QString & whatsThis )

設置 What's This? 幫助為給定 column to whatsThis .

另請參閱 whatsThis (), setStatusTip ()，和 setToolTip ().

QSize QTreeWidgetItem:: sizeHint ( int column ) const

返迴為樹項設置的大小提示在給定 column (見 QSize ).

另請參閱 setSizeHint ().

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

排序項的子級使用給定 order ，通過值在給定 column .

注意： 此函數什麼都不做，若項不關聯 QTreeWidget .

QString QTreeWidgetItem:: statusTip ( int column ) const

返迴狀態提示內容為給定 column .

另請參閱 setStatusTip ().

QTreeWidgetItem *QTreeWidgetItem:: takeChild ( int index )

移除項在 index 並返迴它，否則返迴 0。

QList < QTreeWidgetItem *> QTreeWidgetItem:: takeChildren ()

移除子級列錶並返迴它，否則返迴空列錶。

QString QTreeWidgetItem:: text ( int column ) const

返迴文本在指定 column .

另請參閱 setText ().

int QTreeWidgetItem:: textAlignment ( int column ) const

返迴標簽的文本對齊方式在給定 column .

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

另請參閱 setTextAlignment () 和 Qt::Alignment .

QString QTreeWidgetItem:: toolTip ( int column ) const

返迴工具提示為給定 column .

另請參閱 setToolTip ().

QTreeWidget *QTreeWidgetItem:: treeWidget () const

返迴包含項的樹 Widget。

int QTreeWidgetItem:: type () const

返迴類型被傳遞給 QTreeWidgetItem 構造函數。

QString QTreeWidgetItem:: whatsThis ( int column ) const

返迴 What's This? 幫助內容為給定 column .

另請參閱 setWhatsThis ().

[虛擬] void QTreeWidgetItem:: write ( QDataStream & out ) const

把項寫入流 out 。這僅從一單項寫入數據。

另請參閱 read ().

[虛擬] bool QTreeWidgetItem:: operator< (const QTreeWidgetItem & other ) const

返迴 true 若項文本小於文本在 other 項，否則返迴 false .

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

賦值 other 的數據和標誌到此項。注意 type () 和 treeWidget () 不拷貝。

此函數是有用的，當重實現 clone ().

另請參閱 data () 和 flags ().

相關非成員

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

寫入樹 Widget 項 item 到流 out .

此操作符使用 QTreeWidgetItem::write ().

另請參閱 序列化 Qt 數據類型 .

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

讀取樹 Widget 項從流 in into item .

此操作符使用 QTreeWidgetItem::read ().

另請參閱 序列化 Qt 數據類型 .

內容

1. 公共類型

2. 公共函數

3. 保護函數

4. 相關非成員

5. 詳細描述

6. 子類化