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 で使用可能な拡張機能は、QDesignerContainerExtension 、QDesignerMemberSheetExtension 、QDesignerPropertySheetExtension 、QDesignerTaskMenuExtension の 4 種類です。Qt Widgets Designer の動作は、要求された拡張機能がコンテナ、メンバシート、プロパティシート、タスクメニューのいずれに関連付けられていても同じです。

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