4D Doc Center : GRAPH

4D v12.4

GRAPH


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

Parâmetro	Tipo	Descrição
grafArea	Variável gráfica, Variável Imagem	Área de gráfico ou variável imagem
grafNum	Inteiro longo	Número do tipo do gráfico
xCategorias	Array	Categorias para o eixo x
yValores	Array	Valores a representar graficamente (até 8)

Descrição

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 plug-in integrado 4D Chart, ou a partir da versão 11 de 4D, através do motor de renderização SVG.

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 DOM EXPORT TO PICTURE também pode ser utilizado para aproveitar o motor SVG integrado.

O tipo do parâmetro grafArea determina o motor gráfico utilizado pela renderização: se passa uma referência de área 4D Chart ou uma variável de área de gráfico, se utilizará o plug-in 4D Chart. Se passa uma variável imagem,o motor SVG será utilizado. Pode escolher o tipo de motor em função dos seguintes critérios:

• Os gráficos gerados por 4D Chart podem ser completamente controlados, manipulados e enriquecidos por programação, através dos comandos do plug-in 4D Chart. Para maior informação sobre os comandos 4D Chart, por favor consulte o 4D Chart Language.
• Os gráficos gerados pelo motor SVG têm uma aparência mais moderna e se beneficiam das funções de interface associadas às variáveis de imagens: menu contextual em modo Aplicação (o qual pode ser utilizado mais particularmente para escolher o formato de saída), barras de rolagem, etc.

No parâmetro grafArea, passe o nome da área do gráfico (ou uma referência de área 4D Chart), ou uma variável imagem 4D, de acordo ao motor de renderização a utilizar. Estas áreas são criadas no editor de formulários em modo Desenho. Para maior informação, consulte o .

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 deven ser de tipo numérico. Podem ser graficados até oito conjuntos de dados. Os gráficos por setores só representam os primeiros yValores.

Exemplo

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

 C_PICTURE(vGraf) `Não o passe se quer utilizar o motor SVG

 ARRAY STRING(4;X;2) ` Crie um array para o eixo x

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

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

 ARRAY REAL(A;2) ` Crie um array para o eixo y

 A{1}:=30 ` Insere alguns dados

 A{2}:=40

 ARRAY REAL(B;2) ` Crie um array para o eixo y

 B{1}:=50 ` Insere alguns dados

 B{2}:=80

 GRAPH(vGraf;vTipo;X;A;B) ` Desenhe o gráfico

 GRAPH SETTINGS(vGraf;0;0;0;0;False;False;True;"Franca";"USA") ` Defina as legendas para o gráfico