VDial

Hereda de: Widget.
Esta clase representa al control dial.
Indice de propiedades​
Boolean invertedAppearance​
Boolean invertedControls​
Number maximum​
Number minimum​
Boolean notchesVisible​
const Number notchSize​
Number notchTarget​
Number orientation​
Number pageStep​
Number singleStep​
Boolean sliderDown​
Number sliderPosition​
Boolean tracking​
Number value​
Boolean wrapping​
Indice de funciones
Generales
void setNotchesVisible( Boolean visible )
void setOrientation( Number orienta )
void setValue( Number value )
void setWrapping( Boolean on )
Enumeraciones
Flags de orientación
Horizontal = 0×01
Vertical = 0×02
Documentación de propiedades
invertedAppearance
Permite leer o configurar si el control deslizante muestra sus valores invertidos. Si esta propiedad es false (el valor predeterminado), el mínimo y el máximo se muestra en su posición clásica para el widget heredado. Si el valor es verdadero, el mínimo y el máximo aparezcan en su ubicación opuesta.
invertedControls
Permite leer o configurar si el control deslizante invierte su rueda y eventos clave. Si esta propiedad es false, mueve la rueda del ratón hacia "arriba" y con las teclas como página de arriba aumentará el valor del deslizador hacia su máximo. De lo contrario presionando la página se desplazará hacia el valor mínimo del deslizador.
maximum
Permite leer o configurar el valor máximo del deslizador. Al establecer esta propiedad, el mínimo se ajusta si es necesario para asegurar que el rango sigue siendo válido. Además el valor actual del control deslizante se ajusta para estar dentro de la nueva gama.
minimum
Permite leer o configurar el valor mínimo del deslizador. Al establecer esta propiedad, el máximo es ajustado si es necesario para asegurar que el rango sigue siendo válido. Además el valor actual del control deslizante se ajusta para estar dentro de la nueva gama.
notchesVisible
Permite leer o configurar si las muescas se muestran. Si la propiedad es true, una serie de muescas se dibujan alrededor de la esfera para indicar el rango de valores disponibles, de lo contrario no se muestran muescas. De forma predeterminada, esta propiedad está a false.
notchSize
Devuelve el tamaño actual de la muesca. El tamaño de la muesca se encuentre en unidades de control de rango, no en píxeles, y es posible que sea un múltiplo de singleSetp que da como resultado un tamaño de muesca próximo a notchTarget. De forma predeterminada, esta propiedad tiene un valor de 1.
notchTarget
Permite leer o configurar el número de píxeles entre las muescas. El tamaño real puede diferir del tamaño objetivo. La separación entre cada muesca es por defecto de 3,7 píxeles.
orientation
Permite leer o configurar la orientación de la barra de desplazamiento. La orientación debe ser Vertical (predeterminado) u Horizontal. Ver enum de flags de orientación. Los valores con combinables mediante el uso del operador bitwise or booleano "|".
pageStep
Permite leer o configurar el paso de página. Por lo general corresponde a la pulsación RePág o AvPág.
singleStep
Permite leer o configurar el paso individual. Típicamente se corresponde a la pulsación de una tecla de flecha. Si la propiedad se modifica durante una pulsación repetitiva el comportamiento no está definido.
sliderDown
Permite leer o configurar si el control está pulsado. Cambiar el control deslizante hacia abajo emite las señales sliderPressed y sliderReleased.
sliderPosition
Permite leer o configurar la posición actual del control deslizante. Si el seguimiento está habilitado (por defecto), este es idéntico al valor.
tracking
Permite leer o configurar si el seguimiento de desplazamiento está habilitado. Si el seguimiento está habilitado (por defecto), el regulador emite la señal valueChanged mientras el cursor está siendo arrastrado. Si el seguimiento se desactiva, el regulador emite la señal valueChanged sólo cuando el usuario finaliza el desplazamiento.
value
Permite leer o configurar el valor actual del deslizador. El control deslizante fuerza que el valor dentro del rango mínimo y máximo. Cambiar el valor también cambia el sliderPosition.
wrapping
Permite leer o configurar si el valor del control se comportará de modo circular. Esto sólo tiene sentido si se han especificado el valor mínimo y máximo para que el aumento de valor por encima del máximo lleve al valor mínimo y el decremento de valor por debajo del mínimo lleve al máximo.
Documentación de funciones
Funciones generales
void setNotchesVisible( Boolean visible )
Configura el control haciendo visible u ocultando las marcas de escala de valores.
Parámetros:
visible: valor de tipo boolenao. True las marcas son visibles, false las marcas se ocultan.
void setOrientation( Number orienta )
Asigna la orientación del control. Ver enum de orientación.
Parámetros:
orienta: ver enum de flags de orientación. Los valores con combinables mediante el uso del operador or booleano "|".
void setValue( Number value )
Asigna el valor al control.
Parámetros:
value: número del valor del control que debe estar dentro de su rango de presentación.
void setWrapping( Boolean on )
El valor de la propiedad wrapped, por defecto es false lo que permita a la flecha moverse por la parte superior del dial. En caso de poner el valor a true la flecha podrá moverse en cualquier ángulo del dial.
Parámetros:
on: valor booleano. True para que la flecha tenga libertad total de ángulo de movimiento, false para permitir movimiento de la flecha sólo en la parte superior.
Ejemplo
Mostrar las muescas de un dial
1
//Obtenemos el formulario
2
var formuulario = theRoot.dataView();
3
​
4
//Obtenemos el control dial
5
var control = formuulario.control("DIA");
6
​
7
//Activar muescas
8
control.notchesVisible=1;
Copied!