QExtensionManager Class

Description détaillée

Dans le Designer d'Qt Widgets, les extensions ne sont créées qu'au moment où elles sont requises. C'est pourquoi, lors de l'implémentation d'une extension, vous devez également créer une « QExtensionFactory », c'est-à-dire une classe capable de créer une instance de votre extension, puis l'enregistrer à l'aide du gestionnaire d'extensions du Designer d'Qt Widgets.

L'enregistrement d'une fabrique d'extensions s'effectue généralement dans la fonction 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;
        }

Le `QExtensionManager` n’est pas destiné à être instancié directement. Vous pouvez récupérer une interface vers le gestionnaire d'extensions d'Qt Widgets Designer à l'aide de la fonction QDesignerFormEditorInterface::extensionManager(). Un pointeur vers l'objet QDesignerFormEditorInterface actuel d'Qt Widgets Designer (formEditor dans l'exemple ci-dessus) est fourni par le paramètre de la fonction QDesignerCustomWidgetInterface::initialize(). Lors de l'implémentation d'un plugin de widget personnalisé, vous devez créer une sous-classe de QDesignerCustomWidgetInterface afin d'exposer votre plugin à Qt Widgets Designer.

Ensuite, lorsqu’une extension est requise, le gestionnaire d’extensions d’ Qt Widgets Designer parcourt toutes ses fabriques enregistrées en appelant QExtensionFactory::createExtension() pour chacune d’entre elles, jusqu’à ce qu’il trouve la première capable de créer l’extension demandée pour l’objet sélectionné. Cette fabrique créera alors une instance de l’extension.

Il existe quatre types d’extensions disponibles dans l’ Qt Widgets Designer : QDesignerContainerExtension, QDesignerMemberSheetExtension, QDesignerPropertySheetExtension et QDesignerTaskMenuExtension. Le comportement de l’ Qt Widgets Designer est le même, que l’extension demandée soit associée à un conteneur, à une feuille de membres, à une feuille de propriétés ou à un menu de tâches.

Pour un exemple complet utilisant la classe QExtensionManager, consultez l'exemple « Extension du menu des tâches ». Cet exemple montre comment créer un plugin de widget personnalisé pour Qt Designer, et comment utiliser la classe QDesignerTaskMenuExtension pour ajouter des éléments personnalisés au menu des tâches de Qt Widgets Designer.