# QListWidget Class Reference ## [[QtGui](index.htm) module] 該QListWidget類提供了一個基于項目的列表控件。[More...](#details) 繼承[QListView](qlistview.html)。 ### Methods * `__init__ (self, QWidget?parent?=?None)` * `addItem (self, QListWidgetItem?aitem)` * `addItem (self, QString?label)` * `addItems (self, QStringList?labels)` * `clear (self)` * `closePersistentEditor (self, QListWidgetItem?item)` * `int count (self)` * `QListWidgetItem currentItem (self)` * `int currentRow (self)` * `dropEvent (self, QDropEvent?event)` * `bool dropMimeData (self, int?index, QMimeData?data, Qt.DropAction?action)` * `editItem (self, QListWidgetItem?item)` * `bool event (self, QEvent?e)` * `list-of-QListWidgetItem findItems (self, QString?text, Qt.MatchFlags?flags)` * `QModelIndex indexFromItem (self, QListWidgetItem?item)` * `insertItem (self, int?row, QListWidgetItem?item)` * `insertItem (self, int?row, QString?label)` * `insertItems (self, int?row, QStringList?labels)` * `bool isItemHidden (self, QListWidgetItem?item)` * `bool isItemSelected (self, QListWidgetItem?item)` * `bool isSortingEnabled (self)` * `QListWidgetItem item (self, int?row)` * `QListWidgetItem itemAt (self, QPoint?p)` * `QListWidgetItem itemAt (self, int?ax, int?ay)` * `QListWidgetItem itemFromIndex (self, QModelIndex?index)` * `list-of-QListWidgetItem items (self, QMimeData?data)` * `QWidget itemWidget (self, QListWidgetItem?item)` * `QMimeData mimeData (self, list-of-QListWidgetItem?items)` * `QStringList mimeTypes (self)` * `openPersistentEditor (self, QListWidgetItem?item)` * `removeItemWidget (self, QListWidgetItem?aItem)` * `int row (self, QListWidgetItem?item)` * `scrollToItem (self, QListWidgetItem?item, QAbstractItemView.ScrollHint?hint?=?QAbstractItemView.EnsureVisible)` * `list-of-QListWidgetItem selectedItems (self)` * `setCurrentItem (self, QListWidgetItem?item)` * `setCurrentItem (self, QListWidgetItem?item, QItemSelectionModel.SelectionFlags?command)` * `setCurrentRow (self, int?row)` * `setCurrentRow (self, int?row, QItemSelectionModel.SelectionFlags?command)` * `setItemHidden (self, QListWidgetItem?item, bool?hide)` * `setItemSelected (self, QListWidgetItem?item, bool?select)` * `setItemWidget (self, QListWidgetItem?item, QWidget?widget)` * `setSortingEnabled (self, bool?enable)` * `sortItems (self, Qt.SortOrder?order?=?Qt.AscendingOrder)` * `Qt.DropActions supportedDropActions (self)` * `QListWidgetItem takeItem (self, int?row)` * `QRect visualItemRect (self, QListWidgetItem?item)` ### Special Methods * `__len__ (self)` ### Qt Signals * `void currentItemChanged (QListWidgetItem *,QListWidgetItem *)` * `void currentRowChanged (int)` * `void currentTextChanged (const QString&)` * `void itemActivated (QListWidgetItem *)` * `void itemChanged (QListWidgetItem *)` * `void itemClicked (QListWidgetItem *)` * `void itemDoubleClicked (QListWidgetItem *)` * `void itemEntered (QListWidgetItem *)` * `void itemPressed (QListWidgetItem *)` * `void itemSelectionChanged ()` * * * ## Detailed Description 該QListWidget類提供了一個基于項目的列表控件。 QListWidget是一個方便的類，它提供了類似于通過提供的一個列表視圖[QListView](qlistview.html)，但采用了經典的基于項目的接口，用于添加和刪除項目。 QListWidget使用內部模型來管理每個[QListWidgetItem](qlistwidgetitem.html)在列表中。 對于一個更加靈活的列表視圖控件，使用[QListView](qlistview.html)類與標準模型。 列表部件構造以同樣的方式為其他部件： ``` QListWidget *listWidget = new QListWidget(this); ``` 該[selectionMode](qabstractitemview.html#selectionMode-prop)列表窗口小部件（）確定多少的列表中的項目可以在同一時間被選擇，并確定是否可以創建項的復選。這可以通過設置[setSelectionMode](qabstractitemview.html#selectionMode-prop)（）函數。 有兩種方法將項目添加到列表中：他們可以用列表控件作為它們的父窗口部件來構建，也可以沒有父窗口部件的構造和添加到列表中后。如果列表插件已經存在時，這些項構成，第一種方法更易于使用： ``` new [QListWidgetItem](qlistwidgetitem.html)(tr("Oak"), listWidget); new [QListWidgetItem](qlistwidgetitem.html)(tr("Fir"), listWidget); new [QListWidgetItem](qlistwidgetitem.html)(tr("Pine"), listWidget); ``` 如果你需要插入一個新的項目到列表中的一個特定位置，那么它應該是沒有父部件構成。該[insertItem](qlistwidget.html#insertItem)（）函數應該被用來將其放置在列表中。列表控件將項目的所有權。 ``` [QListWidgetItem](qlistwidgetitem.html) *newItem = new [QListWidgetItem](qlistwidgetitem.html); newItem->setText(itemText); listWidget->insertItem(row, newItem); ``` 為多個項目，[insertItems](qlistwidget.html#insertItems)（）可以被代替使用。在列表中的項數被發現與[count](qlistwidget.html#count-prop)（）函數。若要從列表中刪除項目，請使用[takeItem](qlistwidget.html#takeItem)（ ） 。 在列表中的當前項目可以與發現[currentItem](qlistwidget.html#currentItem)（ ） ，并改變了[setCurrentItem](qlistwidget.html#setCurrentItem)（ ） 。用戶還可以通過用一個不同的項目的鍵盤或點擊導航更改當前資料。當目前的項目發生變化，[currentItemChanged](qlistwidget.html#currentItemChanged)（ ）信號被發射的新的當前項目，這是以前的電流的項目。 |  |  |  | | A [Windows XP style](index.htm) list widget. | A [Macintosh style](index.htm) list widget. | A [Plastique style](index.htm) list widget. | * * * ## Method Documentation ``` QListWidget.__init__ (self, QWidget?parent?=?None) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。 構造一個空[QListWidget](qlistwidget.html)用給定的_parent_。 ``` QListWidget.addItem (self, QListWidgetItem?aitem) ``` 該_aitem_說法有它的所有權轉移給Qt的。 插入的文本的項_label_在列表窗口小部件的末端。 ``` QListWidget.addItem (self, QString?label) ``` 插入_item_在列表窗口小部件的末端。 **Warning:** A [QListWidgetItem](qlistwidgetitem.html)只能添加到一個[QListWidget](qlistwidget.html)一次。添加相同[QListWidgetItem](qlistwidgetitem.html)多次給[QListWidget](qlistwidget.html)將導致不確定的行為。 **See also** [insertItem](qlistwidget.html#insertItem)（ ） 。 ``` QListWidget.addItems (self, QStringList?labels) ``` 插入項目與文本_labels_在列表窗口小部件的末端。 **See also** [insertItems](qlistwidget.html#insertItems)（ ） 。 ``` QListWidget.clear (self) ``` 這種方法也是一個Qt槽與C + +的簽名`void clear()`。 刪除所有項，并選擇在視圖中。 **Warning:**所有項目將被永久刪除。 ``` QListWidget.closePersistentEditor (self, QListWidgetItem?item) ``` 關閉持久編輯器給定_item_。 **See also** [openPersistentEditor](qlistwidget.html#openPersistentEditor)（ ） 。 ``` int QListWidget.count (self) ``` ``` QListWidgetItem QListWidget.currentItem (self) ``` [ 返回當前項目。 ](qlistwidgetitem.html) [**See also**](qlistwidgetitem.html) [setCurrentItem](qlistwidget.html#setCurrentItem)（ ） 。 ``` int QListWidget.currentRow (self) ``` ``` QListWidget.dropEvent (self, QDropEvent?event) ``` 從重新實現[QWidget.dropEvent](qwidget.html#dropEvent)（ ） 。 ``` bool QListWidget.dropMimeData (self, int?index, QMimeData?data, Qt.DropAction?action) ``` 把手_data_由外部拖放操作，與給定的供給結束_action_在給定的_index_。返回True如果_data_和_action_可以通過模型來處理，否則返回False 。 **See also** [supportedDropActions](qlistwidget.html#supportedDropActions)（ ） 。 ``` QListWidget.editItem (self, QListWidgetItem?item) ``` 開始編輯_item_如果是可編輯的。 ``` bool QListWidget.event (self, QEvent?e) ``` 從重新實現[QObject.event](qobject.html#event)（ ） 。 ``` list-of-QListWidgetItem QListWidget.findItems (self, QString?text, Qt.MatchFlags?flags) ``` 查找與該字符串匹配的文本項_text_使用給定的_flags_。 ``` QModelIndex QListWidget.indexFromItem (self, QListWidgetItem?item) ``` [](qmodelindex.html) [返回](qmodelindex.html)[QModelIndex](qmodelindex.html)assocated用給定的_item_。 ``` QListWidget.insertItem (self, int?row, QListWidgetItem?item) ``` 該_item_說法有它的所有權轉移給Qt的。 插入_item_在由給定的列表中的位置_row_。 **See also** [addItem](qlistwidget.html#addItem)（ ） 。 ``` QListWidget.insertItem (self, int?row, QString?label) ``` 插入的文本的項_label_在列表控件由給定的位置_row_。 **See also** [addItem](qlistwidget.html#addItem)（ ） 。 ``` QListWidget.insertItems (self, int?row, QStringList?labels) ``` 從列表中插入件_labels_入列表中，開始于指定的_row_。 **See also** [insertItem](qlistwidget.html#insertItem)（）和[addItem](qlistwidget.html#addItem)（ ） 。 ``` bool QListWidget.isItemHidden (self, QListWidgetItem?item) ``` ``` bool QListWidget.isItemSelected (self, QListWidgetItem?item) ``` ``` bool QListWidget.isSortingEnabled (self) ``` ``` QListWidgetItem QListWidget.item (self, int?row) ``` [ 返回佔用給定的項目_row_在列表中，如果已設置，否則返回0 。 ](qlistwidgetitem.html) [**See also**](qlistwidgetitem.html) [row](qlistwidget.html#row)（ ） 。 ``` QListWidgetItem QListWidget.itemAt (self, QPoint?p) ``` [](qlistwidgetitem.html) [返回一個指針，指向了該項目的坐標_p_。該坐標是相對于列表控件的](qlistwidgetitem.html)[viewport()](qabstractscrollarea.html#viewport)。 ``` QListWidgetItem QListWidget.itemAt (self, int?ax, int?ay) ``` [ 這是一個重載函數。 ](qlistwidgetitem.html) [返回一個指向該項目在坐標（_x_，_y_） 。該坐標是相對于列表控件的](qlistwidgetitem.html)[viewport()](qabstractscrollarea.html#viewport)。 ``` QListWidgetItem QListWidget.itemFromIndex (self, QModelIndex?index) ``` [](qlistwidgetitem.html) [返回一個指針](qlistwidgetitem.html)[QListWidgetItem](qlistwidgetitem.html)assocated用給定的_index_。 ``` list-of-QListWidgetItem QListWidget.items (self, QMimeData?data) ``` 返回指針的列表，包含在該項目_data_對象。如果對象不是由創建[QListWidget](qlistwidget.html)在同一過程中，該列表是空的。 ``` QWidget QListWidget.itemWidget (self, QListWidgetItem?item) ``` [ 返回在給定顯示的窗口小部件_item_。 這個函數是Qt 4.1中引入。 ](qwidget.html) [**See also**](qwidget.html) [setItemWidget](qlistwidget.html#setItemWidget)（ ） 。 ``` QMimeData QListWidget.mimeData (self, list-of-QListWidgetItem?items) ``` [ 該_QMimeData_結果 ](qmimedata.html) [返回一個對象，該對象包含指定的序列化描述_items_。用于描述的項目的格式是從所獲得的](qmimedata.html)[mimeTypes](qlistwidget.html#mimeTypes)（）函數。 如果項目列表為空，則返回一個序列化的空列表0代替。 ``` QStringList QListWidget.mimeTypes (self) ``` 返回可用于描述listwidget項目清單的MIME類型的列表。 **See also** [mimeData](qlistwidget.html#mimeData)（ ） 。 ``` QListWidget.openPersistentEditor (self, QListWidgetItem?item) ``` 打開一個編輯器為給定的_item_。該編輯器編輯后仍保持打開狀態。 **See also** [closePersistentEditor](qlistwidget.html#closePersistentEditor)（ ） 。 ``` QListWidget.removeItemWidget (self, QListWidgetItem?aItem) ``` 刪除給定的窗口小部件設置_item_。 此功能被引入Qt的4.3 。 ``` int QListWidget.row (self, QListWidgetItem?item) ``` 返回包含給定的行_item_。 **See also** [item](qlistwidget.html#item)（ ） 。 ``` QListWidget.scrollToItem (self, QListWidgetItem?item, QAbstractItemView.ScrollHint?hint?=?QAbstractItemView.EnsureVisible) ``` 這種方法也是一個Qt槽與C + +的簽名`void scrollToItem(const QListWidgetItem *,QAbstractItemView::ScrollHint = QAbstractItemView.EnsureVisible)`。 滾動的視圖，如果必要，以確保_item_是可見的。 _hint_指定了_item_應設在手術后。 ``` list-of-QListWidgetItem QListWidget.selectedItems (self) ``` 返回列表控件所有選定項的列表。 ``` QListWidget.setCurrentItem (self, QListWidgetItem?item) ``` 設置當前項目_item_。 除非選擇模式為[NoSelection](qabstractitemview.html#SelectionMode-enum)時，該項目也被選中。 **See also** [currentItem](qlistwidget.html#currentItem)（ ） 。 ``` QListWidget.setCurrentItem (self, QListWidgetItem?item, QItemSelectionModel.SelectionFlags?command) ``` 當前項設置為_item_，使用給定的_command_。 此功能被引入Qt的4.4 。 ``` QListWidget.setCurrentRow (self, int?row) ``` ``` QListWidget.setCurrentRow (self, int?row, QItemSelectionModel.SelectionFlags?command) ``` ``` QListWidget.setItemHidden (self, QListWidgetItem?item, bool?hide) ``` ``` QListWidget.setItemSelected (self, QListWidgetItem?item, bool?select) ``` ``` QListWidget.setItemWidget (self, QListWidgetItem?item, QWidget?widget) ``` 該_widget_說法有它的所有權轉移給Qt的。 設置_widget_要顯示在該給予_item_。 此功能只能用于顯示在一個列表控件選項的位置靜態內容。如果你想顯示自定義的動態內容或實現自定義編輯器部件，使用[QListView](qlistview.html)和子類[QItemDelegate](qitemdelegate.html)代替。 這個函數是Qt 4.1中引入。 **See also** [itemWidget](qlistwidget.html#itemWidget)（）和[Delegate Classes](index.htm#delegate-classes)。 ``` QListWidget.setSortingEnabled (self, bool?enable) ``` ``` QListWidget.sortItems (self, Qt.SortOrder?order?=?Qt.AscendingOrder) ``` 根據指定的列表中的各種插件中的所有項目_order_。 ``` Qt.DropActions QListWidget.supportedDropActions (self) ``` [ 返回此視圖支持的放置動作。 ](index.htm) [**See also**](index.htm) [Qt.DropActions](qt.html#DropAction-enum)。 ``` QListWidgetItem QListWidget.takeItem (self, int?row) ``` [ 該_QListWidgetItem_結果 移除并從給定的返回項_row_在列表控件，否則返回0 。 項目從一個列表控件中刪除不會被Qt進行管理，并需要手動刪除。 ](qlistwidgetitem.html) [**See also**](qlistwidgetitem.html) [insertItem](qlistwidget.html#insertItem)（）和[addItem](qlistwidget.html#addItem)（ ） 。 ``` QRect QListWidget.visualItemRect (self, QListWidgetItem?item) ``` [ 返回矩形上通過了該項目所佔用的視_item_。 ``` QListWidget.__len__ (self) ``` * * * ## Qt Signal Documentation ``` void currentItemChanged (QListWidgetItem *,QListWidgetItem *) ``` 這是該信號的默認超載。 這個信號被發射時的當前項的變化。 _previous_是，以前有焦點的項目;_current_是新的當前項。 ``` void currentRowChanged (int) ``` 這是該信號的默認超載。 這個信號被發射時的當前項的變化。 _currentRow_是當前項目的行。如果不存在當前項目時_currentRow_是-1。 ``` void currentTextChanged (const QString&) ``` 這是該信號的默認超載。 這個信號被發射時的當前項的變化。 _currentText_在當前項目中的文字資料。如果不存在當前項目時_currentText_是無效的。 ``` void itemActivated (QListWidgetItem *) ``` 這是該信號的默認超載。 這個信號被發射時的_item_被激活。該_item_被激活時，用戶單擊或雙擊就可以了，具體取決于系統的配置。當用戶按下啟動鍵（在Windows和X11這是它也被激活了**Return**鍵，在Mac OS X是**Ctrl+0**） 。 ``` void itemChanged (QListWidgetItem *) ``` 這是該信號的默認超載。 這個信號被發射時的數據_item_已經改變。 ``` void itemClicked (QListWidgetItem *) ``` 這是該信號的默認超載。 這個信號被發射與指定_item_單擊當鼠標按鈕上的某個項目中的部件。 ](qrect.html) [**See also**](qrect.html) [itemPressed](qlistwidget.html#itemPressed)（）和[itemDoubleClicked](qlistwidget.html#itemDoubleClicked)（ ） 。 ``` void itemDoubleClicked (QListWidgetItem *) ``` 這是該信號的默認超載。 這個信號被發射與指定_item_當鼠標按鈕被雙擊時的某個項目中的部件。 **See also** [itemClicked](qlistwidget.html#itemClicked)（）和[itemPressed](qlistwidget.html#itemPressed)（ ） 。 ``` void itemEntered (QListWidgetItem *) ``` 這是該信號的默認超載。 當鼠標光標進入一個項目，這個信號被發射。該_item_在該項目進入。這個信號只發射時[mouseTracking](qwidget.html#mouseTracking-prop)被接通時，或者當在移動到一個產品上，按下鼠標按鈕。 **See also** [QWidget.setMouseTracking](qwidget.html#mouseTracking-prop)（ ） 。 ``` void itemPressed (QListWidgetItem *) ``` 這是該信號的默認超載。 這個信號被發射與指定_item_當鼠標按鈕在微件壓在項目上。 **See also** [itemClicked](qlistwidget.html#itemClicked)（）和[itemDoubleClicked](qlistwidget.html#itemDoubleClicked)（ ） 。 ``` void itemSelectionChanged () ``` 這是該信號的默認超載。 這個信號被發射時的選擇改變。 **See also** [selectedItems](qlistwidget.html#selectedItems)（ ）[QListWidgetItem.isSelected](qlistwidgetitem.html#isSelected)（）和[currentItemChanged](qlistwidget.html#currentItemChanged)（ ） 。