Dial QML Type
Circular dial that is rotated to set a value. More...
Import Statement: | import QtQuick.Controls 2.1 |
Since: | Qt 5.7 |
Inherits: |
Properties
- angle : real
- from : real
- handle : Item
- position : real
- pressed : bool
- snapMode : enumeration
- stepSize : real
- to : real
- value : real
- wrap : bool
Methods
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.
The value of the dial is set with the value property. The range is set with the from and to properties. To enable or disable wrapping, use the wrap property.
The dial can be manipulated with a keyboard. It supports the following actions:
Action | Key |
---|---|
Decrease value by stepSize | Qt.Key_Left |
Decrease value by stepSize | Qt.Key_Down |
Set value to from | Qt.Key_Home |
Increase value by stepSize | Qt.Key_Right |
Increase value by stepSize | Qt.Key_Up |
Set value to to | Qt.Key_End |
See also Customizing Dial and Input Controls.
Property Documentation
handle : Item |
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 expressed as a fraction of the control's angle range (the range within which the handle can be moved) in the range 0.0 - 1.0
. Unlike the value property, the position
is continuously updated while the handle is dragged.
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:
Constant | Description |
---|---|
Dial.NoSnap | The dial does not snap (default). |
Dial.SnapAlways | The dial snaps while the handle is dragged. |
Dial.SnapOnRelease | The dial does not snap while being dragged, but only after the handle is released. |
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 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
.
Method Documentation
© 2017 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.