Qt 6.2.4中TableView代理复用致编辑状态异常的解决方法

问题根源 #

QML TableView 采用代理组件复用机制：当滚动时，离开可视区域的代理会被重新分配给新进入可视区域的行。如果将行的状态（比如编辑后的文字颜色）直接存储在代理组件内部，而非绑定到数据模型的对应行数据上，就会出现代理复用后状态残留的问题——你看到的第20行变红，就是因为原来显示第二行的代理被复用给了第20行，而代理内部的颜色状态没有重置。

解决方案 #

将编辑状态（比如是否已编辑、文字颜色）存储到数据模型中，让代理组件的显示属性直接绑定到模型对应行的状态字段，而非维护自身状态。这样代理复用时，会自动读取当前行的模型数据，避免状态残留。

示例代码修改 #

1. 调整数据模型（以QML ListModel为例）

给每个列表项增加isEdited字段，标记该行是否已编辑：

TableView {
    model: ListModel {
        ListElement { text: "Row 1"; isEdited: false }
        ListElement { text: "Row 2"; isEdited: false }
        ListElement { text: "Row 3"; isEdited: false }
        // ... 其余行默认isEdited为false
    }

2. 修改代理组件

让TextField的颜色绑定到模型的isEdited字段，编辑完成时更新模型对应行的状态：

delegate: TextField {
        text: model.text
        // 根据模型的isEdited状态设置文字颜色
        color: model.isEdited ? "red" : "black"

        onEditingFinished: {
            // 更新模型中的文本内容
            model.text = text
            // 标记当前行为已编辑
            model.isEdited = true
        }
    }
}

自定义C++模型适配 #

如果使用C++自定义模型，需要：

• 在模型类中增加对应状态字段（比如isEdited）
• 重写roleNames()方法，将状态字段注册为可被QML访问的角色
• 实现setData()和data()方法，确保状态字段可读写，并在数据变化时发出dataChanged信号

示例C++模型核心代码：

class CustomModel : public QAbstractListModel
{
    Q_OBJECT
public:
    enum Roles {
        TextRole = Qt::UserRole + 1,
        IsEditedRole
    };

    int rowCount(const QModelIndex &parent = QModelIndex()) const override {
        return m_items.size();
    }

    QVariant data(const QModelIndex &index, int role = Qt::DisplayRole) const override {
        if (!index.isValid()) return {};
        const auto &item = m_items[index.row()];
        switch (role) {
        case TextRole: return item.text;
        case IsEditedRole: return item.isEdited;
        default: return {};
        }
    }

    bool setData(const QModelIndex &index, const QVariant &value, int role = Qt::EditRole) override {
        if (!index.isValid()) return false;
        auto &item = m_items[index.row()];
        switch (role) {
        case TextRole: item.text = value.toString(); break;
        case IsEditedRole: item.isEdited = value.toBool(); break;
        default: return false;
        }
        emit dataChanged(index, index, {role});
        return true;
    }

    QHash<int, QByteArray> roleNames() const override {
        QHash<int, QByteArray> roles;
        roles[TextRole] = "text";
        roles[IsEditedRole] = "isEdited";
        return roles;
    }

private:
    struct Item {
        QString text;
        bool isEdited = false;
    };
    QList<Item> m_items;
};

关键注意点 #

• 所有与行绑定的持久状态，必须存储在模型中，而非代理组件内部
• 临时状态（比如编辑中的高亮）可通过代理的active属性或TableView的currentIndex判断，但持久状态必须绑定模型

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