IAxis - Adobe ActionScript® 3 (AS3 Flex) API-Referenz

Paket	mx.charts.chartClasses
Schnittstelle	public interface IAxis extends IEventDispatcher
Umsetzer	CategoryAxis, NumericAxis

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Die IAxis-Klasse ist eine abstrakte Schnittstelle zum Definieren der Positionseigenschaften von Beschriftungen, Markierungen und Daten für eine Achse in einem Diagramm.

Klassen implementieren diese Schnittstelle, um eine Bereichsdefinitionsfunktion bereitzustellen.

Verwandte API-Elemente

mx.charts.CategoryAxis
mx.charts.LinearAxis

Öffentliche Eigenschaften

	Eigenschaft		Definiert von
		baseline : Number [schreibgeschützt] Die Grundlinienposition der Achse.	IAxis
		chartDataProvider : Object [Nur Schreiben] Der dem umschließenden Diagramm zugewiesene Datenprovider.	IAxis
		displayName : String [schreibgeschützt] Der Name der Achse.	IAxis
		title : String [schreibgeschützt] Der Text für den entlang der Achse angezeigten Titel.	IAxis
		unitSize : Number [schreibgeschützt] Die Größe einer Einheit von Daten, wie sie durch diese Achse dargestellt wird.	IAxis

Öffentliche Methoden

Vererbte öffentliche Methoden ausblenden

Vererbte öffentliche Methoden anzeigen

	Methode		Definiert von
		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.	IEventDispatcher
		dataChanged():void Löst Ereignisse aus, die das Bereichsobjekt informieren, wenn sich die Diagrammdaten geändert haben.	IAxis
		dispatchEvent(event:Event):Boolean Sendet ein Ereignis in den Ereignisablauf.	IEventDispatcher
		filterCache(cache:Array, field:String, filteredString:String):void Filtert aus einem Satz von Werten beliebigen Typs einen Satz von Zahlen heraus, die zugeordnet werden können.	IAxis
		formatForScreen(value:Object):String Formatiert Werte für die Anzeige in DataTips.	IAxis
		getLabelEstimate():AxisLabelSet Bestimmt den Bereich, um die Achsenbeschriftungen zu schätzen.	IAxis
		getLabels(minimumAxisLength:Number):AxisLabelSet Ruft den gerenderten Beschriftungstext ab.	IAxis
		hasEventListener(type:String):Boolean Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.	IEventDispatcher
		invertTransform(value:Number):Object Ordnet eine Position entlang der Achse wieder einem numerischen Datenwert zu.	IAxis
		mapCache(cache:Array, field:String, convertedField:String, indexValues:Boolean = false):void Konvertiert einen Satz von Werten beliebigen Typs in einen Satz von Zahlen, die in Bildschirmkoordinaten transformiert werden können.	IAxis
		preferDropLabels():Boolean Bestimmt, wie die Achse sich überschneidende Beschriftungen verarbeitet.	IAxis
		reduceLabels(intervalStart:AxisLabel, intervalEnd:AxisLabel):AxisLabelSet Aufgerufen, wenn ein AxisRenderer die Beschriftungen ohne Überschneidungen nicht sauber rendern kann und eine Reduzierung des Beschriftungssatzes durch das Achsenobjekt benötigt.	IAxis
		registerDataTransform(transform:mx.charts.chartClasses:DataTransform, dimensionName:String):void Jedes DataTransform, das eine Achse nutzt, registriert sich bei dieser Achse.	IAxis
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Entfernt einen Listener aus dem EventDispatcher-Objekt.	IEventDispatcher
		transformCache(cache:Array, field:String, convertedField:String):void Ordnet einen Satz von Werten aus dem Datenraum Werten aus dem Bildschirmraum zu.	IAxis
		unregisterDataTransform(transform:mx.charts.chartClasses:DataTransform):void Jedes DataTransform, das eine Achse nutzt, registriert sich bei dieser Achse.	IAxis
		update():void Aktualisiert das Diagramm.	IAxis
		willTrigger(type:String):Boolean Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist.	IEventDispatcher

Eigenschaftendetails

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():Number

chartDataProvider

Eigenschaft

chartDataProvider:Object [Nur Schreiben]

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Der dem umschließenden Diagramm zugewiesene Datenprovider. Datenproviderbasierte Achsentypen können wahlweise den mit dem umschließenden Diagramm verknüpften Datenprovider erben. Wird eine Achse von mehreren Diagrammen gemeinsam verwendet, ist der Wert dieser Eigenschaft undefined (höchstwahrscheinlich der einem der verknüpften Diagramme zuletzt zugewiesene Datenprovider).

Implementierung
public function set chartDataProvider(value:Object):void

displayName

Eigenschaft

displayName:String [schreibgeschützt]

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Der Name der Achse. Ist dieser Name festgelegt, verwendet Flex ihn zum Formatieren der DataTip-Steuerelemente.

Implementierung
public function get displayName():String

title

Eigenschaft

title:String [schreibgeschützt]

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Der Text für den entlang der Achse angezeigten Titel.

Implementierung
public function get title():String

unitSize

Eigenschaft

unitSize:Number [schreibgeschützt]

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Die Größe einer Einheit von Daten, wie sie durch diese Achse dargestellt wird. Dieser Wert wird von verschiedenen Serientypen zur Unterstützung des Rendervorgangs verwendet. Die ColumnSeries-Klasse verwendet diesen Wert beispielsweise, um zu bestimmen, in welcher Breite die Säulen gerendert werden sollen. Verschiedene Achsentypen geben verschiedene Werte zurück. Dies hängt manchmal von den dargestellten Daten ab. Die DateTimeAxis-Klasse gibt z. B. möglicherweise die Anzahl der Millisekunden eines Tages oder eines Jahres zurück, abhängig von den im Diagramm gerenderten Daten. Da dieser Wert vom Erfassen der dargestellten Daten abhängt, können benutzerdefinierte Serien in ihrer updateData()- oder updateMapping()-Methode nicht davon ausgehen, dass dieser Wert exakt ist.

Implementierung
public function get unitSize():Number

Methodendetails

dataChanged

()

Methode

public function dataChanged():void

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Löst Ereignisse aus, die das Bereichsobjekt informieren, wenn sich die Diagrammdaten geändert haben.

filterCache

()

Methode

public function filterCache(cache:Array, field:String, filteredString: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.

	`filteredString: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.

Rückgabewerte

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ückgabewerte

AxisLabelSet — 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.

Rückgabewerte

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.

Rückgabewerte

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`) — Dieser Parameter ist `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.

Rückgabewerte

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.

Rückgabewerte

AxisLabelSet — Eine neuer Beschriftungssatz, durch den das Problem der Überschneidung behoben wird, indem die Anzahl der Beschriftungen reduziert wird.

registerDataTransform

()

Methode

public function registerDataTransform(transform:mx.charts.chartClasses:DataTransform, dimensionName:String):void

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Jedes DataTransform, das eine Achse nutzt, registriert sich bei dieser Achse. Die Achse ist zuständig dafür, die Transformation zu informieren, wenn sich relevante Werte der Achse geändert haben. Die Achse muss auch Werte von der Transformation abfragen, wenn sie den Mindest- und den Höchstwert automatisch generieren möchte.

Parameter

	`transform:mx.charts.chartClasses:DataTransform` — Das zu registrierende DataTransform.

	`dimensionName:String` — Der Name der Dimension.

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.

unregisterDataTransform

()

Methode

public function unregisterDataTransform(transform:mx.charts.chartClasses:DataTransform):void

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Parameter

transform:mx.charts.chartClasses:DataTransform — Das DataTransform, für das die Registrierung aufzuheben ist.

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.

Rechtliche Hinweise | Onlinedatenschutzerklärung

IAxis - AS3 Flex

Klassen x

baseline

chartDataProvider

displayName

title

unitSize

dataChanged

filterCache

formatForScreen

getLabelEstimate

getLabels

invertTransform

mapCache

preferDropLabels

reduceLabels

registerDataTransform

transformCache

unregisterDataTransform

update