Zum Hauptinhalt springen

ChartSave

obj -> ChartSave(alpha1[, int2[, handle3]]) : int​

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

Speichern des Chart -Objekts

Details

  • obj: Deskriptor auf Chart -Objekt
  • alpha1: Pfad- und Dateiname
  • int2:
    • Format des zu erzeugenden Bildes (optional):
    • _ChartFormatAuto
    • _ChartFormatPng
    • _ChartFormatJpg
    • _ChartFormatGif
    • _ChartFormatBmp
  • handle3: Deskriptor eines Memory -Objekts
  • Resultat: int Fehlerwert Anweisung setzt den globalen Fehlerwert
  • Siehe: Verwandte Befehle , ChartOpen ()

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.