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...
flash.events 

SyncEvent  - AS3

Paketflash.events
Klassepublic class SyncEvent
VererbungSyncEvent Inheritance Event Inheritance Object

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Ein SharedObject-Objekt, das ein remotes freigegebenes Objekt repräsentiert, löst ein SyncEvent-Objekt aus, wenn das remote freigegebene Objekt vom Server aktualisiert wird. Es gibt nur einen Typ eines sync-Ereignisses: SyncEvent.SYNC.

Verwandte API-Elemente



Öffentliche Eigenschaften
 EigenschaftDefiniert von
 Inheritedbubbles : Boolean
[schreibgeschützt] Gibt an, ob es sich bei dem Ereignis um ein Bubbling-Ereignis handelt.
Event
 Inheritedcancelable : Boolean
[schreibgeschützt] Gibt an, ob das mit dem Ereignis verknüpfte Verhalten verhindert werden kann.
Event
  changeList : Array
Ein Array mit Objekten; jedes Objekt enthält Eigenschaften, die die geänderten Mitglieder eines gemeinsamen Remote-Objekts beschreiben.
SyncEvent
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
 InheritedcurrentTarget : Object
[schreibgeschützt] Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
Event
 InheritedeventPhase : uint
[schreibgeschützt] Die aktuelle Phase im Ereignisablauf.
Event
 Inheritedtarget : Object
[schreibgeschützt] Das Ereignis-Ziel.
Event
 Inheritedtype : String
[schreibgeschützt] Der Ereignistyp.
Event
Öffentliche Methoden
 MethodeDefiniert von
  
SyncEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, changeList:Array = null)
Erstellt ein Ereignisobjekt, das Informationen über sync-Ereignisse enthält.
SyncEvent
  
[override] Erstellt eine Kopie des SyncEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.
SyncEvent
 Inherited
formatToString(className:String, ... arguments):String
Eine Dienstprogrammfunktion zur Implementierung der toString()-Methode in benutzerdefinierten ActionScript 3.0 Event-Klassen.
Event
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
Überprüft, ob die preventDefault()-Methode bei dem Ereignis aufgerufen wurde.
Event
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
 Inherited
Bricht das Standardverhalten eines Ereignisses ab, wenn dieses Verhalten abgebrochen werden kann.
Event
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
 Inherited
Verhindert die Verarbeitung von Ereignis-Listenern im aktuellen Knoten und in Knoten, die dem aktuellen Knoten im Ereignisablauf nachfolgen.
Event
 Inherited
Verhindert die Verarbeitung von Ereignis-Listenern in Knoten, die dem aktuellen Knoten im Ereignisablauf nachfolgen.
Event
 Inherited
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.
Object
  
[override] Gibt eine Zeichenfolge zurück, die alle Eigenschaften des SyncEvent-Objekts enthält.
SyncEvent
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
Öffentliche Konstanten
 KonstanteDefiniert von
  SYNC : String = "sync"
[statisch] Definiert den Wert der Eigenschaft type eines sync-Ereignisobjekts.
SyncEvent
Eigenschaftendetails

changeList

Eigenschaft
changeList:Array

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Ein Array mit Objekten; jedes Objekt enthält Eigenschaften, die die geänderten Mitglieder eines gemeinsamen Remote-Objekts beschreiben. Die Eigenschaften jedes Objekts sind code, name und oldValue.

Wenn Sie zum ersten Mal eine Verbindung zu einem gemeinsamen Remote-Objekt herstellen, das permanent lokal und/oder auf dem Server gespeichert ist, werden alle Eigenschaften für dieses Objekt auf leere Strings gesetzt.

Andernfalls setzt Flash code auf "clear", "success", "reject", "change" oder "delete".

  • Der Wert "clear" bedeutet entweder, dass Sie erfolgreich eine Verbindung zu einem gemeinsam genutzten Remote-Objekt hergestellt haben, das noch nicht permanent auf dem Server oder dem Client gespeichert ist, oder dass alle Eigenschaften des Objekts gelöscht wurden – zum Beispiel, wenn seit der letzten Synchronisation der Client- und Serverkopien des Objekts so viele Änderungen vorgenommen wurden, dass Flash Player das Client-Objekt mit dem Server-Objekt erneut synchronisiert. Im zweiten Fall wird SyncEvent.SYNC ausgelöst und der Wert für „code“ wird auf "change" gesetzt.
  • Bei "success" wurde das gemeinsam genutzte Objekt vom Client geändert.
  • Der Wert "reject" bedeutet, dass der Client erfolglos versucht hat, das Objekt zu ändern, und das Objekt stattdessen von einem anderen Client geändert wurde.
  • Bei "change" wurde das Objekt von einem anderen Client geändert oder vom Server erneut synchronisiert.
  • Der Wert "delete" bedeutet, dass das Attribut gelöscht wurde.

Die Eigenschaft name enthält den Namen der Eigenschaft, die geändert wurde.

Die Eigenschaft oldValue enthält den vorherigen Wert der geänderten Eigenschaft. Dieser Parameter lautet null, es sei denn, der Code weist den Wert "reject" oder "change" auf.



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

Verwandte API-Elemente

Konstruktordetails

SyncEvent

()Konstruktor
public function SyncEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, changeList:Array = null)

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Erstellt ein Ereignisobjekt, das Informationen über sync-Ereignisse enthält. Ereignisobjekte werden Ereignis-Listenern als Parameter übergeben.

Parameter
type:String — Der Ereignistyp. Ereignis-Listener können über die übernommene Eigenschaft type auf diese Informationen zugreifen. Es gibt nur einen Typ eines sync-Ereignisses: SyncEvent.SYNC.
 
bubbles:Boolean (default = false) — Bestimmt, ob das Ereignisobjekt an der Bubbling-Phase des Ereignisablaufs teilnimmt. Ereignis-Listener können über die übernommene Eigenschaft bubbles auf diese Informationen zugreifen.
 
cancelable:Boolean (default = false) — Bestimmt, ob das Ereignisobjekt abgebrochen werden kann. Ereignis-Listener können über die übernommene Eigenschaft cancelable auf diese Informationen zugreifen.
 
changeList:Array (default = null) — Ein Objekte-Array, das die Synchronisation mit dem freigegebenen Remote-Objekt (SharedObject) beschreibt. Ereignis-Listener können über die Eigenschaft changeList auf dieses Objekt zugreifen.

Verwandte API-Elemente

Methodendetails

clone

()Methode
override public function clone():Event

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Erstellt eine Kopie des SyncEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.

Rückgabewerte
Event — Ein neues SyncEvent-Objekt mit Eigenschaftswerten, die denen des Originals entsprechen.

toString

()Methode 
override public function toString():String

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Gibt eine Zeichenfolge zurück, die alle Eigenschaften des SyncEvent-Objekts enthält. Der String liegt im folgenden Format vor:

[SyncEvent type=Wert bubbles=Wert cancelable=Wert list=Wert]

Rückgabewerte
String — Eine Zeichenfolge, die alle Eigenschaften des SyncEvent-Objekts enthält.
Konstantendetails

SYNC

Konstante
public static const SYNC:String = "sync"

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Definiert den Wert der Eigenschaft type eines sync-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWert
bubblesfalse
cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.
currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
changeListEin Array mit Eigenschaften, die den Array-Status wiedergeben.
targetDie vom Server aktualisierte SharedObject-Instanz.

Verwandte API-Elemente





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