El sistema de metaobjetos

El sistema de metaobjetos de Qt proporciona el mecanismo de señales y ranuras para la comunicación entre objetos, la información de tipos en tiempo de ejecución y el sistema dinámico de propiedades.

El sistema de metaobjetos se basa en tres elementos:

  1. La clase ` QObject ` proporciona una clase base para los objetos que pueden aprovechar el sistema de metaobjetos.
  2. La macro ` Q_OBJECT ` se utiliza para habilitar las características de metaobjetos, como las propiedades dinámicas, las señales y las ranuras.
  3. La Meta-Object Compiler (moc) proporciona a cada subclase de ` QObject ` el código necesario para implementar las características de metaobjetos.

La herramienta moc lee un archivo fuente de C++. Si encuentra una o más declaraciones de clase que contengan la macro Q_OBJECT, genera otro archivo fuente de C++ que contiene el código de metobjetos para cada una de esas clases. Este archivo fuente generado se integra mediante la directiv #include en el archivo fuente de la clase o, lo que es más habitual, se compila y se enlaza con la implementación de la clase.

Además de proporcionar el mecanismo de señales y ranuras para la comunicación entre objetos (la razón principal por la que se introdujo el sistema), el código de metobjeto ofrece las siguientes características adicionales:

También es posible realizar conversiones dinámicas utilizando ` qobject_cast()` en clases ` QObject `. La función ` qobject_cast()` se comporta de manera similar al operador ` dynamic_cast()` estándar de C++, con la ventaja de que no requiere compatibilidad con RTTI y funciona más allá de los límites de las bibliotecas dinámicas. Intenta convertir su argumento al tipo de puntero especificado entre corchetes angulares, devolviendo un puntero distinto de cero si el objeto es del tipo correcto (determinado en tiempo de ejecución), o nullptr si el tipo del objeto es incompatible.

Por ejemplo, supongamos qu MyWidget hereda de QWidget y se declara con la macro Q_OBJECT:

    QObject *obj = new MyWidget;

La variable ` obj `, de tipo ` QObject *`, en realidad hace referencia a un objeto ` MyWidget `, por lo que podemos realizar la conversión de tipo adecuada:

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

La conversión de QObject a QWidget se realiza correctamente, ya que el objeto es, en realidad, un MyWidget, que es una subclase de QWidget. Como sabemos que obj es un MyWidget, también podemos convertirlo a MyWidget *:

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

La conversión a ` MyWidget ` se realiza correctamente porque ` qobject_cast()` no distingue entre los tipos integrados de Qt y los tipos personalizados.

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

La conversión a ` QLabel`, por el contrario, falla. El puntero se establece entonces en ` nullptr`. Esto permite tratar objetos de diferentes tipos de forma distinta en tiempo de ejecución, en función del tipo:

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

Aunque es posible utilizar ` QObject ` como clase base sin la macro ` Q_OBJECT ` y sin código de metobjeto, ni las señales y ranuras ni las demás características descritas aquí estarán disponibles si no se utiliza la macro ` Q_OBJECT `. Desde el punto de vista del sistema de metacódigos, una subclase de ` QObject ` sin metacódigo es equivalente a su antepasado más cercano con metacódigo. Esto significa, por ejemplo, que ` QMetaObject::className()` no devolverá el nombre real de tu clase, sino el nombre de clase de este antepasado.

Por lo tanto, recomendamos encarecidamente que todas las subclases de ` QObject ` utilicen la macro ` Q_OBJECT `, independientemente de si utilizan o no señales, ranuras y propiedades.

Véase también « QMetaObject» , «El sistema de propiedades de Qt» y «Señales y ranuras».

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.