Qt Widgets Designer プラグインの追加

Qtアプリケーションを拡張するプラグインを作成することで、Qt Widgets Designer にウィジェットを追加できます。

Qt Widgets Designer に独自のウィジェットを追加するためのプラグインを作成できます。アプリケーションにプラグインを含めるには、プラグインをダイナミックライブラリにコンパイルし、それを別途同梱します。アプリケーションは実行時にこのライブラリを検出して読み込みます。

アプリケーションは、標準のプラグインサブディレクトリ内のプラグインを検出できます。プラグインの作成方法、検索方法、およびデフォルトのプラグインパスの変更方法の詳細については、「Qt プラグインの作成方法」を参照してください。

Qt Widgets Designer 用のプラグインの作成方法の詳細については、「 Qt Widgets Designer でのカスタムウィジェットの使用」を参照してください。

Qt Widgets Designer 用プラグインの検索

Qt Widgets Designer は、標準の場所からプラグインを取得し、そのビルドキーに一致するプラグインを読み込みます。Qt Widgets Designer は、スタンドアロンアプリケーションとして、またQt Creator に統合された形で提供されています。プラグインを配置する適切なフォルダは、スタンドアロンのQt Widgets Designer を使用するか、統合版のQt Widgets Designer を使用するかによって異なります。

統合版のQt Widgets Designer は、Qt Creator のインストールディレクトリからプラグインを取得します。Designerプラグインは、Windowsでは<QtCreator>\bin\plugins\designer 、Linuxでは<QtCreator>/lib/Qt/plugins/designer 、そして Qt Creator.app/Contents/PlugIns/designer macOSでは、xml-ph-0002@deepl.internal から読み込まれます。

どのプラグインが正常に読み込まれ、どのプラグインの読み込みに失敗したかを確認するには、[Tools ] > [Form Editor ] > About Qt Widgets Designer Pluginsを選択します。

スタンドアロンのQt Widgets Designer は、プロジェクトのビルドに使用されるQtライブラリの一部であり、Qtインストールディレクトリの<Qt_version>\<compiler>\bin にあります。これは、bin の\plugins\designer サブディレクトリからプラグインを取得します。どのプラグインが正常に読み込まれ、どのプラグインが読み込みに失敗したかを確認するには、LinuxおよびWindowsではHelp >About Plugins （macOSの場合は Qt Creator macOSの場合は >About Plugins ）を選択します。

ビルドキーの一致

Windows のプリビルド Qt パッケージに含まれる `Qt Creator ` は、Microsoft Visual Studio コンパイラでビルドされています。MinGW/g++ コンパイラでビルドされた Qt バージョンをインストールした場合、ビルドキーが一致しないため、Qt Creator は Windows バージョンでビルドされたプラグインを読み込むことができません。

また、Qt Creator がビルドされたQtバージョンよりも新しい、あるいは何らかの理由で互換性のないQtバージョンを使用する場合も同様です。その場合、プラグインはQt Widgets Designer のスタンドアロン版でのみ使用可能となります。Help > About Qt Creator を選択して、Qt Creator がビルドされた際のQtバージョンとコンパイラを確認してください。

同梱の Qt バージョン用にビルドされたQt Widgets Designer プラグインを使用するには、アプリケーションで使用する構成に応じて、MinGW を使用してQt Creator を再コンパイルするか、Microsoft Visual Studio でビルドされた Qt バージョンをインストールし、Qt Creator が同じコンパイラでビルドされていることを確認してください。