IdentifiantMot de passe
Mot de passe oublié ?Je m'inscris ! (gratuit)

RangeSlider QML Type

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

Article lu   fois.

L'auteur

L'article

Publié le - Mis à jour le 14 février 2024 

Liens sociaux

Viadeo Twitter Facebook Share on Google+   

RangeSlider QML Type▲

  • Import Statement: import QtQuick.Controls

  • Inherits:: Control

  • Group: RangeSlider is part of qtquickcontrols-input, qtquickcontrols-focusscopes

I. Detailed Description▲

Image non disponible

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:

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

In order to perform an action when the value for a particular handle changes, use the following syntax:

 
Sélectionnez
first.onMoved: console.log("first.value changed to " + first.value)

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.

For a slider that allows the user to select a single value, see Slider.

I-1. See Also▲

See also Customizing RangeSlider, Input Controls, Focus Management in Qt Quick Controls

II. Property Documentation▲

 

II-1. first group▲

first.handle : Item

first.hovered : bool

first.implicitHandleHeight : real

first.implicitHandleWidth : real

first.position : real

first.pressed : bool

first.value : real

first.visualPosition : real

Property

Description

value

This property holds the value of the first handle in the range from - to.

If from is greater than to, the value of the first handle must be greater than the second, and vice versa.

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. For visualizing a slider, the right-to-left aware visualPosition should be used instead.

pressed

This property holds whether the first handle is pressed by either touch, mouse, or keys.

hovered

This property holds whether the first handle is hovered. This property was introduced in QtQuick.Controls 2.1.

implicitHandleWidth

This property holds the implicit width of the first handle. This property was introduced in QtQuick.Controls 2.5.

implicitHandleHeight

This property holds the implicit height of the first handle. This property was introduced in QtQuick.Controls 2.5.
II-1-1. See Also▲

See also first.moved(), first.increase(), first.decrease()

II-2. from : real▲

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

II-2-1. See Also▲

See also to, first.value, second.value

II-3. [read-only, since QtQuick.Controls 2.3 (Qt 5.10)] horizontal : bool▲

This property holds whether the slider is horizontal.

This property was introduced in QtQuick.Controls 2.3 (Qt 5.10).

II-3-1. See Also▲

See also orientation

II-4. [since QtQuick.Controls 2.2 (Qt 5.9)] live : bool▲

This property holds whether the slider provides live updates for the first.value and second.value properties while the respective handles are dragged.

The default value is true.

This property was introduced in QtQuick.Controls 2.2 (Qt 5.9).

II-4-1. See Also▲

See also first.value, second.value

II-5. orientation : enumeration▲

This property holds the orientation.

Possible values:

Constant

Description

Qt.Horizontal

Horizontal (default)

Qt.Vertical

Vertical
II-5-1. See Also▲

See also horizontal, vertical

II-6. second group▲

second.handle : Item

second.hovered : bool

second.implicitHandleHeight : real

second.implicitHandleWidth : real

second.position : real

second.pressed : bool

second.value : real

second.visualPosition : real

Property

Description

value

This property holds the value of the second handle in the range from - to.

If from is greater than to, the value of the first handle must be greater than the second, and vice versa.

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. For visualizing a slider, the right-to-left aware visualPosition should be used instead.

pressed

This property holds whether the second handle is pressed by either touch, mouse, or keys.

hovered

This property holds whether the second handle is hovered. This property was introduced in QtQuick.Controls 2.1.

implicitHandleWidth

This property holds the implicit width of the second handle. This property was introduced in QtQuick.Controls 2.5.

implicitHandleHeight

This property holds the implicit height of the second handle. This property was introduced in QtQuick.Controls 2.5.
II-6-1. See Also▲

See also second.moved(), second.increase(), second.decrease()

II-7. snapMode : enumeration▲

This property holds the snap mode.

The snap mode determines how the slider handles behave with regards to the stepSize.

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.

II-7-1. See Also▲

See also stepSize

II-8. stepSize : real▲

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

II-8-1. See Also▲

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

II-9. to : real▲

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

II-9-1. See Also▲

See also from, first.value, second.value

II-10. [since QtQuick.Controls 2.5 (Qt 5.12)] 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).

II-10-1. See Also▲

See also QStyleHints

II-11. [read-only, since QtQuick.Controls 2.3 (Qt 5.10)] vertical : bool▲

This property holds whether the slider is vertical.

This property was introduced in QtQuick.Controls 2.3 (Qt 5.10).

II-11-1. See Also▲

See also orientation

III. Signal Documentation▲

 

III-1. [since QtQuick.Controls 2.5] void first.moved()▲

[since QtQuick.Controls 2.5] void second.moved()

This signal is emitted when either the first or second handle has been interactively moved by the user by either touch, mouse, or keys.

This QML signal was introduced in QtQuick.Controls 2.5.

III-1-1. See Also▲

See also first, second

IV. Method Documentation▲

 

IV-1. void first.decrease()▲

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

IV-1-1. See Also▲

See also first

IV-2. void first.increase()▲

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

IV-2-1. See Also▲

See also first

IV-3. void second.decrease()▲

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

IV-3-1. See Also▲

See also second

IV-4. void second.increase()▲

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

IV-4-1. See Also▲

See also second

IV-5. 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.

IV-5-1. See Also▲

See also stepSize

IV-6. [since QtQuick.Controls 2.5 (Qt 5.12)] real valueAt(real position)▲

Returns the value for the given position.

This method was introduced in QtQuick.Controls 2.5 (Qt 5.12).

IV-6-1. See Also▲

See also first.value, second.value, first.position, second.position, live

Vous avez aimé ce tutoriel ? Alors partagez-le en cliquant sur les boutons suivants : Viadeo Twitter Facebook Share on Google+