QListWidgetItem Class Reference · PyQt4 中文文檔

# QListWidgetItem Class Reference ## [[QtGui](index.htm) module] 該QListWidgetItem類提供的項目與使用[QListWidget](qlistwidget.html)項目視圖類。[More...](#details) ### Types * `enum ItemType { Type, UserType }` ### Methods * `__init__ (self, QListWidget?parent?=?None, int?type?=?QListWidgetItem.Type)` * `__init__ (self, QString?text, QListWidget?parent?=?None, int?type?=?QListWidgetItem.Type)` * `__init__ (self, QIcon?icon, QString?text, QListWidget?parent?=?None, int?type?=?QListWidgetItem.Type)` * `__init__ (self, QListWidgetItem?other)` * `QBrush background (self)` * `QColor backgroundColor (self)` * `Qt.CheckState checkState (self)` * `QListWidgetItem clone (self)` * `QVariant data (self, int?role)` * `Qt.ItemFlags flags (self)` * `QFont font (self)` * `QBrush foreground (self)` * `QIcon icon (self)` * `bool isHidden (self)` * `bool isSelected (self)` * `QListWidget listWidget (self)` * `read (self, QDataStream?in)` * `setBackground (self, QBrush?brush)` * `setBackgroundColor (self, QColor?color)` * `setCheckState (self, Qt.CheckState?state)` * `setData (self, int?role, QVariant?value)` * `setFlags (self, Qt.ItemFlags?aflags)` * `setFont (self, QFont?afont)` * `setForeground (self, QBrush?brush)` * `setHidden (self, bool?ahide)` * `setIcon (self, QIcon?aicon)` * `setSelected (self, bool?aselect)` * `setSizeHint (self, QSize?size)` * `setStatusTip (self, QString?astatusTip)` * `setText (self, QString?atext)` * `setTextAlignment (self, int?alignment)` * `setTextColor (self, QColor?color)` * `setToolTip (self, QString?atoolTip)` * `setWhatsThis (self, QString?awhatsThis)` * `QSize sizeHint (self)` * `QString statusTip (self)` * `QString text (self)` * `int textAlignment (self)` * `QColor textColor (self)` * `QString toolTip (self)` * `int type (self)` * `QString whatsThis (self)` * `write (self, QDataStream?out)` ### Special Methods * `bool __ge__ (self, QListWidgetItem?other)` * `bool __lt__ (self, QListWidgetItem?other)` * * * ## Detailed Description 該QListWidgetItem類提供的項目與使用[QListWidget](qlistwidget.html)項目視圖類。一個QListWidgetItem代表一個單一的項目[QListWidget](qlistwidget.html)。每個項目可容納幾條信息，并會適當地顯示出來。項目視圖便利類使用一個典型的項目為基礎的界面，而不是一個純粹的模型/視圖的方法。對于一個更加靈活的列表視圖控件，可以考慮使用[QListView](qlistview.html)類與標準模型。列表項可以被自動插入到一個列表中，當它們被建造，通過指定列表控件： ``` new QListWidgetItem(tr("Hazel"), listWidget); ``` 或者，列表項，也可以沒有父窗口部件創建的，并在以后使用插入到列表[QListWidget.insertItem](qlistwidget.html#insertItem)（）。列表項通常用于顯示[text](qlistwidgetitem.html#text)（）和一個[icon](qlistwidgetitem.html#icon)（）。這些設置與[setText](qlistwidgetitem.html#setText)（）和[setIcon](qlistwidgetitem.html#setIcon)（）函數。文本的外觀可與定制[setFont](qlistwidgetitem.html#setFont)（）[setForeground](qlistwidgetitem.html#setForeground)（）和[setBackground](qlistwidgetitem.html#setBackground)（）。在列表項的文本可使用對齊[setTextAlignment](qlistwidgetitem.html#setTextAlignment)（）函數。工具提示，狀態提示和“這是什么？ ”說明可以被添加到列表中的內容[setToolTip](qlistwidgetitem.html#setToolTip)（）[setStatusTip](qlistwidgetitem.html#setStatusTip)（）和[setWhatsThis](qlistwidgetitem.html#setWhatsThis)（）。默認情況下，項目的啟用，可選擇，可復，可拖放操作的來源。每個項目的標志可以通過調用改變[setFlags](qlistwidgetitem.html#setFlags)（）用適當的值（見[Qt.ItemFlags](qt.html#ItemFlag-enum)）。辨認的項目可以被選中，未選中并與部分檢查[setCheckState](qlistwidgetitem.html#setCheckState)（）函數。相應的[checkState](qlistwidgetitem.html#checkState)（）函數表示該項目的當前選中狀態。該[isHidden](qlistwidgetitem.html#isHidden)（）函數可以被用來確定該項目是否被隱藏。若要隱藏某個項目，用[setHidden](qlistwidgetitem.html#setHidden)（）。 ### Subclassing 當子類QListWidgetItem提供自定義項目，可以為他們使他們能夠從標準的項目區分開來定義新的類型。對于需要此功能的子類，請確保調用基類的構造函數有一個新的類型值等于或大于[UserType](qlistwidgetitem.html#ItemType-enum)，內_your_構造函數。 * * * ## Type Documentation ``` QListWidgetItem.ItemType ``` 該枚舉描述了用于描述列表插件項的類型。 | Constant | Value | Description | | --- | --- | --- | | `QListWidgetItem.Type` | `0` | 默認類型為列表控件的項目。 | | `QListWidgetItem.UserType` | `1000` | 對于自定義類型的最小值。以下用戶等級和積分值被Qt保留。 | 您可以定義新的用戶類型[QListWidgetItem](qlistwidgetitem.html)子類以確保自定義項目被特殊處理。 **See also** [type](qlistwidgetitem.html#type)（）。 * * * ## Method Documentation ``` QListWidgetItem.__init__ (self, QListWidget?parent?=?None, int?type?=?QListWidgetItem.Type) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。構造指定一個空的列表控件項_type_用給定的_parent_。如果_parent_沒有被指定，該項目將需要被插入到一個列表部件與[QListWidget.insertItem](qlistwidget.html#insertItem)（）。這個構造函數插入項目到傳遞給構造函數的父模型。如果模型被排序，然后插入物的行為是不確定的，因為該模型將調用`'<'`運營商的方法上，在這一點上，尚未建成的項目。為了避免不確定的行為，我們建議不要指定父和使用[QListWidget.insertItem](qlistwidget.html#insertItem)（）來代替。 **See also** [type](qlistwidgetitem.html#type)（）。 ``` QListWidgetItem.__init__ (self, QString?text, QListWidget?parent?=?None, int?type?=?QListWidgetItem.Type) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。構造指定一個空的列表控件項_type_用給定的_text_和_parent_。如果未指定父，則該項目將需要被插入到一個列表部件與[QListWidget.insertItem](qlistwidget.html#insertItem)（）。這個構造函數插入項目到傳遞給構造函數的父模型。如果模型被排序，然后插入物的行為是不確定的，因為該模型將調用`'<'`運營商的方法上，在這一點上，尚未建成的項目。為了避免不確定的行為，我們建議不要指定父和使用[QListWidget.insertItem](qlistwidget.html#insertItem)（）來代替。 **See also** [type](qlistwidgetitem.html#type)（）。 ``` QListWidgetItem.__init__ (self, QIcon?icon, QString?text, QListWidget?parent?=?None, int?type?=?QListWidgetItem.Type) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。構造指定一個空的列表控件項_type_用給定的_icon_，_text_和_parent_。如果未指定父，則該項目將需要被插入到一個列表部件與[QListWidget.insertItem](qlistwidget.html#insertItem)（）。這個構造函數插入項目到傳遞給構造函數的父模型。如果模型被排序，然后插入物的行為是不確定的，因為該模型將調用`'<'`運營商的方法上，在這一點上，尚未建成的項目。為了避免不確定的行為，我們建議不要指定父和使用[QListWidget.insertItem](qlistwidget.html#insertItem)（）來代替。 **See also** [type](qlistwidgetitem.html#type)（）。 ``` QListWidgetItem.__init__ (self, QListWidgetItem?other) ``` 構造的副本_other_。需要注意的是[type](qlistwidgetitem.html#type)（）和[listWidget](qlistwidgetitem.html#listWidget)（）不會被復制。重新實現時，此功能非常有用[clone](qlistwidgetitem.html#clone)（）。這個函數是Qt 4.1中引入。 **See also** [data](qlistwidgetitem.html#data)（）和[flags](qlistwidgetitem.html#flags)（）。 ``` QBrush QListWidgetItem.background (self) ``` [ 返回用于顯示列表項的背景的畫筆。這個函數中引入了Qt 4.2中。 ](qbrush.html) [**See also**](qbrush.html) [setBackground](qlistwidgetitem.html#setBackground)（）和[foreground](qlistwidgetitem.html#foreground)（）。 ``` QColor QListWidgetItem.backgroundColor (self) ``` [](qcolor.html) ``` Qt.CheckState QListWidgetItem.checkState (self) ``` [](qt.html#CheckState-enum) [返回列表項的選中狀態（見](qt.html#CheckState-enum)[Qt.CheckState](qt.html#CheckState-enum)）。 **See also** [setCheckState](qlistwidgetitem.html#setCheckState)（）和[flags](qlistwidgetitem.html#flags)（）。 ``` QListWidgetItem QListWidgetItem.clone (self) ``` [ 創建該項目的精確副本。 ``` QVariant QListWidgetItem.data (self, int?role) ``` 返回的項目的數據對于一個給定_role_。如果你需要額外的角色或某些角色的特殊行為重新實現這個函數。 ](qlistwidgetitem.html) [**See also**](qlistwidgetitem.html) [Qt.ItemDataRole](qt.html#ItemDataRole-enum)和[setData](qlistwidgetitem.html#setData)（）。 ``` Qt.ItemFlags QListWidgetItem.flags (self) ``` [](index.htm) [返回該項目的標志為這個項目（見](index.htm)[Qt.ItemFlags](qt.html#ItemFlag-enum)）。 **See also** [setFlags](qlistwidgetitem.html#setFlags)（）。 ``` QFont QListWidgetItem.font (self) ``` [ 返回用于顯示該列表項的文本的字體。 ](qfont.html) [**See also**](qfont.html) [setFont](qlistwidgetitem.html#setFont)（）。 ``` QBrush QListWidgetItem.foreground (self) ``` [ 返回用于顯示列表項的前景（如文字）的筆刷。這個函數中引入了Qt 4.2中。 ](qbrush.html) [**See also**](qbrush.html) [setForeground](qlistwidgetitem.html#setForeground)（）和[background](qlistwidgetitem.html#background)（）。 ``` QIcon QListWidgetItem.icon (self) ``` [ 返回列表項的圖標。 ](qicon.html) [**See also**](qicon.html) [setIcon](qlistwidgetitem.html#setIcon)（）和[iconSize](qabstractitemview.html#iconSize-prop)。 ``` bool QListWidgetItem.isHidden (self) ``` 返回True如果該項目是隱藏，否則返回False 。這個函數中引入了Qt 4.2中。 **See also** [setHidden](qlistwidgetitem.html#setHidden)（）。 ``` bool QListWidgetItem.isSelected (self) ``` 返回True如果該項目被選中，否則返回False 。這個函數中引入了Qt 4.2中。 **See also** [setSelected](qlistwidgetitem.html#setSelected)（）。 ``` QListWidget QListWidgetItem.listWidget (self) ``` [ 返回包含項目的列表控件。 ``` QListWidgetItem.read (self, QDataStream?in) ``` 從流中讀取的項目_in_。 ](qlistwidget.html) [**See also**](qlistwidget.html) [write](qlistwidgetitem.html#write)（）。 ``` QListWidgetItem.setBackground (self, QBrush?brush) ``` 設置列表項的背景刷到給定_brush_。這個函數中引入了Qt 4.2中。 **See also** [background](qlistwidgetitem.html#background)（）和[setForeground](qlistwidgetitem.html#setForeground)（）。 ``` QListWidgetItem.setBackgroundColor (self, QColor?color) ``` ``` QListWidgetItem.setCheckState (self, Qt.CheckState?state) ``` 設置列表項的復選狀態_state_。 **See also** [checkState](qlistwidgetitem.html#checkState)（）。 ``` QListWidgetItem.setData (self, int?role, QVariant?value) ``` 設置數據對于一個給定_role_為給定的_value_。如果你需要額外的角色或某些角色的特殊行為重新實現這個函數。 **See also** [Qt.ItemDataRole](qt.html#ItemDataRole-enum)和[data](qlistwidgetitem.html#data)（）。 ``` QListWidgetItem.setFlags (self, Qt.ItemFlags?aflags) ``` 設置項標志為列表項_flags_。 **See also** [flags](qlistwidgetitem.html#flags)（）和[Qt.ItemFlags](qt.html#ItemFlag-enum)。 ``` QListWidgetItem.setFont (self, QFont?afont) ``` 畫設定的項目給定的時使用的字體_font_。 **See also** [font](qlistwidgetitem.html#font)（）。 ``` QListWidgetItem.setForeground (self, QBrush?brush) ``` 設置列表項的前景畫筆給定的_brush_。這個函數中引入了Qt 4.2中。 **See also** [foreground](qlistwidgetitem.html#foreground)（）和[setBackground](qlistwidgetitem.html#setBackground)（）。 ``` QListWidgetItem.setHidden (self, bool?ahide) ``` 隱藏的項目，如果_hide_為True，否則顯示的項目。這個函數中引入了Qt 4.2中。 **See also** [isHidden](qlistwidgetitem.html#isHidden)（）。 ``` QListWidgetItem.setIcon (self, QIcon?aicon) ``` 設置為列表項的圖標給定的_icon_。 **See also** [icon](qlistwidgetitem.html#icon)（）[text](qlistwidgetitem.html#text)（）和[iconSize](qabstractitemview.html#iconSize-prop)。 ``` QListWidgetItem.setSelected (self, bool?aselect) ``` 設置項的選擇狀態，以_select_。這個函數中引入了Qt 4.2中。 **See also** [isSelected](qlistwidgetitem.html#isSelected)（）。 ``` QListWidgetItem.setSizeHint (self, QSize?size) ``` 設置尺寸暗示的列表項是_size_。如果沒有大小的提示設置，基于項目數據的項目代表將計算尺寸暗示。這個函數是Qt 4.1中引入。 **See also** [sizeHint](qlistwidgetitem.html#sizeHint)（）。 ``` QListWidgetItem.setStatusTip (self, QString?astatusTip) ``` 設置狀態提示為列表項由指定的文本_statusTip_。[QListWidget](qlistwidget.html)mouseTracking需要啟用此功能工作。 **See also** [statusTip](qlistwidgetitem.html#statusTip)（）[setToolTip](qlistwidgetitem.html#setToolTip)（）[setWhatsThis](qlistwidgetitem.html#setWhatsThis)（）和[QWidget.setMouseTracking](qwidget.html#mouseTracking-prop)（）。 ``` QListWidgetItem.setText (self, QString?atext) ``` 設置文本列表控件項的給定_text_。 **See also** [text](qlistwidgetitem.html#text)（）。 ``` QListWidgetItem.setTextAlignment (self, int?alignment) ``` 設置列表項的文本對齊方式_alignment_。 **See also** [textAlignment](qlistwidgetitem.html#textAlignment)（）和[Qt.AlignmentFlag](qt.html#AlignmentFlag-enum)。 ``` QListWidgetItem.setTextColor (self, QColor?color) ``` ``` QListWidgetItem.setToolTip (self, QString?atoolTip) ``` 設置工具提示的列表項由指定的文本_toolTip_。 **See also** [toolTip](qlistwidgetitem.html#toolTip)（）[setStatusTip](qlistwidgetitem.html#setStatusTip)（）和[setWhatsThis](qlistwidgetitem.html#setWhatsThis)（）。 ``` QListWidgetItem.setWhatsThis (self, QString?awhatsThis) ``` 設置“這是什么？ ”幫助列表項由指定的文本_whatsThis_。 **See also** [whatsThis](qlistwidgetitem.html#whatsThis)（）[setStatusTip](qlistwidgetitem.html#setStatusTip)（）和[setToolTip](qlistwidgetitem.html#setToolTip)（）。 ``` QSize QListWidgetItem.sizeHint (self) ``` [ 返回列表項的大小提示集。這個函數是Qt 4.1中引入。 ](qsize.html) [**See also**](qsize.html) [setSizeHint](qlistwidgetitem.html#setSizeHint)（）。 ``` QString QListWidgetItem.statusTip (self) ``` 返回列表項的狀態提示。 **See also** [setStatusTip](qlistwidgetitem.html#setStatusTip)（）。 ``` QString QListWidgetItem.text (self) ``` 返回列表項的文本。 **See also** [setText](qlistwidgetitem.html#setText)（）。 ``` int QListWidgetItem.textAlignment (self) ``` 返回文本對齊方式為列表項。 **See also** [setTextAlignment](qlistwidgetitem.html#setTextAlignment)（）和[Qt.AlignmentFlag](qt.html#AlignmentFlag-enum)。 ``` QColor QListWidgetItem.textColor (self) ``` [ ``` QString QListWidgetItem.toolTip (self) ``` 返回列表項的工具提示。 ](qcolor.html) [**See also**](qcolor.html) [setToolTip](qlistwidgetitem.html#setToolTip)（）[statusTip](qlistwidgetitem.html#statusTip)（）和[whatsThis](qlistwidgetitem.html#whatsThis)（）。 ``` int QListWidgetItem.type (self) ``` 返回傳遞給類型[QListWidgetItem](qlistwidgetitem.html)構造函數。 ``` QString QListWidgetItem.whatsThis (self) ``` 返回列表項的“這是什么？ ”幫助文本。 **See also** [setWhatsThis](qlistwidgetitem.html#setWhatsThis)（）[statusTip](qlistwidgetitem.html#statusTip)（）和[toolTip](qlistwidgetitem.html#toolTip)（）。 ``` QListWidgetItem.write (self, QDataStream?out) ``` 寫入流的項目_out_。 **See also** [read](qlistwidgetitem.html#read)（）。 ``` bool QListWidgetItem.__ge__ (self, QListWidgetItem?other) ``` ``` bool QListWidgetItem.__lt__ (self, QListWidgetItem?other) ```