PyQt6中QListView当前选中项背景颜色设置方法咨询

针对Windows深色主题下QListView选中项辨识度低的问题，有两种实用解决方案：

方法一：使用Qt样式表（QSS） #

直接通过样式表强制覆盖系统默认样式，快速设置选中项的高亮效果，适合简单场景：

# 假设你的QListView实例名为list_view
list_view.setStyleSheet("""
QListView::item:selected {
    background-color: #ffcc00;  /* 替换为舞台显眼的颜色，比如亮黄色 */
    color: #000000;  /* 可选，设置文字颜色保证对比清晰 */
}
QListView::item:selected:active {
    background-color: #ffcc00;  /* 激活状态下保持一致，避免样式闪烁 */
}
""")

方法二：自定义Styled Item委托 #

如果需要更精细的绘制控制（比如渐变背景、边框效果），可以继承QStyledItemDelegate重写绘制逻辑：

from PyQt6.QtWidgets import QStyledItemDelegate, QStyleOptionViewItem
from PyQt6.QtGui import QPainter, QColor
from PyQt6.QtCore import Qt

class HighlightDelegate(QStyledItemDelegate):
    def paint(self, painter: QPainter, option: QStyleOptionViewItem, index):
        opt = QStyleOptionViewItem(option)
        self.initStyleOption(opt, index)
        
        # 判断项是否处于选中状态
        if opt.state & QStyle.State.State_Selected:
            painter.fillRect(opt.rect, QColor("#ffcc00"))
            opt.palette.setColor(opt.palette.ColorRole.Text, QColor("#000000"))
        
        super().paint(painter, opt, index)

# 给QListView绑定自定义委托
delegate = HighlightDelegate()
list_view.setItemDelegate(delegate)

注意事项 #

• 舞台使用建议选择高对比度配色（如亮黄+黑字、亮青+白字），确保灯光下清晰可见；
• 使用QSS时注意样式优先级，避免被其他全局样式覆盖；
• 测试时切换系统主题，验证自定义样式不受系统主题影响。

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