RangeSlider QML Type

Permet de sélectionner une plage de valeurs en faisant glisser deux poignées le long d'une piste. Plus d'informations...

• Liste de tous les membres, y compris les membres hérités

Propriétés

• first
  • first.handle : Item
  • first.hovered : bool
  • first.implicitHandleHeight : real
  • first.implicitHandleWidth : real
  • first.position : real
  • first.pressed : bool
  • first.value : real
  • first.visualPosition : real
• from : real
• horizontal : bool (since QtQuick.Controls 2.3 (Qt 5.10))
• live : bool (since QtQuick.Controls 2.2 (Qt 5.9))
• orientation : enumeration
• second
  • second.handle : Item
  • second.hovered : bool
  • second.implicitHandleHeight : real
  • second.implicitHandleWidth : real
  • second.position : real
  • second.pressed : bool
  • second.value : real
  • second.visualPosition : real
• snapMode : enumeration
• stepSize : real
• to : real
• touchDragThreshold : real (since QtQuick.Controls 2.5 (Qt 5.12))
• vertical : bool (since QtQuick.Controls 2.3 (Qt 5.10))

Signaux

• void first.moved() (since QtQuick.Controls 2.5)
• void second.moved() (since QtQuick.Controls 2.5)

Méthodes

• void first.decrease()
• void first.increase()
• void second.decrease()
• void second.increase()
• void setValues(real firstValue, real secondValue)
• real valueAt(real position) (since QtQuick.Controls 2.5 (Qt 5.12))

Description détaillée

RangeSlider est utilisé pour sélectionner une plage spécifiée par deux valeurs, en faisant glisser chaque poignée le long d'une piste.

Dans l'exemple ci-dessous, les valeurs personnalisées from et to sont définies, ainsi que les positions initiales des poignées first et second:

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

Pour effectuer une action lorsque la valeur d'une poignée particulière change, utilisez la syntaxe suivante :

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

Les propriétés first.position et second.position sont exprimées en fractions de la taille du contrôle, dans la plage 0.0 - 1.0. Les propriétés first.visualPosition et second.visualPosition sont identiques, sauf qu'elles sont inversées dans une application de droite à gauche. La propriété visualPosition est utile pour positionner les poignées lors du stylisme de RangeSlider. Dans l'exemple ci-dessus, first.visualPosition sera 0.24 dans une application de gauche à droite et 0.76 dans une application de droite à gauche.

Pour un curseur permettant à l'utilisateur de sélectionner une seule valeur, voir Slider.

Voir également Personnalisation de RangeSlider, Contrôles de saisie et Gestion du focus dans les contrôles Qt Quick .

Documentation sur les propriétés

first group

Voir aussi first.moved(), first.increase() et first.decrease().

from : real

Cette propriété contient la valeur de départ de l'intervalle. La valeur par défaut est 0.0.

Voir également to, first.value, et second.value.

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

Cette propriété indique si le curseur est horizontal.

Cette propriété a été introduite dans QtQuick.Controls 2.3 (Qt 5.10).

Voir aussi orientation.

live : bool [since QtQuick.Controls 2.2 (Qt 5.9)]

Cette propriété indique si le curseur fournit des mises à jour en direct pour les propriétés first.value et second.value lorsque les poignées respectives sont déplacées.

La valeur par défaut est true.

Cette propriété a été introduite dans QtQuick.Controls 2.2 (Qt 5.9).

Voir également first.value et second.value.

orientation : enumeration

Cette propriété contient l'orientation.

Valeurs possibles :

Voir également horizontal et vertical.

second group

Voir aussi second.moved(), second.increase() et second.decrease().

snapMode : enumeration

Cette propriété contient le mode d'accrochage.

Le mode d'accrochage détermine le comportement des poignées du curseur par rapport à la page stepSize.

Valeurs possibles :

Pour des explications visuelles des différents modes, voir la documentation snapMode de Slider.

Voir également stepSize.

stepSize : real

Cette propriété définit la taille du pas. La valeur par défaut est 0.0.

Voir également snapMode, first.increase() et first.decrease().

to : real

Cette propriété contient la valeur finale de l'intervalle. La valeur par défaut est 1.0.

Voir également from, first.value, et second.value.

touchDragThreshold : real [since QtQuick.Controls 2.5 (Qt 5.12)]

Cette propriété définit le seuil (en pixels logiques) à partir duquel un événement de glissement tactile sera déclenché. Le seuil de glissement de la souris n'est pas affecté. La valeur par défaut est Application.styleHints.startDragDistance.

Cette propriété a été introduite dans QtQuick.Controls 2.5 (Qt 5.12).

Voir aussi QStyleHints.

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

Cette propriété indique si le curseur est vertical.

Cette propriété a été introduite dans QtQuick.Controls 2.3 (Qt 5.10).

Voir aussi orientation.

Documentation sur les signaux

Ce signal est émis lorsque la première ou la deuxième poignée a été déplacée de manière interactive par l'utilisateur au moyen du toucher, de la souris ou des touches.

Ces signaux ont été introduits dans QtQuick.Controls 2.5.

Voir également first et second.

Documentation de la méthode

void first.decrease()

Diminue la valeur du handle de stepSize, ou de 0.1 si stepSize n'est pas défini.

Voir également first.

void first.increase()

Augmente la valeur du handle de stepSize, ou de 0.1 si stepSize n'est pas défini.

Voir également first.

void second.decrease()

Diminue la valeur du handle de stepSize, ou de 0.1 si stepSize n'est pas défini.

Voir également second.

void second.increase()

Augmente la valeur du handle de stepSize, ou de 0.1 si stepSize n'est pas défini.

Voir également second.

void setValues(real firstValue, real secondValue)

Définit first.value et second.value avec les arguments donnés.

Si to est plus grand que from et que firstValue est plus grand que secondValue, firstValue sera limité à secondValue.

Si from est plus grand que to et que secondValue est plus grand que firstValue, secondValue sera calé sur firstValue.

Cette fonction peut être nécessaire pour définir les première et deuxième valeurs après la fin du contrôle, car il existe une dépendance circulaire entre firstValue et secondValue qui peut entraîner la fixation des valeurs attribuées l'une à l'autre.

Voir aussi stepSize.

[since QtQuick.Controls 2.5 (Qt 5.12)] real valueAt(real position)

Renvoie la valeur de l'adresse position.

Cette méthode a été introduite dans QtQuick.Controls 2.5 (Qt 5.12).

Voir aussi first.value, second.value, first.position, second.position, et live.