En esta página

QQmlExtensionPlugin Class

La clase QQmlExtensionPlugin proporciona una base abstracta para complementos de extensión QML personalizados con funciones de registro de tipos personalizadas. Más información...

Encabezado: #include <QQmlExtensionPlugin>
CMake: find_package(Qt6 REQUIRED COMPONENTS Qml)
target_link_libraries(mytarget PRIVATE Qt6::Qml)
qmake: QT += qml
Heredado de: QObject

Funciones públicas

(since 6.0) virtual void unregisterTypes()

Funciones públicas reimplementadas

virtual void initializeEngine(QQmlEngine *engine, const char *uri) override
virtual void registerTypes(const char *uri) override = 0

Descripción detallada

Nota: Si necesitas escribir un complemento manualmente (lo cual es poco habitual), siempre debes utilizar QQmlEngineExtensionPlugin. QQmlExtensionPlugin solo proporciona, además, las funciones registerTypes() y unregisterTypes(). No debes utilizarlas, sino declarar tus tipos con QML_ELEMENT y similares, y dejar que el sistema de compilación se encargue del registro.

Documentación de las funciones de miembro

[override virtual] void QQmlExtensionPlugin::initializeEngine(QQmlEngine *engine, const char *uri)

Inicializa la extensión desde uri utilizando engine. Aquí, un complemento de aplicación podría, por ejemplo, exponer algunos datos u objetos a QML, como propiedades de contexto en el contexto raíz del motor.

[override pure virtual] void QQmlExtensionPlugin::registerTypes(const char *uri)

Registra los tipos QML en el ` uri` especificado. Las subclases deben implementar esto para llamar a ` qmlRegisterType()` para todos los tipos que proporciona el complemento de extensión.

El « uri » es un identificador del complemento generado por el motor QML a partir del nombre y la ruta de la biblioteca del complemento de la extensión.

[virtual, since 6.0] void QQmlExtensionPlugin::unregisterTypes()

Sobrescribe este método para dar de baja los tipos registrados manualmente en « registerTypes ».

Esta función se introdujo en Qt 6.0.

© 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.