Qt框架学习02——属性系统

Qt的属性系统是Qt框架提供的一种强大机制，用于定义对象的属性，并能够以一致的方式访问、修改和处理这些属性。它是Qt元对象系统（Meta-Object System）的核心部分之一，支持Qt的信号和槽机制、动态属性处理以及与QML的集成。

属性系统使得类的属性（如成员变量）可以像对象的方法一样被访问和操作。与直接访问成员变量不同，属性系统提供了额外的功能，例如：

• 可绑定：属性可以与信号、槽或QML绑定，自动响应变化。
• 可编辑：属性可以通过字符串名称进行访问和修改，适用于动态场景。
• 可序列化：属性可以轻松序列化和反序列化为字符串、文件或数据流。

1. 定义

在Qt中定义属性使用Q_PROPERTY宏。以下是一个简单的属性定义示例：

class MyClass : public QObject
{
    Q_OBJECT
    Q_PROPERTY(int value READ value WRITE setValue NOTIFY valueChanged)

public:
    MyClass(QObject *parent = nullptr) : QObject(parent), m_value(0) {}

    int value() const { return m_value; }
    void setValue(int newValue) {
        if (m_value != newValue) {
            m_value = newValue;
            emit valueChanged(m_value);
        }
    }

signals:
    void valueChanged(int newValue);

private:
    int m_value;
};

2. Q_PROPERTY宏详解

Q_PROPERTY 宏用于声明类的属性，并指定其访问和修改方法。
语法如下：

Q_PROPERTY(type name
           READ getFunction
           WRITE setFunction
           RESET resetFunction
           NOTIFY notifySignal
           REVISION int
           DESIGNABLE bool
           SCRIPTABLE bool
           STORED bool
           USER bool)

常用参数：

• type: 属性的类型，例如int、QString等。
• name: 属性的名称。
• READ: 读取属性值的函数。
• WRITE: 写入属性值的函数。
• RESET: 重置属性值的函数（可选）。
• NOTIFY: 属性值变化时发出的信号（可选）。
• DESIGNABLE: 在Qt Designer中是否可见（可选）。
• SCRIPTABLE: 是否可以在Qt脚本中使用（可选）。
• STORED: 属性是否被序列化（可选）。
• USER: 标识此属性是否是用户属性（可选，通常与表单编辑相关）。

1. 静态属性

定义：静态属性是通过在类定义中使用Q_PROPERTY宏来声明的属性。它们在编译时就已经确定，并且只能通过类的代码来定义和使用。

特点：

• 预定义：静态属性必须在类定义中明确声明，使用Q_PROPERTY宏来绑定访问函数和信号。
• 元对象系统支持：静态属性可以通过Qt的元对象系统（Meta-Object System）进行反射（如通过QMetaObject查询属性信息）。
• 性能高：由于静态属性是在编译时就确定的，它们通常比动态属性更高效。

class MyClass : public QObject
{
    Q_OBJECT
    Q_PROPERTY(int value READ value WRITE setValue NOTIFY valueChanged)

public:
    MyClass(QObject *parent = nullptr) : QObject(parent), m_value(0) {}

    int value() const { return m_value; }
    void setValue(int newValue) {
        if (m_value != newValue) {
            m_value = newValue;
            emit valueChanged(m_value);
        }
    }

signals:
    void valueChanged(int newValue);

private:
    int m_value;
};

在上面的示例中，value属性是一个静态属性，它通过Q_PROPERTY宏声明，并且在编译时定义好访问方法。

2. 动态属性

定义：动态属性是在运行时为QObject派生对象动态添加的属性。这些属性不是在类定义中声明的，而是在代码的执行过程中通过setProperty()方法添加。

特点：

• 运行时添加：动态属性不需要在类定义中声明，它们可以在任何时候为一个QObject对象添加，而不需要修改类的代码。
• 灵活性高：动态属性非常灵活，适合在运行时根据需要为对象添加额外的数据或配置项。
• 元对象系统支持有限：虽然可以通过property()和setProperty()访问动态属性，但它们不会出现在通过QMetaObject查询的属性列表中。

MyClass obj;
obj.setProperty("dynamicValue", 42);

int dynamicValue = obj.property("dynamicValue").toInt();
qDebug() << "Dynamic Value:" << dynamicValue;

在上面的示例中，dynamicValue是一个动态属性，它在运行时通过setProperty()方法添加，而不需要在类定义中声明。