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

ObjectProxy  - AS3 Flex
Paketmx.utils
Klassepublic dynamic class ObjectProxy
VererbungObjectProxy Inheritance Proxy
Implementiert IExternalizable, IPropertyChangeNotifier
Unterklassen DataItem, ManagedObjectProxy

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

Diese Klasse bietet die Möglichkeit zum Verfolgen von Änderungen an einem Element, das von diesem Proxy verwaltet wird. Eine beliebige Anzahl von Objekten kann auf Änderungen an diesem Objekt „warten“, indem die addEventListener()-Methode verwendet wird.


Öffentliche Eigenschaften
 EigenschaftDefiniert von
  uid : String
Der eindeutige Bezeichner für dieses Objekt.
ObjectProxy
Geschützte Eigenschaften
 EigenschaftDefiniert von
  dispatcher : EventDispatcher
Ein Verweis auf den EventDispatcher für diesen Proxy.
ObjectProxy
  notifiers : Object
Eine Hashzuordnung der Eigenschaftsänderungs-Benachrichtigung, auf die dieser Proxy wartet. Der Schlüssel der Zuordnung ist der Eigenschaftsname.
ObjectProxy
  object : Object
[schreibgeschützt] Das Objekt, für das ein Proxy erstellt wird.
ObjectProxy
  propertyList : Array
Enthält eine Liste aller Eigenschaftsnamen des über die Proxy-Klasse zugänglich gemachten Objekts.
ObjectProxy
  proxyClass : Class
Gibt bei der Proxyerstellung für komplexe Eigenschaften die zu erstellende Proxyart an.
ObjectProxy
  type : QName
Der qualifizierte Typname, der mit diesem Objekt verknüpft ist.
ObjectProxy
Öffentliche Methoden
 MethodeDefiniert von
  
ObjectProxy(item:Object = null, uid:String = null, proxyDepth:int = -1)
Initialisiert diesen Proxy mit dem angegebenen Objekt, der ID und der Proxytiefe.
ObjectProxy
  
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registriert ein Ereignis-Listener-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird.
ObjectProxy
  
dispatchEvent(event:Event):Boolean
Sendet ein Ereignis in den Ereignisablauf.
ObjectProxy
  
hasEventListener(type:String):Boolean
Überprüft, ob Ereignis-Listener für einen bestimmten Ereignistyp registriert sind.
ObjectProxy
  
propertyChangeHandler(event:PropertyChangeEvent):void
Wird aufgerufen, wenn eine komplexe Eigenschaft aktualisiert wird.
ObjectProxy
  
readExternal(input:IDataInput):void
Da Flex nur ObjectProxy zum Einschließen anonymer Objekte verwendet, serialisiert sich die flex.messaging.io.ObjectProxy-Serverinstanz selbst als Zuordnung, die als einfaches ActionScript-Objekt zurückgegeben wird.
ObjectProxy
  
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Entfernt einen Ereignis-Listener.
ObjectProxy
  
willTrigger(type:String):Boolean
Überprüft, ob ein Ereignislistener bei diesem Objekt oder einem Vorgänger für diesen Ereignistyp registriert ist.
ObjectProxy
  
writeExternal(output:IDataOutput):void
Da Flex nur das innere eingeschlossene ActionScript-Objekt serialisiert, füllt sich das flex.messaging.io.ObjectProxy-Serverobjekt mit dem Inhalt des anonymen Objekts und wird dem Benutzer als Zuordnung angezeigt.
ObjectProxy
Geschützte Methoden
 MethodeDefiniert von
  
callProperty(name:*, ... rest):*
[override] Gibt den Namen der Methode des über die Proxy-Klasse zugänglich gemachten Objekts zurück.
ObjectProxy
  
deleteProperty(name:*):Boolean
[override] Löscht die angegebene Eigenschaft des über die Proxy-Klasse zugänglich gemachten Objekts und benachrichtigt die Prozedur von der Löschung.
ObjectProxy
  
getComplexProperty(name:*, value:*):*
Bietet Unterklassen einen Bereich, um die Verwaltung einer komplexen Eigenschaft zu überschreiben, die entweder über die Proxy-Klasse zugänglich gemacht oder für Ereignis-Bubbling verkettet werden muss.
ObjectProxy
  
getProperty(name:*):*
[override] Gibt den angegebenen Eigenschaftswert des über die Proxy-Klasse zugänglich gemachten Objekts zurück.
ObjectProxy
  
setProperty(name:*, value:*):void
[override] Aktualisiert die angegebene Eigenschaft des über die Proxy-Klasse zugänglich gemachten Objekts und benachrichtigt die Prozedur von der Aktualisierung.
ObjectProxy
  
setupPropertyList():void
Diese Methode erstellt ein Array aller Eigenschaftsnamen des über die Proxy-Klasse zugänglich gemachten Objekts.
ObjectProxy
Eigenschaftendetails

dispatcher

Eigenschaft
protected var dispatcher:EventDispatcher

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

Ein Verweis auf den EventDispatcher für diesen Proxy.

notifiers

Eigenschaft 
protected var notifiers:Object

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

Eine Hashzuordnung der Eigenschaftsänderungs-Benachrichtigung, auf die dieser Proxy wartet. Der Schlüssel der Zuordnung ist der Eigenschaftsname.

object

Eigenschaft 
object:Object  [schreibgeschützt]

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

Das Objekt, für das ein Proxy erstellt wird.



Implementierung
    object_proxy function get object():Object

propertyList

Eigenschaft 
protected var propertyList:Array

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

Enthält eine Liste aller Eigenschaftsnamen des über die Proxy-Klasse zugänglich gemachten Objekts. Untergeordnete Elemente müssen diese Liste durch Überschreiben der setupPropertyList()-Methode ausfüllen.

proxyClass

Eigenschaft 
protected var proxyClass:Class

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

Gibt bei der Proxyerstellung für komplexe Eigenschaften die zu erstellende Proxyart an. Unterklassen sollten diesen Wert entsprechend zuweisen.

type

Eigenschaft 
type:QName

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

Der qualifizierte Typname, der mit diesem Objekt verknüpft ist.



Implementierung
    object_proxy function get type():QName
    object_proxy function set type(value:QName):void

uid

Eigenschaft 
uid:String

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

Der eindeutige Bezeichner für dieses Objekt.



Implementierung
    public function get uid():String
    public function set uid(value:String):void
Konstruktordetails

ObjectProxy

()Konstruktor
public function ObjectProxy(item:Object = null, uid:String = null, proxyDepth:int = -1)

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

Initialisiert diesen Proxy mit dem angegebenen Objekt, der ID und der Proxytiefe.

Parameter
item:Object (default = null) — Objekt, das als Proxy ausgeführt werden soll. Wenn kein Element festgelegt ist, wird ein anonymes Objekt erstellt und zugewiesen.
 
uid:String (default = null) — String, der die eindeutige ID für die Objekt-Instanz enthält. Erforderlich für die IPropertyChangeNotifier-Kompatibilität, da für jedes Objekt eine Möglichkeit zur eindeutigen Identifizierung vorhanden sein muss. Ist kein Wert festgelegt, wird eine Zufalls-ID zugewiesen.
 
proxyDepth:int (default = -1) — Eine Ganzzahl, die die Anzahl der Stufen in einem komplexen Objektdiagramm angibt, für die beim Zugriff auf Eigenschaften ein Proxy erstellt werden soll. Der Standardwert ist -1, d. h. „Proxyerstellung für eine unendliche Tiefe“.

Beispiel
Verwendung dieses Beispiels 
      import mx.events.PropertyChangeEvent;
      import mx.utils.ObjectUtil;
      import mx.utils.ObjectProxy;
      import mx.utils.StringUtil;
     
      var a:Object = { name: "Tyler", age: 5, ssnum: "555-55-5555" };
      var p:ObjectProxy = new ObjectProxy(a);
      p.addEventListener(PropertyChangeEvent.PROPERTY_CHANGE, updateHandler);
      p.name = "Jacey";
      p.age = 2;
      delete p.ssnum;
     
      // handler function
      function updateHandler(event:PropertyChangeEvent):void
      {
          trace(StringUtil.substitute("updateHandler('{0}', {1}, {2}, {3}, '{4}')",
                                         event.kind,
                                         event.property,
                                         event.oldValue,
                                         event.newValue,
                                         event.target.uid));
      }
     
      // trace output
      updateHandler('opUpdate', name, Jacey, '698AF8CB-B3D9-21A3-1AFFDGHT89075CD2')
      updateHandler('opUpdate', age, 2, '698AF8CB-B3D9-21A3-1AFFDGHT89075CD2')
      updateHandler('opDelete', ssnum, null, '698AF8CB-B3D9-21A3-1AFFDGHT89075CD2')
Methodendetails

addEventListener

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

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

Registriert ein Ereignis-Listener-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird. Weitere Informationen einschließlich Parameterbeschreibungen finden Sie unter addEventListener() in der flash.events.EventDispatcher-Klasse.

Parameter

type:String — Der Typ des Ereignisses.
 
listener:Function — Die Listener-Funktion, die das Ereignis verarbeitet. Diese Funktion muss ein Ereignisobjekt als einzigen Parameter akzeptieren und darf keinen Wert zurückgeben.
 
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.
 
useWeakReference: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.

Verwandte API-Elemente

flash.events.EventDispatcher.addEventListener()

callProperty

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

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

Gibt den Namen der Methode des über die Proxy-Klasse zugänglich gemachten Objekts zurück.

Parameter

name:* — Der Name der aufgerufenen Methode.
 
... rest — 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: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Löscht die angegebene Eigenschaft des über die Proxy-Klasse zugänglich gemachten Objekts und benachrichtigt die Prozedur von der Löschung.

Parameter

name:* — Normalerweise ein String, der den Eigenschaftsnamen enthält oder möglicherweise einen QName, wobei der Eigenschaftsname durch Überprüfen der localName-Eigenschaft gefunden wird.

Rückgabewerte
Boolean — Ein boolescher Wert, der angibt, ob eine Eigenschaft gelöscht wurde.

dispatchEvent

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

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

Sendet ein Ereignis in den Ereignisablauf. Weitere Informationen finden Sie im Abschnitt zur flash.events.EventDispatcher-Klasse.

Parameter

event:Event — Das Ereignisobjekt, das in den Ereignisablauf integriert wird. Wenn das Ereignis erneut gesendet wird, wird automatisch ein Klon des Ereignisses erstellt. Nachdem ein Ereignis ausgelöst wurde, lässt sich seine target-Eigenschaft nicht mehr ändern, daher funktioniert ein erneutes Senden des Ereignisses nur, wenn Sie eine neue Kopie des Ereignisses erstellen.

Rückgabewerte
Boolean — Gibt true zurück, wenn das Ereignis erfolgreich versandt wurde. Der Wert false weist entweder auf einen Fehler hin oder auf die Tatsache, dass preventDefault() für das Ereignis aufgerufen worden ist.

Verwandte API-Elemente

flash.events.EventDispatcher.dispatchEvent()

getComplexProperty

()Methode 
object_proxy function getComplexProperty(name:*, value:*):*

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

Bietet Unterklassen einen Bereich, um die Verwaltung einer komplexen Eigenschaft zu überschreiben, die entweder über die Proxy-Klasse zugänglich gemacht oder für Ereignis-Bubbling verkettet werden muss.

Parameter

name:* — Normalerweise ein String, der den Eigenschaftsnamen enthält oder möglicherweise einen QName, wobei der Eigenschaftsname durch Überprüfen der localName-Eigenschaft gefunden wird.
 
value:* — Der Wert der Eigenschaft.

Rückgabewerte
* — Der Eigenschaftswert oder eine Instanz von ObjectProxy.

getProperty

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

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

Gibt den angegebenen Eigenschaftswert des über die Proxy-Klasse zugänglich gemachten Objekts zurück.

Parameter

name:* — Normalerweise ein String, der den Eigenschaftsnamen enthält oder möglicherweise einen QName, wobei der Eigenschaftsname durch Überprüfen der localName-Eigenschaft gefunden wird.

Rückgabewerte
* — Der Wert der Eigenschaft. In einigen Fällen kann dieser Wert eine Instanz von ObjectProxy sein.

hasEventListener

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

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

Überprüft, ob Ereignis-Listener für einen bestimmten Ereignistyp registriert sind. Dadurch können Sie bestimmen, wo ein Objekt die Verarbeitung eines Ereignistyps in der Ereignisablaufhierarchie geändert hat. Weitere Informationen finden Sie im Abschnitt zur flash.events.EventDispatcher-Klasse.

Parameter

type:String — Der Typ des Ereignisses

Rückgabewerte
Boolean — Gibt true zurück, wenn ein Listener des angegebenen Typs registriert ist, andernfalls false.

Verwandte API-Elemente

flash.events.EventDispatcher.hasEventListener().

propertyChangeHandler

()Methode 
public function propertyChangeHandler(event:PropertyChangeEvent):void

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

Wird aufgerufen, wenn eine komplexe Eigenschaft aktualisiert wird.

Parameter

event:PropertyChangeEvent — Ein Ereignisobjekt, das geändert wurde.

readExternal

()Methode 
public function readExternal(input:IDataInput):void

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

Da Flex nur ObjectProxy zum Einschließen anonymer Objekte verwendet, serialisiert sich die flex.messaging.io.ObjectProxy-Serverinstanz selbst als Zuordnung, die als einfaches ActionScript-Objekt zurückgegeben wird. Sie können dann die object_proxy-Objekteigenschaft auf diesen Wert setzen.

Parameter

input:IDataInput — Das Quellobjekt, von dem der ObjectProxy deserialisiert wird.

removeEventListener

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

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

Entfernt einen Ereignis-Listener. Wenn kein entsprechender Listener beim EventDispatcher-Objekt registriert ist, hat ein Aufruf dieser Methode keine Auswirkungen. Weitere Informationen finden Sie im Abschnitt zur flash.events.EventDispatcher-Klasse.

Parameter

type:String — Der Typ des Ereignisses.
 
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.

Verwandte API-Elemente

flash.events.EventDispatcher.removeEventListener().

setProperty

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

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

Aktualisiert die angegebene Eigenschaft des über die Proxy-Klasse zugänglich gemachten Objekts und benachrichtigt die Prozedur von der Aktualisierung.

Parameter

name:* — Objekt, das den Namen der Eigenschaft enthält, die für das über die Proxy-Klasse zugänglich gemachte Objekt aktualisiert werden sollte.
 
value:* — Der für das über die Proxy-Klasse zugänglich gemachte Objekt festzulegende Wert.

setupPropertyList

()Methode 
protected function setupPropertyList():void

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

Diese Methode erstellt ein Array aller Eigenschaftsnamen des über die Proxy-Klasse zugänglich gemachten Objekts. Untergeordnete Elemente müssen diese Methode überschreiben, um der Liste weitere Eigenschaften hinzuzufügen. Stellen Sie sicher, dass super.setupPropertyList aufgerufen wird, bevor Sie die propertyList-Eigenschaft ändern.

willTrigger

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

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

Überprüft, ob ein Ereignislistener bei diesem Objekt oder einem Vorgänger für diesen Ereignistyp registriert ist. Diese Methode gibt den Wert true zurück, sofern während irgendeiner Phase des Ereignisablaufs ein Ereignis-Listener aufgerufen wird, wenn ein Ereignis des angegebenen Typs für das Objekt oder eines seiner untergeordneten Elemente ausgelöst wird. Weitere Informationen finden Sie im Abschnitt zur flash.events.EventDispatcher-Klasse.

Parameter

type:String — Der Typ des Ereignisses.

Rückgabewerte
Boolean — Gibt true zurück, wenn ein Listener des angegebenen Typs ausgelöst wird, andernfalls false.

Verwandte API-Elemente

flash.events.EventDispatcher.willTrigger().

writeExternal

()Methode 
public function writeExternal(output:IDataOutput):void

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

Da Flex nur das innere eingeschlossene ActionScript-Objekt serialisiert, füllt sich das flex.messaging.io.ObjectProxy-Serverobjekt mit dem Inhalt des anonymen Objekts und wird dem Benutzer als Zuordnung angezeigt.

Parameter

output:IDataOutput — Das Quellobjekt, von dem der ObjectProxy deserialisiert wird.




© 2015 Adobe Systems Incorporated. All rights reserved.
Tue Jun 12 2018, 10:04 AM Z
 

 

Rechtliche Hinweise | Onlinedatenschutzerklärung
[ 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.