GRAPH

Version 6.0 Geändert

Version 6 Hinweis: Diagramme werden ab Version 6 über das Plug-In 4D Chart verwaltet, das in 4th Dimension integriert ist. Die Diagrammbefehle der früheren 4D Version werden transparent in 4D Chart umgeleitet. Wollen Sie für einen Diagrammbereich in einem Formular weitere 4D Chart Befehle einsetzen, verwenden Sie den nachfolgend beschriebenen Parameter Diagrammname im Plug-In Bereich von 4D Chart. Weitere Informationen zu den 4D Chart Befehlen finden Sie im Handbuch 4D Chart Reference.

GRAPH (Diagrammname; Typ; xEtiketten; yElemente{; yElemente2; ...; yElementeN})

Parameter	Typ		Beschreibung
Diagrammname	Variable		Name der Diagrammvariablen im Formular
Typ	Ganzzahl		Diagrammtyp
xEtiketten	Array oder Unterdatenfeld		Beschriftung der X-Achse
yElemente	Array oder Unterdatenfeld		Elemente der Y1- bis Y8-Achsen

Der Befehl GRAPH erstellt ein Diagramm, das im Formular durch die Variable Diagrammname angezeigt wird. Die grafisch darzustellenden Daten stammen aus einem Array oder Unterdatenfeldern.

Achtung: Der Befehl GRAPH funktioniert nur, wenn er in der Formularmethode oder einer Objektmethode des Formulars plaziert wird bzw. in einer Projektmethode, die von den

o. a. Methoden aufgerufen wird.

Diagrammname ist der Name des Diagrammbereichs, der im Formulareditor mit dem Plug-In 4D Chart erstellt wird. Weitere Informationen dazu finden Sie im Handbuch 4th Dimension Design.

Typ bestimmt den Diagrammtyp. Die benutzten Werte liegen zwischen 1 und 8. Die einzelnen Typen ersehen Sie aus nachfolgendem Beispiel. Sie können ein bereits erstelltes Diagramm wieder ändern. Ändern Sie dazu den Parameter Typ und führen den Befehl GRAPH erneut aus.

xEtiketten definiert die Bezeichnungen für die X-Achse (den unteren Teil des Diagramms). Sie sind entweder Element eines Arrays oder Datenfeld einer Unterdatei vom Typ alphanumerisch, Datum, Zeit oder numerisch. In xEtiketten muß immer die gleiche Anzahl Unterdatensätze oder Array-Elemente sein wie in jeder Achse yElemente.

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

1. Folgendes Beispiel zeigt, wie Sie mit Arrays ein Diagramm erstellen. Der Code dafür wird in eine Formular- oder Objektmethode eingetragen. Er entspricht jedoch nicht der Realität, da die Daten hier konstant sind:

   ARRAY STRING (4; X; 2) ` Erstelle Array für die X-Achse
   X{1}:="1995" ` X Etikett #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 
   GRAPH (vGraph;vType; X; A; B) ` Erstelle Diagramm
   GRAPH SETTINGS (vGraph;0;0;0;0;False;False;True;"BRD";"USA") 
                              ` Setze Beschriftung für das Diagramm 

Sie erhalten je nach gewähltem Diagrammtyp 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:

2. Folgendes Beispiel stellt den Verkauf für die Angestellten im Vertrieb grafisch in einer Untertabelle dar. Die Untertabelle hat drei Datenfelder: Name, LastYearTot und ThisYearTot. Das Diagramm zeigt den Verkauf pro Angestellten in den beiden letzten Jahren:

   GRAPH (vGraph;1;[Employees]Sales'Name;[Employees]Sales'LastYearTot;[Employees]Sales'ThisYearTot)

GRAPH SETTINGS, GRAPH TABLE.