Qt 6.2.2中QStyledItemDelegate无法在QTableView单元格显示QSpinBox

问题描述 #

在Qt 6.2.2环境下尝试将QSpinBox嵌入QTableView单元格，但自定义的QStyledItemDelegate完全未生效：单元格未显示QSpinBox，且通过qDebug输出确认代理的所有成员函数均未执行。

核心问题分析 #

1. 单元格无编辑权限：默认QAbstractTableModel的flags()函数仅返回Qt::ItemIsSelectable | Qt::ItemIsEnabled，未包含Qt::ItemIsEditable，导致QTableView判定单元格不可编辑，不会触发代理的编辑相关函数。
2. 模型未支持编辑逻辑：原模型未实现setData()函数，且data()未处理Qt::EditRole，即使进入编辑状态也无法正确读取初始值和保存修改。
3. 无实际数据存储容器：原模型仅在data()中返回行号，没有持久化数据的容器，编辑后的数据无法保存。

修复步骤 #

1. 修改数据模型（TestTableModel） #

• 添加flags()函数，赋予单元格可编辑权限
• 实现setData()函数，处理数据更新并通知视图
• 在data()中兼容Qt::EditRole，确保编辑时能读取初始值
• 添加数据存储容器，持久化单元格数据

2. 验证代理触发 #

修复模型后，双击单元格即可触发代理的createEditor()等函数，显示QSpinBox进行编辑。如果需要单元格始终显示QSpinBox（而非仅编辑状态），需额外重写代理的paint()和sizeHint()函数。

修改后的完整代码 #

testtablemodel.h #

#ifndef TESTTABLEMODEL_H
#define TESTTABLEMODEL_H

#include <QAbstractTableModel>
#include <QList>

class TestTableModel : public QAbstractTableModel
{
    Q_OBJECT
public:
    explicit TestTableModel(QObject *parent = nullptr);

protected:
    int rowCount(const QModelIndex &parent) const override;
    int columnCount(const QModelIndex &parent) const override;
    QVariant headerData(int section, Qt::Orientation orientation, int role) const override;
    QVariant data(const QModelIndex &index, int role) const override;
    Qt::ItemFlags flags(const QModelIndex &index) const override;
    bool setData(const QModelIndex &index, const QVariant &value, int role = Qt::EditRole) override;

private:
    QList<QList<int>> m_data; // 存储单元格数据
};

#endif // TESTTABLEMODEL_H

testtablemodel.cpp #

#include "testtablemodel.h"

TestTableModel::TestTableModel(QObject *parent) : QAbstractTableModel(parent)
{
    // 初始化5行5列数据，默认值为行号
    m_data.resize(5);
    for (int row = 0; row < 5; ++row) {
        m_data[row].resize(5);
        for (int col = 0; col < 5; ++col) {
            m_data[row][col] = row;
        }
    }
}

int TestTableModel::rowCount(const QModelIndex &parent) const
{
    if (parent.isValid())
        return 0;
    return m_data.size();
}

int TestTableModel::columnCount(const QModelIndex &parent) const
{
    if (parent.isValid() || m_data.isEmpty())
        return 0;
    return m_data.first().size();
}

QVariant TestTableModel::headerData(int section, Qt::Orientation orientation, int role) const
{
    if (role == Qt::DisplayRole)
    {
        if (orientation == Qt::Horizontal)
            return QStringLiteral("Field %1").arg(section);
        else if (orientation == Qt::Vertical)
            return section + 1;
    }
    return QVariant();
}

QVariant TestTableModel::data(const QModelIndex &index, int role) const
{
    if (!index.isValid())
        return QVariant();

    if (role == Qt::DisplayRole || role == Qt::EditRole)
    {
        return m_data[index.row()][index.column()];
    }
    else if (role == Qt::TextAlignmentRole)
    {
        return Qt::AlignCenter;
    }
    return QVariant();
}

Qt::ItemFlags TestTableModel::flags(const QModelIndex &index) const
{
    if (!index.isValid())
        return Qt::NoItemFlags;
    // 添加可编辑权限
    return QAbstractTableModel::flags(index) | Qt::ItemIsEditable;
}

bool TestTableModel::setData(const QModelIndex &index, const QVariant &value, int role)
{
    if (!index.isValid() || role != Qt::EditRole)
        return false;

    int intValue = value.toInt();
    if (m_data[index.row()][index.column()] == intValue)
        return true;

    m_data[index.row()][index.column()] = intValue;
    // 通知视图数据已更新
    emit dataChanged(index, index, {role});
    return true;
}

（可选）让单元格始终显示QSpinBox #

如果需要单元格无需双击，直接显示QSpinBox样式，修改代理类：

testtabledelegate.h 添加函数声明

void paint(QPainter *painter, const QStyleOptionViewItem &option, const QModelIndex &index) const override;
QSize sizeHint(const QStyleOptionViewItem &option, const QModelIndex &index) const override;

testtabledelegate.cpp 实现函数

#include <QStyle>
#include <QApplication>

void TestTableDelegate::paint(QPainter *painter, const QStyleOptionViewItem &option, const QModelIndex &index) const
{
    QSpinBox spinBox;
    spinBox.setFrame(false);
    spinBox.setMinimum(0);
    spinBox.setMaximum(10000);
    spinBox.setValue(index.data(Qt::EditRole).toInt());

    QStyleOptionSpinBox spinBoxOption;
    spinBoxOption.rect = option.rect;
    spinBoxOption.state = option.state;
    // 若需要直接点击编辑，去掉下面一行的注释
    // spinBoxOption.state |= QStyle::State_Enabled;

    QApplication::style()->drawComplexControl(QStyle::CC_SpinBox, &spinBoxOption, painter, &spinBox);
}

QSize TestTableDelegate::sizeHint(const QStyleOptionViewItem &option, const QModelIndex &index) const
{
    QSpinBox spinBox;
    return spinBox.sizeHint();
}

验证效果 #

修复后：

• 双击单元格会弹出QSpinBox进行编辑
• 修改数值后，数据会保存到模型中，视图同步更新
• 若添加了paint()和sizeHint()，单元格会始终显示QSpinBox样式

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