ChartDataSort

obj -> ChartDataSort([int1[, range2]]) : int

Daten im ChartData -Objekt sortieren

Details

• obj: Deskriptor des ChartData -Objekts
• int1:
  • Sortier-Optionen (optional):
  • _ChartDataSortLabel
  • _ChartDataSortLabelCI
  • _ChartDataSortValue
• range2: Bereich (optional)
• Resultat: int _ErrOk
• Siehe: Verwandte Befehle , ChartDataAdd ()

Mit dieser Anweisung werden die Daten in einem ChartData -Objekt sortiert. Der Deskriptor des Daten-Objekts wird in (obj) angegeben. Im Parameter (int1) wird das Sortier-Kriterium angegeben. Folgende Optionen stehen zur Verfügung:

• _ChartDataSortLabel Die Daten werden nach den Bezeichnern sortiert.
• _ChartDataSortLabelCI De Daten werden nach den Bezeichnern sortiert. Die Groß-/Kleinschreibung wird dabei nicht berücksichtigt.
• _ChartDataSortValue Die Daten werden nach den Werten sortiert. Die Sortierung erfolgt aufsteigend.

Die Zuordnung von Bezeichnern, Farben und Daten bleiben durch die Sortierung der Daten erhalten. Die Optionen können nicht miteinander kombiniert werden.

Im optionalen Parameter (range2) kann ein Bereich angegeben werden, wenn nur eine Teilmenge sortiert werden soll. Ohne Angabe des Arguments findet keine Einschränkung statt.

info

ChartData -Objekte, die anderen ChartData -Objekten untergeordnet sind, können nicht sortiert werden.

Beispiele:

// Nach Beschriftung sortieren ohne Bereichseinschränkung 
tChartData->ChartDataSort(_ChartDataSortLabel, RangeMake(0, 0));
// oder
tChartData->ChartDataSort(_ChartDataSortLabel);

// Nach Datenmenge sortieren; die Einträge 5..12
tChartData->ChartDataSort(_ChartDataSortValue, RangeMake(5, 12));

Als Rückgabewert wird immer _ErrOk zurückgegeben.

Mögliche Laufzeitfehler:

• _ErrValueInvalid: Der in (int1) angegebene Datentyp ist nicht im ChartData -Objekt enthalten oder der angegebene Bereich liegt nicht innerhalb der bei ChartDataOpen () angegebenen Anzahl der Elemente.
• _ErrHdlInvalid: In (obj) wurde kein gültiger ChartData -Deskriptor angegeben.