PyQt6中QTableView绑定QSqlRelationalTableModel时如何为列添加复选框

问题根因 #

你的代码存在5个核心问题导致复选框无法正常工作：

• 构造函数调用错误：自定义委托继承自QSqlRelationalDelegate，但初始化时调用的是QStyledItemDelegate的构造方法，父类关联的SQL模型相关逻辑未正确初始化
• 复选框属性设置无效：checkbox.setCheckable未加括号执行方法，实际没有开启控件的可勾选属性
• 数据双向绑定缺失：直接复用父类的setEditorData/setModelData默认实现，父类逻辑无法识别QCheckBox控件，既不能把模型存储的0/1值同步为复选框勾选状态，也不能把用户勾选后的状态写回模型
• 静态渲染缺失：paint方法完全走父类默认逻辑，单元格未进入编辑状态时只会显示原始字段值，不会渲染复选框样式
• 日期控件逻辑不全：QDateEdit未做数据绑定，用户选择日期后无法同步回数据库模型

可直接复用的修正代码 #

from PyQt5.QtSql import QSqlRelationalDelegate
from PyQt5.QtWidgets import QDateEdit, QCheckBox, QStyle, QStyleOptionButton, QApplication, QAbstractItemView
from PyQt5.QtCore import Qt, QDate

class myQSqlRelationalDelegate(QSqlRelationalDelegate):
    def __init__(self, parent=None):
        # 修复：正确初始化父类
        super().__init__(parent)

    def paint(self, painter, option, index):
        # 第6列非编辑状态下手动绘制复选框
        if index.column() == 6:
            # 绘制单元格选中/默认背景
            if option.state & QStyle.State_Selected:
                painter.fillRect(option.rect, option.palette.highlight())
            # 计算复选框居中坐标
            check_opt = QStyleOptionButton()
            check_rect = QApplication.style().subElementRect(
                QStyle.SE_CheckBoxIndicator, check_opt, None
            )
            check_rect.moveCenter(option.rect.center())
            check_opt.rect = check_rect
            # 同步当前数据状态
            val = index.model().data(index, Qt.EditRole)
            check_opt.state = QStyle.State_Enabled | (QStyle.State_On if bool(val) else QStyle.State_Off)
            # 绘制复选框
            QApplication.style().drawControl(QStyle.CE_CheckBox, check_opt, painter)
            return
        # 其余列使用默认绘制逻辑
        super().paint(painter, option, index)    

    def createEditor(self, parent, option, index):
        # 第1列创建带日历弹窗的日期选择器
        if index.column() == 1:
            date_edit = QDateEdit(parent)
            date_edit.setCalendarPopup(True)
            date_edit.setDisplayFormat("yyyy-MM-dd")
            return date_edit
        # 第6列创建复选框控件
        if index.column() == 6:
            checkbox = QCheckBox(parent)
            checkbox.setCheckable(True)
            return checkbox
        # 其余列使用默认编辑器
        return super().createEditor(parent, option, index)        

    def setEditorData(self, editor, index):
        col = index.column()
        # 日期列：将模型存储的日期同步到控件
        if col == 1:
            model_val = index.model().data(index, Qt.EditRole)
            if isinstance(model_val, QDate):
                editor.setDate(model_val)
            return
        # 复选框列：将模型存储的布尔值同步到勾选状态
        if col == 6:
            model_val = index.model().data(index, Qt.EditRole)
            editor.setChecked(bool(model_val))
            return
        # 其余列使用默认数据同步逻辑
        super().setEditorData(editor, index)

    def setModelData(self, editor, model, index):
        col = index.column()
        # 日期列：把控件选择的日期写回模型
        if col == 1:
            model.setData(index, editor.date(), Qt.EditRole)
            return
        # 复选框列：把控件勾选状态写回模型
        if col == 6:
            model.setData(index, 1 if editor.isChecked() else 0, Qt.EditRole)
            return
        # 其余列使用默认数据写回逻辑
        super().setModelData(editor, model, index)      

    def updateEditorGeometry(self, editor, option, index):
        # 复选框列：把控件居中放置在单元格内
        if index.column() == 6:
            editor.setGeometry(
                option.rect.center().x() - editor.sizeHint().width()//2,
                option.rect.center().y() - editor.sizeHint().height()//2,
                editor.sizeHint().width(),
                editor.sizeHint().height()
            )
            return
        # 其余列使用默认布局逻辑
        super().updateEditorGeometry(editor, option, index)

配套配置建议 #

• 确保数据库第6列对应字段为整型类型，存储值为0（未勾选）/1（勾选），避免类型不匹配导致同步失败
• 如果需要单击即可切换复选框状态，无需双击进入编辑，可给表格控件添加如下配置：

  tableView.setEditTriggers(
      QAbstractItemView.SelectedClicked | QAbstractItemView.CurrentChanged
  )
  

• 原代码中widget.setStyleSheet(style)引用的style变量需定义在委托可访问的作用域内，否则日期控件样式设置会抛出未定义错误。

运行效果截图

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