QExtensionManager Class

詳細説明

Qt Widgets Designerでは、エクステンションは必要になるまで作成されません。そのため、エクステンションを実装する場合は、QExtensionFactory 、つまりエクステンションのインスタンスを作成できるクラスを作成し、Qt Widgets Designerのエクステンションマネージャを使用して登録する必要があります。

拡張機能ファクトリの登録は通常、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;
        }

QExtensionManagerは直接インスタンス化することを意図していません。QDesignerFormEditorInterface::extensionManager() 関数を使用して、Qt Widgets Designer の拡張機能マネージャへのインターフェイスを取得できます。Qt Widgets Designerの現在のQDesignerFormEditorInterface オブジェクト（上記の例ではformEditor ）へのポインタは、QDesignerCustomWidgetInterface::initialize （）関数のパラメータで提供されます。カスタムウィジェットプラグインを実装する場合、QDesignerCustomWidgetInterface をサブクラス化してプラグインをQt Widgets Designer に公開する必要があります。

その後、拡張機能が必要になると、Qt Widgets Designer の拡張機能マネージャは、選択されたオブジェクトに対して要求された拡張機能を作成できる最初のファクトリが見つかるまで、登録されているすべてのファクトリに対してQExtensionFactory::createExtension() を呼び出します。このファクトリがエクステンションのインスタンスを作成します。

Qt Widgets Designerでは4種類のエクステンションを使用できます： QDesignerContainerExtension QDesignerMemberSheetExtension ,QDesignerPropertySheetExtension およびQDesignerTaskMenuExtension 。 Qt Widgets Designerの動作は、要求されたエクステンションがコンテナ、メンバーシート、プロパティシート、タスクメニューのいずれに関連付けられていても同じです。

QExtensionManager クラスを使用した完全な例については、タスク・メニュー拡張の例を参照してください。この例では、Qt Designer のカスタムウィジェットプラグインを作成する方法と、QDesignerTaskMenuExtension クラスを使用してQt Widgets Designer のタスクメニューにカスタム項目を追加する方法を示します。