Slider QML Type

Permet de sélectionner une valeur en faisant glisser une poignée le long d'une piste. Plus d'informations...

• 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 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.

Documentation sur les propriétés

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 et value.

handle : Item

Cette propriété contient l'élément de la poignée.

Voir aussi 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 aussi orientation.

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

Cette propriété contient 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 [read-only, since QtQuick.Controls 2.5 (Qt 5.12)]

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 aussi 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é contient l'orientation.

Valeurs possibles :

Voir également horizontal et vertical.

position : real [read-only]

Cette propriété contient la position logique de la poignée.

La position est exprimée en 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 valeur 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é contient 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 :

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

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 l'intervalle. 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 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 [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.

visualPosition : real [read-only]

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 du support 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 au moyen du toucher, de la souris, de la roue ou des touches.

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

Documentation de la méthode

void decrease()

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

Voir aussi 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 de l'adresse position.

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

Voir aussi value et position.