Slider QML Type
Used to select a value by sliding a handle along a track. More...
Import Statement: | import QtQuick.Controls |
Inherits: |
Properties
- from : real
- handle : Item
- horizontal : bool
(since QtQuick.Controls 2.3 (Qt 5.10))
- implicitHandleHeight : real
(since QtQuick.Controls 2.5 (Qt 5.12))
- implicitHandleWidth : real
(since QtQuick.Controls 2.5 (Qt 5.12))
- live : bool
(since QtQuick.Controls 2.2 (Qt 5.9))
- orientation : enumeration
- position : real
- pressed : bool
- snapMode : enumeration
- stepSize : real
- to : real
- touchDragThreshold : qreal
(since QtQuick.Controls 2.5 (Qt 5.12))
- value : real
- vertical : bool
(since QtQuick.Controls 2.3 (Qt 5.10))
- visualPosition : real
Signals
- moved()
(since QtQuick.Controls 2.2 (Qt 5.9))
Methods
Detailed Description
Slider is used to select a value by sliding a handle along a track.
In the example below, custom from, value, and to values are set:
Slider { from: 1 value: 25 to: 100 }
The position property is expressed as a fraction of the control's size, in the range 0.0 - 1.0
. The visualPosition property is the same, except that it is reversed in a right-to-left application. The visualPosition is useful for positioning the handle when styling Slider. In the example above, visualPosition will be 0.24
in a left-to-right application, and 0.76
in a right-to-left application.
For a slider that allows the user to select a range by providing two handles, see RangeSlider.
See also Customizing Slider and Input Controls.
Property Documentation
from : real |
handle : Item |
This property holds the handle item.
See also Customizing Slider.
horizontal : bool |
This property holds whether the slider is horizontal.
This property was introduced in QtQuick.Controls 2.3 (Qt 5.10).
See also orientation.
implicitHandleHeight : real |
This property holds the implicit handle height.
The value is equal to handle ? handle.implicitHeight : 0
.
This is typically used, together with implicitContentHeight and implicitBackgroundHeight, to calculate the implicitHeight.
This property was introduced in QtQuick.Controls 2.5 (Qt 5.12).
See also implicitHandleWidth.
implicitHandleWidth : real |
This property holds the implicit handle width.
The value is equal to handle ? handle.implicitWidth : 0
.
This is typically used, together with implicitContentWidth and implicitBackgroundWidth, to calculate the implicitWidth.
This property was introduced in QtQuick.Controls 2.5 (Qt 5.12).
See also implicitHandleHeight.
live : bool |
orientation : enumeration |
This property holds the orientation.
Possible values:
Constant | Description |
---|---|
Qt.Horizontal | Horizontal (default) |
Qt.Vertical | Vertical |
See also horizontal and vertical.
position : real |
This property holds the logical position of the handle.
The position is expressed as a fraction of the control's size, in the range 0.0 - 1.0
. For visualizing a slider, the right-to-left aware visualPosition should be used instead.
See also value, visualPosition, and valueAt().
pressed : bool |
This property holds whether the slider is pressed by either touch, mouse, or keys.
snapMode : enumeration |
This property holds the snap mode.
The snap mode determines how the slider handle behaves with regards to the stepSize.
Possible values:
Constant | Description |
---|---|
Slider.NoSnap | The slider does not snap (default). |
Slider.SnapAlways | The slider snaps while the handle is dragged. |
Slider.SnapOnRelease | The slider does not snap while being dragged, but only after the handle is released. |
In the following table, the various modes are illustrated with animations. The movement of the mouse cursor and the stepSize (0.2
) are identical in each animation.
Value | Example |
Slider.NoSnap | |
Slider.SnapAlways | |
Slider.SnapOnRelease |
See also stepSize.
stepSize : real |
to : real |
touchDragThreshold : qreal |
This property holds the threshold (in logical pixels) at which a touch drag event will be initiated. The mouse drag threshold won't be affected. The default value is Qt.styleHints.startDragDistance
.
This property was introduced in QtQuick.Controls 2.5 (Qt 5.12).
See also QStyleHints.
value : real |
This property holds the value in the range from
- to
. The default value is 0.0
.
See also position.
vertical : bool |
This property holds whether the slider is vertical.
This property was introduced in QtQuick.Controls 2.3 (Qt 5.10).
See also orientation.
visualPosition : real |
This property holds the visual position of the handle.
The position is expressed as a fraction of the control's size, in the range 0.0 - 1.0
. When the control is mirrored, the value is equal to 1.0 - position
. This makes the value suitable for visualizing the slider, taking right-to-left support into account.
See also position.
Signal Documentation
|
This signal is emitted when the slider has been interactively moved by the user by either touch, mouse, wheel, or keys.
Note: The corresponding handler is onMoved
.
This signal was introduced in QtQuick.Controls 2.2 (Qt 5.9).
Method Documentation
void decrease() |
void increase() |