Dial QML Type

Cadran circulaire que l'on fait tourner pour fixer une valeur. 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 de cadran traditionnel que l'on trouve sur des appareils tels que les chaînes stéréo ou les équipements industriels. Il permet à l'utilisateur de spécifier une valeur dans une fourchette.

La valeur du cadran est définie par la propriété value. La plage est définie par les propriétés from et to. Pour activer ou désactiver l'enveloppement, utilisez la propriété wrap.

Le cadran peut être manipulé à l'aide d'un 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 d'entrée circulaire fonctionne sur un système d'entrée absolu, où la position du curseur dans le cadran reflète directement sa valeur. Les modes de saisie horizontale et verticale utilisent un système de saisie relative, 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 aussi Personnalisation des contrôles de cadran et de saisie.

Documentation sur les propriétés

angle : real [read-only]

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

L'angle est égal à zéro à la position 12 heures et la plage est comprise entre startAngle et endAngle.

Voir également position, startAngle, et endAngle.

endAngle : real [since 6.6]

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

Il s'agit de l'adresse angle que le cadran aura pour valeur maximale, c'est-à-dire to. L'angle final doit être supérieur à startAngle, inférieur à 720 et inférieur ou égal à 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 de départ de l'intervalle. La valeur par défaut est 0.0.

Voir également to et value.

handle : Item

Ce bien contient la poignée du cadran.

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

Voir aussi Personnalisation du cadran.

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

Cette propriété contient le mode d'entrée.

Dial prend en charge trois modes de saisie : Dial.Circular, Dial.Horizontal et Dial.Vertical. Le mode de saisie circulaire fonctionne sur un système de saisie absolu, où la position du curseur dans le cadran reflète directement sa valeur. Les modes de saisie horizontale et verticale utilisent un système de saisie relative, 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 direct 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.

position : real [read-only]

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

La position est exprimée sous la forme d'une fraction de la plage d'angles du contrôle (la plage dans laquelle la poignée peut être déplacée) dans la plage 0.0 - 1.0.

Voir également value et angle.

pressed : bool

Cette propriété indique si le cadran est enfoncé.

Le cadran est pressé lorsque la souris est appuyée dessus ou qu'une touche telle que Qt.Key_Left est maintenue enfoncée. Si vous préférez que le cadran ne soit pas pressé lorsque vous appuyez sur une touche (pour des raisons de style, par exemple), vous pouvez utiliser la propriété Keys attached property:

Dial {
    Keys.onLeftPressed: {}
}

Cela aura pour effet que le bouton pressé ne sera affiché que sur true lorsque vous appuierez sur la souris.

snapMode : enumeration

Cette propriété contient le mode d'encliquetage.

Le mode d'accrochage fonctionne avec le site stepSize pour permettre à la poignée de s'accrocher à certains points du cadran.

Valeurs possibles :

Voir également stepSize.

startAngle : real [since 6.6]

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

Il s'agit de la valeur minimale du cadran ( angle ), c'est-à-dire from. L'angle de départ doit être inférieur à endAngle, supérieur à -360 et supérieur ou égal à endAngle - 360 degrés.

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

Voir également endAngle et angle.

stepSize : real

Cette propriété contient la taille du pas.

La taille du pas détermine la quantité par laquelle la valeur du cadran est augmentée et diminuée lorsque l'on interagit avec le clavier. Par exemple, une taille de pas de 0.2, se traduira par une augmentation et une diminution de la valeur du cadran par incréments de 0.2.

La taille de l'échelon n'est respectée pour l'interaction tactile et la souris que lorsque snapMode est réglé sur une valeur autre que Dial.NoSnap.

La valeur par défaut est 0.0, ce qui donne une taille de pas effective de 0.1 pour l'interaction avec le clavier.

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.

value : real

Cette propriété contient la valeur dans l'intervalle from - to. La valeur par défaut est 0.0.

Voir aussi position et live.

wrap : bool

Cette propriété indique si le cadran s'enroule lorsqu'on le fait glisser.

Par exemple, lorsque cette propriété est définie sur true, le fait de faire glisser le cadran au-delà de la position to entraînera le positionnement de la poignée à la position from, et vice versa :

Lorsque la valeur de cette propriété est false, il n'est pas possible de faire glisser le cadran à travers les 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 le cadran a été déplacé de manière interactive par l'utilisateur, que ce soit au moyen du toucher, de la souris ou des touches.

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 s'enroule, c'est-à-dire qu'il passe de sa valeur maximale à sa valeur minimale, ou vice versa. Il n'est émis que lorsque wrap est true. L'argument direction spécifie la direction de la rotation complète et sera l'un des arguments suivants :

Ce signal a été introduit dans Qt 6.6.

Documentation de la méthode

void decrease()

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