让自定义的 Person 类使用 Qt 自带的元对象系统

要让自定义的 Person 类使用 Qt 自带的元对象系统，主要步骤是：

1. 继承 QObject 基类：你的类必须继承自 QObject，才能使用元对象系统的功能。
2. 使用 Q_OBJECT 宏：在类声明中添加 Q_OBJECT 宏，这个宏是 Qt 元对象系统的核心部分，用于启用信号与槽、元对象反射等功能。
3. 实现属性（可选）：如果想让类中的某些变量成为 Qt 属性系统的一部分，可以使用 Q_PROPERTY 宏。
4. 定义信号与槽（可选）：如果类中需要使用信号与槽，可以在类中定义相应的信号和槽。

下面我们来实现一个简单的自定义 Person 类，并让它使用 Qt 元对象系统。

1. 创建 Person 类

// person.h

#ifndef PERSON_H
#define PERSON_H

#include <QObject>

class Person : public QObject
{
    Q_OBJECT  // 启用元对象系统的宏

    // Q_PROPERTY 宏定义属性 'name' 和 'age'
    Q_PROPERTY(QString name READ name WRITE setName NOTIFY nameChanged)
    Q_PROPERTY(int age READ age WRITE setAge NOTIFY ageChanged)

public:
    // 构造函数
    explicit Person(QObject* parent = nullptr);

    // Getter 和 Setter 方法
    QString name() const;
    void setName(const QString& name);

    int age() const;
    void setAge(int age);

signals:
    // 定义信号，用于通知属性发生变化
    void nameChanged(const QString& name);
    void ageChanged(int age);

private:
    QString m_name;
    int m_age;
};

#endif // PERSON_H

2. 实现 Person 类

// person.cpp

#include "person.h"

// 构造函数
Person::Person(QObject* parent) : QObject(parent), m_name(""), m_age(0)
{
}

// Getter 和 Setter 的实现
QString Person::name() const
{
    return m_name;
}

void Person::setName(const QString& name)
{
    if (m_name != name) {
        m_name = name;
        emit nameChanged(m_name);  // 当 name 改变时，发出信号
    }
}

int Person::age() const
{
    return m_age;
}

void Person::setAge(int age)
{
    if (m_age != age) {
        m_age = age;
        emit ageChanged(m_age);  // 当 age 改变时，发出信号
    }
}

3. 使用 Person 类

在你的应用程序中，你可以创建 Person 类的实例，并通过元对象系统动态访问属性、信号与槽等功能。以下是一个简单的示例，展示如何使用 Person 类并连接信号与槽。

// main.cpp

#include <QCoreApplication>
#include "person.h"

int main(int argc, char *argv[])
{
    QCoreApplication a(argc, argv);

    // 创建 Person 对象
    Person person;
    person.setName("Alice");
    person.setAge(25);

    // 连接信号与槽
    QObject::connect(&person, &Person::nameChanged, [](const QString& newName) {
        qDebug() << "Name changed to:" << newName;
    });

    QObject::connect(&person, &Person::ageChanged, [](int newAge) {
        qDebug() << "Age changed to:" << newAge;
    });

    // 修改属性，触发信号
    person.setName("Bob");
    person.setAge(30);

    return a.exec();
}

4. 编译与运行

由于 Q_OBJECT 宏涉及到 Qt 的元对象编译器（moc），所以要确保你在编译时正确配置了构建系统。常见的步骤如下：

如果使用 qmake：

• 确保在 .pro 文件中添加了 CONFIG += qmake_qt.
• 通过 qmake 生成 Makefile，然后使用 make 或相应的工具进行编译。

如果使用 CMake：

• 确保在 CMakeLists.txt 中正确配置了 Qt5Core，并且启用了 moc。

例如，一个简单的 CMakeLists.txt 文件：

cmake_minimum_required(VERSION 3.5)

project(PersonExample)

set(CMAKE_CXX_STANDARD 11)

find_package(Qt6 REQUIRED COMPONENTS Core)

set(SOURCES
    main.cpp
    person.cpp
)

set(HEADERS
    person.h
)

add_executable(${PROJECT_NAME} ${SOURCES} ${HEADERS})

target_link_libraries(${PROJECT_NAME} Qt6::Core)

5. 代码解释

• QObject：Person 类继承了 QObject，使其成为 Qt 元对象系统的一部分。
• Q_OBJECT：这个宏告诉 Qt 使用 MOC（元对象编译器）为该类生成元对象代码，支持动态属性、信号与槽等功能。
• Q_PROPERTY：name 和 age 这两个属性使用 Q_PROPERTY 声明，使得它们可以通过 Qt 的元对象系统访问。在 QML、Qt Designer 或者运行时反射中可以访问这些属性。
• 信号与槽：定义了 nameChanged 和 ageChanged 两个信号，用来在属性发生变化时通知外部。

6. 使用元对象系统的好处

通过 Qt 的元对象系统，你可以：

• 使用 信号与槽 进行松耦合的对象间通信。
• 使用 属性系统 实现动态属性绑定和界面设计器的支持。
• 支持 反射，能够在运行时动态访问和修改类的属性和方法。

通过上述方法，你可以让自定义的 Person 类很好地集成 Qt 的元对象系统并使用它的动态特性。