Qt Widgets Designerシグナルとスロット編集モード

Qt Widgets Designerの接続モードで2つのウィジェット間の信号の接続を示すスクリーンショット" src="images/designer-connection-mode.png" title="Qt Widgets Designerの接続モードで2つのウィジェット間の信号の接続を示すスクリーンショット"/>

Qt Widgets Designer のシグナルとスロットの編集モードでは、Qt のシグナルとスロットのメカニズムを使って、フォームのオブジェクト同士を接続することができます。ウィジェットもレイアウトも、Qt Widgets Designer が提供する互換性のあるシグナルとスロットのメニューを使って、直感的な接続インターフェイスで接続できます。フォームが保存されると、すべての接続が保存され、プロジェクトがビルドされたときに使用できるようになります。

Qt のシグナルとスロットのメカニズムについての詳細は、Signals and Slotsを参照してください。

オブジェクトの接続

オブジェクトの接続を開始するには、Editメニューを開き、Edit Signals/Slotsを選択するか、F4キーを押して、シグナルとスロットの編集モードに入ります。

フォーム上のすべてのウィジェットとレイアウトを連結することができます。ただし、スペーサーはレイアウトのスペーシングのヒントを与えるだけなので、他のオブジェクトと接続することはできません。

ハイライトされたオブジェクト 接続に使用できるオブジェクトの上にカーソルがある場合、そのオブジェクトはハイライトされます。

接続を行うには、マウスの左ボタンを押し、接続したいオブジェクトに向かってカーソルをドラッグします。そうすると、接続元のオブジェクトからカーソルまで線が伸びます。カーソルがフォーム上の他のオブジェクトの上にある場合、線は接続先のオブジェクトを指す矢印で終わります。これは、マウスボタンを離すと2つのオブジェクトが接続されることを示しています。

接続パスをドラッグしている間は、Escを押すことでいつでも接続を放棄することができます。

接続の作成 接続パスは、カーソルがフォーム上を移動するにつれて形を変えます。カーソルがオブジェクトの上を通過すると、そのオブジェクトはハイライトされ、シグナルとスロットの接続に使用できることを示します。接続を行うには、マウスボタンを放します。

Configure Connectionダイアログ（下図）が表示され、使用できるソースオブジェクトのシグナルとデスティネーションオブジェクトのスロットが表示されます。

接続を完了するには、ソースオブジェクトのシグナルとデスティネーションオブジェクトのスロットを選択し、OKをクリックします。接続を中止する場合は、Cancelをクリックします。

フォーム上のオブジェクト間の接続はいくつでもできます。オブジェクトからのシグナルをフォーム自体のスロットに接続することも可能です。その結果、多くのダイアログのシグナルとスロットの接続は、Qt Widgets Designer から完全に設定することができます。

フォームへの接続 オブジェクトをフォームに接続するには、カーソルをフォームの上に置き、マウスボタンを離します。接続の終点は電気的な "グラウンド "シンボルに変わります。

接続の編集と削除

デフォルトでは、接続パスは、接続に関係する信号とスロットを示す2つのラベルで作成されます。これらのラベルは通常、接続の線に沿って配置されます。接続パスの両端にある赤い四角をドラッグすると、ホスト・ウィジェット内でラベルを移動できます。

シグナル/スロットエディタ 接続で使用するシグナルとスロットは、設定後に変更することができます。接続が設定されると、Qt Widgets Designer のシグナル/スロットエディタに表示され、さらに編集することができます。接続パスまたはそのラベルをダブルクリックして接続ダイアログを表示することでも、シグナル/スロット接続を編集できます。

接続の削除 接続のパスセグメントをクリックすると、接続全体を選択することができます。一度選択した接続はDeleteキーで削除でき、UI ファイルに設定されることはありません。