输入控件

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

每种类型的输入控件都有其特定的目标用例。以下各节提供了根据用例选择适当类型输入控件的指南。

组合框控件

ComboBox 用于从静态多行下拉列表中选择一个值。它不能添加新值，而且只能选择一个选项。

建议

• 如果值的数量非常多，可以考虑应用过滤器。
• 如果列表非常有限，可以考虑使用RadioButton 。这样做的好处是用户可以同时看到所有选项。
• 选择默认值，即最常选择的值。

另请参阅 复选框控件、滚轮控件。

拨盘控制

Dial 类似于音响或工业设备上的传统拨盘旋钮。

通过点击和拖动来旋转刻度盘，手柄显示刻度盘的值。

对于需要快速输入的应用，圆形input mode 非常有用，因为点击刻度盘就会直接移动到该位置。

对于需要精确输入的应用，建议使用水平和垂直输入模式，因为这些模式允许相对于点击刻度盘的位置进行微调。这些模式也更适用于数值大幅跳动可能不安全的刻度盘，如控制音频音量的刻度盘。

另请参阅 滚轮控件。

文本区域控件

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

文本字段控件

TextField 是单行文本编辑器。

另请参阅 Tumbler Control。

滑块控件

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

RangeSlider 控件

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

另请参阅 滑块控件。

滚轮控件

Tumbler 是一个可选择项目的可旋转滚轮。

另请参阅 ComboBox 控件。

相关信息

• Qt Quick Controls 指南