Dial QML Type

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

Import Statement: import QtQuick.Enterprise.Controls 1.3
Since: QtQuick.Enterprise.Controls 1.0



Detailed Description

A Dial

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-onlyhovered : 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-onlypressed : bool

Returns true if the dial is pressed.

See also activeFocusOnPress.

stepSize : real

The default value is 0.0.

style : Component

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:

The default value is true.

This QML property was introduced in QtQuick.Enterprise.Controls 1.1.

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.

Available under certain Qt licenses.
Find out more.