DataTransform

Paket	mx.charts.chartClasses
Klasse	public class DataTransform
Vererbung	DataTransform EventDispatcher Object
Unterklassen	CartesianTransform, PolarTransform

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Das DataTransform-Objekt stellt einen Teil eines Diagramms dar, das Glyphen enthält, und kann Werte in Bildschirmkoordinaten transformieren (und umgekehrt). Jedes DataTransform-Objekt hat eine horizontale Achse, eine vertikale Achse und einen Satz von zu rendernden Glyphen (Hintergrund, Daten und Überlagerung).

Theoretisch kann ein Diagramm mehrere überlagerte DataTransform-Objekte enthalten. Dies gibt Ihnen die Möglichkeit, ein Diagramm mit mehreren auf derselben Fläche, aber mit unterschiedlichen Bereichen gerenderten Datensätzen anzuzeigen. Es kann beispielsweise wünschenswert sein, die monatlichen Erträge im Vergleich zur Anzahl der verkauften Einheiten anzeigen zu können. Wenn die Erträge normalerweise in Millionen, die Einheiten jedoch normalerweise in Tausend angezeigt werden, wäre es schwierig, diese beiden Werte entlang desselben Bereichs anzuzeigen. Überlagern Sie sie in verschiedenen DataTransform-Objekten, kann der Endbenutzer die Tendenzen dieser Werte vergleichen, wenn sie in verschiedenen Bereichen gerendert werden.

Diagramme können nur einen DataTransform-Satz enthalten.

Meistens wird das ChartBase-Objekt verwendet, welches das Vorhandensein des DataTransform-Objekts zwischen dem Diagramm und den darin enthaltenen Glyphen und Achsenobjekten verbirgt. Wenn Sie Ihre eigenen ChartElement-Objekte erstellen, müssen Sie die Methoden der DataTransform-Klasse beherrschen, um ihr Element korrekt zu implementieren.

Öffentliche Eigenschaften

Vererbte öffentliche Eigenschaften ausblenden

Vererbte öffentliche Eigenschaften anzeigen

	Eigenschaft		Definiert von
		axes : Object [schreibgeschützt] Der Satz der mit dieser Transformation verknüpften Achsen.	DataTransform
		constructor : Object Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.	Object
		elements : Array Die mit dieser Transformation verknüpften Elemente.	DataTransform

Öffentliche Methoden

Vererbte öffentliche Methoden ausblenden

Vererbte öffentliche Methoden anzeigen

	Methode		Definiert von
		DataTransform() Konstruktor.	DataTransform
		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
		dataChanged():void Informiert das DataTransform, dass sich manche der im Diagramm dargestellten zugrunde liegenden Daten geändert haben.	DataTransform
		describeData(dimension:String, requiredFields:uint):Array Erfasst wichtige angezeigte Werte für alle mit dieser Datentransformation verknüpften Werte.	DataTransform
		dispatchEvent(event:Event):Boolean Sendet ein Ereignis in den Ereignisablauf.	EventDispatcher
		getAxis(dimension:String):IAxis Ruft die für die Transformation der durch den Parameter „dimension“ festgelegten Datendimension zuständige Achseninstanz ab.	DataTransform
		hasEventListener(type:String):Boolean Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.	EventDispatcher
		hasOwnProperty(name:String):Boolean Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.	Object
		invertTransform(... values):Array Transformiert x- und y-Koordinaten relativ zum DataTransform-Koordinatensystem in einen zweidimensionalen Wert im Datenraum.	DataTransform
		isPrototypeOf(theClass:Object):Boolean Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.	Object
		propertyIsEnumerable(name:String):Boolean Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Entfernt einen Listener aus dem EventDispatcher-Objekt.	EventDispatcher
		setAxis(dimension:String, v:IAxis):void Weist einer bestimmten Dimension der Transformation eine Achseninstanz zu.	DataTransform
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.	Object
		toLocaleString():String Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.	Object
		toString():String Gibt das angegebene Objekt als String zurück.	Object
		transformCache(cache:Array, xField:String, xConvertedField:String, yField:String, yConvertedField:String):void Ordnet einen Satz von numerischen Werten, die Daten repräsentieren, Bildschirmkoordinaten zu.	DataTransform
		valueOf():Object Gibt den Grundwert des angegebenen Objekts zurück.	Object
		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.	EventDispatcher

Ereignisse

Klicken Sie, um weitere Informationen zu Ereignissen zu erhalten.

Vererbte Ereignisse ausblenden

Vererbte Ereignisse anzeigen

	Übersicht	Definiert von
activate	[broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird.	EventDispatcher
deactivate	[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird.	EventDispatcher
transformChange	Wird ausgelöst, wenn sich die Transformation von Datenraum zu Bildschirmraum geändert hat, normalerweise kann dies zwei Gründe haben: Die Achsen, die die Transformation bilden, haben sich in irgendeiner Weise geändert oder die Größe der Datentransformation selbst hat sich geändert.	DataTransform

Eigenschaftendetails

axes	Eigenschaft

axes:Object [schreibgeschützt]

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Der Satz der mit dieser Transformation verknüpften Achsen.

Implementierung
public function get axes():Object

elements

Eigenschaft

elements:Array

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Die mit dieser Transformation verknüpften Elemente. Dieses Array umfasst mit der Transformation verknüpfte Hintergrund-, Serien- und Überlagerungselemente. Dieser Wert wird durch das umschließende Diagrammobjekt zugewiesen.

Implementierung
public function get elements():Array
public function set elements(value:Array):void

Konstruktordetails

()

Konstruktor

public function DataTransform()

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Konstruktor.

Methodendetails

dataChanged

()

Methode

public function dataChanged():void

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Informiert das DataTransform, dass sich manche der im Diagramm dargestellten zugrunde liegenden Daten geändert haben. Das DataTransform hat im Allgemeinen keine Kenntnis von der Quelle der durch das Diagramm dargestellten zugrunde liegenden Daten. Glyphen sollten deshalb diese Methode aufrufen, wenn sich ihre Daten ändern, sodass das DataTransform die Bereichsskalen basierend auf ihren Daten erneut berechnen kann. Dies führt nicht dazu, dass das DataTransform ungültig gemacht wird, da nicht sicher ist, dass sich die Daten geändert haben. Die Achsenobjekte (oder Bereichsobjekte) müssen ein Ereignis zum Ungültigmachen auslösen.

describeData

()

Methode

public function describeData(dimension:String, requiredFields:uint):Array

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Erfasst wichtige angezeigte Werte für alle mit dieser Datentransformation verknüpften Werte. Achseninstanzen rufen diese Methode auf, um die beim automatischen Generieren der korrekten Bereiche von ihnen zu berücksichtigenden Werte zu erfassen. Diese Methode gibt ein Array von BoundedValue-Objekten zurück.

Übergeben Sie zum Erfassen wichtiger Werte für die horizontale Achse eines CartesianTransform den Wert „0“. Übergeben Sie zum Erfassen von Werten für die vertikale Achse den Wert „1“.

Parameter

	`dimension:String` — Die Dimension, für die Werte erfasst werden sollen.

	`requiredFields:uint` — Definiert die von dieser Transformation benötigten Daten.

Rückgabewerte

Array — Ein Array von BoundedValue-Objekten.

getAxis

()

Methode

public function getAxis(dimension:String):IAxis

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Ruft die für die Transformation der durch den Parameter dimension festgelegten Datendimension zuständige Achseninstanz ab. Wurde zuvor keine Achse zugewiesen, wird eine Standardachse erstellt. Die Standardachse für alle Dimensionen ist eine LinearAxis, wobei die Eigenschaft autoAdjust auf false eingestellt ist.

Parameter

dimension:String — Die Dimension, deren Achse für die Transformation der Daten zuständig ist.

Rückgabewerte

IAxis — Die Achseninstanz.

Verwandte API-Elemente

mx.charts.LinearAxis

invertTransform

()

Methode

public function invertTransform(... values):Array

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Transformiert x- und y-Koordinaten relativ zum DataTransform-Koordinatensystem in einen zweidimensionalen Wert im Datenraum.

Parameter

... values — Die x- und die y-Position (in dieser Reihenfolge).

Rückgabewerte

Array — Ein Array, das die transformierten Werte enthält.

setAxis

()

Methode

public function setAxis(dimension:String, v:IAxis):void

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Weist einer bestimmten Dimension der Transformation eine Achseninstanz zu. Achsenobjekte werden durch das umschließende Diagrammobjekt zugewiesen.

Parameter

	`dimension:String` — Die Dimension der Transformation.

	`v:IAxis` — Die Zielachseninstanz.

transformCache

()

Methode

 public function transformCache(cache:Array, xField:String, xConvertedField:String, yField:String, yConvertedField:String):void

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Ordnet einen Satz von numerischen Werten, die Daten repräsentieren, Bildschirmkoordinaten zu. Bei dieser Methode wird davon ausgegangen, dass die Werte alle numerisch sind. Alle nicht numerischen Werte müssen demzufolge zuvor mit der mapCache()-Methode konvertiert worden sein.

Parameter

	`cache:Array` — Ein Array von Objekten, das die Datenwerte in ihren Feldern enthält. Hier speichert diese Funktion auch die konvertierten numerischen Werte.

	`xField:String` — Das Feld, in dem die Datenwerte für die x-Achse zu finden sind.

	`xConvertedField:String` — Das Feld, in dem die zugeordnete x-Bildschirmkoordinate gespeichert wird.

	`yField:String` — Das Feld, in dem die Datenwerte für die y-Achse zu finden sind.

	`yConvertedField:String` — Das Feld, in dem die zugeordnete y-Bildschirmkoordinate gespeichert wird.

Ereignisdetails

transformChange

Ereignis

Ereignisobjekttyp: mx.events.FlexEvent
Eigenschaft FlexEvent.type = mx.events.FlexEvent.TRANSFORM_CHANGE

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Wird ausgelöst, wenn sich die Transformation von Datenraum zu Bildschirmraum geändert hat, normalerweise kann dies zwei Gründe haben: Die Achsen, die die Transformation bilden, haben sich in irgendeiner Weise geändert oder die Größe der Datentransformation selbst hat sich geändert.

Die FlexEvent.TRANSFORM_CHANGE-Konstante definiert den Wert der type-Eigenschaft des Ereignisobjekts für ein transformChange-Ereignis.

Die Eigenschaften des Ereignisobjekts haben die folgenden Werte:

Eigenschaft	Wert
`bubbles`	false
`cancelable`	false
`currentTarget`	Das Objekt, das den Ereignis-Listener definiert, der das Ereignis übernimmt. Wenn Sie beispielsweise `myButton.addEventListener()` zur Registrierung eines Ereignis-Listeners verwenden, weist `currentTarget` den Wert „myButton“ auf.
`target`	Das Objekt, von dem das Ereignis ausgelöst wurde. Dies ist nicht immer das Objekt, das auf das Ereignis wartet. Verwenden Sie die `currentTarget`-Eigenschaft, damit immer auf das Objekt, das auf das Ereignis wartet, zugegriffen wird.

Rechtliche Hinweise | Onlinedatenschutzerklärung

DataTransform - AS3 Flex

Paketex

Sprachelemente

Anhänge

Paket mx.charts.chartClasses

axes

elements

DataTransform

dataChanged

describeData

getAxis

invertTransform

setAxis

transformCache

transformChange