Indicadores

Los indicadores de progresión (también llamados "termómetros"), reglas y dials son objetos que muestran valores de forma gráfica. Los tres objetos funcionan de la misma forma; la única diferencia es su apariencia. Nos referimos a estos tres objetos como indicadores.

Puede utilizar los indicadores para mostrar o definir valores. Por ejemplo, si un termómetro recibe un valor por un método, muestra el valor. Si el usuario modifica manualmente el valor, el valor cambia. El valor puede ser utilizado por otro objeto tal como un campo o un objeto no editable.

Indicador de progreso / Dial / Regla

4D ofrece varios tipos de indicadores los cuales consisten en tres tipos principales y sus variantes. Para saber cómo seleccionar un tipo especifico de indicador, consulte la sección "Definir los tipos de indicadores" a continuación.

Tipo principal: Indicador de progreso  (termómetro)

La barra de progreso es el indicador de progreso por defecto. Puede mostrar una barra de progresión horizontal o vertical. Este parámetro es determinado por la forma del objeto que dibuje.

Tipo principal: Indicador de progresión (termómetro)

(MacOS)

Cuando se ejecuta el formulario, el termómetro no se anima. La animación debe manejarse pasando un valor a la variable asociada al termómetro:

• 1 (o cualquier valor diferente de 0) = Iniciar animación,
• 0 = Detener animación.

Nota: los termómetros “Barber shop” funcionan únicamente con la apariencia Sistema o Impresión.

Tipo principal: Indicador de progreso (termómetro)

Este indicador circular muestra también una animación continua. Este tipo de objeto indica que una operación tal como la búsqueda de conexión de red o un cálculo está en progreso. Cuando esta variante está seleccionada, las opciones del tema "Graduación" se ocultan.

Cuando se ejecuta el formulario, el termómetro no se anima. La animación debe manejarse pasando un valor a la variable asociada al termómetro:

• 1 (o cualquier valor diferente de 0) = Iniciar animación,
• 0 = Detener animación

Tipo principal: Regla

La regla es un objeto de interfaz estándar utilizado para definir o leer un valor utilizando un cursor ubicado en una regla. Puede asignar su variable asociada a un área editable (campo o variable) para guardar o modificar el valor actual del objeto.

Tipo principal: Regla

Botón paso a paso asociado a la variable vStep.

Este objeto estándar permite al usuario desplazarse por valores numéricos, duraciones (horas) o fechas por pasos predefinidos haciendo clic en los botones en forma de flechas.

Puede asignar la variable asociada al objeto a un área editable (campo o variable) para guardar o modificar el valor actual del objeto.

Un botón paso a paso puede asociarse directamente a una variable numérica, hora o fecha.

• Para los valores de tipo hora, las propiedades Mínimo, Máximo y Paso representan los segundos. Por ejemplo, para definir un paso de 8:00 a 18:00 con pasos de 10 minutos:
  
  • Mínimo = 28 800 (8*60*60)
  • Máximo = 64 800 (18*60*60)
  • Paso = 600 (10*60)

• Para los valores de tipo fecha, el valor introducido en la propiedad Paso representa los días. Las propiedades Mínimo y Máximo se ignoran.

Nota: para que el botón paso a paso funcione con una variable hora o fecha, es imperativo definir su tipo en la lista de propiedades Y declararlo explícitamente vía el comando C_TIME o C_DATE.

Tipo principal: Dial

Este tipo de indicador presenta los datos en forma de semicirculo.

Los dials, indicadores de progreso y reglas están disponibles utilizando el botón de la barra de objetos del editor de formularios. Los objetos de tipo "indicador de progresión" (Termómetro) y "Regla" aceptan diferentes variantes.

• Para los indicadores de progresión, estas variantes se definen utilizando la propiedad Tipo de indicador  del tema "Mostrar" de la lista de propiedades:
  
• Para las reglas, estas variantes se definen vía la propiedad Mostrar como del tema "Mostrar" de la Lista de propiedades:
  

Además de las propiedades estándar de apariencia y ubicación, puede definir otras propiedades específicas para cada indicador: valor mínimo, valor máximo, unidades de graduación, los mínimos pasos permitidos por el indicador como también las opciones de visualización.
También puede definir el formato de salida de una etiqueta del indicador (para mayor información sobre los formatos de salida, consulte la sección GET LIST ITEM PARAMETER).

Estas propiedades específicas se definen en el tema “Graduación” de la Lista de propiedades:

Este tema de propiedades se muestra para los indicadores de tipo barra de progreso, regla, botón paso a paso y dial. Las propiedades disponibles también dependen del tipo de indicador. Esta es la descripción de cada propiedad:

• Mínimo y Máximo: valores mínimo y máximo del indicador.
  En el caso de un botón paso a paso numérico, estas propiedades representan los segundos cuando el objeto está asociado a un valor de tipo hora y si está asociado a un valor de tipo fecha.
• Unidad: unidad de visualización de las graduaciones.   
• Paso: intervalo mínimo aceptado entre dos valores durante la utilización.
  En el caso de un botón paso a paso numérico, esta propiedad representa los segundos cuando el objeto está asociado a un valor de tipo hora y  días si está asociado a un valor de tipo fecha.    
• Posición de la etiqueta: ubicación de las etiquetas cuando se muestran.
• • Abajo: muestra las etiquetas a la derecha o abajo del indicador.
    
  • Arriba: muestra las etiquetas a la izquierda o arriba del indicador. 
    
• Etiquetas: muestra /oculta etiquetas.
• Graduación: muestra/oculta las graduaciones junto a las etiquetas.
  

Cuando se selecciona un objeto indicador, hay una propiedad adicional en el tema “Acción” de la Lista de propiedades: Ejecutar método del objeto.

Cuando esta opción está seleccionada, el método del objeto se ejecutará con el evento On Data Change cuando el usuario cambie el valor del indicador. Por defecto, el método se ejecuta después de la modificación.

La variable asociada al indicador controla la salida. Puede poner valores en el indicador o utilizar los valores del indicador utilizando métodos. Por ejemplo, un método para un campo u objeto editable puede utilizarse para controlar un termómetro:

Este método asigna el valor del campo Salario a la variable vTerm. Este método está asociado al campo Salario.

Recíprocamente, puede utilizar el indicador para controlar el valor de un campo. El usuario arrastra el indicador para definir el valor. El método:

El método asigna el valor del termómetro al campo salario. A medida que el usuario arrastra el indicador, el valor en el campo Salario cambia.