コンテナの使用Qt Widgets Designer

コンテナウィジェットを使用すると、フォーム上のオブジェクトのグループを高度に制御できます。これらは、入力ウィジェットの管理、ページ分割やタブ付きレイアウトの実装、あるいは単に他のオブジェクトを収める装飾的なコンテナとしての役割など、さまざまな機能を実現するために使用できます。

Qt Widgets Designer は、コンテナ内にオブジェクトを配置する際に役立つ視覚的なフィードバックを提供します。フォーム上のウィジェットボックス（またはその他の場所）からオブジェクトをドラッグすると、カーソルがコンテナの上にくるたびに、そのコンテナがハイライト表示されます。これは、そのオブジェクトをコンテナ内にドロップして、コンテナの子オブジェクトにできることを示しています。オブジェクトをコンテナのすぐ近くに配置しても、実際にはコンテナ内に配置されていないことが多いため、この視覚的なフィードバックは重要です。コンテナ内では、ウィジェットとスペーサーの両方を使用できます。

Qt Widgets Designer では、スタック型ウィジェット、タブウィジェット、およびツールボックスが特別に扱われます。通常、独自のコードでこれらのコンテナにページ（タブ、ページ、コンパートメント）を追加する場合、プレースホルダーとして、あるいは子ウィジェットを含むものとして、既存のウィジェットを指定する必要があります。Qt Widgets Designer では、これらが自動的に作成されるため、各ページに子オブジェクトをすぐに追加することができます。

各コンテナでは通常、子オブジェクトを1つ以上のレイアウトに配置することができます。提供されるレイアウト管理の方式はコンテナごとに異なりますが、レイアウトの設定は通常、コンテナをクリックして選択し、レイアウトを適用するだけで行えます。以下の表に、利用可能なコンテナの一覧を示します。

	フレームフレームは、ウィジェットを囲んでグループ化したり、装飾を施したりするために使用されます。より複雑なコンテナの基盤として使用されるほか、フォーム内のプレースホルダーとしても利用できます。フレームの最も重要なプロパティは、`frameShape` 、`frameShadow` 、`lineWidth` 、および`midLineWidth` です。これらについては、QFrame クラスの説明で詳しく解説されています。
	グループボックスグループボックスは通常、同様の目的を持つチェックボックスやラジオボタンの集合をグループ化するために使用されます。グループボックスの重要なプロパティには、`title` 、`flat` 、`checkable` 、および`checked` があり、これらはQGroupBox クラスのドキュメントに記載されています。各グループボックスは独自のレイアウトを持つことができ、他のウィジェットを含む場合にはこれが必須となります。グループボックスにレイアウトを追加するには、その内部をクリックし、通常通りレイアウトを適用します。
	積み重ねウィジェット積み重ねられたウィジェットとは、最上層のみが表示されるウィジェットの集合体です。表示される層の制御は通常、シグナルとスロットを使用して、コンボボックスなどの別のウィジェットによって行われます。 Qt Widgets Designer スタックの右上隅に矢印が表示され、設計時にスタック内のすべてのウィジェットを確認できるようになっています。これらの矢印は、プレビューや最終的なコンポーネントには表示されません。スタック内のページ間を移動するには、スタックされたウィジェットを選択し、コンテキストメニューの「次のページ」および「前のページ」項目を使用します。コンテキストメニューの「ページの挿入」および「ページの削除」オプションを使用すると、ページの追加や削除を行うことができます。
	タブウィジェットタブウィジェットを使用すると、開発者はウィジェットのコンテンツをラベル付きの異なるセクションに分割でき、一度に表示されるのはそのうち1つだけです。デフォルトでは、タブウィジェットには2つのタブが含まれており、必要に応じてこれらを削除したり名前を変更したりできます。また、タブを追加することも可能です。タブを削除するには：そのラベルをクリックして、そのタブをアクティブなタブにします。タブウィジェットを選択し、コンテキストメニューを開きます。「ページを削除」を選択します。新しいタブを追加するには：タブウィジェットを選択し、コンテキストメニューを開きます。「ページの挿入」を選択します。現在のページの前または後にページを追加できます。「Qt Widgets Designer 」を選択すると、そのタブ専用の新しいウィジェットが作成され、タブウィジェット内に挿入されます。プロパティエディタで「`currentTabText` 」のプロパティを変更することで、現在のタブのタイトルを設定できます。
	ツールボックスウィジェット Toolboxウィジェットは、ツールボックス内の一連のページまたはコンパートメントを提供します。これらは、スタックされたウィジェットと同様の方法で処理されます。ツールボックス内のページの名前を変更するには、そのツールボックスを現在のページに設定し、プロパティエディタから`currentItemText` プロパティを変更します。新しいページを追加するには、ツールボックス・ウィジェットのコンテキストメニューから「ページの挿入」を選択します。ページは、現在のページの前または後に追加できます。ページを削除するには、ツールボックスウィジェットのコンテキストメニューから [ページの削除] を選択します。
	ドックウィジェットドックウィジェットは、入力ウィジェットやより複雑なコントロールを含むことが多いフローティングパネルであり、「ドック領域」としてメインウィンドウの端に固定されるか、独立したツールウィンドウとして表示されます。ドックウィジェットはどのタイプのフォームにも追加できますが、通常はメインウィンドウテンプレートから作成されたフォームで使用されます。

フォームの保存、プレビュー、および印刷メインウィンドウの作成

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.

	フレームフレームは、ウィジェットを囲んでグループ化したり、装飾を施したりするために使用されます。より複雑なコンテナの基盤として使用されるほか、フォーム内のプレースホルダーとしても利用できます。フレームの最も重要なプロパティは、`frameShape` 、`frameShadow` 、`lineWidth` 、および`midLineWidth` です。これらについては、QFrame クラスの説明で詳しく解説されています。
	グループボックスグループボックスは通常、同様の目的を持つチェックボックスやラジオボタンの集合をグループ化するために使用されます。グループボックスの重要なプロパティには、`title` 、`flat` 、`checkable` 、および`checked` があり、これらはQGroupBox クラスのドキュメントに記載されています。各グループボックスは独自のレイアウトを持つことができ、他のウィジェットを含む場合にはこれが必須となります。グループボックスにレイアウトを追加するには、その内部をクリックし、通常通りレイアウトを適用します。
	積み重ねウィジェット積み重ねられたウィジェットとは、最上層のみが表示されるウィジェットの集合体です。表示される層の制御は通常、シグナルとスロットを使用して、コンボボックスなどの別のウィジェットによって行われます。 Qt Widgets Designer スタックの右上隅に矢印が表示され、設計時にスタック内のすべてのウィジェットを確認できるようになっています。これらの矢印は、プレビューや最終的なコンポーネントには表示されません。スタック内のページ間を移動するには、スタックされたウィジェットを選択し、コンテキストメニューの「次のページ」および「前のページ」項目を使用します。コンテキストメニューの「ページの挿入」および「ページの削除」オプションを使用すると、ページの追加や削除を行うことができます。
	タブウィジェットタブウィジェットを使用すると、開発者はウィジェットのコンテンツをラベル付きの異なるセクションに分割でき、一度に表示されるのはそのうち1つだけです。デフォルトでは、タブウィジェットには2つのタブが含まれており、必要に応じてこれらを削除したり名前を変更したりできます。また、タブを追加することも可能です。タブを削除するには：そのラベルをクリックして、そのタブをアクティブなタブにします。タブウィジェットを選択し、コンテキストメニューを開きます。「ページを削除」を選択します。新しいタブを追加するには：タブウィジェットを選択し、コンテキストメニューを開きます。「ページの挿入」を選択します。現在のページの前または後にページを追加できます。「Qt Widgets Designer 」を選択すると、そのタブ専用の新しいウィジェットが作成され、タブウィジェット内に挿入されます。プロパティエディタで「`currentTabText` 」のプロパティを変更することで、現在のタブのタイトルを設定できます。
	ツールボックスウィジェット Toolboxウィジェットは、ツールボックス内の一連のページまたはコンパートメントを提供します。これらは、スタックされたウィジェットと同様の方法で処理されます。ツールボックス内のページの名前を変更するには、そのツールボックスを現在のページに設定し、プロパティエディタから`currentItemText` プロパティを変更します。新しいページを追加するには、ツールボックス・ウィジェットのコンテキストメニューから「ページの挿入」を選択します。ページは、現在のページの前または後に追加できます。ページを削除するには、ツールボックスウィジェットのコンテキストメニューから [ページの削除] を選択します。
	ドックウィジェットドックウィジェットは、入力ウィジェットやより複雑なコントロールを含むことが多いフローティングパネルであり、「ドック領域」としてメインウィンドウの端に固定されるか、独立したツールウィンドウとして表示されます。ドックウィジェットはどのタイプのフォームにも追加できますが、通常はメインウィンドウテンプレートから作成されたフォームで使用されます。