| Paket | mx.charts |
| Klasse | public class CategoryAxis |
| Vererbung | CategoryAxis  AxisBase EventDispatcher Object |
| Implementiert | IAxis |
| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Sie müssen die Eigenschaft dataProvider auf einer CategoryAxis nicht explizit festlegen. Eine in einem Diagramm verwendete CategoryAxis erbt die Eigenschaft dataProvider vom enthaltenden Diagramm.
Sie können die gleichen Datenprovider zur Bereitstellung von Daten für das Diagramm und die CategoryAxis-Kategorien verwenden, jedoch kann eine CategoryAxis das Rendern optimieren, wenn der Datenprovider relativ statisch ist. Wenn möglich, sollten Sie sicherstellen, dass die Kategorien relativ statisch sind und die sich ändernden Daten in verschiedenen Datenprovidern gespeichert werden.
Die Eigenschaft dataProvider akzeptiert entweder ein Array von Strings oder ein Array von Datensätzen (Objekte) bei einer Eigenschaft, die den Kategorienamen angibt. Wenn Sie eine categoryField-Eigenschaft angeben, geht die CategoryAxis davon aus, dass der Datenprovider ein Array von Objekten ist. Wenn die Eigenschaft categoryField den Wert null aufweist, geht die CategoryAxis davon aus, dass der Datenprovider ein Array von Strings ist.
MXML-Syntax anzeigen
MXML-Syntax ausblendenThe <mx:CategoryAxis> tag inherits all the properties
of its parent classes and adds the following properties:
<mx:CategoryAxis
Properties
categoryField="null"
dataFunction="No default"
dataProvider="No default"
labelFunction="No default"
padding="Default depends on chart type"
ticksBetweenLabels="true"
/>
| Eigenschaft | Definiert von | ||
|---|---|---|---|
| baseline : Number [schreibgeschützt]
Die Grundlinienposition der Achse. | CategoryAxis | ||
| categoryField : String
Gibt das Feld des Datenproviders an, das den Text für die Beschriftungen enthält. | CategoryAxis | ||
 | chartDataProvider : Object [Nur Schreiben]
Der dem umschließenden Diagramm zugewiesene Datenprovider. | AxisBase | |
| constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | |
| dataFunction : Function
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 { ... | CategoryAxis | ||
| dataProvider : Object
Gibt die Datenquelle mit den Beschriftungsnamen an. | CategoryAxis | ||
| displayName : String
Der Name der Achse. | AxisBase | |
| labelFunction : Function
Gibt eine Funktion an, die die Beschriftungen definiert, die für die einzelnen Elemente im dataProvider der CategoryAxis generiert werden. | CategoryAxis | ||
| padding : Number
Gibt den an beiden Seiten der Achse hinzuzufügenden Abstand an, wenn Daten auf dem Bildschirm gerendert werden. | CategoryAxis | ||
| ticksBetweenLabels : Boolean
Gibt die Position der großen Markierungen auf der Achse in Relation zu den Kategoriebeschriftungen an. | CategoryAxis | ||
| title : String
Der Text für den entlang der Achse angezeigten Titel. | AxisBase | |
| unitSize : Number [schreibgeschützt]
Die Größe einer Einheit von Daten, wie sie durch diese Achse dargestellt wird. | AxisBase | |
| Methode | Definiert von | ||
|---|---|---|---|
Konstruktor. | CategoryAxis | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird. | EventDispatcher | |
|
Löst Ereignisse aus, die das Bereichsobjekt informieren, wenn sich die Diagrammdaten geändert haben. | AxisBase | |
|
Sendet ein Ereignis in den Ereignisablauf. | EventDispatcher | |
Filtert aus einem Satz von Werten beliebigen Typs einen Satz von Zahlen heraus, die zugeordnet werden können. | CategoryAxis | ||
Formatiert Werte für die Anzeige in DataTips. | CategoryAxis | ||
Bestimmt den Bereich, um die Achsenbeschriftungen zu schätzen. | CategoryAxis | ||
Ruft den gerenderten Beschriftungstext ab. | CategoryAxis | ||
|
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat. | EventDispatcher | |
|
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | |
Ordnet eine Position entlang der Achse wieder einem numerischen Datenwert zu. | CategoryAxis | ||
|
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | |
Konvertiert einen Satz von Werten beliebigen Typs in einen Satz von Zahlen, die in Bildschirmkoordinaten transformiert werden können. | CategoryAxis | ||
Bestimmt, wie die Achse sich überschneidende Beschriftungen verarbeitet. | CategoryAxis | ||
|
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | |
Aufgerufen, wenn ein AxisRenderer die Beschriftungen ohne Überschneidungen nicht sauber rendern kann und eine Reduzierung des Beschriftungssatzes durch das Achsenobjekt benötigt. | CategoryAxis | ||
|
Jedes DataTransform, das eine Achse nutzt, registriert sich bei dieser Achse. | AxisBase | |
|
Entfernt einen Listener aus dem EventDispatcher-Objekt. | EventDispatcher | |
|
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | |
|
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | |
|
Gibt das angegebene Objekt als String zurück. | Object | |
Ordnet einen Satz von Werten aus dem Datenraum Werten aus dem Bildschirmraum zu. | CategoryAxis | ||
|
Jedes DataTransform, das eine Achse nutzt, registriert sich bei dieser Achse. | AxisBase | |
Aktualisiert das Diagramm. | CategoryAxis | ||
|
Gibt den Grundwert des angegebenen Objekts zurück. | Object | |
|
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist. | EventDispatcher | |
baseline | Eigenschaft |
baseline:Number [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
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.
Implementierung
public function get baseline():NumbercategoryField | Eigenschaft |
categoryField:String| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
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.
Implementierung
public function get categoryField():String public function set categoryField(value:String):voiddataFunction | Eigenschaft |
dataFunction:Function| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
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 { ... }
Axis ist die aktuelle Achse, die diese dataFunction verwendet. Item ist das aktuelle Element im dataProvider, das berücksichtigt wird. Diese Funktion gibt ein Objekt zurück.
Ein Verwendungsbeispiel für eine angepasste dataFunction ist die Rückgabe eines Werts aus einem dataProvider mit Elementen in eingebetteten Feldern.
Implementierung
public function get dataFunction():Function public function set dataFunction(value:Function):voidBeispiel
Verwendung dieses Beispiels
public function myFunction(axis:CategoryAxis,item:Object):Object {
return(item.Country.State);
}
dataProvider | Eigenschaft |
dataProvider:Object| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
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.
Implementierung
public function get dataProvider():Object public function set dataProvider(value:Object):voidlabelFunction | Eigenschaft |
labelFunction:Function| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
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:
categoryValueist der Wert der darzustellenden Kategorie.previousCategoryValueist der Wert der vorhergehenden Kategorie der Achse.axisist die gerenderte CategoryAxis.categoryItemist das Element aus demdataProvider, 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.
Implementierung
public function get labelFunction():Function public function set labelFunction(value:Function):voidpadding | Eigenschaft |
padding:Number| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
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.
Implementierung
public function get padding():Number public function set padding(value:Number):voidticksBetweenLabels | Eigenschaft |
ticksBetweenLabels:Boolean| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
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.
Implementierung
public function get ticksBetweenLabels():Boolean public function set ticksBetweenLabels(value:Boolean):voidCategoryAxis | () | Konstruktor |
public function CategoryAxis()| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Konstruktor.
filterCache | () | Methode |
public function filterCache(cache:Array, field:String, filteredField:String):void| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Filtert aus einem Satz von Werten beliebigen Typs einen Satz von Zahlen heraus, die zugeordnet werden können.
Parameter
cache:Array — Ein Array von Objekten zum Auslesen und Speichern von konvertierten Werten.
| |
field:String — Das Feld der Objekte im Cache-Array, das die vorgefilterten Werte enthält.
| |
filteredField:String — Das Feld der Objekte im Cache-Array, in dem die gefilterten Werte gespeichert werden sollten.
|
formatForScreen | () | Methode |
public function formatForScreen(value:Object):String| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Formatiert Werte für die Anzeige in DataTips. Gibt einen vom Benutzer lesbaren String zurück.
Parameter
value:Object — Der in eine Zeichenfolge zu konvertierende Wert.
|
String — Der Text des DataTip.
|
getLabelEstimate | () | Methode |
public function getLabelEstimate():AxisLabelSet| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
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.
RückgabewerteAxisLabelSet — Ein Array von AxisLabel-Objekten.
|
getLabels | () | Methode |
public function getLabels(minimumAxisLength:Number):AxisLabelSet| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Ruft den gerenderten Beschriftungstext ab. Wenn Flex diese Methode abruft, hat die Achse bereits die Mindestlänge der Beschriftung bestimmt.
Parameter
minimumAxisLength:Number — Die Mindestlänge der Achse in Pixeln. Die Achse kann länger als dieser Wert sein, jedoch nicht kürzer.
|
AxisLabelSet — Ein Array von AxisLabel-Objekten.
|
invertTransform | () | Methode |
public function invertTransform(value:Number):Object| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Ordnet eine Position entlang der Achse wieder einem numerischen Datenwert zu.
Parameter
value:Number — Die Grenze der Achse. Dieser Parameter sollte zwischen 0 und 1 liegen, wobei 0 die Mindestgrenze der Achse und 1 die Höchstgrenze der Achse ist.
|
Object — Ein Objekt mit dem umgewandelten Wert.
|
mapCache | () | Methode |
public function mapCache(cache:Array, field:String, convertedField:String, indexValues:Boolean = false):void| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Konvertiert einen Satz von Werten beliebigen Typs in einen Satz von Zahlen, die in Bildschirmkoordinaten transformiert werden können.
Parameter
cache:Array — Ein Array von Objekten zum Auslesen und Speichern von konvertierten Werten.
| |
field:String — Das Feld der Objekte im Cache-Array, das die vorkonvertierten Werte enthält.
| |
convertedField:String — Das Feld der Objekte im Cache-Array, in dem die konvertierten Werte gespeichert werden sollten.
| |
indexValues:Boolean (default = false)true, wenn die zugeordneten Werte Indexpositionswerte sind, und false, wenn sie natürliche Datenwerte sind.
|
preferDropLabels | () | Methode |
public function preferDropLabels():Boolean| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
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.
Boolean — true, wenn Beschriftungen ohne Datenverlust ausgelassen werden können, andernfalls false.
|
reduceLabels | () | Methode |
public function reduceLabels(intervalStart:AxisLabel, intervalEnd:AxisLabel):AxisLabelSet| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
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
intervalStart:AxisLabel — Der Anfang des Intervalls, in dem sich Beschriftungen überschneiden.
| |
intervalEnd:AxisLabel — Das Ende des Intervalls, in dem sich Beschriftungen überschneiden.
|
AxisLabelSet — Eine neuer Beschriftungssatz, durch den das Problem der Überschneidung behoben wird, indem die Anzahl der Beschriftungen reduziert wird.
|
transformCache | () | Methode |
public function transformCache(cache:Array, field:String, convertedField:String):void| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Ordnet einen Satz von Werten aus dem Datenraum Werten aus dem Bildschirmraum zu.
Parameter
cache:Array — Ein Array von Objekten zum Auslesen und Speichern von zugeordneten Werten.
| |
field:String — Das Feld der Objekte im Cache-Array, das die vorzugeordneten Werte enthält.
| |
convertedField:String — Das Feld der Objekte im Cache-Array, in dem die zugeordneten Werte gespeichert werden sollten.
|
update | () | Methode |
public function update():void| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Aktualisiert das Diagramm. Diese Methode kann mehrmals pro Frame aufgerufen werden.
<?xml version="1.0"?>
<!-- Simple example to demonstrate the HLOCChart control. -->
<s:Application xmlns:fx="http://ns.adobe.com/mxml/2009"
xmlns:s="library://ns.adobe.com/flex/spark"
xmlns:mx="library://ns.adobe.com/flex/mx">
<fx:Script>
<![CDATA[
import mx.collections.ArrayCollection;
[Bindable]
private var stockDataAC:ArrayCollection = new ArrayCollection( [
{ Date: "25-Jul", Open: 40.55, High: 40.75, Low: 40.24, Close:40.31},
{ Date: "26-Jul", Open: 40.15, High: 40.78, Low: 39.97, Close:40.34},
{ Date: "27-Jul", Open: 40.38, High: 40.66, Low: 40, Close:40.63},
{ Date: "28-Jul", Open: 40.49, High: 40.99, Low: 40.3, Close:40.98},
{ Date: "29-Jul", Open: 40.13, High: 40.4, Low: 39.65, Close:39.95},
{ Date: "1-Aug", Open: 39.00, High: 39.50, Low: 38.7, Close:38.6},
{ Date: "2-Aug", Open: 38.68, High: 39.34, Low: 37.75, Close:38.84},
{ Date: "3-Aug", Open: 38.76, High: 38.76, Low: 38.03, Close:38.12},
{ Date: "4-Aug", Open: 37.98, High: 37.98, Low: 36.56, Close:36.69},
{ Date: "5-Aug", Open: 36.61, High: 37, Low: 36.48, Close:36.86} ]);
]]>
</fx:Script>
<fx:Declarations>
<!-- Define custom Stroke for the wick and ticks. -->
<mx:SolidColorStroke id="s1" color="0x000000" weight="5" joints="bevel" caps="square"/>
</fx:Declarations>
<mx:Panel title="HLOCChart Control Example" height="100%" width="100%">
<mx:HLOCChart id="hlocchart" height="100%" width="100%"
paddingRight="5" paddingLeft="5"
showDataTips="true" dataProvider="{stockDataAC}">
<mx:verticalAxis>
<mx:LinearAxis id="vaxis" baseAtZero="false" title="Price"/>
</mx:verticalAxis>
<mx:horizontalAxis>
<mx:CategoryAxis id="haxis" categoryField="Date" title="Date"/>
</mx:horizontalAxis>
<mx:horizontalAxisRenderers>
<mx:AxisRenderer axis="{haxis}" canDropLabels="true"/>
</mx:horizontalAxisRenderers>
<mx:series>
<mx:HLOCSeries
openField="Open"
highField="High"
lowField="Low"
closeField="Close"
stroke="{s1}"
openTickStroke="{s1}"
closeTickStroke="{s1}"
openTickLength="7"
closeTickLength="7"
/>
</mx:series>
</mx:HLOCChart>
</mx:Panel>
</s:Application>
Tue Jun 12 2018, 10:04 AM Z