<<

Inhaltsverzeichnis

Suchen

>>

 

GRAPHIC

 

 

Funktion

 

 

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>

 

 

Bedeutung:

Erzeugt eine Graphik (Tortendiagramm, Balkendiagramm, Kurve, Linie) und gibt diese am Bildschirm, auf dem Drucker oder in eine Datei aus.

 

GRAPHIC liefert folgende Ergebniswerte:

 

0

Die Grafik wurde erfolgreich erzeugt

7401

Diagramm paßt nicht in Rechteck

7402

Nur <X-Parameter> oder <Y-Parameter> sind in der Textdarstellung zulässig

7404

Unzulässiges Trennzeichen

7405

Ungültige Legende

7406

Ungültiger Typ

7409

Keine Bild-Datei angegeben

7410

Ungültige Größe/Position

 

<Zeile> und <Spalte> legen die Position und <Höhe> und <Breite> die Größe des Bereichs fest, in dem die Grafik angezeigt werden soll. Beim Drucken beziehen sich diese Parameter auf die Rasterkoordinaten (LPGRIDSETTING).

 

<Höhe> und <Breite> werden in Zeilen und Spalten angegeben.

 

Bei <Drucken> = -1 und -2 legen <Höhe> und <Breite> die Größe des Bildes in Pixel fest. <Zeile> und <Spalte> geben den Abstand vom Bildrand in Pixel an.

 

Achtung: Nachfolgend wird zur besseren Lesbarkeit als <Trennzeichen> der Strichpunkt ';' verwendet. Überall dort, wo in der Syntaxnotation der Strichpunkt vorkommt, ist dafür <Trennzeichen> einzusetzen.

 

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:

 

 

Siehe auch:

REMOVE_GRAPHIK