GRAPH

4D - Documentation   Français   English   German   Español   English   4D v11 SQL, Comandos por temas   4D v11 SQL, Lista alfabética de comandos   4D v11 SQL, Constantes por temas   Regresar   Anterior   Siguiente

versión 11 (Modificado)


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

ParámetroTipoDescripción
grafAreaGráfico | Var imagenÁrea de gráfico o variable imagen
grafNumNuméricoNúmero de tipo de gráfico
xCategoriasArrayCategorías par el eje x
yValoresArrayValores a representar gráficamente (hasta 8)

Descripción

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.

Ejemplos

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 
igual 1, usted obtiene un gráfico en Columnas:

Con

vTipo 
igual a 2, obtiene un gráfico en Columnas proporcionales:

Con

vTipo 
igual a 3, obtiene un gráfico en Columnas apiladas:

Con

vTipo 
igual a 4, obtiene un gráfico en Líneas:

Con

vTipo 
igual a 5, obtiene un gráfico en Áreas:

Con

vTipo 
igual a 6, obtiene un gráfico en Puntos:

Con

vTipo 
igual a 7, obtiene un gráfico en Sectores:

Con

vTipo 
igual a 8, obtiene un gráfico en Imágenes:

Ver también

GRAPH SETTINGS, GRAPH TABLE, SVG EXPORT TO PICTURE.


4D - Documentation   Français   English   German   Español   English   4D v11 SQL, Comandos por temas   4D v11 SQL, Lista alfabética de comandos   4D v11 SQL, Constantes por temas   Regresar   Anterior   Siguiente