クイックスタートQt Widgets Designer

Qt Widgets Designer を使うには、4 つの基本ステップがあります:

  1. フォームとオブジェクトを選ぶ
  2. フォーム上にオブジェクトを配置する
  3. 信号をスロットに接続する
  4. フォームをプレビューする

赤、緑、青の値を変更するスライダーを備えたRGBコントローラーを示すスクリーンショット

赤、緑、青(RGB)の値を操作するのに必要なコントロールを含む小さなウィジェット(上のスクリーンショットを参照)を設計したいとします。

ウィンドウに追加するすべてのコンポーネントを含むリストのフォームを示すスクリーンショットフォームの選択

まず、新規フォームダイアログから ウィジェットを選びます。

rgbコントローラーのコンポーネントの配置を示すスクリーンショットフォームにウィジェットを配置する

つのラベル、3つのスピンボックス、3つの垂直スライダーをフォームにドラッグします。ラベルのデフォルトテキストを変更するには、ラベルをダブルクリックするだけです。配置の仕方は自由です。

プログラムでこのように正確にレイアウトするためには、これらのウィジェットをレイアウトに配置する必要があります。これを3つのグループに分けて行います。RED "ラベルを選択します。次に、Ctrlを押しながら、対応するスピンボックスとスライダーを選択します。フォームメニューで、グリッドにレイアウトを選択します。

rgbコントローラーのコンポーネントの配置を示すスクリーンショット。Qt Widgets Designer エディタでグリッドにレイアウトするオプションを示すスクリーンショット。

他の2つのラベルと、それに対応するスピンボックスとスライダーも同様にステップを繰り返します。

次のステップでは、3つのレイアウトを1つのメインレイアウトにまとめます。メインレイアウトは、トップレベル・ウィジェット(この場合、QWidget )のレイアウトです。トップ・レベル・ウィジェットにレイアウトを設定することが重要です。そうしないと、ウィンドウのサイズが変更されたときに、ウィンドウ上のウィジェットのサイズが変更されません。レイアウトを設定するには、3つのレイアウト以外のフォーム上の任意の場所で右クリックし、[Lay Out Horizontally]を選択します。また、「グリッドでレイアウト」を選択しても、同じレイアウトになります(下図)。

最終レイアウトの結果を示すスクリーンショット

注意: メインレイアウトはフォーム上に表示されません。メインレイアウトがインストールされているか確認するには、フォームのサイズを変更してみてください。また、Qt Widgets Designerオブジェクトインスペクタを見ることもできます。トップレベルのウィジェットにレイアウトがない場合、その横に壊れたレイアウトのアイコンが表示されます。トップレベル・レイアウトなしのオプションを示すスクリーンショット

スライダーをクリックして特定の値までドラッグすると、スピンボックスにスライダーの位置が表示されます。この動作を実現するには、スライダーのvalueChanged() 信号をスピンボックスのsetValue() スロットに接続する必要があります。また、スピンボックスのvalueChanged() 信号をスライダーのsetValue() スロットに接続するなど、逆の接続も必要です。

これを行うには、F4キーを押すか、EditメニューからEdit Signals/Slotsを選択して、Edit Signals/Slotsモードに切り替える必要があります。

スライダーとスピンボックス間の信号接続を示すrgbコントローラーのスクリーンショット信号をスロットに接続する

スライダーをクリックし、カーソルをスピンボックスに向かってドラッグします。下図のConfigure Connectionダイアログがポップアップします。正しいシグナルとスロットを選択し、OKをクリックします。

スピンボックスとスライダーを接続し、スピンボックスの値がスライダーを変更する設定を示すスクリーンショット。

スピンボックスをクリックし、カーソルをスライダーの方にドラッグして、スピンボックスのvalueChanged ()信号をスライダーのsetValue ()スロットに接続する、という手順を(逆の順序で)繰り返します。

以下のスクリーンショットを参考に、正しいシグナルとスロットを選択してください。

スライダーとスピンボックスを接続し、スライダーがスピンボックスの値を変更するための設定を示すスクリーンショット。

RGBコントローラーの "RED "コンポーネントのオブジェクトをうまく接続できたので、"GREEN "と "BLUE "コンポーネントも同様に接続してください。

RGBの値の範囲は0から255なので、スピンボックスとスライダーをその特定の範囲に制限する必要があります。

スピンボックスに入力できる最小値と最大値を変更するオプションを示すスクリーンショットウィジェットのプロパティを設定する

最初のスピンボックスをクリックします。プロパティエディタ内に、QSpinBox'のプロパティが表示されます。maximum プロパティに "255" を入力します。次に、最初の垂直スライダーをクリックすると、QAbstractSlider のプロパティが表示されます。同様に、maximum プロパティに「255」を入力します。残りのスピンボックスとスライダーもこの操作を繰り返します。

Ctrl + R を押すか、フォームメニューからプレビューを選択します。スライダーをドラッグしてみましょう - スピンボックスもその値を反映します (逆も同様です)。また、子ウィジェットを管理するために使用されるレイアウトが、異なるウィンドウサイズにどのように対応するかを確認するために、サイズを変更することもできます。

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.