就業培訓     下載中心     Wiki     聯絡
登錄   注冊
  1. 首頁
  2. Qt 6.5.1
  3. Qt Widgets
  4. C++ 類
  5. QListWidgetItem

QListWidgetItem 類

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

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

公共類型

enum ItemType { Type, UserType }

公共函數

QListWidgetItem (QListWidget * parent = nullptr, int type = Type)
QListWidgetItem (const QString & text , QListWidget * parent = nullptr, int type = Type)
QListWidgetItem (const QIcon & icon , const QString & text , QListWidget * parent = nullptr, int type = Type)
QListWidgetItem (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 (Qt::Alignment 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
QListWidgetItem & operator= (const QListWidgetItem & other )
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 (). Text in list items can be aligned using the setTextAlignment() function. Tooltips, status tips and "What's This?" help can be added to list items with 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 ().

成員函數文檔編製

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

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

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

另請參閱 type ().

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

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

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

另請參閱 type ().

[explicit] 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 QListWidgetItem & other )

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

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

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

[虛擬] QListWidgetItem:: ~QListWidgetItem ()

銷毀列錶項。

QBrush QListWidgetItem:: background () const

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

另請參閱 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

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

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

QIcon QListWidgetItem:: icon () const

返迴列錶項的圖標。

另請參閱 setIcon () 和 iconSize .

bool QListWidgetItem:: isHidden () const

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

另請參閱 setHidden ().

bool QListWidgetItem:: isSelected () const

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

另請參閱 setSelected ().

QListWidget *QListWidgetItem:: listWidget () const

返迴包含項的列錶 Widget。

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

讀取項從流 in .

另請參閱 write ().

void QListWidgetItem:: setBackground (const QBrush & brush )

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

另請參閱 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 。設置默認構造的筆刷將使視圖使用來自樣式的默認顔色。

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

void QListWidgetItem:: setHidden ( bool hide )

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

另請參閱 isHidden ().

void QListWidgetItem:: setIcon (const QIcon & icon )

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

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

void QListWidgetItem:: setSelected ( bool select )

將項的選定狀態設為 select .

另請參閱 isSelected ().

void QListWidgetItem:: setSizeHint (const QSize & size )

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

另請參閱 sizeHint ().

void QListWidgetItem:: setStatusTip (const QString & statusTip )

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

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

void QListWidgetItem:: setText (const QString & text )

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

另請參閱 text ().

[since 6.4] void QListWidgetItem:: setTextAlignment ( Qt::Alignment alignment )

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

This function was introduced in Qt 6.4.

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

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

另請參閱 setSizeHint ().

QString QListWidgetItem:: statusTip () const

返迴列錶項的狀態提示。

另請參閱 setStatusTip ().

QString QListWidgetItem:: text () const

返迴列錶項的文本。

另請參閱 setText ().

int QListWidgetItem:: textAlignment () const

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

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

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

QString QListWidgetItem:: toolTip () const

返迴列錶項的工具提示。

另請參閱 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 &QListWidgetItem:: operator= (const QListWidgetItem & other )

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

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

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

相關非成員

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

寫列錶 Widget 項 item 到流 out .

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

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

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

讀取列錶 Widget 項從流 in into item .

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

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

內容

  1. 公共類型

  2. 公共函數

  3. 相關非成員

  4. 詳細描述

  5. 子類化