如何通过角色名称从QAbstractItemModel获取对应数据？

在Qt中，默认的QAbstractItemModel没有直接提供从角色名称映射到整数role值的API，但可以通过以下两种方式实现需求：

方法一：在C++模型中添加自定义方法 #

直接在你的MyModel类中添加一个可被QML调用的方法，封装行、列、角色名称到数据的获取逻辑：

修改C++模型代码 #

// MyModel.h
#include <QAbstractItemModel>
#include <QString>
#include <QVariant>

class MyModel : public QAbstractItemModel
{
    Q_OBJECT
public:
    QHash<int, QByteArray> roleNames() const override
    {
        QHash<int, QByteArray> roleNames;
        roleNames[Qt::UserRole + 1] = "someRole";
        return roleNames;
    }

    // 暴露给QML的方法，直接返回指定行、列、角色名称对应的数据
    Q_INVOKABLE QVariant getData(int row, int column, const QString& roleName) const
    {
        const auto roleMap = roleNames();
        // 反向查找角色名称对应的整数role值
        int targetRole = roleMap.key(roleName.toUtf8(), -1);
        if (targetRole == -1) {
            return QVariant(); // 角色名称不存在时返回空值
        }
        const QModelIndex index = this->index(row, column);
        return data(index, targetRole);
    }

    // 其他必要的模型方法（如index、parent、rowCount等）需自行实现
};

在QML中调用 #

Item {
    ListView {
        model: myModel
        delegate: myDelegate
    }
    
    Button {
        onClicked: {
            // 生成有效的随机行索引（修正原代码的Math.random用法）
            const rowIndex = Math.floor(Math.random() * myModel.count);
            const targetData = myModel.getData(rowIndex, 0, "someRole");
            console.log("获取到的数据：", targetData);
        }
    }
}

方法二：在QML中反向遍历roleNames映射 #

如果不想修改C++模型，可以直接在QML中遍历模型的roleNames属性（该属性会暴露模型的角色名称与整数role值的映射），找到目标角色对应的role值后再获取数据：

Item {
    ListView {
        model: myModel
        delegate: myDelegate
    }
    
    Button {
        onClicked: {
            const rowIndex = Math.floor(Math.random() * myModel.count);
            const targetRoleName = "someRole";
            let targetRole = -1;

            // 遍历roleNames对象，找到对应角色名称的整数role值
            for (const roleKey in myModel.roleNames) {
                if (myModel.roleNames[roleKey] === targetRoleName) {
                    targetRole = parseInt(roleKey);
                    break;
                }
            }

            if (targetRole !== -1) {
                const index = myModel.index(rowIndex, 0);
                const targetData = myModel.data(index, targetRole);
                console.log("获取到的数据：", targetData);
            } else {
                console.log("未找到指定的角色名称");
            }
        }
    }
}

注意事项 #

• Math.random()返回0到1之间的浮点数，需用Math.floor()转换为有效的整数行索引，避免越界。
• 若角色名称不存在，两种方法都会返回空值或提示，需根据业务逻辑处理这种情况。

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