Qt Widgets Designer でのコンテナの使用

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

Qt Widgets Designerは、コンテナ内にオブジェクトを配置するための視覚的なフィードバックを提供します。ウィジェットボックス(または他の場所)からオブジェクトをフォームにドラッグすると、カーソルがコンテナの上に置かれたときに各コンテナがハイライトされます。これは、オブジェクトを中にドロップして、コンテナの子オブジェクトにできることを示しています。このフィードバックは、実際にオブジェクトをコンテナの中に置かなくても、コンテナの近くに簡単にオブジェクトを置けるので重要です。ウィジェットもスペーサーも、コンテナの中で使うことができます。

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

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

フレーム

フレームは、ウィジェットを囲んだり、グループ化したり、装飾するために使用されます。より複雑なコンテナの基礎として使用されますが、フォームのプレースホルダとしても使用できます。

フレームの最も重要なプロパティは、frameShapeframeShadowlineWidthmidLineWidth です。これらはQFrame クラスの説明で詳しく説明されています。

グループボックス

グループ・ボックスは通常、同じような目的を持つチェックボックスやラジオボタンの集まりをグループ化するために使われます。

グループ・ボックスの重要な特性の中には、QGroupBox クラス・ドキュメントで説明されているように、titleflatcheckablechecked があります。各グループ・ボックスは独自のレイアウトを含むことができ、これは他のウィジェットを含む場合に必要です。グループ・ボックスにレイアウトを追加するには、グループ・ボックス内をクリックし、通常どおりレイアウトを適用します。

スタック・ウィジェット

スタック・ウィジェットは、一番上のレイヤーだけが表示されるウィジェットの集合体です。可視レイヤーのコントロールは、通常、シグナルとスロットを使用して、コンボボックスなどの別のウィジェットによって管理されます。

Qt Widgets Designer では、スタックを設計する際にスタック内のすべてのウィジェットを確認できるように、スタックの右上に矢印が表示されます。これらの矢印は、プレビューや最終的なコンポーネントには表示されません。スタック内のページ間を移動するには、スタックされたウィジェットを選択し、コンテキストメニューの[次のページ]および [前のページ]エントリを使用します。ページの挿入と 削除のコンテキスト・メニュー・オプションで、ページの追加と削除ができます。

タブ・ウィジェット

タブ・ウィジェットを使用すると、開発者はウィジェットの内容をラベル付きの異なるセクションに分割し、そのうちの1つだけを常に表示することができます。デフォルトでは、タブ・ウィジェットには2つのタブが含まれており、必要に応じて削除したり、名前を変更したりすることができます。タブを追加することもできます。

タブを削除するには

  • タブのラベルをクリックして、現在のタブにします。
  • タブ・ウィジェットを選択し、コンテキスト・メニューを開きます。
  • ページの削除を選択する。

新しいタブを追加するには

  • タブ・ウィジェットを選択し、コンテキスト・メニューを開きます。
  • ページの挿入」を選択します。
  • 現在のページの前または後にページを追加できます。Qt Widgets Designerは、特定のタブの新しいウィジェットを作成し、タブウィジェットに挿入します。
  • プロパティエディタで currentTabText プロパティを変更することで、現在のタブのタイトルを設定できます。
ツールボックス・ウィジェット

ツールボックス・ウィジェットは、ツールボックス内の一連のページまたはコンパートメントを提供します。スタック・ウィジェットに似た方法で扱われます。

ツールボックスのページ名を変更するには、ツールボックスを現在のパンゲットにし、プロパティエディタから currentItemText プロパティを変更します。

新しいページを追加するには、ツールボックス・ウィジェットのコンテキスト・メニューから「ページの挿入」を選択します。現在のページの前または後にページを追加することができます。

ページを削除するには、ツールボックス・ウィジェットのコンテキスト・メニューから「Delete Page」を選択します。

ドック・ウィジェット

ドック・ウィジェットは、多くの場合入力ウィジェットやより複雑なコントロールを含むフローティング・パネルで、「ドック・エリア」でメイン・ウィンドウの端に取り付けられるか、独立したツール・ウィンドウとしてフローティングされます。

ドック・ウィジェットはどのようなタイプのフォームにも追加できますが、通常はメイン・ウィンドウ・テンプレートから作成されたフォームで使用されます。

©2024 The Qt Company Ltd. ここに含まれるドキュメントの著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。