输入控件

Qt Quick Controls 提供了多种用于数字和文本输入的输入控件。

每种输入控件都有其特定的适用场景。以下各节将根据具体场景，提供选择合适输入控件类型的指导原则。

组合框控件

ComboBox 用于从静态的多行下拉列表中选择一个值。无法添加新值，且每次只能选择一个选项。

建议：

• 如果值数量非常多，请考虑应用过滤器。
• 如果列表选项非常有限，请考虑使用RadioButton 。其优点在于用户可以同时看到所有选项。
• 选择一个默认值，即最常被选中的那个值。

另请参阅 复选框控件、拨动开关控件。

旋钮控件

Dial 类似于立体声设备或工业设备等设备上常见的传统旋钮。

通过点击并拖动来旋转拨盘，手柄指示拨盘的数值。

对于需要快速输入的应用程序，圆形input mode 非常有用，因为点击旋钮会将其直接移动到该位置。

对于重视精确输入的应用程序，建议使用水平和垂直输入模式，因为这些模式允许相对于点击旋钮的位置进行微调。对于值的大幅跳变可能不安全的旋钮（例如控制音量的旋钮），这些模式也更合适。

另请参阅 “拨盘控件”。

TextArea 控件

TextArea 是一个多行文本编辑器。

TextField 控件

TextField 是一个单行文本编辑器。

另请参阅 Tumbler 控件。

Slider 控件

Slider 用于通过沿轨道滑动手柄来选择一个值。

RangeSlider 控件

RangeSlider 用于通过沿轨道滑动每个控点，来选择由两个值指定的范围。

另请参阅 “滑块控件”。

转盘控件

Tumbler 是一个可旋转的选项轮，用于选择项目。

另请参阅 “组合框”控件。

相关信息

• Qt Quick Controls 指南