- Qt 5.15
- Qt Quick Extras
- QML Types
- Dial QML Type
- Qt 5.15.18 Reference Documentation

# Dial QML Type

A circular dial that is rotated to set a value. More...

Import Statement: | import QtQuick.Extras 1.4
Since: | Qt 5.5

- List of all members, including inherited members

## Properties

- activeFocusOnPress : bool
- hovered : real
- maximumValue : real
- minimumValue : real
- pressed : bool
- stepSize : real
- tickmarksVisible : bool
- value : real

## Detailed Description

The Dial is similar to a traditional dial knob that is found on devices such as stereos or industrial equipment. It allows the user to specify a value within a range.

Like CircularGauge, Dial can display tickmarks to give an indication of the current value. When a suitable stepSize is combined with tickmarkStepSize, the dial "snaps" to each tickmark.

You can create a custom appearance for a Dial by assigning a DialStyle.

## Property Documentation

activeFocusOnPress : bool

This property specifies whether the dial should gain active focus when pressed.

The default value is `false`.

See also pressed.

[read-only] hovered : real

This property holds whether the button is being hovered.

maximumValue : real

The largest value allowed by the dial.

The default value is `1.0`.

See also value and minimumValue.

minimumValue : real

The smallest value allowed by the dial.

The default value is `0.0`.

See also value and maximumValue.

[read-only] pressed : bool

Returns `true` if the dial is pressed.

See also activeFocusOnPress.

stepSize : real

The default value is `0.0`.

tickmarksVisible : bool

This property determines whether or not the dial displays tickmarks, minor tickmarks, and labels.

For more fine-grained control over what is displayed, the following style components of DialStyle can be used:

- tickmark
- minorTickmark
- tickmarkLabel

The default value is `true`.

value : real

The angle of the handle along the dial, in the range of `0.0` to `1.0`.

The default value is `0.0`.