ChartSave

Mit diesem Befehl wird ein Chart-Objekt als Bild in einer externen Datei oder einem Memory-Objekt gespeichert. Im (obj) wird der Deskriptor übergeben, der von ``ChartOpen() zurückgegeben wurde. In (alpha1) wird der Pfad und der Name der externen Datei übergeben. Die Angabe einer externen Datei kann entfallen, wenn die Speicherung in einem Memory-Objekt erfolgt.

In (int2) wird das Dateiformat angegeben. Wird dieser Parameter nicht angegeben, wird das Dateiformat aus der Dateierweiterung des externen Dateinamens ermittelt (entspricht _ChartFormatAuto). Folgende Konstanten können angegeben werden:

• _ChartFormatAuto

  Das Dateiformat wird in Abhängigkeit von der Dateierweiterung des in (alpha1) angegebenen Dateinamens gewählt. Zulässige Dateierweiterungen sind .png, .jpg, .jpeg, .gif und .bmp.

• _ChartFormatPng

  Es wird eine PNG-Datei erzeugt.

• _ChartFormatJpg

  Es wird eine JPEG-Datei erzeugt.

• _ChartFormatGif

  Es wird eine GIF-Datei erzeugt.

• _ChartFormatBmp

  Es wird eine Bitmap-Datei erzeugt.

• _ChartFormatPdf

  Es wird eine PDF-Datei erzeugt.

Erfolgt die Speicherung in einem Memory-Objekt, muss in (handle3) der entsprechende Deskriptor angegeben werden. Das Memory-Objekt muss ausreichend dimensioniert sein, dass die Ausgabedaten komplett hineinpassen. Hat das Objekt die Option _MemAutoSize gesetzt, wird es automatisch vergrößert, wenn notwendig. Die Daten werden an die aktuelle Position im Memory-Objekt angehängt. Ist als Format _ChartFormatAuto angegeben, werden Daten im PNG-Format erzeugt. Ist in (handle3) ein Wert angegeben, wird der Dateiname in (alpha1) ignoriert.

info

Nach der Durchführung der Anweisung haben Änderungen an Eigenschaften und Chart-Daten keine Auswirkung mehr. Es ist jedoch möglich den Befehl mehr als einmal aufzurufen, um mehrere Dateien unterschiedlicher Formate zu generieren.

Wurden die Daten erfolgreich gespeichert, gibt die Anweisung _ErrOk zurück. Ist beim Schreiben in eine externe Datei ein Fehler aufgetreten, wird _ErrFsiOther zurückgegeben.

Mögliche Laufzeitfehler:

• _ErrValueInvalid: In (alpha1) wurde eine leere Zeichenkette oder in (int2) ein ungültiger Wert angegeben. Der Laufzeitfehler wird auch generiert, wenn _ChartFormatAuto angegeben ist, der Dateiname jedoch keine gültige Endung besitzt.
• _ErrHdlInvalid: Bei dem in (obj) übergebenen Deskriptor handelt es sich nicht um einen gültigen Chart-Deskriptor oder bei (handle3) nicht um ein Memory-Objekt.
• _ErrValueRange: Das übergebene Memory-Objekt hat nicht genug Platz zum Schreiben aller Daten.