【Qt6 中文参考手册】元对象系统(The Meta-Object System)

• Qt 6.2
• Qt Core
• 元对象系统
• Qt 6.2.3 参考文档

元对象系统(The Meta-Object System)

Qt的元对象系统为对象间通信、运行时类型信息和动态属性系统提供了信号和槽机制。

元对象系统基于三件事：

1. QObject 类为可以利用元对象系统的对象提供了一个基类。
2. 类声明为private的 Q_OBJECT 宏用于启用元对象功能，例如动态属性、信号和槽。
3. 元对象编译器(Meta-Object Compiler) (简写：moc) 为每个 QObject 子类生成实现元对象功能所需的代码。

moc 工具读取C++源文件。如果它找到一个或多个包含 Q_OBJECT 宏的类声明, 它将生成另一个C++源文件，其中包含每个类的元对象代码。此生成的源文件 #include到类的源文件中，要么更常见的是编译并与类的实现链接。

除了提供 信号和插槽 机制用于对象之间的通信（引入系统的主要原因）之外，元对象代码还提供以下附加功能：

• QObject::metaObject() 函数返回类的关联 元对象(meta-object) .
• QMetaObject::className() 在运行时以字符串形式返回类名，而无需通过C++编译器提供本机运行时类型信息 （RTTI） 支持。
• QObject::inherits() 函数返回对象是否是在 QObject 继承树中继承指定类名为参数className的实例
• QObject::tr() 翻译国际化的字符串.
• QObject::setProperty() 和 QObject::property() ，动态设置属性，和按名称获取属性。
• QMetaObject::newInstance() 创建类的新实例。

还可以在 QObject 类上使用qobject_cast() 执行动态转换。qobject_cast() 函数的行为类似于标准C++的 dynamic_cast(), 其优点是它不需要 RTTI 支持，并且可以跨动态库工作。它尝试将其参数转换为尖括号中指定的指针类型，如果对象类型正确（在运行时确定），则返回非零指针;如果对象的类型不兼容，则返回 nullptr.

例如，假设 MyWidget 继承自 QWidget 并使用Q_OBJECT 宏声明：

     QObject *obj = new MyWidget;

类型为QObject * 的 obj 变量实际上引用了一个 MyWidget 对象，因此我们可以适当地转换它：

     QWidget *widget = qobject_cast<QWidget *>(obj);

从QObject 到 QWidget 的强制转换是成功的，因为该对象实际上是 MyWidget，它是 QWidget的子类。由于我们知道obj 是 MyWidget，我们也可以将其转换为 MyWidget *:

     MyWidget *myWidget = qobject_cast<MyWidget *>(obj);

MyWidget的转换是成功的，因为qobject_cast() 分内置Qt类型和自定义类型。

     QLabel *label = qobject_cast<QLabel *>(obj);
     // label is 0

另一方面，转换为< href="http://qtdoc.cutebook.net/qtcore/../qtwidgets/qlabel.html">QLabel 失败。然后将指针设置为 0。这样就可以在运行时根据类型以不同的方式处理不同类型的对象：

     if (QLabel *label = qobject_cast<QLabel *>(obj)) {
         label->setText(tr("Ping"));
     } else if (QPushButton *button = qobject_cast<QPushButton *>(obj)) {
         button->setText(tr("Pong!"));
     }

虽然可以使用QObject作为基类，而不使用Q_OBJECT宏和元对象代码，但如果不使用Q_OBJECT宏，则信号和插槽以及此处描述的其他功能都将不可用。从元对象系统的角度来看，没有元代码的QObject子类等效于其最接近的元对象代码的祖先。 这意味着，例如，QMetaObject::className() 将不返回类的实际名称，而是返回此祖先的类名。

因此，我们强烈建议 QObject 的所有子类都使用 Q_OBJECT宏，无论它们是否实际使用信号、槽和属性。

另请参阅QMetaObject，Qt的属性系统，以及信号和插槽。

© 2022 Qt Company Ltd. 此处包含的文档贡献是其各自所有者的版权。
此处提供的文档是根据自由软件基金会发布的 GNU 自由文档许可证 1.3 版 的条款授予许可的。
Qt 和相应的商标是Qt Company Ltd.在芬兰和/或全球其他国家/地区的商标。所有其他商标均为其各自所有者的财产。