Slider QML Type

Permet de sélectionner une valeur en faisant glisser un curseur le long d'une barre. En savoir plus...

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

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

• void decrease()
• void increase()
• real valueAt(real position) (since QtQuick.Controls 2.1 (Qt 5.8))

Description détaillée

Le curseur permet de sélectionner une valeur en faisant glisser un curseur 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 en 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 s’affichant de droite à gauche. La propriété « visualPosition » est utile pour positionner la poignée lors de la mise en forme du Slider. Dans l’exemple ci-dessus, « 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 plage à l’aide de deux poignées, consultez RangeSlider.

Voir également Personnalisation des contrôlesde curseur et de saisie.

Documentation sur les propriétés

from : real

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

Voir également to et value.

handle : Item

Cette propriété contient l'élément de référence.

Voir également Personnalisation du curseur.

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.

implicitHandleHeight : real [read-only, since QtQuick.Controls 2.5 (Qt 5.12)]

Cette propriété contient la hauteur implicite du poignée.

Sa valeur est égale à handle ? handle.implicitHeight : 0.

Elle est généralement utilisée, conjointement avec implicitContentHeight et implicitBackgroundHeight, pour calculer l'implicitHeight.

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

Voir également implicitHandleWidth.

implicitHandleWidth : real [read-only, since QtQuick.Controls 2.5 (Qt 5.12)]

Cette propriété contient la largeur implicite du descripteur.

Sa valeur est égale à handle ? handle.implicitWidth : 0.

Elle est généralement utilisée, conjointement avec implicitContentWidth et implicitBackgroundWidth, pour calculer l'implicitWidth.

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

Voir également implicitHandleHeight.

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

Cette propriété indique si le curseur fournit des mises à jour en temps réel pour la propriété value lorsque la poignée est déplacée.

La valeur par défaut est true.

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

Voir également value et valueAt().

orientation : enumeration

Cette propriété définit l'orientation.

Valeurs possibles :

Voir également horizontal et vertical.

position : real [read-only]

Cette propriété contient la position logique du curseur.

Cette position est exprimée sous forme de fraction de la taille du contrôle, dans l'intervalle 0.0 - 1.0. Pour l'affichage d'un curseur, il convient d'utiliser à la place la propriété « visualPosition », qui prend en compte la lecture de droite à gauche.

Voir également value, visualPosition et valueAt().

pressed : bool

Cette propriété s'applique que le curseur soit actionné par un geste tactile, à l'aide de la souris ou via le clavier.

snapMode : enumeration

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

Le mode d'alignement détermine le comportement de la poignée du curseur par rapport à l'stepSize.

Valeurs possibles :

Dans le tableau ci-dessous, les différents modes sont illustrés par des animations. Le mouvement du curseur de la souris et l'stepSize (0.2) sont identiques dans chaque animation.

Valeur	Exemple
Slider.NoSnap
Slider.SnapAlways
Slider.SnapOnRelease

Voir aussi stepSize.

stepSize : real

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

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

to : real

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

Voir également from et 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.

value : real

Cette propriété prend une valeur comprise entre from et to. La valeur par défaut est 0.0.

Voir également position.

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.

visualPosition : real [read-only]

Cette propriété définit la position visuelle de la poignée.

La position est exprimée sous forme de fraction de la taille du contrôle, dans l'intervalle 0.0 - 1.0. Lorsque le contrôle est en mode « mirrored », la valeur est égale à 1.0 - position. Cela permet d'adapter la valeur à l'affichage du curseur, en tenant compte de la prise en charge de la lecture de droite à gauche.

Voir également position.

Documentation sur les signaux

[since QtQuick.Controls 2.2 (Qt 5.9)] moved()

Ce signal est émis lorsque le curseur a été déplacé de manière interactive par l'utilisateur, que ce soit par effleurement, à l'aide de la souris, de la molette ou des touches du clavier.

Ce signal a été introduit dans QtQuick.Controls 2.2 (Qt 5.9).

Documentation des méthodes

void decrease()

Réduit la valeur de stepSize ou de 0.1 si stepSize n'est pas défini.

Voir également stepSize.

void increase()

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

Voir également stepSize.

[since QtQuick.Controls 2.1 (Qt 5.8)] real valueAt(real position)

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

Cette méthode a été introduite dans QtQuick.Controls 2.1 (Qt 5.8).

Voir également value et position.