4D Doc Center : CT Chart arrays

4D Chart v13

CT Chart arrays


CT Chart arrays ( Bereich ; Typ ; Größe ; ArrayKategorien ; ArrayReihen ; ArrayWerte ) -> Funktionsergebnis

Parameter	Typ	Beschreibung
Bereich	Lange Ganzzahl	4D Chart Bereich
Typ	Ganzzahl	Diagrammtyp (siehe u.a. Codes)
Größe	Ganzzahl	Option für Anfangsgröße des Diagramms: 1 = Variable, 2 = Relativ zum Fenster (Auto-Variable), 3 = Relativ zum Diagramm (Auto-Dokument)
ArrayKategorien	Array	Array der Kategorien
ArrayReihen	Array	Array der Reihen
ArrayWerte	Array	Array der Werte
Funktionsergebnis	Lange Ganzzahl	Kennummer des Objekts

Beschreibung

Die Funktion CT Chart arrays erstellt ein Diagramm gemäß bestimmten Arrays und gibt die Objekt-Kennummer des Diagramms zurück. Dieser Befehl lässt sich sowohl für zwei- als auch für dreidimensionale Diagramme verwenden.

Nachfolgende Tabelle zeigt die Codes für den Parameter Typ.

1	Fläche
2	Säule
3	Bild
4	Linie
5	Punkt
6	Kreis
7	Polar
8	2D XY
100	3D Säule
101	3D Linie
102	3D Fläche
103	3D Oberfläche
104	3D Dreieck
105	3D Stift

Der Parameter Größe bestimmt, wieviel Platz das Diagramm beim Erstellen einnimmt und wie sich die Diagrammgröße beim Anpassen des Fensters verändert:

Bei 1 (Größe Variable) füllt das Diagramm den 4D Chart Bereich bzw. das Fenster aus. Es behält die Größe bei, bis sie mit den Handgriffen verändert wird.
Bei 2 (Größe Relativ zum Fenster) füllt das Diagramm den 4D Chart Bereich bzw. das Fenster aus. Verändern Sie später die Größe des Fensters, passt sich das Diagramm automatisch an. Verändern Sie jedoch die Diagrammgröße mit den Handgriffen, gilt die automatische Anpassung nicht mehr.
Bei 3 (Größe Relativ zum Dokument) passt das Diagramm sich an die Ausmaße der Seite an, die Sie im Dialog Papierformat gewählt haben. Die Größe bleibt erhalten, bis sie mit den Handgriffen verändert wird.

Der Parameter ArrayKategorien enthält die Kategorien der X-Achse.

ArrayReihen enthält die Reihen. In einem zweidimensionalen Diagramm erscheinen die Reihen auf der Kategorienachse, in einem dreidimensionalen Diagramm auf der Reihenachse.

ArrayWerte ist ein eindimensionales Array mit allen Werten, die auf der Werte-Achse abgebildet werden sollen. WerteArray muss so gefüllt werden, dass es für jedes Element von ArrayKategorien und ArrayReihen einen Wert gibt. Bei n Kategorien und m Reihen gibt es in ArrayWerte n*m Elemente.

Nachfolgendes Schema zeigt, in welcher Reihenfolge ArrayWerte gefüllt werden soll. Dabei ist n die Gesamtzahl der Kategorien, m die Gesamtzahl der Reihen.

Nachfolgend ein Beispiel für Daten und das sich daraus ergebende ArrayWerte:

Gymnasium	Jahr	Schüler	aWerte
(Kategorien)	(Reihen)	(Werte)
Camerloher	1996	1000	aValues{1}:=1000
Camerloher	1998	1250	aValues{2}:=600
Camerloher	2000	800	aValues{3}:=1250
Hofmiller	1996	600	aValues{4}:=975
Hofmiller	1998	975	aValues{5}:=800
Hofmiller	2000	1100	aValues{6}:=1100