Dial QML Type

Cadran circulaire que l'on fait tourner pour régler une valeur. En savoir plus...

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

Propriétés

• angle : real
• endAngle : real (since 6.6)
• from : real
• handle : Item
• inputMode : enumeration (since QtQuick.Controls 2.5 (Qt 5.12))
• live : bool (since QtQuick.Controls 2.2 (Qt 5.9))
• position : real
• pressed : bool
• snapMode : enumeration
• startAngle : real (since 6.6)
• stepSize : real
• to : real
• value : real
• wrap : bool

Signaux

• moved() (since QtQuick.Controls 2.2 (Qt 5.9))
• wrapped(Dial.WrapDirection direction) (since 6.6)

Méthodes

• void decrease()
• void increase()

Description détaillée

Le cadran est similaire à un bouton rotatif traditionnel que l'on trouve sur des appareils tels que les chaînes hi-fi ou les équipements industriels. Il permet à l'utilisateur de spécifier une valeur comprise dans une plage donnée.

La valeur du cadran est définie à l'aide de la propriété « value ». La plage est définie à l'aide des propriétés « from » et « to ». Pour activer ou désactiver le retour à la ligne automatique, utilisez la propriété « wrap ».

Le cadran peut être commandé à l'aide du clavier. Il prend en charge les actions suivantes :

Le cadran prend en charge trois input modes: Dial.Circular, Dial.Horizontal et Dial.Vertical. Le mode de saisie circulaire fonctionne selon un système de saisie absolu, dans lequel la position du curseur au sein du cadran reflète directement sa valeur. Les modes de saisie horizontal et vertical utilisent un système de saisie relatif, dans lequel les changements de position du curseur sont « ajoutés » à la valeur du cadran.

L'image suivante illustre les directions dans lesquelles les différents modes de saisie suivent le mouvement :

Voir également Personnalisation des cadrans et des commandes de saisie.

Documentation sur les propriétés

angle : real [read-only]

Cette propriété indique l'angle de rotation de la poignée dans le sens des aiguilles d'une montre, exprimé en degrés.

L'angle est égal à zéro à la position 12 heures et sa plage va de startAngle à endAngle.

Voir également position, startAngle et endAngle.

endAngle : real [since 6.6]

Cette propriété contient l'angle final du cadran, exprimé en degrés.

Il s'agit de l'angle e que le cadran aura pour sa valeur maximale, c'est-à-dire to. La valeur de endAngle doit être supérieure à startAngle, inférieure à 720 et inférieure ou égale à startAngle + 360 degrés.

Cette propriété a été introduite dans Qt 6.6.

Voir également startAngle et angle.

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 le descripteur du cadran.

La poignée sert d'indicateur visuel de la position du cadran.

Voir également Personnalisation du cadran.

inputMode : enumeration [since QtQuick.Controls 2.5 (Qt 5.12)]

Cette propriété définit le mode de saisie.

Le cadran prend en charge trois modes de saisie : Dial.Circular, Dial.Horizontal et Dial.Vertical. Le mode de saisie circulaire fonctionne selon un système de saisie absolu, dans lequel la position du curseur au sein du cadran reflète directement sa valeur. Les modes de saisie horizontal et vertical utilisent un système de saisie relatif, dans lequel les changements de position du curseur sont « ajoutés » à la valeur du cadran.

L'image suivante illustre les directions dans lesquelles les différents modes de saisie suivent le mouvement :

La valeur par défaut est Dial.Circular.

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

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

Cette propriété indique si le cadran fournit des mises à jour en temps réel pour la propriété value pendant le glissement de la poigné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.

position : real [read-only]

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

Cette position est exprimée sous forme de fraction de la plage angulaire du contrôle (plage dans laquelle la poignée peut être déplacée), comprise entre 0.0 - 1.0.

Voir également value et angle.

pressed : bool

Cette propriété indique si le molette est enfoncée.

Le cadran est enfoncé soit lorsque le bouton de la souris est enfoncé dessus, soit lorsqu'une touche telle que « Qt.Key_Left » est maintenue enfoncée. Si vous préférez que le cadran ne soit pas enfoncé lors de l'appui sur une touche (pour des raisons esthétiques, par exemple), vous pouvez utiliser l'Keys attached property:

Dial {
    Keys.onLeftPressed: {}
}

Ainsi, la propriété « pressed » ne prendra la valeur « true » que lorsque vous cliquerez avec la souris.

snapMode : enumeration

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

Le mode d'alignement fonctionne avec l'stepSize pour permettre à la poignée de s'aligner sur certains points le long du cadran.

Valeurs possibles :

Voir aussi stepSize.

startAngle : real [since 6.6]

Cette propriété contient l'angle de départ du cadran, exprimé en degrés.

Il s'agit de l'angle e que le cadran aura pour sa valeur minimale, c'est-à-dire from. La valeur de startAngle doit être inférieure à endAngle, supérieure à -360 et supérieure ou égale à endAngle - 360 degrés.

Cette propriété a été introduite dans Qt 6.6.

Voir également endAngle et angle.

stepSize : real

Cette propriété définit la taille du pas.

La taille du pas détermine la valeur de l'augmentation ou de la diminution de la valeur du cadran lors d'une interaction via le clavier. Par exemple, une taille de pas de 0.2 entraînera une augmentation ou une diminution de la valeur du cadran par incréments de 0.2.

La taille de pas n’est prise en compte pour les interactions tactiles et à la souris que lorsque « snapMode » est défini sur une valeur autre que « Dial.NoSnap ».

La valeur par défaut est ` 0.0`, ce qui se traduit par un pas effectif de ` 0.1 ` pour les interactions au clavier.

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.

value : real

Cette propriété prend des valeurs comprises entre from et to. La valeur par défaut est 0.0.

Voir également position et live.

wrap : bool

Cette propriété détermine si le cadran effectue un retour à l'origine lorsqu'il est déplacé.

Par exemple, lorsque cette propriété est définie sur « true », le fait de faire glisser le curseur au-delà de la position to entraînera le positionnement du curseur à la position from, et inversement :

Lorsque cette propriété est définie sur « false », il n’est pas possible de faire glisser le cadran au-delà des valeurs « from » et « to ».

La valeur par défaut est « false ».

Documentation sur les signaux

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

Ce signal est émis lorsque l'utilisateur a déplacé le cadran de manière interactive, que ce soit au toucher, à l'aide de la souris ou à l'aide du clavier.

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

[since 6.6] wrapped(Dial.WrapDirection direction)

Ce signal est émis lorsque le cadran effectue une rotation complète, c'est-à-dire lorsqu'il passe de sa valeur maximale à sa valeur minimale, ou inversement. Il n'est émis que lorsque ` wrap ` est défini sur ` true`. L'argument ` direction ` spécifie le sens de la rotation complète et peut prendre l'une des valeurs suivantes :

Ce signal a été introduit dans Qt 6.6.

Documentation de la méthode

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.