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 の拡張機能マネージャーへのインターフェースを取得できます。QDesignerCustomWidgetInterface::initialize()関数のパラメータには、Qt Widgets Designer の現在のQDesignerFormEditorInterface オブジェクト（上記の例ではformEditor ）へのポインタが渡されます。カスタムウィジェットプラグインを実装する際は、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 のタスクメニューにカスタム項目を追加する方法を示しています。