4D v13.4
GRAPH
GRAPH
| GRAPH ( grafArea ; grafNum ; xCategorias {; yValores} {; yValores2 ; ... ; yValoresN} ) | ||||||||
| Parámetro | Tipo | Descripción | ||||||
| grafArea | Variable imagen, Variable gráfica |
|
Área de gráfico o 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) | |||||
Nota de compatibilidad: a partir de 4D v13, el plug-in 4D Chart ya no está integrado a 4D y debe instalarse específicamente si quiere utilizarlo. Por compatibilidad, el comando GRAPH aún puede generar gráficos utilizando este plug-in cuando está presente, pero recomendamos utilizar el motor de renderización SVG integrado.
El comando GRAPH crea un gráfico en 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 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 grafArea, pase el nombre de la variable imagen que muestra el gráfico en el formulario.
Nota: por compatibilidad, el comando también acepta un área de gráfico o una referencia de área 4D Chart en el parámetro grafArea, pero ya no recomendamos utilizar esta sintaxis.
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.
Los IDs específicos ahora 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_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 |
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 STRING(4;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
vType:=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áficoLas 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
- vTipo igual a 8, obtiene un gráfico en Imágenes
Nota: las imágenes son rectángulos simples por defecto
Producto: 4D
Tema: Gráficos
Número
169
Lista alfabética de los comandos
Modificado: 4D v11 SQL
Modificado: 4D v13
GRAPH SETTINGS
GRAPH TABLE
SVG EXPORT TO PICTURE
