RangeSlider QML Type

Permet de sélectionner une plage de valeurs en faisant glisser deux curseurs le long d'une barre. En savoir plus...

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

Propriétés

• crossingEnabled : bool (since QtQuick.Controls 6.12)
• effectiveFirstValue : real (since QtQuick.Controls 6.12)
• effectiveSecondValue : real (since QtQuick.Controls 6.12)
• 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
• handlesCrossed : bool (since QtQuick.Controls 6.12)
• 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 handlesCrossedChanged() (since QtQuick.Controls 6.12)
• 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 permet de sélectionner une plage définie par deux valeurs, en faisant glisser chaque curseur le long d'une piste.

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

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

Pour effectuer une action lorsque la valeur d’un curseur particulier 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, à l’exception qu’elles sont inversées dans une application s’affichant de droite à gauche. La propriété ` visualPosition ` est utile pour positionner les curseurs lors de la mise en forme d’un `RangeSlider`. Dans l’exemple ci-dessus, ` first.visualPosition ` correspondra à ` 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, consultez Slider.

Voir également «Personnalisation de RangeSlider, des contrôles de saisie et de la gestion du focus » à l’adresse Qt Quick Controls.

Documentation sur les propriétés

crossingEnabled : bool [since QtQuick.Controls 6.12]

Cette propriété détermine si les curseurs peuvent se croiser.

Lorsque la valeur est « false » (valeur par défaut), la première poignée ne peut pas dépasser la seconde, et inversement. Les valeurs sont contraintes de telle sorte que first.value <= second.value pour les plages normales, ou first.value >= second.value pour les plages inversées.

Utilisez la propriété « handlesCrossed » pour détecter quand les poignées ont échangé leurs positions.

La valeur par défaut est false.

Lorsque le croisement est désactivé, si les poignées se sont croisées, leurs valeurs seront échangées.

Cette propriété a été introduite dans QtQuick.Controls 6.12.

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

effectiveFirstValue : real [read-only, since QtQuick.Controls 6.12]

Cette propriété contient la valeur du descripteur qui a été initialement créé en tant que « premier » descripteur, que les descripteurs se soient croisés ou non.

Lorsque ` crossingEnabled ` est défini sur ` false ` ou que les poignées ne se sont pas croisées, cette propriété est égale à ` first.value`. Lorsque les poignées se sont croisées, elle représente la valeur de la poignée située en « première » position visuelle (à l’extrême gauche en orientation horizontale, tout en bas en orientation verticale).

Cette propriété a été introduite dans QtQuick.Controls 6.12.

Voir également effectiveSecondValue, first.value, handlesCrossed et crossingEnabled.

effectiveSecondValue : real [read-only, since QtQuick.Controls 6.12]

Cette propriété contient la valeur de la poignée située en « deuxième » position à l'écran (à l'extrême droite en orientation horizontale, tout en haut en orientation verticale).

Lorsque ` crossingEnabled ` est défini sur ` false ` ou que les poignées ne se sont pas croisées, cette valeur est égale à ` second.value`. Lorsque les poignées se sont croisées, elle représente la valeur de la poignée occupant la « deuxième » position visuelle (la plus à droite en orientation horizontale, la plus en haut en orientation verticale).

Cette propriété a été introduite dans QtQuick.Controls 6.12.

Voir également effectiveFirstValue, second.value, handlesCrossed et crossingEnabled.

first group

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

from : real

Cette propriété contient la valeur initiale de la plage. La valeur par défaut est 0.0.

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

handlesCrossed : bool [read-only, since QtQuick.Controls 6.12]

Cette propriété indique si les poignées se sont croisées.

Cette propriété n'est pertinente que lorsque la propriété « crossingEnabled » est définie sur « true ». Lorsque les poignées se croisent, leurs rôles internes s'inversent afin de conserver la signification sémantique des termes «premier» et «second», qui correspondent respectivement aux limites inférieure et supérieure.

Cette propriété peut être utilisée pour fournir un retour visuel lorsque les poignées sont croisées.

Cette propriété a été introduite dans QtQuick.Controls 6.12.

Voir également crossingEnabled et handlesCrossedChanged().

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 également orientation.

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

Cette propriété indique si le curseur affiche des mises à jour en temps réel pour les propriétés first.value et second.value lorsque les poignées correspondantes 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é définit l'orientation.

Valeurs possibles :

Voir également horizontal et vertical.

second group

Voir également second.moved(), second.increase() et second.decrease().

snapMode : enumeration

Cette propriété définit le mode d'alignement.

Le mode d'alignement détermine le comportement des curseurs par rapport à l'stepSize.

Valeurs possibles :

Pour des explications visuelles des différents modes, consultez la documentation « snapMode » sur 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 la plage. 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 également 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 également 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, que ce soit par effleurement, à l'aide de la souris ou à l'aide du clavier.

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

Voir également first et second.

[since QtQuick.Controls 6.12] void handlesCrossedChanged()

Ce signal est émis lorsque les poignées se croisent, ce qui modifie la propriété ` handlesCrossed `.

Ce signal a été introduit dans QtQuick.Controls 6.12.

Voir également crossingEnabled.

Documentation des méthodes

void first.decrease()

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

Voir également first.

void first.increase()

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

Voir également first.

void second.decrease()

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

Voir également second.

void second.increase()

Augmente la valeur du descripteur de ` stepSize`, ou de ` 0.1 ` si ` stepSize ` n’est pas défini.

Voir également second.

void setValues(real firstValue, real secondValue)

Définit les paramètres first.value et second.value avec les arguments fournis.

Si to est supérieur à from et si firstValue est supérieur à secondValue, firstValue sera limité à secondValue.

Si from est supérieur à to et que secondValue est supérieur à firstValue, secondValue sera limité à firstValue.

Cette fonction peut s’avérer nécessaire pour définir les première et deuxième valeurs une fois le contrôle terminé, car il existe une dépendance circulaire entre firstValue et secondValue qui peut entraîner un plafonnement réciproque des valeurs attribuées.

Voir également stepSize.

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

Renvoie la valeur associée à l'position donné.

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

Voir également ` first.value`, ` second.value`, ` first.position`, ` second.position` et ` live`.