GRAPH

4D v15.4

GRAPH


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

Parámetro	Tipo	Descripción
grafImagen	Variable imagen	Variable imagen
grafNum	Entero largo	Número de tipo de gráfico
xCategorias	Array	Categorías para el eje x
yValores	Array	Valores a representar gráficamente (hasta 8)

Descripción

Nota de compatibilidad: a partir de 4D v14 el comando GRAPH sólo funciona con una variable imagen como su primer parámetro. La sintaxis obsoleta utilizando un área de gráfico (4D Chart) ya no se soporta.

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

Los gráficos generados por este comando pueden ser dibujados vía el motor de renderización SVG. Se benefician de las funciones de interfaz asociadas a las variables imágenes: menú contextual en modo Aplicación (para permitirle elegir, más particularmente, el formato de visualización), barras de desplazamiento, etc. IDs específicos se asignan automáticamente a los elementos presentes en el gráfico generado, que puede utilizar para manipularlos individualmente (ver el siguiente párrafo).

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

En el parámetro grafImagen, pase el nombre de la variable imagen que muestra el gráfico en el formulario.

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.

IDs automáticos

Los IDs específicos se asignan automáticamente a los elementos presentes en el gráfico SVG:

IDs	Descripción
ID_graph_1 to ID_graph_8	Columnas, líneas, áreas...
ID_graph_shadow_1 to ID_graph_shadow_8	Sombras de las columnas, líneas, áreas...
ID_bullet_1 to ID_bullet_8	Puntos (gráficos en líneas y puntos únicamente)
ID_pie_label_1 to ID_pie_label_8	Etiquetas de los sectores (gráficos en sectores únicamente)
ID_legend	Legend
ID_legend_1 to ID_legend_8	Títulos de las leyendas
ID_legend_border	Bordes de las leyendas
ID_legend_border_shadow	Sombras de los bordes de las leyendas
ID_x_values	Valores eje X
ID_y_values	Valores del eje Y
ID_y0_axis	Valores del eje Z
ID_background	Fondo
ID_background_shadow	Fondo
ID_x_grid	Rejilla en el eje X
ID_x_grid_shadow	Sombra de la rejilla en el eje X
ID_y_grid	Rejilla en el eje Y
ID_y_grid_shadow	Sombra de la rejilla en el eje Y

Ejemplo

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

 C_PICTURE(vGraph) //Variable del gráfico

 ARRAY TEXT(X;2) //Creación de un array para el eje X

 X{1}:="1995" //X Label #1

 X{2}:="1996" //X Label #2

 ARRAY REAL(A;2) //Creación de un array para el eje Y

 A{1}:=30 //Insertar algunos datos

 A{2}:=40

 ARRAY REAL(B;2) //Creación de un segundo array para el eje Y

 B{1}:=50 //Inserción de datos

 B{2}:=80

 vTipo:=1 //Inicializar tipo de gráfico

 GRAPH(vGraph;vTipo;X;A;B) //Dibujar el gráfico

 GRAPH SETTINGS(vGraph;0;0;0;0;False;False;True;"France";"USA") //Definición de las leyendas para el gráfico

Las siguientes imágenes muestran los gráficos resultantes:

vTipo igual 1, usted obtiene un gráfico en Columnas

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

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

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

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

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

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

Nota: por defecto, los gráficos de sectores no muestran la leyenda. Para que se muestre, debe volver visible el atributo SVG 'ID_legend' utilizando la siguiente instrucción:
SVG SET ATTRIBUTE(vGraph;"ID_legend";"visibility";"visible";*)

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

Nota: las imágenes son rectángulos simples por defecto

Ver también

_o_GRAPH TABLE
GRAPH SETTINGS
SVG EXPORT TO PICTURE