Zum Hauptinhalt springen

ChartOpen

Mit dieser Anweisung wird ein Chart-Objekt angelegt. Der Typ der Grafik wird im Parameter (int1) angegeben. Folgende Konstanten stehen dafür zur Verfügung:

  • _ChartPie

    Es wird eine Tortengrafik angelegt. Es können Torten- oder Donut-Grafiken erzeugt werden. Donut-Grafiken werden dabei durch die zusätzliche Angabe eines Innenradius in der Eigenschaft ChartPieInnerRadius erstellt. Die einzelnen Daten werden als Teil der Gesamtmenge angezeigt.

  • _ChartXY

    Es wird ein Koordinaten-Diagramm angezeigt. Es können Balken-, Linien- oder Flächen-Grafiken erzeugt werden. Die Darstellung wird über die Eigenschaft ChartXYStyleData bestimmt.

  • _ChartPyramid

    Es wird ein Pyramiden-Diagramm angezeigt. Es können Pyramiden-, Kegel- oder Trichter-Grafiken erzeugt werden. Die Darstellung wird über die Eigenschaft ChartPyramidStyleData bestimmt.

  • _ChartSurface

    Es wird ein Oberflächen-Diagramm angezeigt.

Die Parameter (int2) und (int3) bestimmen die Breite und Höhe der Grafik. Die Angaben erfolgen in Pixel. In (alpha4) kann ein Titel für die Grafik angegeben werden. Der Titel wird oben innerhalb der Grafik angezeigt.

Stadardmäßig wird keine Legende angezeigt. Soll eine Legende mit gezeichnet werden, kann zwischen folgenden Typen ausgewählt werden:

  • _ChartOptDefault

    Es wird keine Legende gezeichnet.

  • _ChartOptLegendVertical

    Es wird eine vertikale Legende gezeichnet.

  • _ChartOptLegendHorizontal

    Es wird eine horizontale Legende gezeichnet.

Die Position, Darstellung und Inhalt der Legende werden über verschiedene Eigenschaften des Chart-Objekts gesteuert.

Die Grafik wird erst dann erzeugt, wenn das Chart-Objekt mit der Anweisung ``ChartSave() gespeichert wurde. Die Speicherung kann entweder in eine externe Datei oder in einem Memory-Objekt erfolgen. Anschließend kann das Chart-Objekt mit der Anweisung ChartClose() geschlossen werden.

Die darzustellenden Daten werden mit einem ChartData-Objekt angegeben. Das Objekt kann mit der Anweisung ``ChartDataOpen() erzeugt werden.

Bei erfolgreicher Durchführung gibt die Anweisung den Desktriptor auf ein Chart-Objekt zurück. Steht zum Anlegen des Objekts nicht genug Speicher zur Verfügung, wird die Konstante _ErrOutOfMemory zurückgegeben.

Beispiel:

// Pie
tHdlChart # ChartOpen(_ChartPie, 400, 300, 'Title');
...
tHdlChart->ChartSave(_Sys->spPathTemp + '\chart.gif');
tHdlChart->ChartClose();

Mögliche Laufzeitfehler:

  • _ErrValueInvalid: Im Parameter (int1) wurde ein ungültiger Typ oder in (int5) ein ungültiger Wert angegeben.