Qt Widgets Designerのウィジェット編集モード

ウィジェット編集モードでは、メインウィンドウのウィジェットボックスからフォームへオブジェクトをドラッグしたり、編集やサイズ変更を行ったり、フォーム上でドラッグして配置を変更したり、さらにはフォーム間でオブジェクトをドラッグして移動させたりすることができます。オブジェクトのプロパティはインタラクティブに変更できるため、変更内容が即座に反映されます。 編集インターフェースは、単純な操作には直感的でありながら、Qtの強力なレイアウト機能もサポートしています。

新しいフォームを作成・編集するには、[ファイル] メニューから [新規フォーム...]を選択するか、Ctrl+N キーを押します。既存のフォームを編集するには、[ファイル] メニューから [フォームを開く...]を選択するか、Ctrl+O キーを押します。

いつでも、「ファイル」メニューから「名前を付けて保存...」オプションを選択して、フォームを保存できます。Qt Widgets Designer で保存されたUIファイルには、使用されているオブジェクトに関する情報や、それら間のシグナルとスロットの接続に関する詳細情報が含まれています。

フォームの編集

デフォルトでは、新しいフォームはウィジェット編集モードで開かれます。他のモードから編集モードに切り替えるには、[編集]メニューから [ウィジェットの編集]を選択するか、F3キーを押します。

オブジェクトをフォームに追加するには、メインのウィジェットボックスからオブジェクトをドラッグし、フォーム上の目的の場所にドロップします。配置後は、ドラッグするか、カーソルキーを使用することで、オブジェクトを自由に移動させることができます。Ctrlキーを同時に押すと、選択したウィジェットがピクセル単位で移動します。一方、カーソルキーのみを使用すると、選択したウィジェットは移動時にグリッドにスナップします。オブジェクトは、マウスの左ボタンでクリックすることで選択できます。また、Tabキーを使用して選択対象を切り替えることもできます。

ウィジェットボックスには、さまざまなカテゴリのオブジェクトが含まれており、これらすべてを必要に応じてフォーム上に配置できます。少し準備が必要なオブジェクトは、コンテナウィジェットだけです。これらについては、「 Qt Widgets Designer でのコンテナの使用」の章でさらに詳しく説明しています。

オブジェクトの選択 フォーム上のオブジェクトは、マウスの左ボタンでクリックすることで選択します。オブジェクトが選択されると、各角と各辺の中点にサイズ変更ハンドルが表示され、サイズ変更が可能であることを示します。 さらにオブジェクトを選択するには、Controlキーを押したままクリックします。複数のオブジェクトが選択されている場合、現在選択されているオブジェクトは、異なる色のサイズ変更ハンドルで表示されます。 レイアウト内でウィジェットを移動するには、Shift キーとControl キーを押し続けながらウィジェットをドラッグします。これにより、選択範囲がウィジェットの親レイアウトまで拡張されます。 あるいは、「オブジェクトインスペクタ」でオブジェクトを選択することもできます。

ウィジェットが選択されているときは、切り取り、コピー、貼り付けといった通常のクリップボード操作を行うことができます。これらの操作はすべて、必要に応じて実行したり元に戻したりすることができます。

以下のショートカットを使用できます：

上記の操作（クローン作成を除く）はすべて、「編集」メニューおよびフォームのコンテキストメニューから実行できます。これらのメニューには、オブジェクトの配置機能に加え、フォーム上のすべてのオブジェクトを選択する「すべて選択」機能も用意されています。

ウィジェットは固有のオブジェクトではありません。必要に応じていくつでもコピーを作成できます。ウィジェットを素早く複製するには、Ctrlキーを押したままドラッグしてクローンを作成します。これにより、クリップボード操作よりも迅速にウィジェットをコピーしてフォーム上に配置することができます。

ドラッグ＆ドロップ Qt Widgets Designer では、Qtが提供するドラッグ＆ドロップ機能を幅広く活用しています。Qt Widgetsはウィジェットボックスからドラッグして、フォーム上にドロップすることができます。 また、ウィジェットをフォーム上で「複製」することもできます。Ctrl キーを押したままウィジェットをドラッグすると、そのウィジェットのコピーが作成され、新しい位置にドラッグして配置することができます。 また、ウィジェットをオブジェクトインスペクタ上にドロップすることで、ネストされたレイアウトを簡単に扱うことも可能です。

Qt Widgets Designer この機能により、選択したオブジェクトをコピー、貼り付け、あるいはフォーム間でドラッグすることができます。この機能を使用すると、同じフォームのコピーを複数作成し、それぞれで異なるレイアウトを試すことができます。

プロパティエディタ

プロパティエディタには、常にフォーム上で現在選択されているオブジェクトのプロパティが表示されます。利用可能なプロパティは編集中のオブジェクトによって異なりますが、提供されているすべてのウィジェットには、objectName （オブジェクトの内部名）やenabled （オブジェクトと対話できるかどうかを決定するプロパティ）といった共通のプロパティがあります。

プロパティの編集 プロパティエディタは、フォーム上のオブジェクトのプロパティを管理するために、標準のQt Widgetsを使用します。テキスト型のプロパティはラインエディタに、整数型のプロパティはスピンボックスに、ブール型のプロパティはチェックボックスに表示され、色やサイズなどの複合型プロパティは、入力ウィジェットのドロップダウンリストで表示されます。 変更されたプロパティは、ラベルが太字で表示されます。これらをリセットするには、右側の矢印ボタンをクリックしてください。 プロパティの変更は、同じプロパティを持つ選択されたすべてのオブジェクトに適用されます。

プロパティエディタでは、特定のプロパティが特別に扱われます：

• 複合プロパティ（複数の値で構成されるプロパティ）は、展開可能なノードとして表示され、その値を編集することができます。
• フラグの選択や組み合わせを含むプロパティは、チェック可能な項目を備えたコンボボックスを介して編集されます。
• QPalette などのリッチなデータ型へのアクセスを許可するプロパティは、プロパティの編集時に開くダイアログを使用して変更されます。QLabel およびウィジェットボックスの「ボタン」セクションにあるウィジェットには、text というプロパティがあり、ウィジェットをダブルクリックするか、F2キーを押すことで編集することもできます。Qt Widgets Designer バックスラッシュ (\) 文字は特別な意味を持ち、テキスト内に改行文字 (\n) を挿入することができます。また、\\ という文字列を使用すると、テキスト内にバックスラッシュを 1 つ挿入できます。編集中にコンテキストメニューを開くこともでき、テキストに特殊文字や改行を挿入する別の方法として利用できます。

動的プロパティ

プロパティエディタを使用すると、標準のQt Widgetsやフォーム自体に新しいdynamic properties を追加することもできます。Qt 4.4以降、動的プロパティの追加および削除は、以下に示すプロパティエディタのツールバーを介して行われます。

動的プロパティを追加するには、「追加」ボタン をクリックします。削除するには、「削除」ボタン をクリックします。また、「設定」ボタン をクリックすることで、プロパティをアルファベット順に並べ替えたり、カラーグループを変更したりすることもできます。

オブジェクトインスペクタ

オブジェクトインスペクタ オブジェクトインスペクタには、現在編集中のフォーム上のすべてのオブジェクトが階層リストとして表示されます。コンテナウィジェットやレイアウトの子オブジェクトを表示するには、オブジェクトラベルの横にあるハンドルをクリックします。 フォーム上の各オブジェクトは、オブジェクトインスペクタ内の対応する項目をクリックすることで選択できます。右クリックすると、フォームのコンテキストメニューが開きます。これらの機能は、重なり合うオブジェクトが多数ある場合に便利です。オブジェクトインスペクタ内でオブジェクトを検索するには、Ctrl+F を使用してください。 Qt 4.4 以降、オブジェクト名をダブルクリックすると、インプレースエディタを使用してオブジェクト名を変更できるようになりました。 Qt 4.5 以降、オブジェクトインスペクタにはコンテナのレイアウト状態が表示されます。レイアウトに問題がある場合は、レイアウト異常を示すアイコン ###ICON が表示されます。