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

//Obtenemos el formulario
var formuulario = theRoot.dataView();

//Obtenemos el control dial
var control = formuulario.control("DIA");

//Activar muescas
control.notchesVisible = 1;