ChartDataSort

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.