QT 动态属性和静态属性

在 Qt 中，属性（Property）可以分为 动态属性（Dynamic Property） 和 静态属性（Static Property），它们的区别主要在于定义方式、存储方式和使用场景。

1. 静态属性（Static Property）

静态属性是通过 Q_PROPERTY 宏在类的声明中定义的，通常用于类的正式接口，可以被 元对象系统（Meta-Object System） 识别，支持信号与槽、属性绑定、动态查询等特性。

特点

在 头文件（.h） 中使用 Q_PROPERTY 宏声明。
需要提供 READ、WRITE、NOTIFY 等方法（可选）。
可以被 Qt 的元对象系统（MOC） 处理，支持运行时反射。
适用于长期存在的属性，通常与类的核心功能相关。

示例

复制代码

#include <QObject>

class MyClass : public QObject {
    Q_OBJECT
    Q_PROPERTY(QString name READ name WRITE setName NOTIFY nameChanged)

public:
    QString name() const { return m_name; }
    void setName(const QString &name) {
        if (m_name != name) {
            m_name = name;
            emit nameChanged();
        }
    }

signals:
    void nameChanged();

private:
    QString m_name;
};

使用方式

复制代码

MyClass obj;
obj.setName("Qt");  // 使用 WRITE 方法
qDebug() << obj.name();  // 使用 READ 方法

// 通过元对象系统访问
QString propValue = obj.property("name").toString();
obj.setProperty("name", "NewName");

2. 动态属性（Dynamic Property）

动态属性是在 运行时 动态添加的属性，不需要在类声明中预先定义。它们通常用于临时存储数据或扩展对象行为，但不会被 MOC 处理，也不支持信号与槽机制。

特点

使用 QObject::setProperty() 动态添加。
不需要 Q_PROPERTY 声明，适用于临时或扩展性需求。
存储在 QObject 的 动态属性表 中，可以通过 property() 查询。
适用于 UI 组件（如 QWidget）的临时标记或数据传递。

示例

复制代码

#include <QPushButton>

int main() {
    QPushButton button("Click Me");

    // 动态添加属性
    button.setProperty("highlighted", true);
    button.setProperty("customData", QVariant(42));

    // 读取动态属性
    bool isHighlighted = button.property("highlighted").toBool();
    int data = button.property("customData").toInt();

    qDebug() << isHighlighted;  // true
    qDebug() << data;          // 42

    return 0;
}

典型用途

在 QSS（Qt样式表） 中使用动态属性控制样式：
复制代码
```
QPushButton[highlighted="true"] {
    background-color: yellow;
}
```
临时存储数据，避免额外变量。
在 QML 和 C++ 之间传递额外信息。

3. 静态属性 vs 动态属性

特性	静态属性 (`Q_PROPERTY`)	动态属性 (`setProperty`)
定义方式	头文件声明	运行时动态添加
MOC 处理	✔️ 支持	❌ 不支持
信号与槽	✔️ 支持（NOTIFY）	❌ 不支持
性能	更高（编译期确定）	稍低（运行时查找）
适用场景	核心业务逻辑	临时数据、UI扩展
QSS 支持	✔️ 支持	✔️ 支持
QML 集成	✔️ 直接绑定	❌ 需额外处理

4. 如何选择？

使用 Q_PROPERTY（静态属性）：
- 属性是类的核心部分，需要信号通知或 QML 绑定。
- 需要元对象系统支持（如动态调用、反射）。
使用 setProperty()（动态属性）：
- 临时存储数据，避免修改类定义。
- 用于 QSS 样式控制或跨模块数据传递。
- 无法修改类代码（如第三方库的扩展）。

总结

静态属性 是强类型、高性能的正式接口，适合长期使用。
动态属性 是灵活、临时的扩展机制，适合 UI 或临时需求。

如果你的属性需要 信号/槽、QML 绑定、强类型检查 ，优先用 Q_PROPERTY；如果只是 临时存储或 UI 控制，动态属性更方便。