PyQt PySide QListWidget 添加自定义 widget

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)

运行结果：