4D Doc Center : GRAPH

Home

4D v14.3

GRAPH


GRAPH ( Diagrammbild ; Diagrammnr ; xEtiketten {; yElemente} {; yElemente2 ; ... ; yElementeN} )

Parameter	Typ	Beschreibung
Diagrammbild	Bildvariable	Bildvariable
Diagrammnr	Lange Ganzzahl	Nummer des Diagrammtyps
xEtiketten	Array	Beschriftung der X-Achse
yElemente	Array	Elemente der Y1- bis Y8-Achsen

Beschreibung

Hinweis zur Kompatibilität: Der Befehl GRAPH funktioniert ab Version 14 nur mit einer Bildvariablen als erster Parameter. Die Syntax mit einem grafischen Bereich (4D Chart) ist überholt und wird nicht mehr unterstützt.

Der Befehl GRAPH erstellt ein Diagramm für eine Bildvariable im Formular. Der Befehl muss in der Formularmethode oder einer Objektmethode eines Formulars gesetzt werden bzw. in einer Projektmethode, die von einer der beiden Methoden aufgerufen wird.

Mit GRAPH erstellte Diagramme lassen sich mit der integrierten SVG rendering Engine erstellen. Sie haben Oberflächenfunktionen, die Bildvariablen zugewiesen sind: Ein Kontextmenü im Anwendungsmodus, um insbesondere das Anzeigeformat zu wählen, Rollbalken, etc. Den im Diagramm vorhandenen Elementen werden automatisch spezifische IDs zugewiesen, damit Sie diese individuell verwalten können (siehe nächsten Abschnitt)

Hinweis: SVG (Scalable Vector Graphics) ist ein Dateiformat für Grafiken, gekennzeichnet mit der Endung .svg. Es basiert auf XML und ist heute weitverbreitet. Es ist besonders für Web Browser geeignet. Weitere Informationen dazu finden Sie im Internet unter http://www.w3.org/Graphics/SVG/. Der Befehl SVG EXPORT TO PICTURE kann auch die Vorteile der integrierten SVG Rendering Engine nutzen.

In Diagrammbild übergeben Sie den Namen der Bildvariablen, die das Diagramm im Formular anzeigt.

Diagrammnr bestimmt den Diagrammtyp. Der Wert muss zwischen 1 und 8 liegen. Die einzelnen Typen sehen Sie in Beispiel 1. Sie können ein bereits erstelltes Diagramm wieder ändern. Ändern Sie dazu den Parameter Diagrammnr und führen den Befehl GRAPH erneut aus.

xEtiketten definiert die Bezeichnungen für die X-Achse (den unteren Teil des Diagramms). Das können Elemente eines Arrays vom Typ alphanumerisch, Datum, Zeit oder Zahl sein. In xEtiketten muss immer die gleiche Anzahl Array-Elemente sein wie in jeder Achse yElemente.

yElemente sind Felder aus Arrays mit numerischen Werten. Sie können bis zu acht Datenmengen darstellen. Diagramme vom Typ Kreis stellen nur den ersten Parameter yElemente dar.

Automatische IDs

Den Einträgen im SVG Diagramm werden automatisch spezifische IDs zugewiesen:

IDs	Beschreibung
ID_graph_1 to ID_graph_8	Spalten, Linien, Flächen....
ID_graph_shadow_1 to ID_graph_shadow_8	Schatten für Spalten, Linien, Flächen...
ID_bullet_1 to ID_bullet_8	Punkte (nur Linien- und Streudiagramme)
ID_pie_label_1 to ID_pie_label_8	Beschriftung Tortendiagramm (nur Tortendiagramm)
ID_legend_1 to ID_legend_8	Legende Titel
ID_legend_border	Legende Ränder
ID_legend_border_shadow	Schatten für Legende Ränder
ID_x_values	Werte der X Achse
ID_y_values	Werte der Y Achse
ID_y0_axis	Werte der Z Achse
ID_background	Hintergrund
ID_background_shadow	Hintergrund Schatten
ID_x_grid	Gitter auf X Achse
ID_x_grid_shadow	Schatten für Gitter auf X Achse
ID_y_grid	Gitter auf Y Achse
ID_y_grid_shadow	Schatten für Gitter auf Y Achse

Beispiel

Folgendes Beispiel zeigt die verschiedenen Diagrammtypen, die Sie mit der jeweiligen Engine für Diagramme erhalten können. Der Code dafür wird in eine Formular- oder Objektmethode eingetragen. Er entspricht jedoch nicht der Realität, da die Daten hier konstant sind:

 C_PICTURE(vGraph) //Variable des Diagramms

 ARRAY TEXT(X;2) //Erstelle Array für die X-Achse

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

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

 ARRAY REAL(A;2) //Erstelle Array für die Y-Achse

 A{1}:=30 //Füge einige Daten ein

 A{2}:=40

 ARRAY REAL(B;2) //Erstelle Array für die Y-Achse

 B{1}:=50 //Füge einige Daten ein

 B{2}:=80

 vType:=1 //Initialisiere Diagrammtyp

 GRAPH(vGraph;vType;X;A;B) //Erstelle Diagramm

 GRAPH SETTINGS(vGraph;0;0;0;0;False;False;True;"France";"USA")

  //Setze Beschriftung für das Diagramm

Sie erhalten als Ergebnis folgende Diagramme.

Ist vType gleich 1, erhalten Sie Säulen

Ist vType gleich 2, erhalten Sie proportionale Säulen

Ist vType gleich 3, erhalten Sie gestapelte Säulen

Ist vType gleich 4, erhalten Sie Linien

Ist vType gleich 5, erhalten Sie Flächen

Ist vType gleich 6, erhalten Sie Punkte

Ist vType gleich 7, erhalten Sie einen Kreis

Ist vType gleich 8, erhalten Sie Bilder

Hinweis: Bilder sind standardmäßig einfache Rechtecke