ChartDataAdd

obj -> ChartDataAdd(var1[, int2]) : int

Daten in ein ChartData -Objekt einfügen

Details

• obj: Deskriptor auf ein ChartData -Objekt
• var1: Einzufügende Daten
• int2:
  • Datentyp:
  • _ChartDataValue
  • _ChartDataLabel
  • _ChartDataColor
  • _ChartDataExtra
• Resultat: int Fehlerwert
• Siehe: Verwandte Befehle , ChartDataOpen ()

Mit dieser Anweisung werden Daten einem ChartData -Objekt hinzugefügt. Das Objekt muss zuvor mit ChartDataOpen () erzeugt worden sein. Der Deskriptor des Objekts wird in (obj) übergeben.

In (var1) werden die Daten übergeben. Abhängig vom Typ der Daten kann hier eine Variable bzw. ein Array mit bestimmten Datentypen angegeben werden. Der Typ der Daten wird in (int2) übergeben:

• Typ der Daten (int2): (var1) Beschreibung
• _ChartDataValue: int , bigint , float darzustellende Daten
• _ChartDataLabel: alpha Bezeichner der Sektoren oder Balken
• _ChartDataColor: color , int Farben der Sektoren oder Balken
• _ChartDataExtra: alpha Zusätzliche Daten

info

Farbwerte von Datentyp color besitzen neben den Werten für die Anteile Rot, Grün und Blau zusätzlich einen Transparenzwert, mit dem die Deckung der Farbe angegeben werden kann.

Wird (int2) nicht angegeben, werden in (var1) darzustellende Daten angegeben. Die Datenmenge kann in Form von int-, bigint- oder float-Werten übergeben werden. Eine Mischung der Daten in einer Datenreihe ist nicht möglich. Als Bezeichnungen können nur Zeichenketten (alpha) angegeben werden. Farben können als _WinCol...-Farbwerte oder mit den Datentyp color angegeben werden. Auch hier ist eine Mischung der Datentypen nicht möglich.

Wird als Wert die Konstante _ChartDataNoValue angegeben, kennzeichnet sie einen fehlenden Wert.

info

Daten vom Typ _ChartDataLabel , _ChartDataColor und _ChartDataExtra können nur übergeben werden, wenn das ChartData -Objekt mit der Anweisung ChartDataOpen () entsprechen vorbereitet wurde.

Konnte die Anweisung ausgeführt werden, gibt sie den Wert _ErrOk zurück. Steht kein ausreichender Speicher zur Verfügung, wird _ErrOutOfMemory zurückgegeben.

Beispiel:

tChartData->ChartDataAdd('Frankfurt am Main', _ChartDataLabel);
tChartData->ChartDataAdd(664838);
tChartData->ChartDataAdd('Wiesbaden', _ChartDataLabel);
tChartData->ChartDataAdd(276742);

Mögliche Laufzeitfehler:

• _ErrValueInvalid: In (int2) wurde ein ungültiger Wert übergeben oder der angegebene Datentyp wurde nicht bei ChartDataOpen () spezifiziert. Der Laufzeitfehler wird auch generiert, wenn die Obergrenze der insgesamt möglichen Daten (siehe ChartDataOpen () ) überschritten wurde.
• _ErrFldType: In (var1) wurde ein nicht unterstützter Datentyp übergeben.