PyQt5 – 为组合框中的项目设置角色

下面我来详细讲解一下Python的PyQt5库中如何为组合框中的项目设置角色。

1. 什么是角色，为什么要设置角色

在解释如何设置角色之前，我们需要先了解一下什么是角色，以及为什么要为组合框中的项目设置角色。

在PyQt5中，QComboBox是一种下拉式列表框控件，它可以显示多个选项，供用户进行选择。当用户从该列表框中选择某一项时，我们可以通过设置该项的角色，来获取该项对应的值。简言之，角色就是给选项设置的额外的属性或元数据。

2. 如何为组合框中的项目设置角色

在PyQt5中，可以通过setItemData()方法为组合框中的选项设置角色。该方法的基本语法如下：

setItemData(index, value[, role])

其中，参数index是要设置角色的选项所在的下标（从0开始），value是要设置的角色值，而role则是角色的类型。对于已知的角色类型，可以从PyQt5.QtCore模块中导入，比如：

from PyQt5.QtCore import Qt

此外，也可以自定义角色类型，具体方法可自行查阅相关文档。

下面我们通过两个示例来说明如何为组合框中的项目设置角色：

示例1：在组合框中设置上下文菜单

下面我们将演示如何在组合框中设置上下文菜单。具体代码如下：

from PyQt5.QtWidgets import QApplication, QComboBox, QMainWindow, QMenu
from PyQt5.QtCore import Qt
import sys

class Example(QMainWindow):

    def __init__(self):
        super().__init__()

        self.initUI()

    def initUI(self):

        combo = QComboBox(self)
        combo.setGeometry(50, 50, 150, 30)

        # 为组合框中的选项设置上下文菜单
        menu = QMenu('Menu', self)
        item1 = menu.addAction('Item 1')
        item2 = menu.addAction('Item 2')
        combo.setContextMenuPolicy(Qt.CustomContextMenu)
        combo.customContextMenuRequested.connect(lambda x: menu.exec_(combo.mapToGlobal(x)))

        combo.addItem('Option 1', 1)
        combo.setItemData(0, 'Menu', Qt.ToolTipRole)

        combo.addItem('Option 2', 2)
        combo.setItemData(1, 'Menu', Qt.ToolTipRole)

        self.setGeometry(300, 300, 300, 200)
        self.show()

if __name__ == '__main__':
    app = QApplication(sys.argv)
    ex = Example()
    sys.exit(app.exec_())

说明：

• 首先，我们创建一个组合框对象combo，并通过setGeometry()方法设置其初始位置和大小。

• 接着，我们创建一个上下文菜单menu，以及两个菜单项item1和item2。

• 然后，我们通过setContextMenuPolicy()方法设置组合框的上下文菜单策略为Qt.CustomContextMenu，以便在鼠标右键点击组合框时可以弹出上下文菜单。同时，我们通过customContextMenuRequested()信号，连接一个Lambda表达式，用于响应右键点击事件。

• 接下来，我们通过addItem()方法向组合框中添加两个选项Option 1和Option 2，并为它们分别设定对应的值1和2。

• 最后，我们通过setItemData()方法，为第一个选项设置Qt.ToolTipRole角色。这样，当用户将鼠标悬停在第一个选项上时，就可以显示菜单。

运行程序后，右键单击组合框的第一个选项，可以看到弹出了上下文菜单。

示例2：在组合框中设置图标

下面我们将演示如何在组合框中设置图标。具体代码如下：

from PyQt5.QtWidgets import QApplication, QComboBox, QLabel, QMainWindow
from PyQt5.QtGui import QIcon
import sys

class Example(QMainWindow):

    def __init__(self):
        super().__init__()

        self.initUI()

    def initUI(self):

        self.lbl = QLabel('Option 1', self)
        self.lbl.setGeometry(50, 50, 150, 30)

        combo = QComboBox(self)
        combo.setGeometry(50, 100, 150, 30)

        combo.addItem(QIcon('icons/phone.png'), 'Option 1', 1)
        combo.addItem(QIcon('icons/email.png'), 'Option 2', 2)

        combo.currentIndexChanged.connect(self.updateLabel)

        self.setGeometry(300, 300, 300, 200)
        self.show()

    def updateLabel(self, index):
        self.lbl.setText(self.sender().currentText())

if __name__ == '__main__':
    app = QApplication(sys.argv)
    ex = Example()
    sys.exit(app.exec_())

说明：

• 首先，我们创建一个标签lbl，并通过setGeometry()方法设置其初始位置和大小。

• 接着，我们创建一个组合框对象combo，并通过setGeometry()方法设置其初始位置和大小。

• 然后，我们通过addItem()方法向组合框中添加两个选项Option 1和Option 2，分别设置对应的值1和2，并为它们分别设置了两个不同的图标。

• 最后，我们通过currentIndexChanged()信号连接了一个updateLabel()槽函数，用于显示用户当前选中的选项的文本。

运行程序后，可以看到组合框中的选项已经显示了对应的图标。