入力コントロール

Qt Quick Controls は、数値入力とテキスト入力の両方に対応するさまざまな入力コントロールを提供します。

各タイプの入力コントロールには、それぞれ固有のターゲットとなるユースケースがあります。以下のセクションでは、ユースケースに応じて適切な入力コントロールのタイプを選択するためのガイドラインを提供します。

コンボボックス

ComboBox は、静的な複数行のドロップダウンリストから値を選択するために使用されます。新しい値を追加することはできず、選択できる選択肢は1つだけです。

推奨事項

• 値の数が非常に多い場合は、フィルタの適用を検討してください。
• リストが非常に限られている場合は、RadioButton の使用を検討してください。これには、ユーザーがすべてのオプションを同時に見ることができるという利点があります。
• デフォルト値（最も頻繁に選択される値）を選択します。

チェックボックス・コントロール、タンブラー・コントロールも参照してください。

ダイヤルコントロール

Dial は、ステレオや産業機器などに見られる伝統的なダイヤルノブに似ています。

ダイヤルはクリックとドラッグで回転し、ハンドルがダイヤルの値を示します。

高速入力が重要な用途では、ダイヤルをクリックするとその位置に直接移動する円形input mode が便利です。

正確な入力が重要な用途では、水平入力モードと垂直入力モードが推奨されます。これらのモードでは、ダイヤルをクリックした位置に対して微調整を行うことができるからです。これらのモードは、オーディオの音量を調節するダイヤルのように、値が大きくジャンプして安全でないようなダイヤルにも適しています。

タンブラーコントロールも参照してください。

テキストエリアコントロール

TextArea は、複数行のテキストエディタです。

テキストフィールドコントロール

TextField は、単一行のテキストエディタです。

タンブラーコントロールもご覧ください。

スライダーコントロール

Slider トラックに沿ってハンドルをスライドさせて値を選択します。

レンジスライダーコントロール

RangeSlider トラックに沿って各ハンドルをスライドさせることで、2 つの値で指定された範囲を選択するために使用します。

スライダーコントロール」も参照。

タンブラーコントロール

Tumbler 選択可能な項目のホイールを回転させるコントロール。

コンボボックス コントロールもご覧ください。

関連情報

• Qt Quick Controls ガイドライン