CategoryAxis  - AS3 Flex

Die Grundlinienposition der Achse. Einige Serien wie ColumnSeries oder AreaSeries verwenden diesen Wert zum Definieren der Basis eines ausgefüllten Bereichs, wenn kein Mindestwert angegeben ist.

Gibt das Feld des Datenproviders an, das den Text für die Beschriftungen enthält. Wenn diese Eigenschaft null entspricht, geht CategoryAxis davon aus, dass der dataProvider ein Array von Strings enthält.

Der Standardwert ist null.

Gibt eine Methode an, die den Wert zurückgibt, der als categoryValue für das aktuelle Element verwendet werden soll. Wenn diese Eigenschaft festgelegt wird, hat der Rückgabewert der angepassten Datenfunktion Vorrang vor categoryField.

Die angepasste dataFunction hat die folgende Signatur:

     function_name (axis:CategoryAxis, item:Object):Object { ... }
     

Ein Verwendungsbeispiel für eine angepasste dataFunction ist die Rückgabe eines Werts aus einem dataProvider mit Elementen in eingebetteten Feldern.

     public function myFunction(axis:CategoryAxis,item:Object):Object {
          return(item.Country.State);
     }     
     

Gibt die Datenquelle mit den Beschriftungsnamen an. Der dataProvider kann ein Array von Strings oder Objekten oder ein beliebiges Objekt sein, das die IList- oder ICollectionView-Schnittstelle implementiert. Wenn der dataProvider ein Array von Strings ist, vergewissern Sie sich, dass die Eigenschaft categoryField auf null gesetzt ist. Wenn der dataProvider ein Array von Objekten ist, setzen Sie die Eigenschaft categoryField auf den Namen des Felds, das den Beschriftungstext enthält.

Gibt eine Funktion an, die die Beschriftungen definiert, die für jedes Element im dataProvider der CategoryAxis generiert werden. Wenn keine labelFunction vorhanden ist, verwenden die Achsenbeschriftungen standardmäßig den Wert der Kategorie selbst.

Die labelFunction-Methode für eine CategoryAxis hat folgende Signatur:

      function function_name(categoryValue:Object, previousCategoryValue:Object, axis:CategoryAxis, categoryItem:Object):String { ... }
      

Ort:

• categoryValue ist der Wert der darzustellenden Kategorie.
• previousCategoryValue ist der Wert der vorhergehenden Kategorie der Achse.
• axis ist die gerenderte CategoryAxis.
• categoryItem ist das Element aus dem dataProvider, das dargestellt wird.

Flex zeigt den zurückgegebenen String als Achsenbeschriftung an.

Wenn die Eigenschaft categoryField nicht festgelegt ist, entspricht der Wert der Eigenschaft categoryValue.

Gibt den an beiden Seiten der Achse hinzuzufügenden Abstand an, wenn Daten auf dem Bildschirm gerendert werden. Legen Sie 0 fest, um die erste Kategorie dem Anfang der Achse und die letzte Kategorie dem Ende zuzuweisen. Legen Sie 0,5 fest, um einen Abstand von einer halben Kategoriebreite zwischen dem Beginn der Achse und der ersten Kategorie und der letzten Kategorie und dem Ende der Achse hinzuzufügen.

Dies ist bei Diagrammen nützlich, bei denen über die Grenzen der Kategorie hinaus Werte gerendert werden, wie bei Säulen- und Balkendiagrammen. Bei Verwendung als horizontalAxis in einem LineChart oder AreaChart wird der Wert auf 0 zurückgesetzt.

Der Standardwert ist 0.5.

Gibt die Position der großen Markierungen auf der Achse in Relation zu den Kategoriebeschriftungen an. Bei true werden Markierungen (und die verknüpften Rastelinien) zwischen den Kategorien angezeigt. Bei false werden Markierungen in der Mitte der Kategorie angezeigt und sind an der Beschriftung ausgerichtet.

Konstruktor.

Filtert aus einem Satz von Werten beliebigen Typs einen Satz von Zahlen heraus, die zugeordnet werden können.

Parameter

Formatiert Werte für die Anzeige in DataTips. Gibt einen vom Benutzer lesbaren String zurück.

Parameter

Bestimmt den Bereich, um die Achsenbeschriftungen zu schätzen. Die Achse ruft direkt im Anschluss daran die getLabels()-Methode auf, um die tatsächlichen Werte abzurufen. Die Achse verwendet die geschätzten Werte zum Anpassen der Ränder des Diagramms, sodass gegebenenfalls auftretende Unterschiede zwischen den geschätzten Beschriftungen und den tatsächlichen Beschriftungen (zurückgegeben von der getLabels()-Methode) dazu führen, dass die Beschriftungen passend skaliert werden.

Die Achse braucht für die Schätzung nur den Mindest- und den Höchstwert für die Beschriftung zurückzugeben. Ist der Beschriftungssatz relativ statisch und hängt nicht von der Größe der auf dem Bildschirm wiedergegebenen Achse ab, kann die Achse aus dieser Funktion heraus den gesamten Beschriftungssatz zurückgeben und die Schätzung als exakt zutreffend markieren.

Ruft den gerenderten Beschriftungstext ab. Wenn Flex diese Methode abruft, hat die Achse bereits die Mindestlänge der Beschriftung bestimmt.

Parameter

Ordnet eine Position entlang der Achse wieder einem numerischen Datenwert zu.

Parameter

Konvertiert einen Satz von Werten beliebigen Typs in einen Satz von Zahlen, die in Bildschirmkoordinaten transformiert werden können.

Parameter

Bestimmt, wie die Achse sich überschneidende Beschriftungen verarbeitet. Normalerweise geben numerische Bereiche den Wert true zurück, während diskrete wertbasierte Bereiche dies nicht tun. Sie können diese Eigenschaft überschreiben, indem Sie sie direkt an der Achse einstellen.

Aufgerufen, wenn ein AxisRenderer die Beschriftungen ohne Überschneidungen nicht sauber rendern kann und eine Reduzierung des Beschriftungssatzes durch das Achsenobjekt benötigt. An die Methode werden zwei sich überschneidende Beschriftungen übergeben.

Parameter

Ordnet einen Satz von Werten aus dem Datenraum Werten aus dem Bildschirmraum zu.

Parameter

Aktualisiert das Diagramm. Diese Methode kann mehrmals pro Frame aufgerufen werden.