En esta página

QExtensionFactory Class

La clase QExtensionFactory te permite crear una fábrica capaz de generar instancias de extensiones personalizadas en Qt Designer. Más información...

Encabezado: #include <QExtensionFactory>
CMake: find_package(Qt6 REQUIRED COMPONENTS Designer)
target_link_libraries(mytarget PRIVATE Qt6::Designer)
qmake: QT += designer
Heredado de:QObject y QAbstractExtensionFactory

Funciones públicas

QExtensionFactory(QExtensionManager *parent = nullptr)
QExtensionManager *extensionManager() const

Funciones públicas reimplementadas

virtual QObject *extension(QObject *object, const QString &iid) const override

Funciones protegidas

virtual QObject *createExtension(QObject *object, const QString &iid, QObject *parent) const

Descripción detallada

Qt Widgets DesignerEn Qt Widgets Designer, las extensiones no se crean hasta que son necesarias. Por ese motivo, al implementar una extensión personalizada, también debes crear una QExtensionFactory, es decir, una clase capaz de crear una instancia de tu extensión, y registrarla utilizando extension manager.

La clase QExtensionManager proporciona funciones de gestión de extensiones para Qt Widgets Designer. Cuando se requiere una extensión, Qt Designer's extension manager recorrerá todas sus fábricas registradas llamando a QExtensionFactory::createExtension() para cada una de ellas hasta que encuentre la primera capaz de crear la extensión solicitada para el objeto seleccionado. A continuación, esta fábrica creará una instancia de la extensión.

Hay cuatro tipos de extensiones disponibles en Qt Widgets Designer: QDesignerContainerExtension, QDesignerMemberSheetExtension, QDesignerPropertySheetExtension y QDesignerTaskMenuExtension. El comportamiento de Qt Designer es el mismo tanto si la extensión solicitada está asociada a un contenedor de varias páginas, una hoja de miembros, una hoja de propiedades o un menú de tareas.

Puedes crear una nueva QExtensionFactory y reimplementar la función QExtensionFactory::createExtension(). Por ejemplo:

        QObject *ANewExtensionFactory::createExtension(QObject *object,
                const QString &iid, QObject *parent) const
        {
            if (iid != Q_TYPEID(QDesignerContainerExtension))
                return nullptr;

            if (auto *widget = qobject_cast<MyCustomWidget*>(object))
                return new MyContainerExtension(widget, parent);

            return nullptr;
        }

O bien, puede utilizar una fábrica existente, ampliando la función QExtensionFactory::createExtension() para que la fábrica también pueda crear su extensión. Por ejemplo:

        QObject *AGeneralExtensionFactory::createExtension(QObject *object,
                const QString &iid, QObject *parent) const
        {
            auto *widget = qobject_cast<MyCustomWidget*>(object);
            if (!widget)
                return nullptr;

            if (iid == Q_TYPEID(QDesignerTaskMenuExtension))
                return new MyTaskMenuExtension(widget, parent);

            if (iid == Q_TYPEID(QDesignerContainerExtension))
                return new MyContainerExtension(widget, parent);

            return nullptr;
        }

Para ver un ejemplo completo del uso de la clase `QExtensionFactory`, consulte el ejemplo «Extensión del menú de tareas». El ejemplo muestra cómo crear un complemento de widget personalizado para ` Qt Designer`, y cómo utilizar la clase ` QDesignerTaskMenuExtension ` para añadir elementos personalizados al menú de tareas del Diseñador de ` Qt Widgets `.

Véase también QExtensionManager y QAbstractExtensionFactory.

Documentación de funciones de miembro

[explicit] QExtensionFactory::QExtensionFactory(QExtensionManager *parent = nullptr)

Crea una fábrica de extensiones con el objeto ` parent` proporcionado.

[virtual protected] QObject *QExtensionFactory::createExtension(QObject *object, const QString &iid, QObject *parent) const

Crea una extensión especificada por iid para el object dado. El objeto de extensión se crea como un elemento secundario del parent especificado.

Véase también extension().

[override virtual] QObject *QExtensionFactory::extension(QObject *object, const QString &iid) const

Reimplementa: ` QAbstractExtensionFactory::extension(QObject *object, const QString &iid) const`.

Devuelve la extensión especificada por ` iid ` para el ` object` dado.

Véase también createExtension().

QExtensionManager *QExtensionFactory::extensionManager() const

Devuelve el gestor de extensiones de la fábrica de extensiones.

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