如何在QTableView中实现指定行单元格内容的选择性缩进

基于继承QAbstractTableModel的自定义模型实现QTableView功能时，需要根据指定参数对表格部分行的单元格文本做缩进处理，具体场景约束如下：

• 表格共2列，分别展示变量名称（Name）、变量值（Value），仅对名称列做缩进处理
• 待展示数据为Variable类实例，每个实例携带IndentParameter参数，取值仅为0/1/2：
  • 取值0：无缩进、无特殊背景
  • 取值1：文本缩进1级，单元格背景为青色
  • 取值2：文本缩进2级，单元格背景为绿色
• 已在模型data()方法中实现背景色逻辑，此前尝试直接给名称字符串前加空格实现缩进，但会破坏依赖原始变量名的其他业务逻辑，需要基于Qt模型/视图架构的无侵入实现方案。

Variable类定义如下：

class Variable
{
public:
    Variable();
    ~Variable();
    
    QString getName() const;
    void setName(const QString newName);

    int getIndentParamater() const;
    void setIndentParamater(const int newInt);

    int getValue() const;
    void setValue(const int newValue);
    
private:
    QString m_name;
    int m_IndentParamater;
    int m_value;
};

已实现的背景色逻辑片段：

QVariant VariableModel::data(const QModelIndex &index, int role) const
{
    if (role == Qt::BackgroundRole)
    {
        auto var = VariableList.at(index.row());
        if (var->getIndentParamater() == 1)
            return QBrush(Qt::cyan);
        if (var->getIndentParamater() == 2)
            return QBrush(Qt::green);
    }
    // 其余原有显示逻辑保留
}

变量名称列预期缩进效果

无需修改原始数据，无需改动模型返回的原始显示文本，通过自定义委托重写绘制逻辑即可实现无侵入的缩进效果，完全不影响依赖原始变量名的业务逻辑，实现步骤如下：

• 自定义名称列专属委托类，继承QStyledItemDelegate
• 重写委托的paint方法，绘制文本前根据缩进参数计算文本起始偏移量
• 将自定义委托仅绑定到名称列，变量值列保留默认委托即可

具体实现代码 #

1. 自定义委托头文件 variablenamedelegate.h #

#include <QStyledItemDelegate>

class VariableNameDelegate : public QStyledItemDelegate
{
    Q_OBJECT
public:
    explicit VariableNameDelegate(QObject *parent = nullptr);

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

2. 委托实现文件 variablenamedelegate.cpp #

#include "variablenamedelegate.h"
#include <QPainter>

// 单级缩进像素宽度，可根据UI显示效果自行调整
#define INDENT_STEP 20

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

void VariableNameDelegate::paint(QPainter *painter, const QStyleOptionViewItem &option, const QModelIndex &index) const
{
    // 保留原有样式绘制逻辑，自动处理背景色、选中态、hover态等效果
    QStyleOptionViewItem opt = option;
    initStyleOption(&opt, index);

    // 获取当前行缩进参数，二选一即可
    // 方式1：模型提前把缩进参数通过Qt::UserRole返回，直接读取
    int indentLevel = index.data(Qt::UserRole).toInt();
    // 方式2：直接从模型获取对应Variable对象读取参数
    // auto* model = qobject_cast<const VariableModel*>(index.model());
    // int indentLevel = model->getVariableByRow(index.row())->getIndentParamater();

    // 调整文本绘制区域，按缩进等级偏移起始位置
    opt.rect.adjust(indentLevel * INDENT_STEP, 0, 0, 0);

    // 调用基类方法完成最终绘制，原始变量名全程不做修改
    QStyledItemDelegate::paint(painter, opt, index);
}

3. 视图层绑定委托 #

在初始化QTableView的代码中，给名称列单独设置自定义委托：

// 假设名称列为第0列
ui->tableView->setItemDelegateForColumn(0, new VariableNameDelegate(this));

补充说明 #

• 该方案不会修改Variable实例的原始m_name字段，所有依赖原始变量名的业务逻辑不受任何影响
• 原有模型中实现的Qt::BackgroundRole背景色逻辑会被委托自动继承，不需要重复编写背景绘制代码
• 如果需要支持单元格编辑，重写委托的createEditor方法时，同步给编辑控件设置对应数值的内容边距即可，不影响编辑时读取原始变量名。

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