QStyledItemDelegate：如何添加禁用状态的复选框指示器

嘿，好问题！其实你完全可以在initStyleOption方法内实现复选框禁用且保持勾选可见的效果，不一定非要重写paint()——具体怎么选，取决于你是否希望项的文本等其他内容保持正常状态。

场景1：接受整个项（文本+复选框）变灰 #

如果不介意禁用复选框时，项的文本也随之变灰，那直接修改option.state就搞定了，完全不用碰paint()。修改后的代码如下：

def initStyleOption(self, option, index):
    super().initStyleOption(option, index)
    option.features |= QtWidgets.QStyleOptionViewItem.HasCheckIndicator
    # 先确保复选框处于勾选状态（按你的需求来）
    option.state |= QtWidgets.QStyle.State_Checked
    if index.data(MyItem.ROLE_OPTIONAL):
        # 移除启用状态，这样复选框会显示为灰色勾选，且无法点击切换
        option.state &= ~QtWidgets.QStyle.State_Enabled

这么改之后，符合条件的项会整体变灰，复选框呈现禁用的勾选状态，而且用户点不动它，完美匹配你“可见、已勾选、禁用”的要求。

场景2：仅禁用复选框，文本保持正常 #

如果你希望项的文本依然正常显示（甚至可交互），只让复选框呈现禁用的勾选状态，那就要重写paint()方法，单独绘制复选框了。代码示例如下：

class MyDelegate(QtWidgets.QStyledItemDelegate):
    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)

    def initStyleOption(self, option, index):
        super().initStyleOption(option, index)
        option.features |= QtWidgets.QStyleOptionViewItem.HasCheckIndicator
        # 这里不用改state，留到paint里单独处理复选框

    def paint(self, painter, option, index):
        # 先绘制项的文本等内容（临时移除复选框特征，避免默认绘制）
        temp_option = QtWidgets.QStyleOptionViewItem(option)
        temp_option.features &= ~QtWidgets.QStyleOptionViewItem.HasCheckIndicator
        super().paint(painter, temp_option, index)

        # 单独绘制禁用的勾选复选框
        if index.data(MyItem.ROLE_OPTIONAL):
            # 计算复选框的位置，和默认位置对齐
            check_rect = QtWidgets.QApplication.style().subElementRect(
                QtWidgets.QStyle.SE_ItemViewItemCheckIndicator, option, None
            )
            # 创建复选框的样式选项
            check_option = QtWidgets.QStyleOptionButton()
            check_option.rect = check_rect
            # 设置为勾选+禁用状态
            check_option.state |= QtWidgets.QStyle.State_Checked
            check_option.state &= ~QtWidgets.QStyle.State_Enabled
            # 调用系统样式绘制复选框
            QtWidgets.QApplication.style().drawControl(
                QtWidgets.QStyle.CE_CheckBox, check_option, painter
            )

这种方式下，项的文本部分和正常项一样，只有复选框是禁用的勾选状态，完全满足“仅复选框禁用”的需求。

小补充 #

• 如果你需要的是复选框不能点击，但外观和正常勾选一样（不显示灰色），那还得额外调整，但根据你的描述，应该是要显示禁用状态，所以上面两种方式都适用。
• 记得确认MyItem.ROLE_OPTIONAL返回的数据是正确的——比如当需要禁用复选框时返回True。

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