GRAPH

versión 11 (Modificado)

GRAPH (grafArea; grafNum; xCategorias; yValores{; yValores2; ...; yValoresN})

El comando GRAPH crea un gráfico en un área de gráfico o una variable imagen ubicada en un formulario a partir de los valores provenientes de los arrays. El comando GRAPH debe ser ubicado en el método de formulario o en un método de objeto perteneciente al formulario, o en un método de proyecto llamado por uno de estos dos métodos.

Los gráficos generados por este comando pueden ser dibujados utilizando el plug-in integrado 4D Chart, o a partir de la versión 11 de 4D, vía el motor de renderización SVG.

Nota: SVG (Scalable Vector Graphics) es un formato de archivo gráfico vectorial (extensión .svg). Basado en XML, este formato es extendido y puede ser mostrado más particularmente en navegadores Web. Para mayor información, consulte la siguiente dirección: http://www.w3.org/Graphics/SVG/. El comando DOM EXPORT TO PICTURE también puede ser utilizado para tomar ventaja del motor SVG integrado.

El tipo del parámetro grafArea determina el motor gráfico utilizado por la renderización: si pasa una referencia de área 4D Chart o una variable de área de gráfico, se utilizará el plug-in 4D Chart. Si pasa una variable imagen, el motor SVG será utilizado. Puede elegir el tipo de motor en función de los siguientes criterios:

• Los gráficos generados por 4D Chart pueden ser completamente controlados, manipulados y enriquecidos por programación, vía los comandos del plug-in 4D Chart. Para mayor información sobre los comandos 4D Chart, por favor consulte el manual de Lenguaje de 4D Chart.

• Los gráficos generados por el motor SVG tienen una apariencia más moderna y se benefician de las funciones de interfaz asociadas a las variables de imágenes: menú contextual en modo Aplicación (el cual puede utilizarse más particularmente para elegir el formato de salida), barras de desplazamiento, etc.

En el parámetro grafArea, pase el nombre del área del gráfico (o una referencia de área 4D Chart), o una variable imagen 4D, de acuerdo al motor de renderización a utilizar. Estas áreas son creadas en el editor de formularios en modo Diseño. Para mayor información, consulte el manual de Diseño.

El parámetro grafNum define el tipo de gráfico a dibujar. Debe ser un número entre 1 y 8. Los tipos de gráficos se describen en el ejemplo 1. Después de dibujar un gráfico, puede cambiar el tipo modificando el valor de grafNum y ejecutando nuevamente el comando GRAPH.

El parámetro xCategorias define las etiquetas que serán utilizadas por el eje x. (la parte inferior del gráfico). Este dato puede ser de tipo alfa, hora, fecha o numérico. Debe haber el mismo de elementos de array en xCategorias que en cada yValores.

Los datos especificados por yValores son los datos a graficar. Los datos deben ser de tipo numérico. Se puede graficar hasta ocho conjuntos de datos. Los gráficos por sectores sólo representan los primeros yValores.

El siguiente ejemplo muestra los diferentes tipos de gráficos que usted puede obtener con cada motor gráfico. El código debe ser insertado en un método de formulario o método de objeto. Los datos representados son constantes, generalmente este no es el caso:

   C_PICTURE (vGraf)  `No lo pase si quiere utilizar el motor SVG 
    ARRAY STRING (4; X; 2)  ` Cree un array para el eje x
      X{1}:="1995"  ` X Label #1 
      X{2}:="1996"  ` X Label #2 
      ARRAY REAL (A; 2)  ` Cree un array para el eje y 
      A{1}:=30  ` Inserte algunos datos 
      A{2}:=40 
      ARRAY REAL (B; 2) ` Cree un array para el eje y 
      B{1}:=50  ` Inserte algunos datos 
      B{2}:=80 
      GRAPH (vGraf;vTipo; X; A; B) ` Dibuje el gráfico
      GRAPH SETTINGS (vGraf;0;0;0;0;False;False;True;"Francia";"USA") ` Defina las leyendas para el gráfico

La siguiente imagen muestra el gráfico resultante con cada motor de renderización (4D Chart luego SVG).

• Con

vTipo 

• Con

vTipo 

• Con

vTipo 

• Con

vTipo 

• Con

vTipo 

• Con

vTipo 

• Con

vTipo 

• Con

vTipo 

GRAPH SETTINGS, GRAPH TABLE, SVG EXPORT TO PICTURE.