QDial Class

Descripción Detallada

QDial se utiliza cuando el usuario necesita controlar un valor dentro de un rango definible por el programa, y el rango o bien es envolvente (por ejemplo, con ángulos medidos de 0 a 359 grados) o el diseño del diálogo necesita un widget cuadrado.

Dado que QDial hereda de QAbstractSlider, el dial se comporta de manera similar a un slider. Cuando wrapping() es falso (la configuración por defecto) no hay diferencia real entre un deslizador y un dial. Ambos comparten las mismas señales, ranuras y funciones miembro. Cuál utilizar dependerá de las expectativas de los usuarios y del tipo de aplicación.

El dial emite inicialmente señales valueChanged() de forma continua mientras se mueve el deslizador; puedes hacer que emita la señal con menos frecuencia desactivando la propiedad tracking. La señal sliderMoved() se emite continuamente incluso cuando el seguimiento está desactivado.

El dial también emite señales sliderPressed() y sliderReleased() cuando se pulsa y suelta el botón del ratón. Tenga en cuenta que el valor del dial puede cambiar sin que se emitan estas señales, ya que el teclado y la rueda también se pueden utilizar para cambiar el valor.

A diferencia del deslizador, QDial intenta dibujar un "buen" número de muescas en lugar de una por paso de línea. Si es posible, el número de muescas dibujadas es una por paso de línea, pero si no hay suficientes píxeles para dibujar cada una, QDial omitirá muescas para intentar dibujar un conjunto uniforme (por ejemplo, dibujando cada segunda o tercera muesca).

Al igual que el deslizador, el dial hace que la función QAbstractSlider setValue () esté disponible como ranura.

La interfaz de teclado del dial es bastante sencilla: Las teclas de flecha left/up y right/down ajustan el value del dial por el singleStep definido, Page Up y Page Down por el pageStep definido, y las teclas Home y End ajustan el valor a los valores minimum y maximum definidos.

Si utiliza la rueda del ratón para ajustar el dial, el valor de incremento se determina por el valor menor de wheelScrollLines multiplicado por singleStep, y pageStep.