QExtensionManager Class

Descripción detallada

En Qt Widgets Designer las extensiones no se crean hasta que son necesarias. Por esa razón, al implementar una extensión, también debe crear una QExtensionFactory, es decir, una clase que sea capaz de crear una instancia de su extensión, y registrarla utilizando el gestor de extensiones de Qt Widgets Designer.

El registro de una fábrica de extensiones se hace típicamente 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. Puede recuperar una interfaz al gestor de extensiones de Qt Widgets Designer usando la función QDesignerFormEditorInterface::extensionManager(). El parámetro de la función QDesignerCustomWidgetInterface::initialize() proporciona un puntero al objeto QDesignerFormEditorInterface actual de Qt Widgets Designer (formEditor en el ejemplo anterior). Al implementar un plugin de widget personalizado, debe subclasificar el QDesignerCustomWidgetInterface para exponer su plugin a Qt Widgets Designer.

Entonces, 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 hasta encontrar la primera que sea capaz de crear la extensión solicitada para el objeto seleccionado. 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. Qt Widgets El comportamiento de Designer es el mismo si la extensión solicitada está asociada a un contenedor, una hoja de miembros, una hoja de propiedades o un menú de tareas.

Para un ejemplo completo utilizando la clase QExtensionManager, vea el ejemplo de Extensión de 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.