<QtPlugin> - Defining Plugins
El archivo de cabecera <QtPlugin> contiene macros para definir complementos. Más información...
| Header: | #include <QtPlugin> |
forma parte de las clases de complementos.
Macros
| Q_DECLARE_INTERFACE(ClassName, Identifier) | |
| Q_IMPORT_PLUGIN(PluginName) | |
| Q_PLUGIN_METADATA(...) |
Véase también Cómo crear complementos de Qt.
Documentación de las macros
Q_DECLARE_INTERFACE(ClassName, Identifier)
Esta macro asocia el nombre de clase dado « Identifier » (un literal de cadena) a la clase de interfaz denominada « ClassName ». El nombre de clase « Identifier » debe ser único.
Esta macro se suele utilizar justo después de la definición de la clase ClassName, en un archivo de cabecera.
Si deseas utilizar Q_DECLARE_INTERFACE con clases de interfaz declaradas en un espacio de nombres, debes asegurarte de que Q_DECLARE_INTERFACE no se encuentre dentro de dicho espacio de nombres. Por ejemplo:
namespace Foo
{
struct MyInterface { /*...*/ };
}
Q_DECLARE_INTERFACE(Foo::MyInterface, "org.examples.MyInterface")Véase también ` Q_INTERFACES()` y «Cómo crear complementos de Qt».
Q_IMPORT_PLUGIN(PluginName)
Esta macro importa el complemento denominado « PluginName », cuyo nombre coincide con el de la clase que declara los metadatos del complemento mediante « Q_PLUGIN_METADATA()».
Al insertar esta macro en el código fuente de tu aplicación, en el ámbito del archivo del espacio de nombres raíz, podrás utilizar un complemento estático.
Ejemplo:
Q_IMPORT_PLUGIN(qjpeg)Los complementos estáticos también deben ser incluidos por el enlazador al compilar la aplicación. Consulta Complementos estáticos para obtener más información al respecto.
Véase también «Complementos estáticos » y «Cómo crear complementos Qt».
Q_PLUGIN_METADATA(...)
Esta macro se utiliza para declarar los metadatos que forman parte de un complemento que instancia este objeto.
La macro debe declarar el IID de la interfaz implementada a través del objeto y hacer referencia a un archivo que contenga los metadatos del complemento.
Debe haber exactamente una aparición de esta macro en el código fuente de un complemento de Qt.
Ejemplo:
class MyInstance : public QObject
{
Q_PLUGIN_METADATA(IID "org.qt-project.Qt.QDummyPlugin" FILE "mymetadata.json")
};Ten en cuenta que la clase en la que aparece esta macro debe poder construirse de forma predeterminada.
FILE es opcional y apunta a un archivo JSON.
El archivo JSON debe encontrarse en uno de los directorios de inclusión especificados por el sistema de compilación. moc termina con un error si no encuentra el archivo especificado.
Véase también Q_DECLARE_INTERFACE() y Cómo crear complementos de Qt.
© 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.