Dial QML Type
Cadran circulaire que l'on fait tourner pour fixer une valeur. Plus...
| Import Statement: | import QtQuick.Controls |
| Inherits: |
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
Méthodes
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 :
| Action | Touche |
|---|---|
| Diminuer value de stepSize | Qt.Key_Left |
| Diminuer value de stepSize | Qt.Key_Down |
| Fixer value à from | Qt.Key_Home |
| Augmenter value de stepSize | Qt.Key_Right |
| Augmenter value de stepSize | Qt.Key_Up |
| Régler value sur to | Qt.Key_End |
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.
Propriété Documentation
angle : real |
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 |
Cette propriété indique l'angle final du cadran en degrés.
Il s'agit de l'adresse angle que le cadran aura pour sa 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 |
handle : Item |
Cette propriété 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 |
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 |
position : real |
pressed : bool |
Cette propriété indique si la molette est enfoncée.
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: {} }
Ceci aura pour résultat que le bouton pressé ne sera true qu'en cas d'appui sur la souris.
snapMode : enumeration |
Cette propriété définit le mode d'accrochage.
Le mode d'accrochage fonctionne avec stepSize pour permettre à la poignée de s'accrocher à certains points du cadran.
Valeurs possibles :
| Constant | Description : Le cadran ne s'enclenche pas (par défaut). |
|---|---|
Dial.NoSnap | Le cadran ne s'enclenche pas (valeur par défaut). |
Dial.SnapAlways | Le cadran s'enclenche lorsque la poignée est déplacée. |
Dial.SnapOnRelease | Le cadran ne s'enclenche pas lorsqu'il est déplacé, mais uniquement lorsque la poignée est relâchée. |
Voir également stepSize.
startAngle : real |
Cette propriété contient l'angle de départ du cadran en degrés.
Il s'agit de l'adresse angle que le cadran aura pour sa valeur minimale, 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.
stepSize : real |
Cette propriété définit 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.
to : real |
value : real |
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
|
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.
Remarque : le gestionnaire correspondant est onMoved.
Ce signal a été introduit dans QtQuick.Controls 2.2 (Qt 5.9).
|
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 :
| Constante | Description |
|---|---|
Dial.Clockwise | Le cadran est enroulé dans le sens des aiguilles d'une montre. |
Dial.CounterClockwise | Le cadran enroulé dans le sens inverse des aiguilles d'une montre. |
Remarque : le gestionnaire correspondant est onWrapped.
Ce signal a été introduit dans Qt 6.6.
Méthode Documentation
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.