QComboBox与QStyledItemDelegate高亮颜色异常的解决方案咨询

引用Qt 5.15文档内容：我们推荐创建新代理时使用QStyledItemDelegate。

在测试场景中：

• 当DELEGATE_CHOICE = 0（不为QComboBox设置代理）时，组合框弹出列表项的鼠标悬停高亮为默认深蓝色：
  
• 当DELEGATE_CHOICE = 3（使用QItemDelegate子类作为代理）时，高亮效果与无代理时一致。
• 但当DELEGATE_CHOICE = 1（使用QStyledItemDelegate子类作为代理）时，悬停高亮变为浅蓝色，不符合默认样式需求：
  

问题解答 #

能否使用QStyledItemDelegate且保留默认高亮？ #

可以实现。原因是QComboBox默认使用QItemDelegate作为项代理，而QStyledItemDelegate的样式逻辑与前者不同，导致高亮样式变化。解决方式是重写QStyledItemDelegate的paint方法，复用QComboBox的样式来绘制高亮项。

修改后的代理类代码：

class SubDelegate(QStyledItemDelegate):
    def paint(self, painter, option, index):
        # 检测悬停或选中状态，复用QComboBox的样式绘制高亮背景
        if option.state & (QStyle.State_MouseOver | QStyle.State_Selected):
            combo_style = self.parent().style()
            combo_style.drawPrimitive(QStyle.PE_PanelItemViewItem, option, painter, self.parent())
        # 调用父类方法完成文本绘制
        super().paint(painter, option, index)

QItemDelegate是否是QComboBox的适配基类？ #

QComboBox默认确实使用QItemDelegate作为其项代理，这也是直接替换为QStyledItemDelegate会改变样式的核心原因。如果不需要复杂自定义样式，直接使用QItemDelegate子类就能保持默认效果；若想遵循文档推荐使用QStyledItemDelegate，则需要通过上述重写paint方法的方式适配样式。

如何提前知晓这一细节？ #

可以通过打印comboBox.itemDelegate()查看默认代理类型，也可以查阅Qt官方文档中QComboBox的itemDelegate相关说明，了解其默认实现逻辑。

修改后的完整示例代码 #

import sys
from PyQt5.QtCore import Qt
from PyQt5.QtGui import QPainter
from PyQt5.QtWidgets import (QApplication, QWidget, QComboBox, QVBoxLayout,
                             QStyle, QStyledItemDelegate, QItemDelegate)

class SubComboBox(QComboBox):
    def __init__(self, parent=None):
        super().__init__(parent)
        self.setStyleSheet("text-align:left;")

DELEGATE_CHOICE = 1   # 0 # 1 # 2 # 3

if DELEGATE_CHOICE == 1:
    class SubDelegate(QStyledItemDelegate):
        def paint(self, painter, option, index):
            # 复用QComboBox的样式绘制高亮背景
            if option.state & (QStyle.State_MouseOver | QStyle.State_Selected):
                combo_style = self.parent().style()
                combo_style.drawPrimitive(QStyle.PE_PanelItemViewItem, option, painter, self.parent())
            super().paint(painter, option, index)

elif DELEGATE_CHOICE == 2:
    class SubDelegate(QAbstractItemDelegate): 
        pass

elif DELEGATE_CHOICE == 3:
    class SubDelegate(QItemDelegate): 
        pass

class ComboBoxExample(QWidget):
    def __init__(self):
        super().__init__()

        self.setWindowTitle('ComboBox Example')
        self.setGeometry(100, 100, 200, 100)

        self.comboBox = SubComboBox(self)
        if DELEGATE_CHOICE > 0:
            self.comboBox.setItemDelegate(SubDelegate(self))

        data = [100, 200, 330, 400, 550]
        for num in data:
            self.comboBox.addItem(str(num))

        layout = QVBoxLayout()
        layout.addWidget(self.comboBox)
        layout.addStretch(1)
        self.setLayout(layout)

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

内容的提问来源于stack exchange，提问作者sdbbs