W3cubDocs

/Qt 5.15

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

Properties

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-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:

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.

© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.15/qml-qtquick-extras-dial.html