PyQt5 - 如何为 ComboBox 中的每个项目设置图标

在 PyQt5 中，ComboBox 是一个常用控件，它可以用来下拉显示一组选项。有时候，为了提高用户的体验，我们可能希望在 ComboBox 中为每个选项设置一个图标。本文将介绍如何在 PyQt5 中为 ComboBox 中的每个项目设置图标。

准备工作

在开始编写代码之前，需要先准备一些资源。具体地，需要为每个 ComboBox 选项准备一个图标文件。建议使用 16x16 大小的 png 格式图标。可以将所有的图标保存在一个文件夹中，方便统一管理。

实现方法

我们可以通过 PyQt5 中的 QComboBox 和 QStandardItemModel 类来实现 ComboBox 中每个项目设置图标。

下面是实现方法的代码片段：

from PyQt5.QtCore import QSize, Qt
from PyQt5.QtGui import QIcon
from PyQt5.QtWidgets import QComboBox, QStandardItem, QStandardItemModel

class IconComboBox(QComboBox):
    def __init__(self):
        super().__init__()

        # 创建一个 model
        self._model = QStandardItemModel(self)

        # 设置 model 中的数据
        for i in range(self.count()):
            # 获取每个选项的文本和图标路径
            text = self.itemText(i)
            icon_path = "icons/{}.png".format(text)

            # 创建一个 item
            item = QStandardItem(text)
            item.setIcon(QIcon(icon_path))
            item.setEditable(False)

            # 将 item 添加到 model 中
            self._model.appendRow(item)

        # 设置 ComboBox 的 model
        self.setModel(self._model)

        # 设置 ComboBox 的最小宽度
        self.setMinimumWidth(100)

    # 重新实现下拉列表显示的大小
    def sizeHint(self):
        # 获取 ComboBox 中最长的选项文本的宽度
        max_width = max(self.fontMetrics().width(self.itemText(i)) for i in range(self.count()))

        # 计算并返回下拉列表的大小
        return QSize(max_width + 30, self.size().height())

上面的代码片段中，我们使用了自定义的 IconComboBox 类来实现 ComboBox 中每个项目设置图标的功能。

具体地，我们首先创建了一个 _model 对象，用来存储 ComboBox 的选项数据。然后，我们遍历 ComboBox 的每个选项，从图标文件夹中获取对应的图标文件路径，并创建一个 QStandardItem 对象。最后，将该 QStandardItem 对象添加到 _model 中，以便 ComboBox 可以使用它来显示选项。

注意，在创建 QStandardItem 对象时，我们通过 setIcon() 方法为该项设置了对应的图标。我们还将该项的编辑功能禁用，以保证用户无法修改它的值。

最后，我们将 _model 设置为 ComboBox 的 model，并重写 sizeHint() 方法，以便 ComboBox 可以正确地显示下拉选项的大小。

使用方法

使用上面的代码片段创建 IconComboBox 类后，就可以在你的 PyQt5 应用程序中像使用普通 ComboBox 一样使用它了。例如，可以通过如下代码创建一个 IconComboBox 对象，并添加一些选项：

from PyQt5.QtWidgets import QApplication, QDialog, QVBoxLayout
import sys

class MyDialog(QDialog):
    def __init__(self):
        super().__init__()

        # 创建一个 Layout
        layout = QVBoxLayout(self)

        # 创建一个 IconComboBox
        combobox = IconComboBox()

        # 添加一些选项
        combobox.addItem("Apple")
        combobox.addItem("Banana")
        combobox.addItem("Cherry")
        combobox.addItem("Durian")

        # 将 IconComboBox 添加到 Layout 中
        layout.addWidget(combobox)

if __name__ == '__main__':
    app = QApplication(sys.argv)
    dialog = MyDialog()
    dialog.show()
    sys.exit(app.exec_())

上面的代码中，我们创建了一个 MyDialog 类，并在其中创建了一个 IconComboBox 对象。然后，我们向该 IconComboBox 中添加了一些选项，并将它添加到 MyDialog 的 Layout 中，以便用户可以看到它。

总结

本文介绍了如何在 PyQt5 中为 ComboBox 中的每个项目设置图标。具体地，我们使用了 QComboBox 和 QStandardItemModel 类来实现该功能，通过创建一个自定义的 IconComboBox 类，为每个选项设置一个图标文件。这样，我们就可以在 PyQt5 应用程序中为 ComboBox 添加更美观的图标了。