入力コントロール

Qt Quick 「コントロール」では、数値入力およびテキスト入力の両方に対応したさまざまな入力コントロールが用意されています。

各入力コントロールの種類には、それぞれ固有の想定される使用場面があります。以下のセクションでは、使用場面に応じて適切な入力コントロールの種類を選択するためのガイドラインを示します。

ComboBox コントロール

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

推奨事項：

• 値の数が非常に多い場合は、フィルターの適用を検討してください。
• リストの項目数が非常に少ない場合は、RadioButton の使用を検討してください。これにより、ユーザーがすべての選択肢を一度に確認できるという利点があります。
• デフォルト値、つまり最も頻繁に選択される値を設定してください。

関連項目： CheckBox コントロール、Tumbler コントロール。

ダイヤルコントロール

Dial は、ステレオや産業用機器などのデバイスに見られる従来のダイヤルノブに似ています。

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

高速入力が重要なアプリケーションでは、円形のinput mode が便利です。ダイヤルをクリックすると、その位置に直接移動します。

正確な入力が重要なアプリケーションでは、ダイアルがクリックされた位置を基準に微調整ができる水平および垂直入力モードが推奨されます。これらのモードは、オーディオの音量を制御するダイアルなど、値の大幅な変化が危険となる可能性のあるダイアルにも適しています。

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

TextArea コントロール

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

TextField コントロール

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

「Tumbler コントロール」も参照してください。

Slider コントロール

Slider トラックに沿ってハンドルをスライドさせて値を選択するために使用されます。

RangeSlider コントロール

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

「スライダーコントロール」も参照してください。

タンブラーコントロール

Tumbler 選択可能な項目が並んだ、回転可能なホイールです。

「コンボボックス コントロール」も参照してください。

関連情報

• Qt Quick コントロールのガイドライン