|
Syntax:
|
GRAPHIC(<Typ>,<Drucken>,<Zeile>,<Spalte>,<Höhe>,<Breite>,<Trennzeichen>,<Optionen>,<Design>,<Titel>,
<Legende>,<Datenreihentexte>,<Farben>,<X-Parameter>,<Y-Parameter>,<X-Werte>,<Y-Werte>
[,<Handle>[,<Dateiname>]])
|
<Typ>
|
=
<STRING-AUSDRUCK>
|
|
<Drucken>
|
=
<NUM-AUSDRUCK>
|
|
<Zeile>
|
=
<NUM-AUSDRUCK>
|
|
<Spalte>
|
=
<NUM-AUSDRUCK>
|
|
<Höhe>
|
=
<NUM-AUSDRUCK>
|
|
<Breite>
|
=
<NUM-AUSDRUCK>
|
|
<Trennzeichen>
|
=
<STRING-AUSDRUCK>
|
|
<Optionen>
|
=
<STRING-AUSDRUCK>
|
|
<Design>
|
=
<STRING-AUSDRUCK>
|
|
<Titel>
|
=
<STRING-AUSDRUCK>
|
|
<Legende>
|
=
<STRING-AUSDRUCK>
|
|
<Datenreihentexte>
|
=
<STRING-AUSDRUCK>
|
|
<Farben>
|
=
<STRING-AUSDRUCK>
|
|
<X-Parameter>
|
=
<STRING-AUSDRUCK>
|
|
<Y-Parameter>
|
=
<STRING-AUSDRUCK>
|
|
<X-Werte>
|
=
<STRING-AUSDRUCK>
|
|
<Y-Werte>
|
=
<STRING-AUSDRUCK>
|
|
<Dateiname>
|
=
<STRING-AUSDRUCK>
|
|
|
Parameter:
|
Typ
|
Legt
die Art der Grafik fest:
L
= Linie/Kurve
B
= Balken
P
= Torte (Pie).
|
Drucken
|
Legt
fest, wo die Grafik ausgegeben wird
0
= Ausgabe am Bildschirm
-1
= Es wird ein Bild erzeugt, das in der Datei <Dateiname> gespeichert
wird.
-2
= Es wird ein Bild erzeugt, das in die Zwischenablage kopiert wird.
Sonst
= Ausgabe auf den Drucken
|
Zeile
|
Zeilenposition
der linken oberen Ecke der Graphik
|
Spalte
|
Spaltenposition
der linken oberen Ecke der Graphik
|
Höhe
|
Höhe
der Graphik in Zeilen bzw. Pixel
|
Breite
|
Breite
der Graphik in Spalten bzw. Pixel
|
Trennzeichen
|
Wird
zur Abgrenzung der Werte innerhalb eines Parameters verwendet. Folgende
Zeichen sind als Trennzeichen nicht zulässig:
","
"+"
"-"
"."
"*"
CHR$(32)
(Leerzeichen)
CHR$(10)
CHR$(13)
alle
Buchstaben
alle
Ziffern.
Wird
der Leerstring "" angegeben, so gilt der Strichpunkt als
Trennzeichen.
|
Optionen
|
Hat
nur eine Bedeutung bei <TYP> B und L.
|
<Typ>
B:
|
<Optionen>
= <3D>
<3D>
= <Ja> oder <Nein>
<Ja>
= J oder j oder Y oder y
<Nein>
= N oder n
Bei
<3D> = <Ja> werden die Balken 3-dimensional, andernfalls
2-dimensional gezeichnet.
|
|
<Typ>
L:
|
<Optionen>
= <Liniendicke><Trennzeichen>
<Interpolieren><Trennzeichen>
<Quadrate><Trennzeichen>
<Farbe>
<Liniendicke>
= <ZAHL>
<Interpolieren>
= <Ja> oder <Nein>
<Quadrate>
= <Ja> oder <Nein>
<Farbe>
= <Ja> oder <Nein>
<Liniendicke>
legt die Dicke der Linien in Pixel fest.
Ist
<Interpolieren> = <Nein>, so werden die Datenpunkte durch
eine Gerade verbunden, andernfalls werden die Zwischenpunkte
interpoliert.
Bei
<Quadrate> = <Ja> werden die Datenpunkte als Quadrat
dargestellt.
|
|
|
<Farbe>
= <Ja>:
|
Die
Linienbeschriftung erfolgt in der Linienfarbe
|
|
|
<
Farbe > = <Nein>:
|
Die
Linienbeschriftung erfolgt in der Standardfarbe (schwarz oder weiß je
nach Hintergrund bzw. die in <Design> festgelegte
<Text-Farbe>)
|
|
Design
|
Der
Parameter <Design> hat folgenden Aufbau (<Trennzeichen> ist ;):
<Hintergrund-Farbe>;<Umrahmung>;<Achsen-Stärke>;<Schwarz-Weiss>;<Wert-Beschriftung>;<Wert-Zeilen>;<X-Beschriftung>;<X-Zeilen>;<Text-Größe>;<Text-Farbe>;<Text-Font>;<Text-Fontname>
Fehlende
Einträge werden durch die Voreinstellung ersetzt.
|
|
Voreinstellung
|
|
<Hintergrund-Farbe>
= <Rot>,<Grün>,<Blau>
<Rot>
= <ZAHL>
<Grün> = <ZAHL>
<Blau> = <ZAHL>
|
Fenster-Hintergrund
|
|
<Umrahmung>
= <Ja> oder <Nein>
|
N
|
|
<Achsen-Stärke>
= <ZAHL>
|
1
|
|
<Schwarz-Weiss>
= <Ja> oder <Nein>
|
N
bei Bildschirm und Farbdrucker
J
bei S/W-Drucker
|
|
<Wert-Beschriftung>
= A oder H oder V
|
A
|
|
<Wert-Zeilen>
= <ZAHL>
|
0
|
|
<X-Beschriftung>
= A oder H oder V
|
A
|
|
<X-Zeilen>
= <ZAHL>
|
0
|
|
<Text-Größe>
= <ZAHL>
|
9
|
|
<Text-Farbe>
= <Rot>,<Grün>,<Blau>
|
0,0,0
oder
255,255,255
je nach
Hintergrund
|
|
<Text-Font>
= <Fett>,<Kursiv>,<Unterstrichen>
<Fett>
= <Ja> oder <Nein>
<Kursiv> = <Ja> oder <Nein>
<Unterstrichen> = <Ja> oder <Nein>
|
N,N,N
|
|
<Text-Fontname>
= <STRING>
|
Arial
|
<Hintergrund-Farbe>
legt die Hintergrundfarbe der Grafik fest.
Ist
<Umrahmung> = <Ja>, so wird die Grafik mit einer Linie umrahmt.
<Achsen-Stärke>
legt die Dicke der Achsenlinien in Pixel fest.
Bei
<Schwarz-Weiss> = <Ja> wird die Grafik schwarz/weiß angezeigt,
andernfalls farbig (falls das Ausgabegerät Farbe unterstützt).
<Wert-Beschriftung>
legt die Orientierung der Beschriftung der Werte fest:
H
= horizontal, V = vertikal, A = automatisch (Die Orientierung wird so
berechnet, dass der Text möglichst wenig Platz benötigt und gut lesbar
ist.)
<Wert-Zeilen>
legt die Anzahl der Zeilen für die <Wert-Beschriftung> fest. Es wird
versucht, die Beschriftung mit der angegebenen Zeilenanzahl anzuzeigen. Ist
dies nicht möglich, weil z.B. Text nicht umbrochen werden kann (ein Umbruch
kann erfolgen bei einem Leerzeichen, CHR$(10) oder CHR$(13)), so werden
weniger Zeilen verwendet. Ist <Wert-Zeilen> = 0, so wird eine
optimale Zeilenanzahl errechnet.
<X-Beschriftung>
legt die Orientierung der Beschriftung der X-Achse fest:
H
= horizontal, V = vertikal, A = automatisch.
<X-Zeilen>
legt die Anzahl der Zeilen für die <X-Beschriftung> fest.
Ist
<X-Zeilen> = 0, so wird eine optimale Zeilenanzahl errechnet.
Durch
<Text-Größe> wird die Größe der Textschrift in Punkten festgelegt.
<Text-Farbe>
legt die Farbe der Texte fest.
<Text-Font>
legt die Schriftart der Texte fest.
<Text-Fontname>
legt die Schrift für die Texte fest.
|
Titel
|
Der
Parameter <Titel> hat folgenden Aufbau (<Trennzeichen> ist ;):
<Text>;<Größe>;<Farbe>;<Font>;<Fontname>
Fehlende
Einträge werden durch die Voreinstellung ersetzt.
|
|
Voreinstellung
|
|
<Text>
= <STRING>
|
""
|
|
<Größe>
= <ZAHL>
|
<Text-Größe>
|
|
<Farbe>
= <Rot>,<Grün>,<Blau>
|
<Text-Farbe>
|
|
<Font>
= <Fett>,<Kursiv>,<Unterstrichen>
<Fett>
= <Ja> oder <Nein>
<Kursiv>
= <Ja> oder <Nein>
<Unterstrichen>
= <Ja> oder <Nein>
|
<Text-Font>
|
|
<Fontname>
= <STRING>
|
<Text-Fontname>
|
<Text>
legt die Überschrift der Grafik fest.
<Größe>
ist die Größe der Überschrift in Punkten.
<Farbe>
legt die Farbe der Überschrift fest.
<Font>
legt die Schriftart der Überschrift fest.
<Fontname>
legt die Schrift für die Überschrift fest.
|
Legende
|
Legt
die Position der Legende fest:
R
= rechts (right)
L = links (left)
T = oben (top)
B = unten (bottom)
N = keine Legende (none)
|
Datenreihentexte
|
Bei
den Parametern <X-Werte> und <Y-Werte> können in der
Wertedarstellung mehrere Datenreihen angegeben werden (siehe unten).
<Datenreihentexte> legt die Texte für die einzelnen Datenreihen fest,
die in der Legende angezeigt werden.
|
Farben
|
<Farben>
hat folgenden Aufbau (<Trennzeichen> ist ;):
<Rot>,<Grün>,<Blau>
[;<Rot>,<Grün>,<Blau>]...
Bei
Balkengrafiken mit nur einer Datenreihe und bei Tortengrafiken werden damit
die Farben der Werte (Balken oder 'Tortenstücke'), bei den anderen Grafiken
die Farben der einzelnen Datenreihen festgelegt.
|
X-Parameter
|
<X-Parameter>
und <Y-Parameter> können in der Textdarstellung T oder
Wertedarstellung V (Value)
angegeben werden (<Trennzeichen> ist ;):
|
Textdarstellung:
|
T;<Rasterlinien>;<Achsen-Beschriftung>;<Wert-Beschriftung>
|
|
|
|
|
|
|
Voreinstellung
|
|
|
<Rasterlinien>
= <Ja> oder <Nein>
|
N
|
|
|
<Achsen-Beschriftung>
= 0 oder 1 oder 2
|
0
|
|
|
<Wert-Beschriftung>
= <Ja> oder <Nein>
|
N
|
Fehlende
Einträge werden durch die Voreinstellung ersetzt.
Die
Textdarstellung wird gewählt, wenn die Achsenskala mit Texten beschriftet
wird (z.B. Umsatz Jan, Umsatz Feb, ...). Die Wertedarstellung wird
verwendet, wenn die Achsenskala mit Zahlenwerten oder Prozenten beschriftet
werden soll, die sich auf die Zahlenwerte <Wert_ij> beziehen.
Bei
Balkendiagrammen legt die Textdarstellung fest, ob die Balken im Hoch- oder
Querformat angezeigt werden: Wird <X-Parameter> im Textdarstellungat
angegeben, so werden die Balken im Hochformat angezeigt. Ist
<Y-Parameter> im Textdarstellungat und <X-Parameter> im
Wertedarstellungat, so erfolgt die Anzeige im Querformat. Sind
<X-Parameter> und <Y-Parameter> im Textdarstellungat, so werden
keine Balken, sondern nur Punkte angezeigt, da keine Werte für die Größe
der Balken vorliegen.
Bei
<Rasterlinien> = <Ja> werden durch die Achsenpunkte
Rasterlinien gezeichnet.
Die
<Achsen-Beschriftung> legt fest, wie die Achsen beschriftet werden:
|
0
1
jeder
andere Wert
|
keine
Beschriftung
Beschriftung
links bzw. unten
Beschriftung
links und rechts bzw. unten und oben
|
In
der Textdarstellung werden die Achsen mit den Texten <Text-i>
beschriftet.
Ist
<Wert-Beschriftung> = <Ja>, so werden die Grafikelemente mit
den Texten <Text-i> beschriftet, andernfalls erfolgt keine
Beschriftung.
|
Wertedarstellung:
|
V;<Rasterlinien>;
<Achsen-Beschriftung>;
<Suffix-Achsen-Beschriftung>;
<Achsen-Beschriftung-NKS>;
<Achsenwert-Minimum>;
<Achsenwert-Maximum>;
<Achsen-Unterteilung>;
<Wert-Beschriftung>;
<Prefix-Wert-Beschriftung>;
<Suffix-Wert-Beschriftung>;
<Wert-Beschriftung-NKS>;
<Prozent-Beschriftung>;
<Suffix-Prozent-Beschriftung>;
<Prozent-Beschriftung-NKS>
|
|
|
|
Voreinstellung
|
|
|
<Rasterlinien>
= <Ja> oder <Nein>
|
N
|
|
|
<Achsen-Beschriftung>
= 0 oder 1 oder 2
|
0
|
|
|
<Suffix-Achsen-Beschriftung>
= <STRING>
|
""
|
|
|
<Achsen-Beschriftung-NKS>
= <ZAHL>
|
0
|
|
|
<Achsenwert-Minimum>
= <ZAHL>
|
wird
errechnet
|
|
|
<Achsenwert-Maximum>
= <ZAHL>
|
wird
errechnet
|
|
|
<Achsen-Unterteilung>
= <ZAHL>
|
1
|
|
|
<Wert-Beschriftung>
= <Ja> oder <Nein>
|
N
|
|
|
<Prefix-Wert-Beschriftung>
= <STRING>
|
""
|
|
|
<Suffix-Wert-Beschriftung>=
<STRING>
|
""
|
|
|
<Wert-Beschriftung-NKS>
= <ZAHL>
|
0
|
|
|
<Prozent-Beschriftung>
= <Ja> oder <Nein>
|
N
|
|
|
<Suffix-Prozent-Beschriftung>
= <STRING>
|
""
|
|
|
<Prozent-Beschriftung-NKS>
= <ZAHL>
|
0
|
Fehlende
Einträge werden durch die Voreinstellung ersetzt.
Die
Wertedarstellung wird verwendet, wenn die Achsenskala mit Zahlenwerten oder
Prozenten beschriftet werden soll, die sich auf die Zahlenwerte
<Wert_ij> beziehen.
Bei
<Rasterlinien> = <Ja> werden durch die Achsenpunkte
Rasterlinien gezeichnet.
Die
<Achsen-Beschriftung> legt fest, wie die Achsen beschriftet werden:
|
0
1
jeder andere Wert
|
keine
Beschriftung
Beschriftung
links bzw. unten
Beschriftung
links und rechts bzw. unten und oben
|
In
der Textdarstellung werden die Achsen mit den Texten <Text-i>
beschriftet, in der Wertedarstellung mit den Zahlenwerten, die durch
<Achsenwert-Minimum>, <Achsenwert-Maximum> und
<Achsen-Unterteilung> festgelegt werden.
<Suffix-Achsen-Beschriftung>
ist eine Zeichenkette, die jeweils hinter dem Skalawert angezeigt wird.
<Achsen-Beschriftung-NKS>
legt fest, mit wie vielen Nachkommastellen die Werte der Achsenskala
angezeigt werden. Die Werte werden gerundet angezeigt.
<Achsenwert-Minimum>
und <Achsenwert-Maximum> legen den kleinsten und größten Wert der
Achsenskala fest. Der kleinste Wert wird links bzw. unten und der größte
Wert rechts bzw. oben angezeigt. <Achsen-Unterteilung> legt fest, in
wie viele Abschnitte die Achse aufgeteilt wird. Zwischen dem Minimum- und
dem Maximumwert werden also <Achsen-Unterteilung> - 1 Zwischenwerte
in jeweils gleichem Abstand angezeigt.
Bei
<Wert-Beschriftung> = <Ja> werden die Werte mit
<Wert_ij>, bei <Prozent-Beschriftung> = <Ja> mit
Prozenten beschriftet.
<Prefix-Wert-Beschriftung>
ist eine Zeichenkette, die vor dem Wert bzw. vor der Prozentzahl angezeigt
wird, wenn <Wert-Beschriftung> = <Ja> und/oder
<Prozent-Beschriftung> = <Ja> ist.
Bei
<Suffix-Wert-Beschriftung> kann eine Zeichenkette angegeben werden,
die nach <Wert_ij> angezeigt wird, wenn <Wert-Beschriftung> =
<Ja> ist.
<Wert-Beschriftung-NKS>
und <Prozent-Beschriftung-NKS> legen die Anzahl der Nachkommastellen
fest, mit denen <Wert_ij> bzw. die Prozente angezeigt werden.
<Suffix-Prozent-Beschriftung>
ist eine Zeichenkette die nach der Prozentzahl angezeigt wird, wenn
<Prozent-Beschriftung> = <Ja> ist.
|
Y-Parameter
|
Siehe
X-Parameter
|
X-Werte
|
Die
Parameter <X-Werte> und <Y-Werte> enthalten die Funktionswerte.
Bei
der Textdarstellung sind die Texte in folgendem Format anzugeben:
<Text-1>;<Text-2>...;<Text-n>
<Text-i>
= <STRING>
Bei
der Wertedarstellung gilt folgende Syntax:
<Wert_11>,<Wert_12>,...,<Wert_1r>;
<Wert_21>,<Wert_22>,...,<Wert_2r>;
...
<Wert_n2>,...,<Wert_nr>
<Wert_ij>
= <ZAHL>
(r
= Anzahl der Datenreihen, n = Anzahl Werte)
Bei
der Wertedarstellung können mehrere Datenreihen angegeben werden. Dies
bedeutet bei der horizontalen Darstellung, dass bei jedem X-Wert mehrere
Y-Werte vorkommen können. Analog dazu können bei der Querdarstellung jedem
Y-Wert mehrere X-Werte zugeordnet werden. Die Folge <Wert_1j> ...
<Wert_nj> (n = Anzahl Werte) wird Datenreihe j genannt. Es können
beliebig viele Datenreihen definiert werden. <Datenreihentexte> legt
die Texte für die einzelnen Datenreihen fest, die in der Legende angezeigt
werden.
Die
Werte <Wert_ij> müssen folgendermaßen angeordnet werden: Zuerst
kommen durch Komma getrennt die ersten Werte einer jeden Datenreihe. Dann
folgt das Trennzeichen. Danach folgen durch Komma getrennt die zweiten
Werte einer jeden Datenreihe, usw.
Bei
Tortengrafiken wird nur die erste Datenreihe verwendet, alle weiteren
werden ignoriert.
Bei
<Wert_ij> kann ein Stern "*" angefügt werden. Bei
Tortengrafiken erscheint das entsprechende 'Tortenstück' dann
herausgeschoben.
Bei
allen <...-NKS>-Parametern kann ein führendes "+"-Zeichen
angegeben werden. Bei positiven Werten wird dann das "+"-Zeichen
mit angezeigt.
|
Y-Werte
|
Siehe
X-Werte
|
Handle
|
Enthält
die Windowtiefe oder die Identifizierungsnummer eines Splitwindows oder
eines WINDOWCALL-Windows.
|
Dateiname
|
Legt
bei <Drucken> = -1 den Dateinamen fest, in dem das Bild gespeichert
wird.
|
|
|
Beispiel:
|
H% = GRAPHIC("P", /*
<Typ>
0, /* <Drucken>
5,
/* <Zeile>
2,
/* <Spalte>
11,
/* <Höhe>
35,
/* <Breite>
";", /* <Trennzeichen>
"", /* <Optionen>
"192,192,192;J", /* <Design>
"Umsatzentwicklung 1998;12;;J;Times" /* <Titel>
"B", /* <Legende>
"", /* <Datenreihentexte>
"255,0,0;0,255,0;0,0,255;255,255,0", /* <Farben>
"T;N;1;N",
/*
<X-Parameter>
"V;;;;;;;;;;;;J", /* <Y-Parameter>
"I/1998;II/1998;III/1998;IV/1998", /* <X-Werte>
"20;40;30;60") /* <Y-Werte>
IF H% <> 0
THEN ... Fehler ...
ENDIF
Damit wird folgende Grafik erzeugt:

H% = GRAPHIC("B", /* <Typ>
0, /* <Drucken>
2, /* <Zeile>
2, /* <Spalte>
14, /* <Höhe>
50, /* <Breite>
";", /*
<Trennzeichen>
"J", /*
<Optionen>
";J;1;;A;0;A;0;7;;N,N,N;MS Sans Serif", /* <Design>
"Umsatz;15;0,0,128;Y,Y,N;Arial", /* <Titel>
"R", /*
<Legende>
"Hardware;Software;Dienstl.;Zubehör;"+ /* <Datenreihentexte>
"Wartung;Support;sonstiges",
"128,0,0;0,0,0;128,0,128;128,64,0;"+ /* <Farben>
"0,128,0;0,0128;64,64,64",
"T;N;1;N", /*
<X-Parameter>
"V;Y;1;%;0;0;40;4;N;;;1;N;;1", /* <Y-Parameter>
"1997;1998", /*
<X-Werte>
"34.0,34.4,19.9,4,5.1,3.6,3.0;"+ /* <Y-Werte>
"35.9,22,19.6,12.9,3.2,4.2,2.2")
IF H% <> 0
THEN ... Fehler ...
ENDIF
Damit
wird folgende Grafik erzeugt:

|