Qt TableView单元格CheckBox带标签显示问题求助

我需要在Qt TableView的单元格中显示带有标签的CheckBox，但当前代码仅显示CheckBox的状态值（0/1）而非标签。我已创建了自定义Delegate和Model，以下是完整代码：

table_view_delegate.h #

#include <QObject>
#include <QStyledItemDelegate>
#include "QSpinBox"
#include "QDoubleSpinBox"
#include "QCheckBox"
#include "QApplication"
#include "QStyle"
class table_view_delegate : public QStyledItemDelegate
{
    Q_OBJECT
public:
     table_view_delegate(QObject *parent = nullptr);
     QWidget *createEditor(QWidget *parent, const QStyleOptionViewItem &option, const QModelIndex &index) const override;
     void setEditorData(QWidget *editor, const QModelIndex &index) const override;
     void setModelData(QWidget *editor, QAbstractItemModel *model,  const QModelIndex &index) const override;
     void updateEditorGeometry(QWidget *editor, const QStyleOptionViewItem &option, const QModelIndex &index) const override;
     void paint(QPainter *painter, const QStyleOptionViewItem &option, const QModelIndex &index) const override;


signals:

};

table_view_delegate.cpp #

#include "table_view_delegate.h"
#include "QMouseEvent"
#include "QAbstractItemModel"
#include "QCheckBox"
#include "QSpinBox"

table_view_delegate::table_view_delegate(QObject *parent)  : QStyledItemDelegate{parent}
{

}

QWidget *table_view_delegate::createEditor(QWidget *parent, const QStyleOptionViewItem & option , const QModelIndex & index ) const
{
    int c= index.column();
    if(c == 0 ){
         QCheckBox* check = new QCheckBox("Lable",parent);
         return check;
    }
    else  if(c == 1 ){
        QSpinBox *editor = new QSpinBox(parent);
        return editor;
    }
    else {
        return NULL;
    }

}

void table_view_delegate::setEditorData(QWidget *editor, const QModelIndex &index) const
{
    int c= index.column();
   if(c == 0 ){
        int value = index.model()->data(index, Qt::CheckStateRole).toInt();
        QCheckBox* check = static_cast<QCheckBox*>(editor);
        if(value==0)
            check->setChecked(false);
        else
            check->setChecked(true);

        check->setText("test");
    }
    else if(c==1){
       QString val_str = index.model()->data(index, Qt::EditRole).toString();
       float value = val_str.toFloat();
       QDoubleSpinBox *spinBox = static_cast<QDoubleSpinBox*>(editor);
       spinBox->setValue(value);
   }

}

void table_view_delegate::setModelData(QWidget *editor, QAbstractItemModel *model,  const QModelIndex &index) const
{
    int c= index.column();
    if(c == 0 ){
        QCheckBox* check = static_cast<QCheckBox*>(editor);
        check->setText("test");
        QString value =QString::number(check->isChecked());//check->isChecked();
        model->setData(index, value, Qt::EditRole);

    }
    else if(c ==1){
        QDoubleSpinBox *spinBox = static_cast<QDoubleSpinBox*>(editor);
        spinBox->interpretText();
        QString value = QString::number(spinBox->value(), 'f', 2);
        model->setData(index, value, Qt::EditRole);
    }

}

void table_view_delegate::updateEditorGeometry(QWidget *editor, const QStyleOptionViewItem &option,  const QModelIndex &/* index */) const
{
    editor->setGeometry(option.rect);
}

void table_view_delegate::paint(QPainter *painter, const QStyleOptionViewItem &option, const QModelIndex &index) const
{

    QStyledItemDelegate::paint(painter, option, index);
}

table_view_model.h #

#include <QObject>
#include <QAbstractTableModel>

class table_view_model : public QAbstractTableModel
{
    Q_OBJECT
public:
    explicit table_view_model(QObject *parent = nullptr);
    int rowCount(const QModelIndex &parent = QModelIndex()) const override;
    int columnCount(const QModelIndex &parent = QModelIndex()) const override;
    QVariant data(const QModelIndex &index, int role = Qt::DisplayRole) const override;
    bool setData(const QModelIndex &index, const QVariant &value, int role = Qt::EditRole) override;
    Qt::ItemFlags flags(const QModelIndex &index) const override;
    void setDataList(QList <QStringList> alog_data_list);
    QVariant headerData(int section, Qt::Orientation ,   int role) const override;

private:
    QList <QStringList> model_data_list;
    int col_count = 3;
    QStringList header={"CheckBox","SpinBox","String"};

signals:

};

table_view_model.cpp #

#include "table_view_model.h"

table_view_model::table_view_model(QObject *parent) : QAbstractTableModel{parent}
{

}

int table_view_model::rowCount(const QModelIndex & /*parent*/) const
{
   return model_data_list.length();
}

int table_view_model::columnCount(const QModelIndex & /*parent*/) const
{
    return col_count;
}

QVariant table_view_model::data(const QModelIndex &index, int role) const
{
    int r = index.row();
    int c = index.column();

    if(model_data_list.length()==0)
           return QVariant();

     if (!index.isValid())
           return QVariant();

     if( c==0){
         if (role == Qt::CheckStateRole&& c==0 ){
            int checked = model_data_list[r][c].toInt();
            if (checked)
                return Qt::Checked;
            else
               return Qt::Unchecked;
        }
        else if(role == Qt::EditRole){
              return  model_data_list[r][c];
         }
        else if (role == Qt::DisplayRole)
              return  model_data_list[r][c];

     }
     else{
       if (role == Qt::DisplayRole)
            return  model_data_list[r][c];
     }

      return QVariant();

}


bool table_view_model::setData(const QModelIndex &index, const QVariant &value, int role)
{
     int c=index.column();
     if(  c==1){
            if (role == Qt::EditRole) {
                if (!checkIndex(index))
                    return false;
                return true;
            }

    }
    else if (role == Qt::CheckStateRole&&c==0)
    {

         model_data_list[index.row()][index.column()] = value.toString();

         if ((Qt::CheckState)value.toInt() == Qt::Checked)
         {
             //user has checked item
             return true;
         }
         else
         {
             //user has unchecked item
             return true;
         }

    }
    return false;
}

void table_view_model::setDataList(QList <QStringList> model_data_listTmp){
    table_view_model::beginResetModel();

    model_data_list.clear();
    for(int i=0;i<model_data_listTmp.length();i++){
        model_data_list.push_back(model_data_listTmp[i]);
    }

    table_view_model::endResetModel();
}


Qt::ItemFlags table_view_model::flags(const QModelIndex &index) const
{
    int c=index.column();
    //Editable column
    if(c==1)
        return Qt::ItemIsEditable | QAbstractTableModel::flags(index);
    else if(c==0)
       return Qt::ItemIsUserCheckable | QAbstractTableModel::flags(index);
    else
        return QAbstractTableModel::flags(index);
}

QVariant table_view_model::headerData(int section, Qt::Orientation orientation,   int role) const
{
    if (role != Qt::DisplayRole){
        return QVariant();
    }
    if (orientation == Qt::Horizontal)
            return header.at(section);
        else
            return QString::number(section);

}

MainWindow.cpp初始化代码 #

table_view_model *model = new table_view_model();
    ui->tableView->setModel(model);
    ui->tableView->horizontalHeader()->setStretchLastSection(true);
    table_view_delegate *delgate = new table_view_delegate() ;
    ui->tableView->setItemDelegate(delgate);

    QList <QStringList> data_list;
    QStringList r1;
    r1.append("0");
    r1.append("100");
    r1.append("Str1");
    data_list.append(r1);

    QStringList r2;
    r2.append("1");
    r2.append("200");
    r2.append("Str2");
    data_list.append(r2);

     model->setDataList(data_list);

问题分析与解决方案 #

问题根源

1. Model的data方法中，列0的DisplayRole返回状态值（"0"/"1"），导致视图默认绘制时显示该值而非带标签的CheckBox。
2. Delegate仅在编辑状态下创建带标签的CheckBox，默认状态下依赖父类绘制逻辑，无法显示标签。

解决方案一：自定义Delegate绘制（推荐，无需编辑状态即可交互）

1. 修改Delegate，添加事件处理与自定义绘制

   • 在table_view_delegate.h中添加editorEvent重写声明：

     bool editorEvent(QEvent *event, QAbstractItemModel *model, const QStyleOptionViewItem &option, const QModelIndex &index) const override;
     

   • 在table_view_delegate.cpp中实现editorEvent处理点击切换状态：

     bool table_view_delegate::editorEvent(QEvent *event, QAbstractItemModel *model, const QStyleOptionViewItem &option, const QModelIndex &index) const
     {
         if (index.column() != 0)
             return QStyledItemDelegate::editorEvent(event, model, option, index);
     
         if (event->type() == QEvent::MouseButtonRelease) {
             Qt::CheckState currentState = static_cast<Qt::CheckState>(model->data(index, Qt::CheckStateRole).toInt());
             Qt::CheckState newState = (currentState == Qt::Checked) ? Qt::Unchecked : Qt::Checked;
             return model->setData(index, newState, Qt::CheckStateRole);
         }
         return QStyledItemDelegate::editorEvent(event, model, option, index);
     }
     

   • 修改paint方法，绘制带标签的CheckBox：

     void table_view_delegate::paint(QPainter *painter, const QStyleOptionViewItem &option, const QModelIndex &index) const
     {
         if (index.column() != 0) {
             QStyledItemDelegate::paint(painter, option, index);
             return;
         }
     
         QStyleOptionButton checkBoxOption;
         checkBoxOption.rect = option.rect;
         checkBoxOption.state = option.state;
     
         Qt::CheckState checkState = static_cast<Qt::CheckState>(index.model()->data(index, Qt::CheckStateRole).toInt());
         checkBoxOption.state |= (checkState == Qt::Checked) ? QStyle::State_On : QStyle::State_Off;
     
         QApplication::style()->drawControl(QStyle::CE_CheckBox, &checkBoxOption, painter);
     
         // 标签文本可自定义，也可从Model的特定Role获取
         QString labelText = "test";
         QRect textRect = option.rect.adjusted(25, 0, 0, 0);
         painter->drawText(textRect, Qt::AlignVCenter, labelText);
     }
     

2. 修复Model的状态更新逻辑

   • 在table_view_model.cpp的setData方法中，添加数据变更通知：

     else if (role == Qt::CheckStateRole && c == 0)
     {
         model_data_list[index.row()][index.column()] = QString::number(static_cast<int>(value.value<Qt::CheckState>()));
         emit dataChanged(index, index); // 通知视图更新
         return true;
     }
     

   • 可选：修改Model的data方法，让列0的DisplayRole返回标签文本而非状态值：

     else if (role == Qt::DisplayRole)
         return "test"; // 可替换为自定义标签逻辑
     

解决方案二：持久化编辑器（简单但低效）

在MainWindow初始化时，为列0的所有单元格打开持久编辑器，让CheckBox始终显示：

for (int row = 0; row < model->rowCount(); ++row) {
    ui->tableView->openPersistentEditor(model->index(row, 0));
}

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