Dial QML Type

This property holds the angle of the handle.

Like the position property, angle is continuously updated while the handle is dragged.

The range is from -140 degrees to 140 degrees.

See also position.

This property holds the starting value for the range. The default value is 0.0.

See also to and value.

This property holds the handle of the dial.

The handle acts as a visual indicator of the position of the dial.

See also Customizing Dial.

This property holds the logical position of the handle.

The position is defined as a percentage of the control's angle range (the range within which the handle can be moved) scaled to 0.0 - 1.0. Unlike the value property, the position is continuously updated while the handle is dragged.

See also value and angle.

This property holds whether the dial is pressed.

The dial will be pressed when either the mouse is pressed over it, or a key such as Qt.Key_Left is held down. If you'd prefer not to have the dial be pressed upon key presses (due to styling reasons, for example), you can use the Keys attached property:

  Dial {
      Keys.onLeftPressed: {}
  }

This will result in pressed only being true upon mouse presses.

This property holds the snap mode.

The snap mode works with the stepSize to allow the handle to snap to certain points along the dial.

Possible values:

See also stepSize.

This property holds the step size.

The step size determines the amount by which the dial's value is increased and decreased when interacted with via the keyboard. For example, a step size of 0.2, will result in the dial's value increasing and decreasing in increments of 0.2.

The step size is only respected for touch and mouse interaction when snapMode is set to a value other than Dial.NoSnap.

The default value is 0.0, which results in an effective step size of 0.1 for keyboard interaction.

See also snapMode, increase(), and decrease().

This property holds the end value for the range. The default value is 1.0.

See also from and value.

This property holds the value in the range from - to. The default value is 0.0.

Unlike the position property, the value is not updated while the handle is dragged. The value is updated after the value has been chosen and the dial has been released.

See also position.

This property holds whether the dial wraps when dragged.

For example, when this property is set to true, dragging the dial past the to position will result in the handle being positioned at the from position, and vice versa:

When this property is false, it's not possible to drag the dial across the from and to values.

The default value is false.

Decreases the value by stepSize, or 0.1 if stepSize is not defined.

See also stepSize.

Increases the value by stepSize, or 0.1 if stepSize is not defined.

See also stepSize.