PyQt6 优化操作：下拉列表框 QcomboBox 支持多选(含全选项)

abigailqin2017

已于 2024-04-25 18:11:20 修改

阅读量2.7k

点赞数 30

分类专栏： PyQt 文章标签： python pyqt

于 2024-02-06 10:57:44 首次发布

本文链接：https://blog.csdn.net/weixin_40134371/article/details/136052294

版权

PyQt 专栏收录该内容

11 篇文章 1 订阅

订阅专栏

1. 效果展示

<全选>

<取消全选>

<选中部分内容>

2. 知识点

1. Model/View

Model-View-Controller （Model-View-Controller, MVC）是一种源自Smalltalk的设计模式，经常用于构建用户界面；如果 View 和 Controller 对象被组合，结果就是 Model/View 架构。Model负责提供数据，而View负责展示数据，这种分离使得可以在多个不同的View中显示相同的数据，或实现新的View类型，而无需更改底层数据结构。关于Model/View的更多信息可参考下方<参考链接-1>。

2. QComboBox

QComboBox 中的 model 是一个数据模型，它用于存储和管理下拉列表框中的选项数据。在 PyQt 中，QComboBox 的 model 通常是一个 QStandardItemModel 对象，它可以通过 addItem()、addItems()、insertItem()、removeItem() 等方法来添加、删除和修改选项数据。

QComboBox 中的 view 是一个视图，它用于显示下拉列表框中的选项数据。在 PyQt 中，QComboBox 的 view 通常是一个 QListView 对象，它可以通过 setView() 方法来设置。

官方文档：

QComboBox — PyQt Documentation v6.6.0

QAbstractItemModel — PyQt Documentation v6.6.0

3. 代码部分

import sys
from PyQt6.QtWidgets import QComboBox, QMainWindow, QApplication, QToolTip, QLineEdit
from PyQt6.QtCore import Qt
from PyQt6.QtGui import QFont


class CheckableComboBox(QComboBox):
    def __init__(self, parent=None):
        super(CheckableComboBox, self).__init__(parent)
        QToolTip.setFont(QFont('Times New Roman', 15))  # 设置提示框字体和字号
        self.setLineEdit(QLineEdit())
        self.lineEdit().setReadOnly(True)
        self.view().clicked.connect(self.selectItemAction)
        self.addCheckableItem('全选')
        self.SelectAllStatus = 1

    def addCheckableItem(self, text):
        super().addItem(text)
        item = self.model().item(self.count() - 1, 0)
        item.setFlags(Qt.ItemFlag.ItemIsUserCheckable | Qt.ItemFlag.ItemIsEnabled)
        item.setCheckState(Qt.CheckState.Unchecked)
        item.setToolTip(text)

    def addCheckableItems(self, texts):
        for text in texts:
            self.addCheckableItem(text)

    def ifChecked(self, index):
        item = self.model().item(index, 0)
        return item.checkState() == Qt.CheckState.Checked

    def checkedItems(self):
        return [self.itemText(i) for i in range(self.count()) if self.ifChecked(i)]

    def checkedItemsStr(self):
        return ';'.join(self.checkedItems()).strip('全选').strip(';')

    def showPopup(self):
        self.view().setMinimumWidth(3*self.width()//2)   # 下拉列表宽度加大
        self.view().setMaximumHeight(200)                # 最大高度为200
        super().showPopup()

    def selectItemAction(self, index):
        if index.row() == 0:
            for i in range(self.model().rowCount()):
                if self.SelectAllStatus:
                    self.model().item(i).setCheckState(Qt.CheckState.Checked)
                else:
                    self.model().item(i).setCheckState(Qt.CheckState.Unchecked)
            self.SelectAllStatus = (self.SelectAllStatus + 1) % 2

        self.lineEdit().clear()
        self.lineEdit().setText(self.checkedItemsStr())

    def clear(self) -> None:
        super().clear()
        self.addCheckableItem('全选')

    def select_all(self):
        for i in range(self.model().rowCount()):
            self.model().item(i).setCheckState(Qt.CheckState.Checked)
        self.lineEdit().setText(self.checkedItemsStr())


class Ui_Study(QMainWindow):
    def __init__(self):
        super().__init__()
        self.resize(500, 500)
        self.setMinimumSize(500, 500)

        self.combobox = CheckableComboBox(self)
        self.combobox.move(20, 20)
        self.combobox.resize(200, 30)

        self.line_edit = QLineEdit(self)
        self.line_edit.move(20, 80)
        self.line_edit.resize(300, 30)

        self.combobox.addCheckableItems(['sdsfdsf', 'hgjghj', 'reyeyey'])
        self.combobox.setCurrentIndex(-1)
        self.combobox.lineEdit().textChanged.connect(lambda: self.line_edit.setText(self.combobox.checkedItemsStr()))

        self.show()


if __name__ == '__main__':
    app = QApplication(sys.argv)
    my_ui = Ui_Study()
    a = my_ui.combobox
    sys.exit(app.exec())

部分细节优化点说明：

1. 通过setToolTip，给每个项目增加一个提示框，鼠标经过时显示其内容;

2. 重写showPopup函数，让下拉框宽度大于控件原本宽度，可以显示更多内容;

优化前（ComboBox宽度不够，例子略极端哈）

优化后

3. self.combobox.setCurrentIndex(-1)，让选项框中不显示任何内容（默认会显示第一项）;