C

数码旋钮 QML 类型

旋转以设置值的圆形旋钮。 更多信息...

导入声明import QtQuick.Controls
Qt Quick Ultralite 1.0
继承

Control

属性

信号

详细描述

Dial 类似于在如立体声或工业设备等设备上找到的传统旋钮,它允许用户在范围内指定一个值。

使用旋钮的 value 属性设置旋钮值。使用 fromto 属性设置范围。使用 wrap 属性启用或禁用循环。

Dial 支持 three input modes: Dial.Circular, Dial.HorizontalDial.Vertical。圆形输入模式在绝对输入系统中运行,其中旋钮内光标的位置直接反映了其值。水平和垂直输入模式使用相对输入系统,其中光标位置的变化将“添加”到旋钮的值上。

以下图像说明了各种输入模式跟踪运动的方向

另请参阅 输入控件控件样式

属性文档

[只读] angle : double

此属性持有手柄的角度。

范围从 -140 度到 140 度。

另请参阅 位置


from : 实数

此属性保存范围的起始值。默认值是 0.0

另请参阅 tovalue


handle : Item

此属性保存旋钮的柄。

柄作用为旋钮位置的视觉指示。

另请参阅 控件样式


inputMode : 枚举

此属性保存输入模式。

旋钮支持三种输入模式:Dial.CircularDial.HorizontalDial.Vertical。圆形输入模式在绝对输入系统中运行,其中旋钮内光标的位置直接反映其值。水平和垂直输入模式使用相对输入系统,其中光标位置的更改“添加到”旋钮的值。

以下图像说明了各种输入模式跟踪运动的方向

默认值是 Dial.Circular


live : bool

此属性保存旋钮是否在拖动柄时为 value 属性提供实时更新。

默认值是 true

另请参阅 value


[只读] position : 实数

此属性保存柄的逻辑位置。

位置是以控制角度范围(柄可以移动的范围)的分数表示的,即 0.0 - 1.0

另请参阅 valueangle


snapMode : 枚举

此属性保存捕获模式。

捕获模式与 stepSize 一起使用,以便使柄沿着旋钮的某些点进行捕获。

可能值

常量描述
Dial.NoSnap旋钮不会捕获(默认)。
Dial.SnapAlways在拖动柄时旋转开关。
Dial.SnapOnRelease拖动时,旋钮不会捕获,但仅在释放柄后才会。

另请参阅 stepSize


stepSize : 实数

此属性保存步长。

步长决定了通过键盘与旋钮交互时增减的值。例如,步长为 0.2 的结果是在 0.2 的增量中增加和减少旋钮的值。

snapMode 设置为除 Dial.NoSnap 之外的其他值时,才会尊重触摸和鼠标交互中的步长。

默认值是 0.0,这将在键盘交互中产生一个实际步长为 0.1

另请参阅 snapMode


to : 实数

此属性保存范围的结束值。默认值是 1.0

另请参阅 fromvalue


: 实数

此属性保留在 from - to 范围内的值。默认值为 0.0

也见位置live


wrap : 布尔

此属性表示当旋转时是否回绕。

例如,当此属性设置为 true 时,将旋转器拖动过 to 位置,则移动手柄到 from 位置,反之亦然

当此属性为 false 时,不允许旋转器跨越从和到值。

默认值为 false


信号文档

moved()

当用户通过触摸、鼠标或按键等方式交互式地移动旋转器时发出此信号。

注意:对应处理器是 onMoved


在特定 Qt 许可证下提供。
了解更多信息。