ActionScript® 3.0 Referenzhandbuch für die Adobe® Flash®-Plattform
Home  |  Liste der Pakete und Klassen ausblenden |  Pakete  |  Klassen  |  Neue Funktionen  |  Stichwortverzeichnis  |  Anhänge  |  Warum auf Englisch?
Filter: Daten werden vom Server abgerufen...
Daten werden vom Server abgerufen...
mx.charts.chartClasses 

IChartElement  - AS3 Flex

Paketmx.charts.chartClasses
Schnittstellepublic interface IChartElement extends IFlexDisplayObject , IBitmapDrawable , IEventDispatcher

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

IChartElement definiert den Basissatz an Eigenschaften und Methoden, die für eine UIComponent erforderlich sind, damit sie im Datenbereich eines Diagramms angezeigt werden kann. Jede der Serie, dem backgroundElements-Array oder dem annotationElements-Array eines Diagramms zugewiesene Komponente muss diese Schnittstelle implementieren.



Öffentliche Eigenschaften
 EigenschaftDefiniert von
 InheritedaccessibilityProperties : AccessibilityProperties
Die aktuellen Optionen für Eingabehilfen zur Barrierefreiheit dieses Anzeigeobjekts.
IFlexDisplayObject
 Inheritedalpha : Number
Gibt den Alphatransparenzwert des angegebenen Objekts an.
IFlexDisplayObject
 InheritedblendMode : String
Ein Wert aus der BlendMode-Klasse, mit dem angegeben wird, welcher Mischmodus verwendet werden soll.
IFlexDisplayObject
 InheritedcacheAsBitmap : Boolean
Wird diese Eigenschaft auf „true“ gesetzt, speichern Flash-Laufzeitumgebungen eine interne Bitmap-Darstellung des Anzeigeobjekts im Cache.
IFlexDisplayObject
  chartDataProvider : Object
[Nur Schreiben] Der dem umschließenden Diagramm zugewiesene Datenprovider.
IChartElement
  dataTransform : mx.charts.chartClasses:DataTransform
[Nur Schreiben] Das DataTransform-Objekt, das das Element für die Zuordnung zwischen Daten und Bildschirmkoordinaten verwendet.
IChartElement
 Inheritedfilters : Array
Ein indiziertes Array, das alle dem Anzeigeobjekt derzeit zugeordneten filter-Objekte enthält.
IFlexDisplayObject
 Inheritedheight : Number
Gibt die Höhe des Anzeigeobjekts in Pixeln an.
IFlexDisplayObject
  labelContainer : Sprite
[schreibgeschützt] Das DisplayObject, das die durch dieses Element gerenderten Beschriftungen anzeigt.
IChartElement
 InheritedloaderInfo : LoaderInfo
[schreibgeschützt] Gibt ein LoaderInfo-Objekt mit Informationen zum Laden der Datei zurück, zu der dieses Anzeigeobjekt gehört.
IFlexDisplayObject
 Inheritedmask : DisplayObject
Das aufrufende Anzeigeobjekt wird durch das angegebene mask-Objekt maskiert.
IFlexDisplayObject
 InheritedmeasuredHeight : Number
[schreibgeschützt] Die gemessene Höhe dieses Objekts.
IFlexDisplayObject
 InheritedmeasuredWidth : Number
[schreibgeschützt] Die gemessene Breite dieses Objekts.
IFlexDisplayObject
 InheritedmouseX : Number
[schreibgeschützt] Gibt die x-Koordinate der Position der Maus oder des Benutzereingabegeräts in Pixeln an.
IFlexDisplayObject
 InheritedmouseY : Number
[schreibgeschützt] Gibt die y-Koordinate der Position der Maus oder des Benutzereingabegeräts in Pixeln an.
IFlexDisplayObject
 Inheritedname : String
Gibt den Instanznamen des Anzeigeobjekts an.
IFlexDisplayObject
 InheritedopaqueBackground : Object
Legt fest, ob das Anzeigeobjekt bei einer bestimmten Hintergrundfarbe undurchsichtig ist.
IFlexDisplayObject
 Inheritedparent : DisplayObjectContainer
[schreibgeschützt] Gibt das DisplayObjectContainer-Objekt an, das dieses Anzeigeobjekt enthält.
IFlexDisplayObject
 Inheritedroot : DisplayObject
[schreibgeschützt] Bei einem Anzeigeobjekt in einer geladenen SWF-Datei ist die root-Eigenschaft das oberste Anzeigeobjekt in dem Teil der Baumstruktur der Anzeigeliste, der diese SWF-Datei repräsentiert.
IFlexDisplayObject
 Inheritedrotation : Number
Gibt die Drehung der DisplayObject-Instanz ausgehend von der ursprünglichen Ausrichtung in Grad an.
IFlexDisplayObject
 Inheritedscale9Grid : Rectangle
Das aktuell verwendete Skalierungsraster.
IFlexDisplayObject
 InheritedscaleX : Number
Gibt die horizontale Skalierung (Prozentwert) des Objekts ausgehend vom Registrierungspunkt an.
IFlexDisplayObject
 InheritedscaleY : Number
Gibt die vertikale Skalierung (Prozentwert) eines Objekts ausgehend vom Registrierungspunkt an.
IFlexDisplayObject
 InheritedscrollRect : Rectangle
Die Begrenzungen des Bildlaufrechtecks für das Anzeigeobjekt.
IFlexDisplayObject
 Inheritedstage : Stage
[schreibgeschützt] Die Bühne des Anzeigeobjekts.
IFlexDisplayObject
 Inheritedtransform : flash.geom:Transform
Ein Objekt mit Eigenschaften, die zur Matrix, Farbtransformation und Pixelbegrenzung eines Anzeigeobjekts gehören.
IFlexDisplayObject
 Inheritedvisible : Boolean
Gibt an, ob das Anzeigeobjekt sichtbar ist oder nicht.
IFlexDisplayObject
 Inheritedwidth : Number
Gibt die Breite des Anzeigeobjekts in Pixeln an.
IFlexDisplayObject
 Inheritedx : Number
Gibt die x-Koordinate der DisplayObject-Instanz relativ zu den lokalen Koordinaten des übergeordneten DisplayObjectContainer-Objekts an.
IFlexDisplayObject
 Inheritedy : Number
Gibt die y-Koordinate der DisplayObject-Instanz relativ zu den lokalen Koordinaten des übergeordneten DisplayObjectContainer-Objekts an.
IFlexDisplayObject
Öffentliche Methoden
 MethodeDefiniert von
 Inherited
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
  
Wird vom umschließenden Diagramm aufgerufen und zeigt an, dass sich der aktuelle Status des Diagramms geändert hat.
IChartElement
  
claimStyles(styles:Array, firstAvailable:uint):uint
Aufgerufen durch das Diagramm, damit verknüpfte Elemente Stilselektoren von seinem chartSeriesStyles-Array anfordern können.
IChartElement
  
collectTransitions(chartState:Number, transitions:Array):void
Wird vom umgebenden Diagramm aufgerufen, um Übergänge zu erfassen, die ein bestimmtes Element möglicherweise bei Änderung des Status des Diagramms wiedergibt.
IChartElement
  
describeData(dimension:String, requiredFields:uint):Array
Wird durch das steuernde DataTransform aufgerufen, um eine Beschreibung der durch dieses IChartElement dargestellten Daten zu erhalten.
IChartElement
 Inherited
Sendet ein Ereignis in den Ereignisablauf.
IEventDispatcher
  
Gibt ein HitData-Objekt zurück, das den Datenpunkt beschreibt, der am nächsten bei den an die Methode übergebenen Koordinaten liegt.
IChartElement
 Inherited
getBounds(targetCoordinateSpace:DisplayObject):Rectangle
Gibt ein Rechteck zurück, das den Bereich des Anzeigeobjekts in Bezug auf das Koordinatensystem des targetCoordinateSpace-Objekts definiert.
IFlexDisplayObject
 Inherited
getRect(targetCoordinateSpace:DisplayObject):Rectangle
Gibt ein Rechteck zurück, das die Begrenzung des Anzeigeobjekts (ohne etwaige Striche oder Formen) definiert, und zwar aufgrund des vom Parameter „targetCoordinateSpace“ definierten Koordinatensystems.
IFlexDisplayObject
 Inherited
Konvertiert das point-Objekt von den (globalen) Bühnenkoordinaten in die (lokalen) Koordinaten des Anzeigeobjekts.
IFlexDisplayObject
 Inherited
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.
IEventDispatcher
 Inherited
Untersucht den Begrenzungsrahmen des Anzeigeobjekts, um festzustellen, ob er sich mit dem Begrenzungsrahmen des obj-Anzeigeobjekts überschneidet.
IFlexDisplayObject
 Inherited
hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean
Wertet das Anzeigeobjekt aus, um festzustellen, ob es den durch die Parameter „x“ und „y“ festgelegten Punkt überdeckt oder schneidet.
IFlexDisplayObject
 Inherited
Konvertiert das point-Objekt von den (lokalen) Koordinaten des Anzeigeobjekts in die (globalen) Bühnenkoordinaten.
IFlexDisplayObject
  
Erteilt einen Hinweis an das Element, dass sich die Datenzuordnung der verknüpften Achsen geändert hat.
IChartElement
 Inherited
Verschiebt dieses Objekt an die angegebenen x- und y-Koordinaten.
IFlexDisplayObject
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Entfernt einen Listener aus dem EventDispatcher-Objekt.
IEventDispatcher
 Inherited
setActualSize(newWidth:Number, newHeight:Number):void
Legt die tatsächliche Größe dieses Objekts fest.
IFlexDisplayObject
 Inherited
Ü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

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. Elementtypen können wahlweise den Datenprovider vom umschließenden Diagramm erben, falls erforderlich, oder die spezifische Zuweisung von Datenprovidern zum Element durch die Entwickler zulassen. Nicht alle Elemente werden notwendigerweise durch einen Datenprovider gesteuert.



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

dataTransform

Eigenschaft 
dataTransform:mx.charts.chartClasses:DataTransform  [Nur Schreiben]

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Das DataTransform-Objekt, das das Element für die Zuordnung zwischen Daten und Bildschirmkoordinaten verwendet. Diese Eigenschaft wird durch das umschließende Diagramm zugewiesen.



Implementierung
    public function set dataTransform(value:mx.charts.chartClasses:DataTransform):void

labelContainer

Eigenschaft 
labelContainer:Sprite  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Das DisplayObject, das die durch dieses Element gerenderten Beschriftungen anzeigt. In den meisten Fällen werden im Datenbereich angezeigte Beschriftungen über allen Elementen, und nicht zwischen den Daten angezeigt. Wenn ein implementierendes Element anzuzeigende Beschriftungen hat, kann es sie in einem Sprite-Objekt platzieren und als Wert der Eigenschaft labelContainer zurückgeben. Umschließende Diagramme rendern labelContainers von allen umschlossenen Elementen und platzieren Sie im Datenbereich über allen anderen Elementen.



Implementierung
    public function get labelContainer():Sprite
Methodendetails

chartStateChanged

()Methode
public function chartStateChanged(oldState:uint, v:uint):void

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Wird vom umschließenden Diagramm aufgerufen und zeigt an, dass sich der aktuelle Status des Diagramms geändert hat. Die Implementierungselemente müssen auf diese Methode reagieren, damit die Änderungen an den durch das Element angezeigten Daten synchronisiert werden können.

Parameter

oldState:uint — Eine Ganzzahl, die den vorherigen Status repräsentiert.
 
v:uint — Eine Ganzzahl, die den neuen Status repräsentiert.

claimStyles

()Methode 
public function claimStyles(styles:Array, firstAvailable:uint):uint

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Aufgerufen durch das Diagramm, damit verknüpfte Elemente Stilselektoren von seinem chartSeriesStyles-Array anfordern können. Jedes Diagramm verfügt über einen ihm zugeordneten Satz von Selektoren, die implizit enthaltenen Elementen zugewiesen sind, die sie benötigen. Die Implementierung dieser Funktion gibt einem Element die Möglichkeit, je nach Bedarf, Elemente aus diesem Satz 'anzufordern'. Ein Element das N Stilselektoren benötigt, fordert die Werte von styles[firstAvailable] bis styles[firstAvailable + N - 1] an.

Parameter

styles:Array — Ein Array von Stilen, die angefordert werden können.
 
firstAvailable:uint — Der erste Stilselektor im Array, der eine Anforderung stellt.

Rückgabewerte
uint — Der neue Wert für firstAvailable nach dem Anfordern von Stilen (beispielsweise firstAvailable + N).

collectTransitions

()Methode 
public function collectTransitions(chartState:Number, transitions:Array):void

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Wird vom umgebenden Diagramm aufgerufen, um Übergänge zu erfassen, die ein bestimmtes Element möglicherweise bei Änderung des Status des Diagramms wiedergibt. Das Diagramm erfasst Übergänge von allen Elementen und stellt sicher, dass sie parallel wiedergegeben werden. Es wartet, bis alle Übergänge abgeschlossen sind, bevor es zu einem anderen Status wechselt. Implementoren müssen alle notwendigen Übergänge an den Übergangs-Arrayparameter anhängen.

Parameter

chartState:Number — Der Status, in dem das Diagramm die neuen Übergänge wiedergibt.
 
transitions:Array — Ein Übergangs-Array, das der Liste der wiederzugebenden Übergänge des Diagramms hinzugefügt wird.

describeData

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

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Wird durch das steuernde DataTransform aufgerufen, um eine Beschreibung der durch dieses IChartElement dargestellten Daten zu erhalten. Implementoren füllen ein Array von mx.charts.chartClasses.DataDescription-Objekten aus und geben es zurück, um sicherzustellen, dass ihre Daten von Achsen, die Werte aus den angezeigten Daten (wie „minimum“, „maximum“, „interval“ und „unitSize“) automatisch generieren, korrekt abgerufen werden. Die meisten Elementtypen geben ein Array zurück, das nur eine DataDescription enthält. Kombinierte Elemente, wie BarSet und ColumnSet geben möglicherweise mehrere DataDescription-Instanzen zurück, die die von ihren Unterelementen angezeigten Daten beschreiben. Bei entsprechendem Aufruf beschreibt der Implementor die Daten entlang der durch das Argument dimension angegebenen Achse. Diese Funktion wird möglicherweise für jede von dem übergeordneten Diagramm unterstützte Achse aufgerufen.

Parameter

dimension:String — Bestimmt die Achse, von der Datenbeschreibungen abgerufen werden sollen.
 
requiredFields:uint — Ein Bitfeld, das anzeigt, welche Werte des DataDescription-Objekts von der spezifischen Achse berücksichtigt werden. Implementoren können optimiert werden, indem sie nur die erforderlichen Felder berechnen.

Rückgabewerte
Array — Ein Array, das die die angezeigten Daten beschreibenden DataDescription-Instanzen enthält.

Verwandte API-Elemente

findDataPoints

()Methode 
public function findDataPoints(x:Number, y:Number, sensitivity2:Number):Array

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Gibt ein HitData-Objekt zurück, das den Datenpunkt beschreibt, der am nächsten bei den an die Methode übergebenen Koordinaten liegt. Die Elemente x und y müssen Werte im Koordinatensystem des Elements sein. Diese Methode berücksichtigt bei der Suche nach nahe liegenden Datenpunkten die durch den Parameter sensitivity2 festgelegten Grenzen.

Parameter

x:Number — Die x-Koordinate bezogen auf das ChartBase-Objekt.
 
y:Number — Die y-Koordinate bezogen auf das ChartBase-Objekt.
 
sensitivity2:Number — Der maximale Abstand, den eine X/Y-Koordinatenposition vom Datenpunkt entfernt sein darf.

Rückgabewerte
Array — Ein den nächsten Datenpunkt innerhalb von sensitivity2 Pixel beschreibendes HitData-Objekt.

Verwandte API-Elemente

mappingChanged

()Methode 
public function mappingChanged():void

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Gibt einen Hinweis an das Element, dass sich die Datenzuordnung der verknüpften Achsen geändert hat. Implementoren müssen über zwischengespeicherte Daten verfügen und entsprechend erneut rendern. Diese Funktion wird, falls erforderlich, automatisch durch das verknüpfte DataTransform aufgerufen.





[ X ]Warum auf Englisch?
Inhalt des ActionScript 3.0-Referenzhandbuchs wird in englischer Sprache angezeigt

Nicht alle Teile des ActionScript 3.0-Referenzhandbuchs wurden in alle Sprachen übersetzt. Wenn der Text zu einem Sprachelement nicht übersetzt wurde, wird er auf Englisch angezeigt. Zum Beispiel wurden die Informationen zur ga.controls.HelpBox-Klasse nicht in andere Sprachen übersetzt. In der deutschen Version des Referenzhandbuchs erscheint der Abschnitt zur ga.controls.HelpBox-Klasse deshalb auf Englisch.