En esta página

QExtensionManager Class

La clase QExtensionManager proporciona funciones de gestión de extensiones para Qt Widgets Designer. Más información...

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

Funciones públicas

QExtensionManager(QObject *parent = nullptr)
virtual ~QExtensionManager()

Funciones públicas reimplementadas

virtual QObject *extension(QObject *object, const QString &iid) const override
virtual void registerExtensions(QAbstractExtensionFactory *factory, const QString &iid = QString()) override
virtual void unregisterExtensions(QAbstractExtensionFactory *factory, const QString &iid = QString()) override
T qt_extension(QAbstractExtensionManager *manager, QObject *object)

Macros

Q_DECLARE_EXTENSION_INTERFACE(ExtensionName, Identifier)

Descripción detallada

En Qt Widgets Designer, las extensiones no se crean hasta que son necesarias. Por ese motivo, al implementar una extensión, también debes crear una « QExtensionFactory », es decir, una clase capaz de crear una instancia de tu extensión, y registrarla mediante el gestor de extensiones de Qt Widgets Designer.

El registro de una fábrica de extensiones se suele realizar en la función QDesignerCustomWidgetInterface::initialize():

        void MyPlugin::initialize(QDesignerFormEditorInterface *formEditor)
        {
            if (initialized)
                return;

            auto *manager = formEditor->extensionManager();
            Q_ASSERT(manager != nullptr);

            manager->registerExtensions(new MyExtensionFactory(manager),
                                        Q_TYPEID(QDesignerTaskMenuExtension));

            initialized = true;
        }

El QExtensionManager no está pensado para ser instanciado directamente. Puedes obtener una interfaz al gestor de extensiones de Qt Widgets Designer mediante la función QDesignerFormEditorInterface::extensionManager(). La función QDesignerCustomWidgetInterface::initialize() proporciona, como parámetro, un puntero al objeto QDesignerFormEditorInterface actual de Qt Widgets Designer(formEditor en el ejemplo anterior). Al implementar un complemento de widget personalizado, debes crear una subclase de QDesignerCustomWidgetInterface para exponer tu complemento a Qt Widgets Designer.

A continuación, cuando se requiera una extensión, el gestor de extensiones de Qt Widgets Designer recorrerá todas sus fábricas registradas llamando a QExtensionFactory::createExtension() para cada una de ellas hasta encontrar la primera que sea capaz de crear la extensión solicitada para el objeto seleccionado. Esta fábrica creará entonces 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 Widgets Designer es el mismo independientemente de si la extensión solicitada está asociada a un contenedor, una hoja de miembros, una hoja de propiedades o un menú de tareas.

Para ver un ejemplo completo del uso de la clase `QExtensionManager`, 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 de ` Qt Widgets Designer`.

Véase también QExtensionFactory y QAbstractExtensionManager.

Documentación de las funciones de miembro

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

Crea un gestor de extensiones con el parent especificado.

[virtual noexcept] QExtensionManager::~QExtensionManager()

Elimina el gestor de extensiones

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

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

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

[override virtual] void QExtensionManager::registerExtensions(QAbstractExtensionFactory *factory, const QString &iid = QString())

Reimplementa: ` QAbstractExtensionManager::registerExtensions` (`QAbstractExtensionFactory *factory, const QString &iid)`.

Registra la extensión especificada por la clase factory proporcionada y el identificador de extensión iid.

[override virtual] void QExtensionManager::unregisterExtensions(QAbstractExtensionFactory *factory, const QString &iid = QString())

Reimplementa: QAbstractExtensionManager::unregisterExtensions(QAbstractExtensionFactory *factory, const QString &iid).

Da de baja la extensión especificada por el objeto ` factory ` proporcionado y el identificador de extensión ` iid`.

Elementos no miembros relacionados

template <typename T> T qt_extension(QAbstractExtensionManager *manager, QObject *object)

Devuelve la extensión del objeto « object » convertido al tipo T si el objeto es de tipo T (o de una subclase); en caso contrario, devuelve 0. La extensión se obtiene utilizando la extensión dada « manager ».

       auto *manager = formEditor->extensionManager();

       auto *propertySheet = qt_extension<QDesignerPropertySheetExtension*>(manager, widget);

       if(propertySheet) {...}

Al implementar un complemento de widget personalizado, la función QDesignerCustomWidgetInterface::initialize() proporciona, como parámetro, un puntero al objeto QDesignerFormEditorInterface actual de Qt Widgets Designer(formEditor).

Si el widget del ejemplo anterior no tiene definido un ` QDesignerPropertySheetExtension`, ` propertySheet ` será un puntero nulo.

Documentación de macros

Q_DECLARE_EXTENSION_INTERFACE(ExtensionName, Identifier)

Asocia el Identifier dado (un literal de cadena) a la clase de extensión denominada ExtensionName. El Identifier debe ser único. Por ejemplo:

   Q_DECLARE_EXTENSION_INTERFACE(MyExtension, "com.mycompany.myproduct.myextension")

Utilizar los nombres de la empresa y del producto es una buena forma de garantizar la unicidad del identificador.

Al implementar una clase de extensión personalizada, debes utilizar Q_DECLARE_EXTENSION_INTERFACE() para habilitar el uso de la función qt_extension(). La macro suele situarse justo después de la definición de la clase ExtensionName, en el archivo de cabecera asociado.

Véase también Q_DECLARE_INTERFACE().

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