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.data 

DynamicManagedItem  - AS3 ADEP Data Services

Paketmx.data
Klassepublic dynamic class DynamicManagedItem
VererbungDynamicManagedItem Inheritance Proxy
Implementiert IManaged

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3.1
Laufzeitversionen: Flash Player 9, AIR 1.1

Eingegebenes verwaltetes Element, das dynamisch ist, sollte diese Klasse erweitern, sodass Ereignisse ausgeführt werden, wenn dynamische Eigenschaften geändert werden.



Öffentliche Methoden
 MethodeDefiniert von
  
Konstruktor.
DynamicManagedItem
  
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, weakRef:Boolean = false):void
Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird.
DynamicManagedItem
  
Sendet ein Ereignis in den Ereignisablauf.
DynamicManagedItem
  
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.
DynamicManagedItem
  
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Entfernt einen Listener aus dem EventDispatcher-Objekt.
DynamicManagedItem
  
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner übergeordneten Objekte ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist.
DynamicManagedItem
Geschützte Methoden
 MethodeDefiniert von
  
callProperty(name:*, ... parameters):*
[override] Überschreibt das Verhalten einer Objekteigenschaft, die als Funktion aufgerufen werden kann.
DynamicManagedItem
  
[override] Überschreibt die Anforderung zum Löschen einer Eigenschaft.
DynamicManagedItem
  
[override] Überschreibt alle Anforderungen des Werts einer Eigenschaft.
DynamicManagedItem
  
[override] Überschreibt eine Anforderung zur Überprüfung, ob ein Objekt über eine Eigenschaft mit einem bestimmten Namen verfügt.
DynamicManagedItem
  
[override] Ermöglicht die Aufzählung der Eigenschaften des über die Proxyklasse zugänglich gemachten Objekts nach Indexnummer, um die Namen der Eigenschaften abzurufen.
DynamicManagedItem
  
[override] Ermöglicht die Aufzählung der Eigenschaften des über die Proxyklasse zugänglich gemachten Objekts nach Indexnummer.
DynamicManagedItem
  
nextValue(index:int):*
[override] Ermöglicht die Aufzählung der Eigenschaften des über die Proxyklasse zugänglich gemachten Objekts nach Indexnummer, um die Werte der Eigenschaften abzurufen.
DynamicManagedItem
  
setProperty(name:*, value:*):void
[override] Überschreibt einen Aufruf zum Ändern des Werts einer Eigenschaft.
DynamicManagedItem
Konstruktordetails

DynamicManagedItem

()Konstruktor
public function DynamicManagedItem()

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3.1
Laufzeitversionen: Flash Player 9, AIR 1.1

Konstruktor.

Methodendetails

addEventListener

()Methode
public function addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, weakRef:Boolean = false):void

Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird. Sie können Ereignis-Listener bei allen Knoten in der Anzeigeliste für eine bestimmte Art von Ereignis, Phase oder Priorität registrieren.

Nachdem Sie einen Ereignis-Listener erfolgreich registriert haben, können Sie seine Priorität nicht durch weitere Aufrufe von addEventListener() ändern. Um die Priorität eines Listeners zu ändern, müssen Sie zunächst removeEventListener() aufrufen. Anschließend können Sie den Listener mit der neuen Prioritätsstufe erneut aufrufen.

Nach der Registrierung des Listeners haben nachfolgende Aufrufe von addEventListener() mit einem anderen type- oder useCapture-Wert eine separate Listener-Registrierung zur Folge. Wenn Sie beispielsweise zuerst einen Listener registrieren, für den useCapture auf true gesetzt ist, wird dieser nur während der Erfassungsphase aktiv sein. Wenn Sie addEventListener() für dasselbe Listener-Objekt erneut aufrufen, diesmal aber useCapture auf false gesetzt ist, werden zwei separate Listener angelegt: einer, der während der Erfassungsphase aktiv ist und ein zweiter, der während der Ziel- und Bubbling-Phase aktiv ist.

Sie können einen Ereignis-Listener nicht nur für die Ziel- oder Bubbling-Phase registrieren. Die beiden Phasen hängen während der Registrierung immer zusammen, da Bubbling nur für übergeordnete Elemente des Zielknotens gilt.

Wenn Sie einen Ereignis-Listener nicht mehr benötigen, entfernen sie ihn, indem Sie EventDispatcher.removeEventListener() aufrufen, andernfalls könnte es zu Speicherproblemen kommen. Objekte mit registrierten Ereignis-Listenern werden nicht automatisch aus dem Speicher entfernt, da der Garbagekollektor (Speichermanagement) keine Objekte entfernt, die noch Verweise enthalten.

Beim Kopieren einer EventDispatcher-Instanz werden zugewiesene Ereignis-Listener nicht kopiert. (Wenn ein neu angelegter Knoten einen Ereignis-Listener benötigt, müssen Sie den Listener nach dem Erstellen des Knotens zuweisen.) Wenn Sie jedoch eine EventDispatcher-Instanz verschieben, werden zugewiesene Ereignis-Listener ebenfalls verschoben.

Wenn der Ereignis-Listener bei einem Knoten registriert ist und dieser Knoten ein Ereignis durchgeführt, so wird der Ereignis-Listener nicht während der aktuellen Phase ausgelöst, kann aber in einer späteren Phase im Ereignisablauf gesendet werden, etwa in der Bubbling-Phase.

Wird ein Ereignis-Listener von einem Knoten entfernt, während mit dem Knoten ein Ereignis durchgeführt wird, so wird er von den aktuellen Aktionen immer noch ausgelöst. Nachdem er entfernt worden ist, wird der Ereignis-Listener nicht wieder aufgerufen (es sei denn er wird für spätere Verarbeitungsvorgänge erneut aufgerufen).

Parameter

type:String — Der Ereignistyp.
 
listener:Function — Die Listener-Funktion, die das Ereignis verarbeitet. Diese Funktion muss, wie das nachfolgende Beispiel zeigt, ein Ereignisobjekt als einzigen Parameter akzeptieren und keinen Wert zurückgeben:

function(evt:Event):void

Der Name der Funktion ist beliebig.
 
useCapture:Boolean (default = false) — Bestimmt, ob der Listener in der Erfassungsphase oder in der Ziel- und Bubbling-Phase arbeitet. Ist useCapture auf true gesetzt, so verarbeitet der Listener das Ereignis nur während der Erfassungsphase und nicht während der Ziel- oder Bubbling-Phase. Hat useCapture hingegen den Wert false, verarbeitet der Listener das Ereignis nur während der Ziel- oder Bubbling-Phase. Damit das Ereignis in allen drei Phasen aktiv ist, rufen Sie addEventListener() zweimal auf; einmal ist useCapture auf true gesetzt, und beim zweiten Mal hat useCapture den Wert false.
 
priority:int (default = 0) — Die Prioritätsstufe des Ereignis-Listeners. Prioritäten werden über eine 32-Bit-Ganzzahl zugewiesen. Je höher die Zahl, desto höher die Priorität. Alle Listener mit der Priorität n werden vor Listenern mit der Priorität n-1 verarbeitet. Wenn zwei oder mehr Listener die gleiche Priorität aufweisen, werden sie in der Reihenfolge verarbeitet, in der sie hinzugefügt wurden. Die Standardpriorität ist 0.
 
weakRef:Boolean (default = false) — Bestimmt, ob der Verweis auf den Listener stark oder schwach ist. Ein starker Verweis (der Standard) verhindert, dass der Listener von einem Garbage Collector entfernt wird. Ein schwacher Verweis hingegen nicht.

Funktionen von Mitgliedern auf Klassenebene werden nicht vom Garbagekollektor entfernt. Daher können Sie useWeakReference für Mitgliedsfunktionen auf Klassenebene auf true setzen, ohne dass sie vom Garbagekollektor entfernt werden. Wenn Sie useWeakReference für einen Listener, der eine verschachtelte innere Funktion ist, auf true setzen, wird Garbage Collection auf diese Funktion angewendet, die damit nicht mehr permanent gespeichert wird. Indem Sie Verweise auf die innere Funktion erstellen (d. h sie in einer anderen Variable speichern), umgehen Sie die Garbage Collection, sodass die Funktion permanent gespeichert bleibt.

callProperty

()Methode 
override flash_proxy function callProperty(name:*, ... parameters):*

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3.1
Laufzeitversionen: Flash Player 9, AIR 1.1

Überschreibt das Verhalten einer Objekteigenschaft, die als Funktion aufgerufen werden kann. Beim Aufrufen einer Methode des Objekts wird diese Methode aufgerufen. Einige Objekte können als Funktion aufgerufen werden und ebenso einige Objekteigenschaften.

Parameter

name:* — Der Name der aufgerufenen Methode.
 
... parameters — Ein Array mit den Argumenten für die aufgerufene Methode.

Rückgabewerte
* — Der Rückgabewert der aufgerufenen Methode.

deleteProperty

()Methode 
override flash_proxy function deleteProperty(name:*):Boolean

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3.1
Laufzeitversionen: Flash Player 9, AIR 1.1

Überschreibt die Anforderung zum Löschen einer Eigenschaft. Beim Löschen einer Eigenschaft mit dem delete-Operator wird zum Ausführen des Löschvorgangs diese Methode aufgerufen.

Parameter

name:* — Der Name der zu löschenden Eigenschaft.

Rückgabewerte
Boolean — „true“, wenn die Eigenschaft gelöscht wurde; andernfalls „false“.

dispatchEvent

()Methode 
public function dispatchEvent(event:Event):Boolean

Sendet ein Ereignis in den Ereignisablauf. Das Ereignisziel ist das EventDispatcher-Objekt, für das die Methode dispatchEvent() aufgerufen wird.

Parameter

event:Event — Das Ereignisobjekt, das in den Ereignisablauf gesendet wird.

Rückgabewerte
Boolean — Der Wert true (sofern nicht preventDefault()) wird bei dem Ereignis aufgerufen. In diesem Fall wird false zurückgegeben.

getProperty

()Methode 
override flash_proxy function getProperty(name:*):*

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3.1
Laufzeitversionen: Flash Player 9, AIR 1.1

Überschreibt alle Anforderungen des Werts einer Eigenschaft. Wenn die Eigenschaft nicht vorhanden ist, gibt die Methode „undefined“ zurück. Weitere Informationen zu diesem Verhalten finden Sie in der ECMA-262 Language Specification, 3rd Edition, Abschnitt 8.6.2.1.

Parameter

name:* — Der Name der abzurufenden Eigenschaft.

Rückgabewerte
* — Die angegebene Eigenschaft oder „undefined“, wenn die Eigenschaft nicht vorhanden ist.

hasEventListener

()Methode 
public function hasEventListener(type:String):Boolean

Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat. Dadurch können Sie bestimmen, wo ein EventDispatcher-Objekt die Verarbeitung eines Ereignistyps in der Ereignisablaufhierarchie geändert hat. Um festzustellen, ob ein bestimmter Ereignistyp einen Ereignis-Listener auslöst, verwenden Sie IEventDispatcher.willTrigger().

Der Unterschied zwischen hasEventListener() und willTrigger() besteht darin, dass hasEventListener() nur das Objekt untersucht, zu dem es gehört, während willTrigger() den gesamten Ereignisablauf auf das im Parameter type angegebene Ereignis untersucht.

Parameter

type:String — Der Ereignistyp.

Rückgabewerte
Boolean — Der Wert true, wenn ein Listener des angegebenen Typs registriert ist; andernfalls false.

hasProperty

()Methode 
override flash_proxy function hasProperty(name:*):Boolean

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3.1
Laufzeitversionen: Flash Player 9, AIR 1.1

Überschreibt eine Anforderung zur Überprüfung, ob ein Objekt über eine Eigenschaft mit einem bestimmten Namen verfügt.

Parameter

name:* — Der Name der zu überprüfenden Eigenschaft.

Rückgabewerte
Boolean — „true“, wenn die Eigenschaft vorhanden ist; andernfalls „false“.

nextName

()Methode 
override flash_proxy function nextName(index:int):String

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3.1
Laufzeitversionen: Flash Player 9, AIR 1.1

Ermöglicht die Aufzählung der Eigenschaften des über die Proxyklasse zugänglich gemachten Objekts nach Indexnummer, um die Namen der Eigenschaften abzurufen. Es kann jedoch keine Aufzählung der Eigenschaften der Proxyklasse selbst erstellt werden. Diese Funktion unterstützt die Implementierung von „for...in“ und „for each..“in-Schleifen für das Objekt mit dem Ziel des Abrufens der gewünschten Namen.

Parameter

index:int — Der auf null basierende Wert der Indexposition der Objekteigenschaft.

Rückgabewerte
String — Der Name der Eigenschaft.

nextNameIndex

()Methode 
override flash_proxy function nextNameIndex(index:int):int

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3.1
Laufzeitversionen: Flash Player 9, AIR 1.1

Ermöglicht die Aufzählung der Eigenschaften des über die Proxyklasse zugänglich gemachten Objekts nach Indexnummer. Es kann jedoch keine Aufzählung der Eigenschaften der Proxyklasse selbst erstellt werden. Diese Funktion unterstützt die Implementierung von „for...in“ und „for each..“in-Schleifen für das Objekt mit dem Ziel des Abrufens von Eigenschaftsindexwerten.

Parameter

index:int — Der auf null basierende Indexwert, ab dem die Aufzählung erfolgen soll.

Rückgabewerte
int — Der Indexwert der Eigenschaft.

nextValue

()Methode 
override flash_proxy function nextValue(index:int):*

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3.1
Laufzeitversionen: Flash Player 9, AIR 1.1

Ermöglicht die Aufzählung der Eigenschaften des über die Proxyklasse zugänglich gemachten Objekts nach Indexnummer, um die Werte der Eigenschaften abzurufen. Es kann jedoch keine Aufzählung der Eigenschaften der Proxyklasse selbst erstellt werden. Diese Funktion unterstützt die Implementierung von „for...in“ und „for each..“in-Schleifen für das Objekt mit dem Ziel des Abrufens der gewünschten Werte.

Parameter

index:int — Der auf null basierende Wert der Indexposition der Objekteigenschaft.

Rückgabewerte
* — Der Wert der Eigenschaft.

removeEventListener

()Methode 
public function removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void

Entfernt einen Listener aus dem EventDispatcher-Objekt. Wenn kein entsprechender Listener mit dem EventDispatcher-Objekt registriert ist, hat ein Aufruf dieser Methode keine Auswirkungen.

Parameter

type:String — Der Ereignistyp.
 
listener:Function — Das zu entfernende Listener-Objekt.
 
useCapture:Boolean (default = false) — Gibt an, ob der Listener für die Erfassungsphase oder die Ziel- und Bubbling-Phase registriert wurde. Wenn der Listener sowohl für die Erfassungs- als auch für die Bubbling-Phase registriert wurde, sind auch zwei Aufrufe von removeEventListener() erforderlich, um beide zu entfernen: ein Aufruf, bei dem useCapture auf true gesetzt ist, und einer, bei dem useCapture auf false gesetzt ist.

setProperty

()Methode 
override flash_proxy function setProperty(name:*, value:*):void

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3.1
Laufzeitversionen: Flash Player 9, AIR 1.1

Überschreibt einen Aufruf zum Ändern des Werts einer Eigenschaft. Wenn die Eigenschaft noch nicht vorhanden ist, erstellt diese Methode eine Eigenschaft mit dem angegebenen Namen und Wert.

Parameter

name:* — Der Name der zu ändernden Eigenschaft.
 
value:* — Der Wert, der für die Eigenschaft festgelegt werden soll.

willTrigger

()Methode 
public function 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. Diese Methode liefert den Wert true, wenn während irgendeiner Phase des Ereignisablaufs ein Ereignis-Listener aufgerufen wird, wenn ein Ereignis des angegebenen Typs für dieses EventDispatcher-Objekt oder eines seiner nachfolgenden Elemente ausgelöst wird.

Der Unterschied zwischen hasEventListener() und willTrigger() besteht darin, dass hasEventListener() nur das Objekt untersucht, zu dem es gehört, während willTrigger() den gesamten Ereignisablauf auf das im Parameter type angegebene Ereignis untersucht.

Parameter

type:String — Der Ereignistyp.

Rückgabewerte
Boolean — Der Wert true, wenn ein Listener des angegebenen Typs ausgelöst wird; andernfalls false.




[ 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.