Zum Hauptinhalt springen

ChartOpen

ChartOpen(int1, int2, int3[, alpha4[,int5]]) : handle​

Ausführbar von Clients mit grafischer Oberfläche Ausführbar vom Server Ausführbar von der DLL-Schnittstelle mit grafischer Erweiterung Ausführbar von der Web-Schnittstelle Ausführbar vom Druckprozessor Ausführbar von der ODBC-Schnittstelle Ausführbar vom SOA-Service mit grafischer Erweiterung

Chart -Grafik anlegen

Details

  • int1:
    • Typ der Chart-Grafik:
    • _ChartPie
    • _ChartXY
    • _ChartPyramid
    • _ChartSurface
  • int2: Breite des Chart -Objekts
  • int3: Höhe des Chart -Objekts
  • alpha4: Titel der Grafik (optional)
  • int5:
    • Legende (optional):
    • _ChartOptDefault
    • _ChartOptLegendVertical
    • _ChartOptLegendHorizontal
  • Resultat: handle Deskriptor des Chart -Objekts Anweisung setzt den globalen Fehlerwert
  • Siehe: Verwandte Befehle , ChartClose ()

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.