继承QAbstractItemModel的C++类自定义函数在QML调用失败如何解决？

原因1：元对象代码未更新 #

Qt的MOC（元对象编译器）只会在执行qmake时扫描C++头文件生成元调用代码，你在头文件中添加Q_INVOKABLE后，如果没有重新运行qmake，新的方法不会被注册到元系统，QML自然识别不到这个函数。

解决方法：

删除项目的构建目录，先执行qmake，再重新编译整个项目，90%以上的同类问题都是这个原因导致的。

原因2：返回值类型未被QML元系统识别 #

QModelIndex不属于QML默认支持的基础类型，直接作为返回值时，即便函数被标记为Q_INVOKABLE，也可能因为元系统找不到类型映射导致方法注册失败。

解决方法：

两种方案二选一：

• 方案一：将返回值改为QVariant类型，用QVariant包裹QModelIndex返回：

// 修改头文件声明
Q_INVOKABLE QVariant getIndexByValue(QVariant varValue) const;

// 修改cpp实现
QVariant IMTreeModel::getIndexByValue(QVariant varValue) const
{
    std::wcout << L"==getIndexByValue==== " << varValue.toString().toStdWString() << endl;
    return QVariant::fromValue(QModelIndex());
}

• 方案二：在main.cpp中注册QModelIndex类型到元系统，放在qmlRegisterType代码之前执行：

qRegisterMetaType<QModelIndex>();

额外优化建议 #

你当前使用的Q_ENUMS宏已经在Qt5中被废弃，建议替换为Q_ENUM宏，避免潜在的元对象兼容问题：

// 替换原来的Q_ENUMS(ItemRoles)
Q_ENUM(ItemRoles)

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