QML与C++共享类无法同时访问枚举和Q_PROPERTY问题

问题重现 #

你定义了一个C++类SharedConstants，包含Q_ENUM枚举和Q_PROPERTY字符串属性，但遇到以下矛盾：

• 用qmlRegisterType<SharedConstants>注册类后，QML能正确读取枚举值（比如SharedConstants.EditRoute返回2），但SharedConstants.testString为空；
• 将类实例设为上下文属性后，QML能读取testString的值，但枚举值全部显示为0。

原因分析 #

1. 注册类后无法访问属性：testString是实例属性，但你在QML里直接通过类名SharedConstants.testString访问，这相当于试图读取静态属性，而你的类里并没有定义静态的testString，所以返回空。
2. 上下文属性模式下枚举失效：没有通过qmlRegisterType注册类时，QML的类型系统无法识别该类的枚举定义，所有枚举值会被当作未定义的常量，默认返回0。

解决方案 #

方案1：同时注册类和上下文属性（推荐）

这种方法既能让QML识别枚举类型，又能通过实例访问属性，是最通用的解决方案：

C++代码修改：

// 先注册类，让QML识别枚举类型
qmlRegisterType<SharedConstants>("SharedConstants", 1, 0, "SharedConstants");
// 创建类实例，设为上下文属性（注意变量生命周期，避免局部变量被销毁）
SharedConstants* constants = new SharedConstants(&engine);
engine.rootContext()->setContextProperty("constants", constants);

QML代码修改：

import SharedConstants 1.0

ApplicationWindow {
    property int editState: SharedConstants.EditRoute  // 通过类名访问枚举
    property string testString: constants.testString    // 通过上下文属性访问实例属性

    Component.onCompleted: {
        console.log("editState: ", editState);
        console.log("testString: ", testString)
    }    
}

方案2：将属性改为静态（仅适用于常量场景）

如果testString是不需要变化的常量，可以把它改成静态属性，这样注册类后就能直接通过类名访问：

C++代码修改：

class SharedConstants : public QObject
{
    Q_OBJECT
    Q_ENUM(EditState)
    // 声明静态属性，Qt 5.14+支持Q_PROPERTY的STATIC关键字
    Q_PROPERTY(QString testString READ getTestString CONSTANT STATIC)

public:
    enum EditState {
            Unknown,
            Pointing,
            EditRoute,
            EditPoints,
            EditOverlay
    };

    // 静态getter方法
    static QString getTestString() {
        return QString("Dummy value");
    }
};

QML代码无需修改，注册类后就能同时访问枚举和静态属性：

import SharedConstants 1.0

ApplicationWindow {
    property int editState: SharedConstants.EditRoute
    property string testString: SharedConstants.testString

    Component.onCompleted: {
        console.log("editState: ", editState);
        console.log("testString: ", testString)
    }    
}

关键注意点 #

• 上下文属性的实例要保证生命周期足够长，避免局部变量被销毁导致QML访问无效指针；
• 必须通过qmlRegisterType注册类，才能让QML识别类的枚举定义；
• 实例属性必须通过类的实例访问，不能直接通过类名访问（除非是静态属性）。

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