メインウィンドウの作成Qt Widgets Designer

Qt Widgets Designer は、さまざまな目的のユーザーインターフェースを作成するために使用でき、各ユーザーインターフェースごとに異なる種類のフォームテンプレートを提供しています。メインウィンドウテンプレートは、メニューバー、ツールバー、およびドックウィジェットを備えたアプリケーションウィンドウを作成するために使用されます。

「ファイル」メニューを開き、「新規フォーム...」オプションを選択するか、Ctrl+N キーを押して、新しいメインウィンドウを作成します。次に、「メインウィンドウ」テンプレートを選択します。このテンプレートでは、デフォルトでメニューバーとツールバーを含むメインアプリケーションウィンドウが提供されます。これらは必要ない場合は削除することもできます。

メニューバーを削除した場合、メインウィンドウフォーム内を右クリックして表示されるコンテキストメニューから「メニューバーの作成」オプションを選択することで、新しいメニューバーを作成できます。

アプリケーションにはメニューバーは1つしか持つことができませんが、ツールバーは複数持つことができます。

メニュー

メニューは、「Type Here」というプレースホルダーを編集することでメニューバーに追加されます。これらのプレースホルダーのうち1つは編集用として常に表示されており、プレビューや完成したウィンドウには表示されません。

メニューを作成すると、プロパティエディタを使用してそのプロパティにアクセスできます。また、この目的で各メニューにアクセスするには、オブジェクトインスペクタを使用します。

既存のメニューを削除するには、メニューバーのラベル上でコンテキストメニューを開き、「メニュー『menu_name』を削除」を選択します。

メニューの作成

プレースホルダー項目をダブルクリックして編集を開始します。ラインエディットで表示されるメニューのテキストは、変更可能です。

新しいメニューに必要なテキストを入力します。アンパサンド記号（&）を入力すると、その後に続く文字がメニューのニーモニックとして使用されます。

Return キーまたはEnterキーを押して新しいテキストを確定するか、Escape キーを押して破棄します。必要に応じて、後で編集操作を元に戻すことができます。

また、メニューバー上のメニューは、目的の場所にドラッグ＆ドロップするだけで並べ替えることができます。縦の赤い線は、メニューが挿入される位置を示しています。

メニューには、任意の数の項目や区切り記号を含めることができ、必要な深さまでネストさせることも可能です。メニューに新しい項目を追加するには、通常どおりメニュー構造を操作します。

メニュー項目の作成

「ここにタイプ」というプレースホルダーをダブルクリックして編集を開始するか、「区切り線を追加」をダブルクリックして、メニューの最後の項目後に新しい区切り線を挿入します。

メニュー項目のテキストはラインエディットで表示され、変更することができます。

新しい項目に必要なテキストを入力します。必要に応じて、アンパサンド記号 (&) を使用して、その項目のニーモニックとして使用する文字を指定することもできます。

Return キーまたはEnter キーを押して新しいテキストを確定するか、Escape キーを押して破棄します。このメニュー項目用に作成されたアクションは、アクションエディタからアクセス可能であり、関連するキーボードショートカットはそこで設定できます。

メニューと同様に、項目はドラッグ＆ドロップで希望の位置に移動させることができます。閉じたメニューの上に項目をドラッグすると、メニューが開き、そこに項目を挿入できるようになります。メニュー項目はアクションに基づいているため、ツールバーにドロップすることも可能で、その場合はツールバーボタンとして表示されます。

ツールバー

ツールバーの作成と削除

ツールバーは、メニューバーと同様の方法でメインウィンドウに追加されます。フォームのコンテキストメニューから「ツールバーの追加」オプションを選択します。あるいは、メインウィンドウに既存のツールバーがある場合は、その右端にある矢印をクリックして新しいツールバーを作成することもできます。

ツールバーをフォームから削除するには、そのツールバーのコンテキストメニューにある項目を使用します。

ツールバーボタンの追加と削除

ツールバーボタンは、アクションエディタでアクションとして作成され、ツールバーにドラッグして配置されます。アクションはメニュー項目やツールバーボタンとして表示できるため、メニューとツールバーの間で移動させることができます。

メニューとツールバーでアクションを共有するには、そのアクションのアイコンを、エントリが配置されているメニューからではなく、アクションエディタからツールバーへドラッグします。この手順の詳細については、「アクションの追加」を参照してください。

ツールバーボタンは、ツールバーのコンテキストメニューから削除します。

アクション

メニューバーとツールバーの配置が完了したら、次はそれらにアクションを追加します。メニューとツールバーの両方に対する新しいアクションは、アクションエディタウィンドウで作成されるため、アクションの作成と管理が簡素化されます。

アクションエディタ

「ツール」メニューを開き、「アクションエディタ」オプションをオンにすることで、アクションエディタを有効にします。

アクションエディタでは、「新しいアクションの作成」や「アクションの削除」を行うことができます。また、アクションのテキストを用いた検索機能「フィルタ」も利用できます。

Qt Widgets Designerこのアクションエディタは、従来の「アイコン表示」と「詳細表示」で表示できます。以下のスクリーンショットは、「詳細表示」でのアクションエディタを示しています。また、メニュー、ツールバー、フォーム間でアクションをコピーして貼り付けることもできます。

アクションの作成

アクションを作成するには、アクションエディタの［新規］ボタンを使用します。これにより、入力ダイアログが表示されます。新しいアクションに［テキスト］を入力してください。これは、メニュー項目やアクションのツールチップに表示されるテキストです。このテキストには自動的に「action」という接頭辞が追加され、アクションのオブジェクト名が生成されます。

さらに、このダイアログでは、アクション用のアイコンを選択したり、現在のアイコンを削除したりするオプションも用意されています。

アクションの作成が完了すると、アクションが適用可能な場所であればどこでも使用できるようになります。

アクションの追加

メニューやツールバーにアクションを追加するには、アクションエディタ上でそのアクションを左クリックし、目的の場所にドラッグするだけです。

Qt Widgets Designer アクションが追加される位置を示すハイライトされたガイドラインが表示されます。適切な位置が見つかったら、マウスボタンを離してアクションを追加してください。

ウィジェットのドッキング

ドックウィジェットもコンテナウィジェットの一種です。これらは、目的のドック領域にドラッグ＆ドロップすることで、フォームに追加できます。

ドックウィジェットの追加

フォームにドックウィジェットを追加するには、ウィジェットボックスの「コンテナ」セクションからウィジェットをドラッグし、メインのフォーム領域にドロップします。既存のレイアウトにドックウィジェットを追加しないでください。代わりに、プロパティエディタを開き、「ドック」プロパティを有効にして、ドック領域に配置してください。

なお、中央のウィジェットにレイアウトを適用する前に、フォームにドックウィジェットを追加しておくと、設定がしやすい場合があります。たとえば、ドックから外してサイズを変更できるため、子ウィジェットの追加がより便利になります。

ドックウィジェットは、必要に応じて独立したツールウィンドウとしてフローティング表示することができます。そのため、windowTitle プロパティを設定してウィンドウタイトルを付けると便利です。これは、フォーム上でウィジェットを識別するのにも役立ちます。