PyQt5 - 带有可检查项目的组合框

引言

在 PyQt5 中，我们可以使用 QComboBox 控件实现一个下拉框。但是如果我们希望在下拉框的每个选项中添加一个复选框，该怎么办呢？答案是使用 QComboBox 中的 QStandardItemModel 实现一个 “带有可检查项目的组合框”。

实现过程

首先，我们需要导入 PyQt5 和 QtWidgets 模块。

import sys
from PyQt5.QtWidgets import QApplication, QComboBox, QCheckBox, QStandardItemModel

接下来，我们使用 QStandardItemModel 创建一个可检查项目列表，将其附加到 QComboBox 中。

model = QStandardItemModel()
combobox = QComboBox()

for i in range(5):
    item = QStandardItem("Item {}".format(i+1))
    item.setCheckable(True)
    model.appendRow(item)

combobox.setModel(model)

这里，我们遍历了一个包含 5 个元素的循环，创建了 5 个带有复选框的项目，并将其添加到了列表中。

现在，我们需要添加一个可触发事件（在此示例中，我们将使用 QCheckBox 作为事件源）将选定的项目添加到当前选定对象的文本属性中。我们将在列表中查找已经检查的项目，并将其添加到文本中。

def on_checkbox_changed():      
    selected_items = [str(combobox.model().item(i).text())
                      for i in range(combobox.count())
                      if combobox.model().item(i).checkState()]
    combobox.lineEdit().setText(", ".join(selected_items))
 
 
for i in range(combobox.count()):
    checkbox = QCheckBox(combobox.model().item(i).text())
    checkbox.setChecked(combobox.model().item(i).checkState())
    combobox.setItemDelegateForColumn(i, checkbox)        
 
combobox.currentIndexChanged.connect(on_checkbox_changed)

在这里，我们定义了一个回调函数 on_checkbox_changed，每当复选框状态发生变化时，该函数就会被调用。函数会找到选中的项目，将其文本添加到当前选定对象的文本属性中。

接下来，我们为每个项目添加一个对应的复选框，并将其设置为已选中状态，以便您可以看到哪些项目已被选中。

最后，我们通过连接 QComboBox 的 currentIndexChanged 信号，告诉我们每当用户选择一个选项时，我们需要调用 on_checkbox_changed 函数。

完整代码

import sys
from PyQt5.QtWidgets import QApplication, QComboBox, QCheckBox, QStandardItemModel
 
 
def on_checkbox_changed():      
    selected_items = [str(combobox.model().item(i).text())
                      for i in range(combobox.count())
                      if combobox.model().item(i).checkState()]
    combobox.lineEdit().setText(", ".join(selected_items))
 
 
app = QApplication(sys.argv)
 
model = QStandardItemModel()
combobox = QComboBox()
 
for i in range(5):
    item = QStandardItem("Item {}".format(i+1))
    item.setCheckable(True)
    model.appendRow(item)
 
combobox.setModel(model)
 
for i in range(combobox.count()):
    checkbox = QCheckBox(combobox.model().item(i).text())
    checkbox.setChecked(combobox.model().item(i).checkState())
    combobox.setItemDelegateForColumn(i, checkbox)        
 
combobox.currentIndexChanged.connect(on_checkbox_changed)
 
combobox.show()
 
sys.exit(app.exec_())

总结

在本教程中，我们介绍了如何在 PyQt5 中创建一个 “带有可检查项目的组合框”。我们使用 QStandardItemModel 创建一个可检查项目列表，并将其附加到 QComboBox 中。我们添加了一个回调函数，用于检测选中的项目，并将其添加到当前选定对象的文本属性中。最后，我们通过连接 currentIndexChanged 信号，告诉 PyQt5 每当用户选择一个选项时，需要调用 on_checkbox_changed 函数。