4D Doc Center : GRAPH

4D v14.3

GRAPH


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

Parâmetro	Tipo	Descrição
grafArea	Variável Imagem	Area do gráfico ou variável da imagem
grafNum	Inteiro longo	Número do tipo do gráfico
xCategorias	Array	Rótulos para o eixo x
yValores	Array	Dados para gráfico (até oito permitido)

Descrição

Nota de compatibilidade: A partir de 4D v14, o comando GRAPH só funciona com uma variável imagne como seu primeiro parâmetro. A sintaxe obsoleta utilizando uma área de gráfico (4D Chart) já não se suporta.

O comando GRAPH cria um gráfico em uma área de gráfico ou uma variável imagem localizada em um formulário a partir dos valores provenientes dos arrays. O comando GRAPH deve ser localizado no método de formulário ou em um método de objeto pertencente ao formulário, ou em um método de projeto chamado por um destes dois métodos.

Os gráficos gerados por este comando podem ser criados utilizando o o motor de renderização SVG integrado. Eles gostam de as funções de interface associadas com variáveis imagens: menu de contexto no modo Aplicação (inclusive permitindo a escolha do formato de exibição), barras de rolagem, etc. Os IDs são automaticamente atribuídos a elementos específicos no gráfico gerado, que pode manipular (ver próximo parágrafo).

Nota: SVG (Scalable Vector Graphics) é um formato de arquivo gráfico vetorial (extensão .svg). Baseado em XML, este formato é estendido e pode ser mostrado mais particularmente em navegadores Web. Para maior informação, consulte a seguinte direção: http://www.w3.org.Graphics/SVG /. O comando SVG EXPORT TO PICTURE também pode ser utilizado para aproveitar o motor SVG integrado.

No parâmetro grafImagem, passe o nome da variável imagem que mostra o gráfico no formulário.

O parâmetro grafNum define o tipo de gráfico a criar. Deve ser um número entre 1 e 8. Os tipos de gráficos são descritos no exemplo 1. Depois de criar um gráfico, pode mudar o tipo modificando o valor de grafNum e executando novamente o comando GRAPH.

O parâmetro xCategorias define as etiquetas que serão utilizadas pelo eixo x. (a parte inferior do gráfico). Este dado pode ser de tipo alfa, hora, data ou numérico. Deve haver o mesmo número de elementos de array em xCategorias que em cada yValores.

Os dados especificados por yValores são os dados a graficar. Os dados devem ser de tipo numérico. Podem ser graficados até oito conjuntos de dados. Os gráficos por setores só representam os primeiros yValores.

IDs automáticos

Os IDs específicos agora são asignados automaticamente aos elementos presentes no gráfico SVG:

IDs	Descrição
ID_graph_1 to ID_graph_8	Colunas, linhas, áreas...
ID_graph_shadow_1 to ID_graph_shadow_8	Sombras das colunas, linhas, áreas...
ID_bullet_1 to ID_bullet_8	Pontos (gráficos em linhas e pontos somente)
ID_pie_label_1 to ID_pie_label_8	Rótulos dos setores (gráficos em setores somente)
ID_legend_1 to ID_legend_8	Títulos das lendas
ID_legend_border	Bordas das lendas
ID_legend_border_shadow	Sombras das bordas das lendas
ID_x_values	Valores eixo X
ID_y_values	Valores do eixo Y
ID_y0_axis	Valores do eixo Z
ID_background	Fundo
ID_background_shadow	Fundo
ID_x_grid	Grade no eixo X
ID_x_grid_shadow	Sombra da grade no eixo X
ID_y_grid	Grade no eixo Y
ID_y_grid_shadow	Sombra da grade no eixo Y

Exemplo

O exemplo a seguir mostra os diferentes tipos de gráficos que você pode obter. O código deve ser inserido em um método formulário ou método objeto que contém a variável imagem. Os dados representados são constantes, geralmente este não é o caso:

 C_PICTURE(vGraph) //Variável do gráfico

 ARRAY TEXT(4;X;2) //Criação de um array para o eixo X

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

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

 ARRAY REAL(A;2) //Criação de um array para o eixo Y

 A{1}:=30 //Inserção de dados

 A{2}:=40

 ARRAY REAL(B;2) //Criação de um array para o eixo Y

 B{1}:=50 //Inserção de dados

 B{2}:=80

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

 GRAPH(vGraph;vType;X;A;B) //Desenhar o gráfico

 GRAPH SETTINGS(vGraph;0;0;0;0;False;False;True;"France";"USA") //Definição das lendas para o gráfico

As seguinte imagens mostram o gráfico resultante.

Com vType igual a 1, obtém um gráfico em Colunas:

Com vType igual a 2, obtém um gráfico em Colunas proporcionais:

Com vType igual a 3, obtém um gráfico em Colunas empilhadas:

Com vType igual a 4, obtém um gráfico em Linhas:

Com vType igual a 5, obtém um gráfico em Áreas:

Com vType igual a 6, obtém um gráfico em Pontos:

Com vType igual a 7, obtém um gráfico em Setores:

Com vType igual a 8, obtém um gráfico em Imagens:

Nota: As imagens são retângulos simples por padrão.