Slider QML Type
Permet de sélectionner une valeur en faisant glisser une poignée le long d'une piste. Plus d'informations...
| Import Statement: | import QtQuick.Controls |
| Inherits: |
Propriétés
- from : real
- handle : Item
- horizontal : bool
(since QtQuick.Controls 2.3 (Qt 5.10)) - implicitHandleHeight : real
(since QtQuick.Controls 2.5 (Qt 5.12)) - implicitHandleWidth : real
(since QtQuick.Controls 2.5 (Qt 5.12)) - live : bool
(since QtQuick.Controls 2.2 (Qt 5.9)) - orientation : enumeration
- position : real
- pressed : bool
- snapMode : enumeration
- stepSize : real
- to : real
- touchDragThreshold : real
(since QtQuick.Controls 2.5 (Qt 5.12)) - value : real
- vertical : bool
(since QtQuick.Controls 2.3 (Qt 5.10)) - visualPosition : real
Signaux
- moved()
(since QtQuick.Controls 2.2 (Qt 5.9))
Méthodes
Description détaillée
Le curseur est utilisé pour sélectionner une valeur en faisant glisser une poignée le long d'une piste.
Dans l'exemple ci-dessous, les valeurs personnalisées from, value et to sont définies :
Slider { from: 1 value: 25 to: 100 }
La propriété position est exprimée comme une fraction de la taille du contrôle, dans la plage 0.0 - 1.0. La propriété visualPosition est identique, sauf qu'elle est inversée dans une application de droite à gauche. La propriété visualPosition est utile pour positionner la poignée lors de la création d'un curseur. Dans l'exemple ci-dessus, visualPosition sera 0.24 dans une application de gauche à droite, et 0.76 dans une application de droite à gauche.
Pour un curseur qui permet à l'utilisateur de sélectionner une plage en fournissant deux poignées, voir RangeSlider.
Voir aussi Personnalisation des contrôles decurseur et de saisie.
Propriété Documentation
from : real |
handle : Item |
Cette propriété contient l'élément de poignée.
Voir aussi Personnalisation du curseur.
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.
implicitHandleHeight : real |
Cette propriété indique la hauteur implicite de la poignée.
La valeur est égale à handle ? handle.implicitHeight : 0.
Elle est généralement utilisée, avec implicitContentHeight et implicitBackgroundHeight, pour calculer implicitHeight.
Cette propriété a été introduite dans QtQuick.Controls 2.5 (Qt 5.12).
Voir aussi implicitHandleWidth.
implicitHandleWidth : real |
Cette propriété contient la largeur implicite de la poignée.
La valeur est égale à handle ? handle.implicitWidth : 0.
Elle est généralement utilisée, avec implicitContentWidth et implicitBackgroundWidth, pour calculer implicitWidth.
Cette propriété a été introduite dans QtQuick.Controls 2.5 (Qt 5.12).
Voir également implicitHandleHeight.
live : bool |
orientation : enumeration |
Cette propriété définit l'orientation.
Valeurs possibles :
| Constante | Description |
|---|---|
Qt.Horizontal | Horizontal (par défaut) |
Qt.Vertical | Vertical |
Voir également horizontal et vertical.
position : real |
Cette propriété indique la position logique de la poignée.
La position est exprimée sous la forme d'une fraction de la taille du contrôle, dans la plage 0.0 - 1.0. Pour la visualisation d'un curseur, il convient d'utiliser plutôt la propriété de droite à gauche visualPosition.
Voir également value, visualPosition, et valueAt().
pressed : bool |
Cette propriété indique si le curseur est pressé par le toucher, la souris ou les touches.
snapMode : enumeration |
Cette propriété indique le mode d'accrochage.
Le mode d'accrochage détermine le comportement de la poignée du curseur par rapport à la page stepSize.
Valeurs possibles :
| Constante | Description |
|---|---|
Slider.NoSnap | Le curseur ne s'enclenche pas (valeur par défaut). |
Slider.SnapAlways | Le curseur s'enclenche lorsque la poignée est déplacée. |
Slider.SnapOnRelease | Le curseur ne s'enclenche pas lorsqu'il est déplacé, mais uniquement lorsque la poignée est relâchée. |
Dans le tableau suivant, les différents modes sont illustrés par des animations. Le mouvement du curseur de la souris et le site stepSize (0.2) sont identiques dans chaque animation.
| Valeur | Exemple |
Slider.NoSnap | |
Slider.SnapAlways | |
Slider.SnapOnRelease |
Voir aussi stepSize.
stepSize : real |
to : real |
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 aussi QStyleHints.
value : real |
Cette propriété contient la valeur dans l'intervalle from - to. La valeur par défaut est 0.0.
Voir aussi position.
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 aussi orientation.
visualPosition : real |
Cette propriété indique la position visuelle de la poignée.
La position est exprimée sous la forme d'une fraction de la taille du contrôle, dans la plage 0.0 - 1.0. Lorsque le contrôle est mirrored, la valeur est égale à 1.0 - position, ce qui permet de visualiser le curseur en tenant compte de la prise en charge de la droite vers la gauche.
Voir également position.
Documentation sur les signaux
|
Ce signal est émis lorsque le curseur a été déplacé de manière interactive par l'utilisateur au moyen du toucher, de la souris, de la roue ou des touches.
Remarque : le gestionnaire correspondant est onMoved.
Ce signal a été introduit dans QtQuick.Controls 2.2 (Qt 5.9).
Documentation de la méthode
void decrease() |
void increase() |
© 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.