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...
| Import Statement: | import QtQuick.Controls |
| Inherits: |
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 la 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
| Propriété | Description de la propriété |
|---|---|
| valeur | Cette propriété contient la valeur de la première poignée dans la plage from - to.Si from est supérieur à to, la valeur de la première poignée doit être supérieure à la seconde, et vice versa. La valeur par défaut est |
| handle | Cette propriété contient le premier élément de la poignée. |
| visualPosition | Cette propriété définit la position visuelle de la première poignée. La position est exprimée sous la forme d'une fraction de la taille du contrôle, dans la plage |
| position | Cette propriété contient la position logique de la première poignée. La position est exprimée sous la forme d'une fraction de la taille du contrôle, dans la plage |
| pressé | Cette propriété indique si la première poignée est pressée par le toucher, la souris ou les touches. |
| hovered | Cette propriété indique si la première poignée est survolée. Cette propriété a été introduite dans QtQuick.Controls 2.1. |
| implicitHandleWidth | Cette propriété définit la largeur implicite de la première poignée. Cette propriété a été introduite dans QtQuick.Controls 2.5. |
| implicitHandleHeight | Cette propriété définit la hauteur implicite de la première poignée. Cette propriété a été introduite dans QtQuick.Controls 2.5. |
Voir également first.moved(), first.increase() et first.decrease().
from : real |
Cette propriété définit la valeur de départ de la plage. La valeur par défaut est 0.0.
Voir également to, first.value, et second.value.
horizontal : bool |
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 |
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é définit l'orientation.
Valeurs possibles :
| Constante | Description |
|---|---|
Qt.Horizontal | Horizontale (par défaut) |
Qt.Vertical | Vertical |
Voir également horizontal et vertical.
| Propriété | Description de la propriété |
|---|---|
| valeur | Cette propriété contient la valeur de la deuxième poignée dans la plage from - to.Si from est supérieur à to, la valeur de la première poignée doit être supérieure à celle de la seconde, et vice versa. La valeur par défaut est |
| handle | Cette propriété contient le deuxième élément de la poignée. |
| visualPosition | Cette propriété définit la position visuelle de la deuxième poignée. La position est exprimée sous la forme d'une fraction de la taille du contrôle, dans la plage |
| position | Cette propriété contient la position logique de la deuxième poignée. La position est exprimée sous la forme d'une fraction de la taille du contrôle, dans la plage |
| pressé | Cette propriété indique si la deuxième poignée est pressée par le toucher, la souris ou les touches. |
| hovered (survolé) | Cette propriété indique si la deuxième poignée est survolée. Cette propriété a été introduite dans QtQuick.Controls 2.1. |
| implicitHandleWidth | Cette propriété indique la largeur implicite de la deuxième poignée. Cette propriété a été introduite dans QtQuick.Controls 2.5. |
| implicitHandleHeight | Cette propriété définit la hauteur implicite de la deuxième poignée. Cette propriété a été introduite dans QtQuick.Controls 2.5. |
Voir également second.moved(), second.increase() et second.decrease().
snapMode : enumeration |
Cette propriété définit le mode d'accrochage.
Le mode d'accrochage détermine le comportement des poignées du curseur par rapport à la page stepSize.
Valeurs possibles :
| Constante | Description |
|---|---|
RangeSlider.NoSnap | Le curseur ne s'enclenche pas (valeur par défaut). |
RangeSlider.SnapAlways | Le curseur s'enclenche lorsque la poignée est déplacée. |
RangeSlider.SnapOnRelease | Le curseur ne s'enclenche pas lorsqu'il est déplacé, mais uniquement lorsque la poignée est relâchée. |
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é définit la valeur finale de la plage. La valeur par défaut est 1.0.
Voir aussi from, first.value, et second.value.
touchDragThreshold : real |
Cette propriété définit le seuil (en pixels logiques) à partir duquel un événement de déplacement 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 |
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
|
|
Documentation de la méthode
void first.decrease() |
void first.increase() |
void second.decrease() |
void second.increase() |
Définit first.value et second.value avec les arguments donnés.
Si to est plus grand que from et firstValue plus grand que secondValue, firstValue sera clampé à 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.
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.
© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.