如何在自定义QStyledItemDelegate.paint()中设置复选框指示器宽度或背景色

问题描述 #

我有一个QTableView，为部分列自定义了QStyledItemDelegate，用于显示居中的复选框。功能正常，但复选框的指示器（即边框）过细，在背景下难以辨认。我希望调粗指示器，若无法实现，设置背景色使其与背景区分度更高也可以。我在delegate、qstyle、qpalette、qrect的相关内容中感到困惑，希望得到帮助。

以下是我的代码：

def paint(self,
          painter: QtGui.QPainter,
          option: QtWidgets.QStyleOptionViewItem,
          proxy_index: QtCore.QModelIndex):
    self.initStyleOption(option, proxy_index)

    option = QtWidgets.QStyleOptionViewItem(option)
    widget = option.widget
    style = widget.style() if widget else QtWidgets.QApplication.style()
    style.drawPrimitive(
        style.PE_PanelItemViewItem,
        option,
        painter,
        option.widget
    )

    rect = style.subElementRect(
        QtWidgets.QStyle.SE_CheckBoxIndicator,
        option,
        widget=option.widget
    )

    option.rect = style.alignedRect(
        option.direction,
        Qt.AlignCenter,
        rect.size(),
        option.rect
    )

    proxy_model = proxy_index.model()
    source_model = proxy_model.sourceModel()
    source_index = proxy_model.mapToSource(proxy_index)

    item = source_model.itemFromIndex(source_index)
    option.state = style.State_On if item.checked else style.State_Off

    style.drawPrimitive(
        style.PE_IndicatorItemViewItemCheck,
        option,
        painter,
        widget=option.widget
    )

我查阅了上述相关文档，但未找到明确解决方案。我还尝试设置QTableView的样式表为QCheckbox::indicator {border: 1px solid <some color>;}，但没有效果。

解决方案 #

方案一：调粗复选框指示器边框 #

你当前用PE_IndicatorItemViewItemCheck绘制的是视图项专属的复选框元素，并非普通QCheckBox控件，因此直接给QCheckBox写样式表无效。要调粗边框，可在绘制指示器前修改画笔参数：

修改paint方法中绘制指示器的代码段：

# 保存画笔状态，避免影响其他绘制
painter.save()
# 设置2px宽的深灰色边框，颜色和宽度可按需调整
painter.setPen(QtGui.QPen(QtGui.QColor("#333333"), 2))
style.drawPrimitive(
    style.PE_IndicatorItemViewItemCheck,
    option,
    painter,
    widget=option.widget
)
# 恢复原画笔状态
painter.restore()

方案二：添加背景色提升辨识度 #

如果调粗边框仍达不到预期，可给复选框区域绘制背景矩形，增强区分度：

在计算好option.rect（居中后的复选框区域）后，先绘制背景：

# 绘制背景矩形
painter.save()
# 浅灰色背景，adjusted方法给复选框留出边距，颜色可自定义
painter.fillRect(option.rect.adjusted(-2, -2, 2, 2), QtGui.QColor("#f0f0f0"))
painter.restore()

# 后续绘制指示器的代码保持不变
proxy_model = proxy_index.model()
source_model = proxy_model.sourceModel()
source_index = proxy_model.mapToSource(proxy_index)

item = source_model.itemFromIndex(source_index)
option.state = style.State_On if item.checked else style.State_Off

style.drawPrimitive(
    style.PE_IndicatorItemViewItemCheck,
    option,
    painter,
    widget=option.widget
)

关键说明 #

• 样式表无效原因：PE_IndicatorItemViewItemCheck属于QStyle的视图项原生元素，不是独立的QCheckBox控件，因此针对QCheckBox的样式规则不会作用于它。
• 进阶自定义：若需要更个性化的复选框样式，可完全脱离QStyle的drawPrimitive，直接用painter绘制矩形、对勾等元素，实现完全自定义的外观。

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