PyQt PySide QListWidget 添加自定义 widget

原文链接：https://stackoverflow.com/questions/25187444/pyqt-qlistwidget-custom-items

参考链接：https://www.cnblogs.com/weizhixiang/p/5913775.html

前言：

　　QListWidget 的 addItem('item') 只是快速的往 list 里面添加文本 item，有时候我们会希望添加自定义的 widget，那么就会用到 addItem ( QListWidgetItem * item )，也就是说 addItem 参数只接受 QString 和 QListWidgetItem，如果要添加自定义的 widget，那么就要把 QListWidgetItem 和 QWidget关联起来，方式是使用 QListWidget 的 setItemWidget(QListWidgetItem, QWidget)，不过还要注意一些其它的设置（item 的 size）。

我根据原文链接稍微修改的代码（把图片改为按钮）：

该代码可以直接运行，注意自己使用的是 PyQt4 还是 PySide

 # -*- coding: utf-8 -*-

 import sys

 from PySide import QtGui

 #from PyQt4 import QtGui

 class QCustomQWidget (QtGui.QWidget):

     def __init__ (self, parent = None):

         super(QCustomQWidget, self).__init__(parent)

         self.textQVBoxLayout = QtGui.QVBoxLayout()

         self.textUpQLabel    = QtGui.QLabel()

         self.textDownQLabel  = QtGui.QLabel()

         self.textQVBoxLayout.addWidget(self.textUpQLabel)

         self.textQVBoxLayout.addWidget(self.textDownQLabel)

         self.allQHBoxLayout  = QtGui.QHBoxLayout()

         self.iconQLabel      = QtGui.QPushButton()

         self.allQHBoxLayout.addWidget(self.iconQLabel, 0)

         self.allQHBoxLayout.addLayout(self.textQVBoxLayout, 1)

         self.setLayout(self.allQHBoxLayout)

         # setStyleSheet

         self.textUpQLabel.setStyleSheet('''

             color: rgb(0, 0, 255);

         ''')

         self.textDownQLabel.setStyleSheet('''

             color: rgb(255, 0, 0);

         ''')

     def setTextUp (self, text):

         self.textUpQLabel.setText(text)

     def setTextDown (self, text):

         self.textDownQLabel.setText(text)

     def setIcon (self, imagePath):

         pass

         #self.iconQLabel.setPixmap(QtGui.QPixmap(imagePath))

 class exampleQMainWindow (QtGui.QMainWindow):

     def __init__ (self):

         super(exampleQMainWindow, self).__init__()

         # Create QListWidget

         self.myQListWidget = QtGui.QListWidget(self)

         for index, name, icon in [

             ('No.1', 'Meyoko',  'icon.png'),

             ('No.2', 'Nyaruko', 'icon.png'),

             ('No.3', 'Louise',  'icon.png')]:

             # Create QCustomQWidget

             myQCustomQWidget = QCustomQWidget()

             myQCustomQWidget.setTextUp(index)

             myQCustomQWidget.setTextDown(name)

             myQCustomQWidget.setIcon(icon)

             # Create QListWidgetItem

             myQListWidgetItem = QtGui.QListWidgetItem(self.myQListWidget)

             # Set size hint

             myQListWidgetItem.setSizeHint(myQCustomQWidget.sizeHint())

             # Add QListWidgetItem into QListWidget

             self.myQListWidget.addItem(myQListWidgetItem)

             self.myQListWidget.setItemWidget(myQListWidgetItem, myQCustomQWidget)

         self.setCentralWidget(self.myQListWidget)

 app = QtGui.QApplication([])

 window = exampleQMainWindow()

 window.show()

 sys.exit(app.exec_())

从代码总结的思路和注意点是：

1. 创建 QListWidget

2. 创建 QListWidgetItem，父类为 QListWidget，可以理解为一个空的 item

3. 把 QListWidgetItem 添加到 QListWidget中：QListWidget.addItem(QListWidgetItem)

4. 创建 自定义的 QWidget

5. 把 QListWidgetItem 的 sizeHint 设置为 QWidget 的 sizeHint（如果不设置，看不到 QWidget）

6. 关联 QListWidgetItem 和 QWidget：QListWidget.setItemWidget(QListWidgetItem, QWidget)

运行结果：