Dial QML Type
Esfera circular que se gira para fijar un valor. Más...
| Import Statement: | import QtQuick.Controls |
| Inherits: |
Propiedades
- 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
Señales
Métodos
Descripción detallada
El dial es similar a una perilla de dial tradicional que se encuentra en dispositivos tales como equipos de música o equipos industriales. Permite al usuario especificar un valor dentro de un rango.
El valor del dial se establece con la propiedad value. El rango se establece con las propiedades from y to. Para activar o desactivar la envoltura, utilice la propiedad wrap.
El dial se puede manipular con un teclado. Admite las siguientes acciones:
| Acción | Tecla |
|---|---|
| Disminuir value en stepSize | Qt.Key_Left |
| Disminuir value en stepSize | Qt.Key_Down |
| Establecer value en from | Qt.Key_Home |
| Aumentar value en stepSize | Qt.Key_Right |
| Aumentar value en stepSize | Qt.Key_Up |
| Establecer value en to | Qt.Key_End |
El dial admite tres input modes: Dial.Circular, Dial.Horizontal y Dial.Vertical. El modo de entrada circular funciona con un sistema de entrada absoluto, en el que la posición del cursor dentro del dial refleja directamente su valor. Los modos de entrada horizontal y vertical utilizan un sistema de entrada relativo, en el que los cambios en la posición del cursor se "añaden" al valor del dial.
La siguiente imagen ilustra las direcciones en las que los distintos modos de entrada siguen el movimiento:
Véase también Personalización de los controles de entrada ymarcación.
Documentación de propiedades
angle : real [read-only]
Esta propiedad mantiene el ángulo de la manilla en el sentido de las agujas del reloj en grados.
El ángulo es cero en la posición de las 12 en punto y el rango es de startAngle a endAngle.
Véase también position, startAngle, y endAngle.
endAngle : real [since 6.6]
Esta propiedad contiene el ángulo final del dial en grados.
Este es el angle que tendrá el dial para su valor máximo, es decir to. El endAngle tiene que ser mayor que startAngle, menor que 720 y menor o igual que startAngle + 360 grados.
Esta propiedad se introdujo en Qt 6.6.
Véase también startAngle y angle.
from : real
Esta propiedad contiene el valor inicial del rango. El valor por defecto es 0.0.
handle : Item
Esta propiedad contiene el asa de la esfera.
El asa actúa como indicador visual de la posición del dial.
Véase también Personalizar el dial.
inputMode : enumeration [since QtQuick.Controls 2.5 (Qt 5.12)]
Esta propiedad contiene el modo de entrada.
Dial admite tres modos de entrada: Dial.Circular, Dial.Horizontal y Dial.Vertical. El modo de entrada circular opera en un sistema de entrada absoluto, donde la posición del cursor dentro del dial refleja directamente su valor. Los modos de entrada horizontal y vertical utilizan un sistema de entrada relativo, en el que los cambios en la posición del cursor se "añaden" al valor del dial.
La siguiente imagen ilustra las direcciones en las que los distintos modos de entrada siguen el movimiento:
El valor por defecto es Dial.Circular.
Esta propiedad se introdujo en QtQuick.Controls 2.5 (Qt 5.12).
live : bool [since QtQuick.Controls 2.2 (Qt 5.9)]
Esta propiedad mantiene si el dial proporciona actualizaciones en vivo para la propiedad value mientras se arrastra el manejador.
El valor por defecto es true.
Esta propiedad se introdujo en QtQuick.Controls 2.2 (Qt 5.9).
Véase también value.
position : real [read-only]
Esta propiedad contiene la posición lógica del mando.
La posición se expresa como una fracción del rango angular del control (el rango dentro del cual se puede mover el mando) en el rango 0.0 - 1.0.
pressed : bool
Esta propiedad indica si el dial está pulsado.
El dial será presionado cuando el ratón sea presionado sobre él, o una tecla como Qt.Key_Left sea presionada. Si prefiere que el dial no se pulse al pulsar una tecla (por razones de estilo, por ejemplo), puede utilizar la propiedad Keys attached property:
Dial { Keys.onLeftPressed: {} }
Esto hará que sólo se pulse true al pulsar el ratón.
snapMode : enumeration
Esta propiedad contiene el modo de ajuste.
El modo de ajuste funciona con stepSize para permitir que el tirador se ajuste a ciertos puntos del dial.
Valores posibles:
| Constante | Descripción |
|---|---|
Dial.NoSnap | La esfera no se ajusta (por defecto). |
Dial.SnapAlways | La esfera se ajusta mientras se arrastra el mando. |
Dial.SnapOnRelease | El dial no se encaja mientras se arrastra, sino sólo después de soltar el asa. |
Véase también stepSize.
startAngle : real [since 6.6]
Esta propiedad contiene el ángulo inicial de la esfera en grados.
Este es el angle que tendrá el dial para su valor mínimo, es decir from. El startAngle tiene que ser menor que endAngle, mayor que -360 y mayor o igual que endAngle - 360 grados.
Esta propiedad se introdujo en Qt 6.6.
Véase también endAngle y angle.
stepSize : real
Esta propiedad contiene el tamaño del paso.
El tamaño del paso determina la cantidad en la que el valor del dial aumenta y disminuye cuando se interactúa con él a través del teclado. Por ejemplo, un tamaño de paso de 0.2, hará que el valor del dial aumente y disminuya en incrementos de 0.2.
El tamaño de paso sólo se respeta para la interacción táctil y con el ratón cuando snapMode se establece en un valor distinto de Dial.NoSnap.
El valor por defecto es 0.0, lo que resulta en un tamaño de paso efectivo de 0.1 para la interacción con el teclado.
Véase también snapMode, increase(), y decrease().
to : real
Esta propiedad contiene el valor final del rango. El valor por defecto es 1.0.
value : real
Esta propiedad mantiene el valor en el rango from - to. El valor por defecto es 0.0.
Véase también position y live.
wrap : bool
Esta propiedad mantiene si el dial se envuelve cuando se arrastra.
Por ejemplo, cuando esta propiedad está establecida a true, arrastrar el dial más allá de la posición to resultará en que el manejador se posicione en la posición from, y viceversa:
Cuando esta propiedad es false, no es posible arrastrar el dial a través de los valores desde y hasta.
El valor por defecto es false.
Documentación sobre señales
[since QtQuick.Controls 2.2 (Qt 5.9)] moved()
Esta señal se emite cuando la esfera ha sido movida interactivamente por el usuario, ya sea mediante el tacto, el ratón o las teclas.
Nota: El manejador correspondiente es onMoved.
Esta señal se introdujo en QtQuick.Controls 2.2 (Qt 5.9).
[since 6.6] wrapped(Dial.WrapDirection direction)
Esta señal se emite cuando la esfera da una vuelta, es decir, pasa de su valor máximo a su valor mínimo, o viceversa. Sólo se emite cuando wrap es true. El argumento direction especifica la dirección de la rotación completa y será uno de los siguientes argumentos:
| Constante | Descripción |
|---|---|
Dial.Clockwise | La esfera envuelta en el sentido de las agujas del reloj. |
Dial.CounterClockwise | La esfera girada en el sentido contrario a las agujas del reloj. |
Nota: El manejador correspondiente es onWrapped.
Esta señal se introdujo en Qt 6.6.
Documentación del Método
void decrease()
Disminuye el valor en stepSize, o 0.1 si stepSize no está definido.
Véase también stepSize.
void increase()
Aumenta el valor en stepSize, o 0.1 si stepSize no está definido.
Véase también stepSize.
© 2026 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.
