PySide6中如何在QTableView列内居中显示复选框代理

问题背景 #

早年基于PyQt 4.8/PySide 1.2.1实现的QTableView复选框代理，升级到PySide6后完全失效；找到的PyQt5版本代理因继承QItemDelegate，导致复选框显示尺寸过大；直接通过Qt.ItemIsUserCheckable标记列实现复选框时，无法让复选框在单元格内居中，必须借助代理完成居中需求。

自用解决方案 #

以下是基于QStyledItemDelegate实现的代理，适配PySide6，支持复选框居中显示，且在高分辨率屏幕下显示正常：

from PySide6.QtWidgets import QStyledItemDelegate, QStyleOptionButton, QStyle
from PySide6.QtCore import Qt, QEvent
from PySide6.QtGui import QPainter

class CenteredCheckBoxDelegate(QStyledItemDelegate):
    def paint(self, painter, option, index):
        # 仅处理带复选框标记的列
        if not (index.flags() & Qt.ItemIsUserCheckable):
            super().paint(painter, option, index)
            return

        # 获取当前复选框状态
        is_checked = index.data(Qt.CheckStateRole) == Qt.Checked

        # 构建复选框样式选项
        check_box_opt = QStyleOptionButton()
        # 计算复选框居中位置
        indicator_rect = option.style.subElementRect(QStyle.SE_CheckBoxIndicator, check_box_opt, None)
        indicator_rect.moveCenter(option.rect.center())
        check_box_opt.rect = indicator_rect
        check_box_opt.state = QStyle.State_Enabled | QStyle.State_Active
        
        # 设置选中/未选中状态
        if is_checked:
            check_box_opt.state |= QStyle.State_On
        else:
            check_box_opt.state |= QStyle.State_Off

        # 绘制复选框
        option.style.drawControl(QStyle.CE_CheckBox, check_box_opt, painter)

    def editorEvent(self, event, model, option, index):
        # 仅处理带复选框标记的列的交互
        if not (index.flags() & Qt.ItemIsUserCheckable):
            return super().editorEvent(event, model, option, index)

        # 响应左键点击切换复选框状态
        if event.type() == QEvent.MouseButtonRelease and event.button() == Qt.LeftButton:
            current_state = index.data(Qt.CheckStateRole)
            new_state = Qt.Unchecked if current_state == Qt.Checked else Qt.Checked
            model.setData(index, new_state, Qt.CheckStateRole)
            return True
        
        return super().editorEvent(event, model, option, index)

使用方式 #

1. 给目标列绑定代理：

# 假设table_view是你的QTableView实例，column_index是要设置复选框的列序号
table_view.setItemDelegateForColumn(column_index, CenteredCheckBoxDelegate())

2. 确保模型中对应列的项设置了Qt.ItemIsUserCheckable标志，并且初始化Qt.CheckStateRole的数据（比如默认Qt.Unchecked）。

方案优势 #

• 基于QStyledItemDelegate实现，继承原生样式系统，适配高分辨率屏幕，不会出现复选框尺寸异常问题
• 通过计算单元格中心位置，确保复选框完全居中
• 保留原生复选框的交互逻辑与视觉风格，和系统UI统一

欢迎提出更优实现方案。

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