Qt 的Q

Qt 的Q_PROPERTY关键字

• • • 1. Q_PROPERTY 的由来
    • 2. 实现原理
    • 3. Q_PROPERTY 的特点
    • 4. Q_PROPERTY 的属性
    • 5. 应用说明
    • 示例代码
    • 示例代码
    • 连接信号和槽的多种方式
    • 处理信号和槽的注意事项
    • QT的元对象系统
    • • • 1. 元对象系统的由来
        • 2. 实现原理
        • 3. 元对象系统的特点
        • 4. 元对象系统的属性
        • 5. 应用说明
        • 示例代码

          Q_PROPERTY 宏是 Qt 框架中元对象系统的重要组成部分，它允许开发者在类中声明属性，使这些属性可以在运行时动态访问和操作。以下是对 Q_PROPERTY 的详细说明，包括其由来、实现原理、特点、属性和应用。

          
          （图片来源网络，侵删）

          1. Q_PROPERTY 的由来

          Qt 框架从一开始就注重跨平台开发和增强的开发者体验。为此，Qt 引入了元对象系统（Meta-Object System），允许在运行时对对象进行动态反射（reflection）。Q_PROPERTY 是这个系统的一部分，它使得对象的属性可以被动态地获取和设置。这在 GUI 开发、对象序列化和属性绑定等方面有着广泛的应用。

          2. 实现原理

          Q_PROPERTY 宏在类的声明中使用，Qt 的元对象编译器（moc，Meta-Object Compiler）会解析这些宏并生成额外的 C++ 代码来实现属性系统。以下是实现原理的简要概述：

          1. 宏定义：在类中使用 Q_PROPERTY 宏声明属性。
          2. moc 生成代码：Qt 的 moc 工具会解析类定义，识别 Q_PROPERTY 宏，并生成对应的元对象代码。这个代码包括属性的元数据和用于访问属性的方法。
          3. 运行时访问：在运行时，可以通过 QObject 的 setProperty 和 property 方法来动态设置和获取属性值。

          3. Q_PROPERTY 的特点

          • 动态访问：属性可以在运行时动态访问和修改。
          • 信号槽机制：属性可以与 Qt 的信号槽机制结合使用。
          • 元数据支持：属性声明会生成元数据，支持反射和动态类型检查。
          • 序列化支持：可以方便地进行对象序列化和反序列化。

            4. Q_PROPERTY 的属性

            Q_PROPERTY 宏的语法如下：

            Q_PROPERTY(type name
                       READ getFunction
                       WRITE setFunction
                       RESET resetFunction
                       NOTIFY notifySignal
                       MEMBER memberName
                       USER true|false
                       STORED true|false
                       DESIGNABLE true|false
                       SCRIPTABLE true|false
                       CONSTANT true|false
                       FINAL true|false)
            

            • type：属性的类型。
            • name：属性的名称。
            • READ：指定用于读取属性值的函数。
            • WRITE：指定用于写入属性值的函数。
            • RESET：指定用于重置属性值的函数。
            • NOTIFY：指定属性值变化时发射的信号。
            • MEMBER：指定直接映射到属性的成员变量。
            • USER：标记该属性为用户属性，通常用于 UI 设计工具。
            • STORED：指示该属性是否应该被存储（例如，在对象序列化时）。
            • DESIGNABLE：指示该属性在设计工具中是否可见。
            • SCRIPTABLE：指示该属性是否可用于脚本引擎。
            • CONSTANT：指示该属性是否是常量。
            • FINAL：指示该属性是否可以被重写。

              5. 应用说明

              Q_PROPERTY 在 Qt 中有广泛的应用：

              1. GUI 开发：在 Qt Widgets 和 Qt Quick 中，用于绑定属性和界面组件。
              2. 对象序列化：通过元对象系统，属性可以方便地进行序列化和反序列化。
              3. 信号槽机制：属性变化可以触发信号，使得属性值变化可以被其他对象感知。
              4. 设计工具：在 Qt Designer 和 Qt Creator 等设计工具中，属性可以被可视化和编辑。

              示例代码

              以下是一个示例，展示了如何使用 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 val)
                  {
                      if (val != m_value)
                      {
                          m_value = val;
                          emit valueChanged(m_value);
                      }
                  }
              signals:
                  void valueChanged(int newValue);
              private:
                  int m_value;
              };
              

              在这个示例中：

              • Q_PROPERTY 声明了一个名为 value 的属性。
              • value 属性通过 value() 函数读取，通过 setValue(int) 函数写入，并在值改变时发射 valueChanged(int) 信号。

                valueChanged(int) 信号需要自己定义连接槽函数

                通过这种方式，value 属性可以在运行时动态访问、修改，并且与信号槽机制集成。

                处理 valueChanged(int) 信号时，可以使用 connect 方法将信号连接到自定义的槽函数。通过这种机制，可以在信号发射时自动调用相应的槽函数。

                以下是一个详细的示例，展示了如何自定义一个槽函数并将其连接到 valueChanged(int) 信号。

                示例代码

                1. 自定义槽函数：定义一个自定义的槽函数来处理 valueChanged(int) 信号。
                2. 连接信号和槽：使用 connect 方法将 valueChanged(int) 信号连接到自定义槽函数。

                #include 
                #include 
                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 val)
                    {
                        if (val != m_value)
                        {
                            m_value = val;
                            emit valueChanged(m_value);
                        }
                    }
                signals:
                    void valueChanged(int newValue);
                private:
                    int m_value;
                };
                class Receiver : public QObject
                {
                    Q_OBJECT
                public slots:
                    void handleValueChanged(int newValue)
                    {
                        qDebug() 
                    QCoreApplication app(argc, argv);
                    MyClass obj;
                    Receiver receiver;
                    // 连接信号和槽
                    QObject::connect(&obj, &MyClass::valueChanged, &receiver, &Receiver::handleValueChanged);
                    // 修改值，触发信号
                    obj.setValue(42);
                    return app.exec();
                }
                #include "main.moc"
                
                    qDebug() 
                    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 val)
                    {
                        if (val != m_value)
                        {
                            m_value = val;
                            emit valueChanged(m_value);
                        }
                    }
                signals:
                    void valueChanged(int newValue);
                private:
                    int m_value;
                };
                int main()
                {
                    MyClass obj;
                    obj.setValue(42);
                    qDebug()