Qt Documentation

Qt 5.8
Qt Quick Controls 2
QML Types
RangeSlider QML Type

RangeSlider QML Type

Used to select a range of values by sliding two handles along a track. More...

Import Statement:	import QtQuick.Controls 2.1
Since:	Qt 5.7
Inherits:	Control

List of all members, including inherited members

Properties

first
- first.value : real
- first.position : real
- first.visualPosition : real
- first.handle : Item
- first.pressed : bool
- first.hovered : bool
from : real
orientation : enumeration
second
- second.value : real
- second.position : real
- second.visualPosition : real
- second.handle : Item
- second.pressed : bool
- second.hovered : bool
snapMode : enumeration
stepSize : real
to : real

Methods

void first.decrease()
void first.increase()
void second.decrease()
void second.increase()
void setValues(real firstValue, real secondValue)

Detailed Description

RangeSlider is used to select a range specified by two values, by sliding each handle along a track.

In the example below, custom from and to values are set, and the initial positions of the first and second handles are set:

RangeSlider {
    from: 1
    to: 100
    first.value: 25
    second.value: 75
}

The first.position and second.position properties are expressed as fractions of the control's size, in the range 0.0 - 1.0. The first.visualPosition and second.visualPosition properties are the same, except that they are reversed in a right-to-left application. The visualPosition is useful for positioning the handles when styling RangeSlider. In the example above, first.visualPosition will be 0.24 in a left-to-right application, and 0.76 in a right-to-left application.

See also Customizing RangeSlider and Input Controls.

Property Documentation

first group
first.value : real
first.position : real
first.visualPosition : real
first.handle : Item
first.pressed : bool
first.hovered : bool

Property	Description
value	This property holds the value of the first handle in the range `from` - `to`. If to is greater than from, the value of the first handle must be greater than the second, and vice versa. Unlike position, value is not updated while the handle is dragged, but rather when it has been released. The default value is `0.0`.
handle	This property holds the first handle item.
visualPosition	This property holds the visual position of the first 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.
position	This property holds the logical position of the first handle. The position is expressed as a fraction of the control's size, in the range `0.0 - 1.0`. Unlike value, position is continuously updated while the handle is dragged. For visualizing a slider, the right-to-left aware visualPosition should be used instead.
pressed	This property holds whether the first handle is pressed.
hovered	This property holds whether the first handle is hovered. This property was introduced in QtQuick.Controls 2.1.

See also first.increase() and first.decrease().

from : real

This property holds the starting value for the range. The default value is 0.0.

See also to, first.value, and second.value.

orientation : enumeration

This property holds the orientation.

Possible values:

Constant	Description
`Qt.Horizontal`	Horizontal (default)
`Qt.Vertical`	Vertical

second group
second.value : real
second.position : real
second.visualPosition : real
second.handle : Item
second.pressed : bool
second.hovered : bool

Property	Description
value	This property holds the value of the second handle in the range `from` - `to`. If to is greater than from, the value of the first handle must be greater than the second, and vice versa. Unlike position, value is not updated while the handle is dragged, but rather when it has been released. The default value is `0.0`.
handle	This property holds the second handle item.
visualPosition	This property holds the visual position of the second 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.
position	This property holds the logical position of the second handle. The position is expressed as a fraction of the control's size, in the range `0.0 - 1.0`. Unlike value, position is continuously updated while the handle is dragged. For visualizing a slider, the right-to-left aware visualPosition should be used instead.
pressed	This property holds whether the second handle is pressed.
hovered	This property holds whether the second handle is hovered. This property was introduced in QtQuick.Controls 2.1.

See also second.increase() and second.decrease().

snapMode : enumeration

This property holds the snap mode.

Possible values:

Constant	Description
`RangeSlider.NoSnap`	The slider does not snap (default).
`RangeSlider.SnapAlways`	The slider snaps while the handle is dragged.
`RangeSlider.SnapOnRelease`	The slider does not snap while being dragged, but only after the handle is released.

For visual explanations of the various modes, see the snapMode documentation of Slider.

See also stepSize.

stepSize : real

This property holds the step size. The default value is 0.0.

See also snapMode, first.increase(), and first.decrease().

to : real

This property holds the end value for the range. The default value is 1.0.

See also from, first.value, and second.value.

Method Documentation

void first.decrease()

Decreases the value of the handle by stepSize, or 0.1 if stepSize is not defined.

See also first.

void first.increase()

Increases the value of the handle by stepSize, or 0.1 if stepSize is not defined.

See also first.

void second.decrease()

Decreases the value of the handle by stepSize, or 0.1 if stepSize is not defined.

See also second.

void second.increase()

Increases the value of the handle by stepSize, or 0.1 if stepSize is not defined.

See also second.

void setValues(real firstValue, real secondValue)

Sets first.value and second.value with the given arguments.

If to is larger than from and firstValue is larger than secondValue, firstValue will be clamped to secondValue.

If from is larger than to and secondValue is larger than firstValue, secondValue will be clamped to firstValue.

This function may be necessary to set the first and second values after the control has been completed, as there is a circular dependency between firstValue and secondValue which can cause assigned values to be clamped to each other.