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

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

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

Qtのシグナルとスロットの仕組みに関する詳細については、「シグナルとスロット」のドキュメントを参照してください。

オブジェクトの接続

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

フォーム上のすべてのウィジェットとレイアウトは、互いに接続することができます。ただし、スペーサーはレイアウトに対して間隔のヒントを提供するだけのものであるため、他のオブジェクトとは接続できません。

強調表示されたオブジェクト 接続に使用できるオブジェクトの上にカーソルを置くと、そのオブジェクトがハイライト表示されます。

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

接続パスをドラッグしている最中は、いつでもEsc キーを押すことで接続をキャンセルできます。

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

「接続の設定」ダイアログ（下図）が表示され、使用可能な送信元オブジェクトからのシグナルと、送信先オブジェクトからのスロットが表示されます。

接続を完了するには、ソースオブジェクトのシグナルと宛先オブジェクトのスロットを選択し、[OK] をクリックします。接続を中止する場合は、[キャンセル]をクリックしてください。

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

フォームへの接続 オブジェクトをフォーム自体に接続するには、カーソルをフォームの上に置き、マウスボタンを離すだけです。接続の終端が電気的な「アース」記号に変わります。

接続の編集と削除

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

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

接続の削除 接続のパスセグメントのいずれかをクリックすると、接続全体を選択できます。選択後、Deleteキーを押すことで接続を削除でき、これによりUIファイルにその接続が設定されないようにできます。