QtQuick ComboBox扩展图标：如何统一访问各类模型选中项数据

问题背景 #

我需要为QtQuick的ComboBox扩展图标功能，使用textRole、valueRole以及自定义的iconSourceRole（指定.qrc格式的PNG图标路径）。ComboBox的delegate中可以通过model[comboBox.textRole]和model[comboBox.iconSourceRole]访问每行模型数据，但选中项由contentItem负责渲染，这里无法直接获取模型的所有角色数据，仅能通过comboBox.displayText拿到显示文本。

当前需要适配三类模型，但它们的数据访问API差异明显：

• QML的ListModel：.get()方法仅需一个参数
• FolderListModel：.get()方法需要两个参数
• C++实现的QAbstractListModel：roleNames()和itemData()未标记为Q_INVOKABLE，使用.data()需要知道角色数值而非名称，现有代码无法适配

希望找到在contentItem中统一访问各类模型数据的方法，同时想了解ListView和ComboBox的C++实现是否包含处理不同模型类型的统一逻辑。

统一访问方案 #

1. 为C++模型添加可调用的角色映射方法 #

在C++的QAbstractListModel子类中，新增Q_INVOKABLE方法，实现通过角色名称获取对应角色数值的功能，让QML可以直接用名称定位角色。

2. 封装QML通用数据获取函数 #

在IconComboBox中封装一个工具函数，自动识别模型类型，调用对应API获取指定行、指定角色的数据，实现统一调用逻辑。

3. 对齐Qt内部逻辑 #

Qt的ListView和ComboBox内部基于QAbstractItemModel的标准接口（data()、roleNames()）处理数据，我们的封装逻辑可以对齐这套标准，保证兼容性。

修改后的代码 #

cppdefinedmodel.h #

#pragma once

#include <QAbstractListModel>
#include <qqml.h>

class CppDefinedModel : public QAbstractListModel
{
    Q_OBJECT
    QML_ELEMENT

    enum {
        TextRole = Qt::UserRole,
        ValueRole,
        IconUrlRole
    };

public:
    using QAbstractListModel::QAbstractListModel;

    int rowCount(const QModelIndex &parent) const override
    {
        return 6;
    }
    QVariant data(const QModelIndex &index, int role) const override
    {
        switch (role)
        {
        case TextRole:    return QString("name%0").arg(index.row());
        case ValueRole:   return QString("value%0").arg(index.row());
        case IconUrlRole: return QString("qrc:/comboboxtests/icons/%0.png")
                    .arg(std::array<const char *,3>{{"movinghead", "nebelmaschine", "rgbstrahler"}}[index.row() / 2 % 3]);
        }
        return {};
    }
    QHash<int, QByteArray> roleNames() const override
    {
        return {{TextRole, "theText"}, {ValueRole, "theValue"}, {IconUrlRole, "theIconUrl"}};
    }

    // 新增Q_INVOKABLE方法：通过角色名称获取角色数值
    Q_INVOKABLE int roleValue(const QString& roleName) const
    {
        auto roles = roleNames();
        for (auto it = roles.constBegin(); it != roles.constEnd(); ++it) {
            if (it.value() == roleName.toUtf8()) {
                return it.key();
            }
        }
        return -1;
    }
};

IconComboBox.qml #

import QtQuick
import QtQuick.Controls
import QtQuick.Controls.Material
import Qt.labs.folderlistmodel 2.4
import comboboxtests 1.0

ComboBox {
    id: comboBox

    property string iconSourceRole

    // 统一模型数据获取函数
    function getModelData(rowIndex, roleName) {
        if (rowIndex < 0 || !model || !roleName) return '';

        // 适配FolderListModel
        if (model instanceof FolderListModel) {
            return model.get(rowIndex, roleName);
        }
        // 适配带get()方法的QML模型（如ListModel）
        else if ('get' in model) {
            const item = model.get(rowIndex);
            return item[roleName] || '';
        }
        // 适配C++ QAbstractListModel
        else if ('roleValue' in model && 'data' in model && 'index' in model) {
            const role = model.roleValue(roleName);
            if (role === -1) return '';
            const idx = model.index(rowIndex, 0);
            return model.data(idx, role) || '';
        }
        return '';
    }

    delegate: ItemDelegate {
        height: 64
        anchors.left: parent.left
        anchors.right: parent.right
        contentItem: IconChooserDelegateLayout {
            anchors.top: parent.top
            anchors.bottom: parent.bottom
            text: model[comboBox.textRole]
            iconSource: model[comboBox.iconSourceRole]
        }
    }
    contentItem: IconChooserDelegateLayout {
        text: comboBox.displayText
        isInsideMaterialComboBox: true
        iconSource: comboBox.getModelData(comboBox.currentIndex, comboBox.iconSourceRole)
    }
}

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