QListWidgetItem 類

QListWidgetItem 類提供項為用於 QListWidget 項視圖類。更多...

頭：	#include <QListWidgetItem>
qmake:	QT += widgets

公共類型

enum	ItemType { Type, UserType }

公共函數

	QListWidgetItem (const QListWidgetItem & other )
	QListWidgetItem (const QIcon & icon , const QString & text , QListWidget * parent = nullptr, int type = Type)
	QListWidgetItem (const QString & text , QListWidget * parent = nullptr, int type = Type)
	QListWidgetItem (QListWidget * parent = nullptr, int type = Type)
QListWidgetItem &	operator= (const QListWidgetItem & other )
virtual	~QListWidgetItem ()
QBrush	background () const
Qt::CheckState	checkState () const
virtual QListWidgetItem *	clone () const
virtual QVariant	data (int role ) const
Qt::ItemFlags	flags () const
QFont	font () const
QBrush	foreground () const
QIcon	icon () const
bool	isHidden () const
bool	isSelected () const
QListWidget *	listWidget () const
virtual void	read (QDataStream & in )
void	setBackground (const QBrush & brush )
void	setCheckState (Qt::CheckState state )
virtual void	setData (int role , const QVariant & value )
void	setFlags (Qt::ItemFlags flags )
void	setFont (const QFont & font )
void	setForeground (const QBrush & brush )
void	setHidden (bool hide )
void	setIcon (const QIcon & icon )
void	setSelected (bool select )
void	setSizeHint (const QSize & size )
void	setStatusTip (const QString & statusTip )
void	setText (const QString & text )
void	setTextAlignment (int alignment )
void	setToolTip (const QString & toolTip )
void	setWhatsThis (const QString & whatsThis )
QSize	sizeHint () const
QString	statusTip () const
QString	text () const
int	textAlignment () const
QString	toolTip () const
int	type () const
QString	whatsThis () const
virtual void	write (QDataStream & out ) const
virtual bool	operator< (const QListWidgetItem & other ) const

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

詳細描述

QListWidgetItem 錶示單項在 QListWidget 。每個項可以保持幾條信息，並將適當顯示它們。

項視圖方便類使用基於項的經典接口，而不是純模型/視圖方式。對於更靈活列錶視圖 Widget，考慮使用 QListView 類采用標準模型。

可以將列錶項自動插入列錶當構建它們時，通過指定列錶 Widget：

    new QListWidgetItem(tr("Hazel"), listWidget);

另外，也可以創建列錶項不采用父級 Widget，然後插入列錶使用 QListWidget::insertItem ().

列錶項通常用於顯示 text () 和 icon ()。設置這些采用 setText () 和 setIcon () 函數。可以定製文本的外觀采用 setFont (), setForeground ()，和 setBackground ()。可以對齊列錶項文本使用 setTextAlignment () 函數。可以將工具提示、狀態提示和 What's This? 幫助添加到列錶項采用 setToolTip (), setStatusTip ()，和 setWhatsThis ().

默認情況下，項目被啓用、可選擇、可檢查，且可以是拖放操作的源。

可以改變每項的標誌通過調用 setFlags () 采用適當值 (見 Qt::ItemFlags )。可復選項可以被復選、取消復選和部分復選采用 setCheckState () 函數。相應 checkState () 函數指示項的當前復選狀態。

The isHidden () 函數可以用於確定項是否被隱藏。要隱藏項，使用 setHidden ().

子類化

當子類化 QListWidgetItem 以提供自定義項時，為它們定義新類型使之區分於標準項是可能的。對於要求此特徵的子類，確保調用基類構造函數采用新類型值等於或大於 UserType ，在 your 構造函數。

另請參閱 QListWidget , 模型/視圖編程 , QTreeWidgetItem ，和 QTableWidgetItem .

成員類型文檔編製

enum QListWidgetItem:: ItemType

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

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

可以定義新用戶類型在 QListWidgetItem 子類以確保自定義項被特殊對待。

另請參閱 type ().

成員函數文檔編製

QListWidgetItem:: QListWidgetItem (const QListWidgetItem & other )

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

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

該函數在 Qt 4.1 引入。

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

QListWidgetItem:: QListWidgetItem (const QIcon & icon , const QString & text , QListWidget * parent = nullptr, int type = Type)

構造空列錶 Widget 項為指定 type 采用給定 icon , text and parent 。若父級未指定，則需要將項插入列錶 Widget 采用 QListWidget::insertItem ().

此構造函數將項插入被傳遞給構造函數的父級模型。若模型有排序，則插入行為不確定，由於模型將調用 '<' 運算符方法，此時項尚未被構造。為避免不確定行為，推薦不指定父級和使用 QListWidget::insertItem () 代替。

另請參閱 type ().

QListWidgetItem:: QListWidgetItem (const QString & text , QListWidget * parent = nullptr, int type = Type)

構造空列錶 Widget 項為指定 type 采用給定 text and parent 。若父級未指定，則需要將項插入列錶 Widget 采用 QListWidget::insertItem ().

另請參閱 type ().

QListWidgetItem:: QListWidgetItem ( QListWidget * parent = nullptr, int type = Type)

構造空列錶 Widget 項為指定 type 采用給定 parent 。若 parent 未指定，則需要將項插入列錶 Widget 采用 QListWidget::insertItem ().

另請參閱 type ().

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

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

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

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

`[虛擬]` QListWidgetItem:: ~QListWidgetItem ()

銷毀列錶項。

QBrush QListWidgetItem:: background () const

返迴用於顯示列錶項背景的筆刷。

該函數在 Qt 4.2 引入。

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

Qt::CheckState QListWidgetItem:: checkState () const

返迴列錶項的復選狀態 (見 Qt::CheckState ).

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

`[虛擬]` QListWidgetItem *QListWidgetItem:: clone () const

創建項的準確副本。

`[虛擬]` QVariant QListWidgetItem:: data ( int role ) const

返迴項的數據為給定 role 。重實現此函數若需要額外角色或某些角色的特殊行為。

另請參閱 Qt::ItemDataRole and setData ().

Qt::ItemFlags QListWidgetItem:: flags () const

返迴此項的項標誌 (見 Qt::ItemFlags ).

另請參閱 setFlags ().

QFont QListWidgetItem:: font () const

返迴用於顯示此列錶項文本的字體。

另請參閱 setFont ().

QBrush QListWidgetItem:: foreground () const

返迴用於顯示列錶項前景 (如：文本) 的筆刷。

該函數在 Qt 4.2 引入。

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

QIcon QListWidgetItem:: icon () const

返迴列錶項的圖標。

另請參閱 setIcon () 和 iconSize .

bool QListWidgetItem:: isHidden () const

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

該函數在 Qt 4.2 引入。

另請參閱 setHidden ().

bool QListWidgetItem:: isSelected () const

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

該函數在 Qt 4.2 引入。

另請參閱 setSelected ().

QListWidget *QListWidgetItem:: listWidget () const

返迴包含項的列錶 Widget。

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

讀取項從流 in .

另請參閱 write ().

void QListWidgetItem:: setBackground (const QBrush & brush )

將列錶項的背景筆刷設為給定 brush 。設置默認構造的筆刷將使視圖使用來自樣式的默認顔色。

該函數在 Qt 4.2 引入。

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

void QListWidgetItem:: setCheckState ( Qt::CheckState state )

將列錶項的校驗狀態設為 state .

另請參閱 checkState ().

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

設置數據為給定 role 到給定 value 。重實現此函數若需要額外角色或某些角色的特殊行為。

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

另請參閱 Qt::ItemDataRole and data ().

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

將列錶項的項標誌設為 flags .

另請參閱 flags () 和 Qt::ItemFlags .

void QListWidgetItem:: setFont (const QFont & font )

將描繪項時使用的字體設為給定 font .

另請參閱 font ().

void QListWidgetItem:: setForeground (const QBrush & brush )

將列錶項的前景筆刷設為給定 brush 。設置默認構造的筆刷將使視圖使用來自樣式的默認顔色。

該函數在 Qt 4.2 引入。

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

void QListWidgetItem:: setHidden ( bool hide )

隱藏項若 hide 為 true；否則展示項。

該函數在 Qt 4.2 引入。

另請參閱 isHidden ().

void QListWidgetItem:: setIcon (const QIcon & icon )

將列錶項的圖標設為給定 icon .

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

void QListWidgetItem:: setSelected ( bool select )

將項的選定狀態設為 select .

該函數在 Qt 4.2 引入。

另請參閱 isSelected ().

void QListWidgetItem:: setSizeHint (const QSize & size )

將列錶項的大小提示設為 size 。若未設置大小提示或 size 無效，項委托將基於項數據計算大小提示。

該函數在 Qt 4.1 引入。

另請參閱 sizeHint ().

void QListWidgetItem:: setStatusTip (const QString & statusTip )

將列錶項的狀態提示設為文本指定通過 statusTip . QListWidget 鼠標追蹤需要啓用為使此特徵能工作。

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

void QListWidgetItem:: setText (const QString & text )

把列錶 Widget 項的文本，設為給定 text .

另請參閱 text ().

void QListWidgetItem:: setTextAlignment ( int alignment )

把列錶項的文本對齊方式，設為 alignment .

另請參閱 textAlignment () 和 Qt::AlignmentFlag .

void QListWidgetItem:: setToolTip (const QString & toolTip )

將列錶項工具提示設為指定文本通過 toolTip .

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

void QListWidgetItem:: setWhatsThis (const QString & whatsThis )

將列錶項 What's This? 幫助設為指定文本通過 whatsThis .

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

QSize QListWidgetItem:: sizeHint () const

返迴列錶項的大小提示設置。

該函數在 Qt 4.1 引入。

另請參閱 setSizeHint ().

QString QListWidgetItem:: statusTip () const

返迴列錶項的狀態提示。

另請參閱 setStatusTip ().

QString QListWidgetItem:: text () const

返迴列錶項的文本。

另請參閱 setText ().

int QListWidgetItem:: textAlignment () const

返迴列錶項的文本對齊方式。

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

返迴列錶項的工具提示。

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

int QListWidgetItem:: type () const

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

QString QListWidgetItem:: whatsThis () const

返迴列錶項的 What's This? 幫助文本。

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

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

把項寫入流 out .

另請參閱 read ().

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

返迴 true 若此項的文本小於 other 項的文本；否則返迴 false .

QListWidgetItem 類

公共類型

公共函數

相關非成員

詳細描述

子類化

成員類型文檔編製

enum QListWidgetItem:: ItemType

成員函數文檔編製

QListWidgetItem:: QListWidgetItem (const QListWidgetItem & other )

QListWidgetItem:: QListWidgetItem (const QIcon & icon , const QString & text , QListWidget * parent = nullptr, int type = Type)

QListWidgetItem:: QListWidgetItem (const QString & text , QListWidget * parent = nullptr, int type = Type)

QListWidgetItem:: QListWidgetItem ( QListWidget * parent = nullptr, int type = Type)

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

[虛擬] QListWidgetItem:: ~QListWidgetItem ()

QBrush QListWidgetItem:: background () const

Qt::CheckState QListWidgetItem:: checkState () const

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

[虛擬] QVariant QListWidgetItem:: data ( int role ) const

Qt::ItemFlags QListWidgetItem:: flags () const

QFont QListWidgetItem:: font () const

QBrush QListWidgetItem:: foreground () const

QIcon QListWidgetItem:: icon () const

bool QListWidgetItem:: isHidden () const

bool QListWidgetItem:: isSelected () const

QListWidget *QListWidgetItem:: listWidget () const

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

void QListWidgetItem:: setBackground (const QBrush & brush )

void QListWidgetItem:: setCheckState ( Qt::CheckState state )

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

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

void QListWidgetItem:: setFont (const QFont & font )

void QListWidgetItem:: setForeground (const QBrush & brush )

void QListWidgetItem:: setHidden ( bool hide )

void QListWidgetItem:: setIcon (const QIcon & icon )

void QListWidgetItem:: setSelected ( bool select )

void QListWidgetItem:: setSizeHint (const QSize & size )

void QListWidgetItem:: setStatusTip (const QString & statusTip )

void QListWidgetItem:: setText (const QString & text )

void QListWidgetItem:: setTextAlignment ( int alignment )

void QListWidgetItem:: setToolTip (const QString & toolTip )

void QListWidgetItem:: setWhatsThis (const QString & whatsThis )

QSize QListWidgetItem:: sizeHint () const

QString QListWidgetItem:: statusTip () const

QString QListWidgetItem:: text () const

int QListWidgetItem:: textAlignment () const

QString QListWidgetItem:: toolTip () const

int QListWidgetItem:: type () const

QString QListWidgetItem:: whatsThis () const

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

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

相關非成員

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

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

內容

`[虛擬]` QListWidgetItem:: ~QListWidgetItem ()

`[虛擬]` QListWidgetItem *QListWidgetItem:: clone () const

`[虛擬]` QVariant QListWidgetItem:: data ( int role ) const

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

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

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

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