| 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 |
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.
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 | ||
| Methode | Definiert von | ||
|---|---|---|---|
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 | |
Informiert das DataTransform, dass sich manche der im Diagramm dargestellten zugrunde liegenden Daten geändert haben. | DataTransform | ||
Erfasst wichtige angezeigte Werte für alle mit dieser Datentransformation verknüpften Werte. | DataTransform | ||
|
Sendet ein Ereignis in den Ereignisablauf. | EventDispatcher | |
Ruft die für die Transformation der durch den Parameter „dimension“ festgelegten Datendimension zuständige Achseninstanz ab. | DataTransform | ||
|
Ü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 | |
Transformiert x- und y-Koordinaten relativ zum DataTransform-Koordinatensystem in einen zweidimensionalen Wert im Datenraum. | DataTransform | ||
|
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | |
|
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | |
|
Entfernt einen Listener aus dem EventDispatcher-Objekt. | EventDispatcher | |
Weist einer bestimmten Dimension der Transformation eine Achseninstanz zu. | DataTransform | ||
|
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 | |
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 | ||
|
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 | |
| Ereignis | Übersicht | Definiert von | ||
|---|---|---|---|---|
| [broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird. | EventDispatcher | ||
| [broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird. | EventDispatcher | ||
| 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 | |||
axes | Eigenschaft |
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):voidDataTransform | () | Konstruktor |
public function DataTransform()| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Konstruktor.
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.
|
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.
|
IAxis — Die Achseninstanz.
|
Verwandte API-Elemente
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).
|
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.
|
transformChange | Ereignis |
mx.events.FlexEventEigenschaft 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.
DieFlexEvent.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. |
Tue Jun 12 2018, 10:04 AM Z