Gauge QML Type
A straight gauge that displays a value within a range. More...
Import Statement: | import QtQuick.Extras 1.4 |
Since: | Qt 5.5 |
Inherits: |
Properties
- font : font
- formatValue : var
- maximumValue : alias
- minimumValue : alias
- minorTickmarkCount : int
- orientation : int
- style : Component
- tickmarkAlignment : int
- tickmarkStepSize : real
- value : alias
Detailed Description
The Gauge control displays a value within some range along a horizontal or vertical axis. It can be thought of as an extension of ProgressBar, providing tickmarks and labels to provide a visual measurement of the progress.
The minimum and maximum values displayable by the gauge can be set with the minimumValue and maximumValue properties.
Example:
Gauge { minimumValue: 0 value: 50 maximumValue: 100 anchors.centerIn: parent }
You can create a custom appearance for a Gauge by assigning a GaugeStyle.
Property Documentation
font : font
The font to use for the tickmark text.
formatValue : var
This property accepts a function that formats the given value for display in tickmarkLabel.
For example, to provide a custom format that displays all values with 3 decimal places:
formatValue: function(value) { return value.toFixed(3); }
The default function does no formatting.
maximumValue : alias
This property holds the largest value displayed by the gauge.
The default value is 100
.
minimumValue : alias
This property holds the smallest value displayed by the gauge.
The default value is 0
.
minorTickmarkCount : int
This property determines the amount of minor tickmarks drawn between each regular tickmark.
The default value is 4
.
orientation : int
This property determines the orientation of the gauge.
The default value is Qt.Vertical
.
style : Component
The style Component for this control.
See also Qt Quick Controls Styles QML Types.
tickmarkAlignment : int
This property determines the alignment of each tickmark within the gauge. When orientation is Qt.Vertical
, the valid values are:
- Qt.AlignLeft
- Qt.AlignRight
Any other value will cause Qt.AlignLeft
to be used, which is also the default value for this orientation.
When orientation is Qt.Horizontal
, the valid values are:
- Qt.AlignTop
- Qt.AlignBottom
Any other value will cause Qt.AlignBottom
to be used, which is also the default value for this orientation.
tickmarkStepSize : real
This property determines the rate at which tickmarks are drawn on the gauge. The lower the value, the more often tickmarks are drawn.
The default value is 10
.
value : alias
This property holds the value displayed by the gauge.
The default value is 0
.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.9/qml-qtquick-extras-gauge.html