Actionscript 3 Entwicklerhandbuch

ACTIONSCRIPT 3.0 ENTWICKLERHANDBUCH
Verarbeiten von Ereignissen
Verwalten von Ereignis-Listenern
Flash Player 9 und höher, Adobe AIR 1.0 und höher
Sie können Listener-Funktionen mithilfe der Methoden der IEventDispatcher-Schnittstelle verwalten. Die
IEventDispatcher-Schnittstelle ist die ActionScript 3.0-Variante der EventTarget-Schnittstelle des DOM-
Ereignismodells. Obwohl der Name „IEventDispatcher“ darauf hinzuweisen scheint, dass der Hauptzweck dieser
Schnittstelle das Senden von Ereignisobjekten ist, werden die Methoden dieser Klasse in Wahrheit wesentlich häufiger
zum Registrieren, Überprüfen und Entfernen von Ereignis-Listenern eingesetzt. Die IEventDispatcher-Schnittstelle
definiert fünf Methoden, die im folgenden Codebeispiel dargestellt sind:
package flash.events
{
public interface IEventDispatcher
{
function addEventListener(eventName:String,
listener:Object,
useCapture:Boolean=false,
priority:Integer=0,
useWeakReference:Boolean=false):Boolean;
}
}
function removeEventListener(eventName:String,
listener:Object,
useCapture:Boolean=false):Boolean;
function dispatchEvent(eventObject:Event):Boolean;
function hasEventListener(eventName:String):Boolean;
function willTrigger(eventName:String):Boolean;
Die Flash Player-API implementiert die IEventDispatcher-Schnittstelle mithilfe der EventDispatcher-Klasse. Diese
dient als Basisklasse für alle Klassen, die ein Ereignisziel oder Teil des Ereignisablaufs sein können. Beispielsweise erbt
die DisplayObject-Klasse von der EventDispatcher-Klasse. Das bedeutet, dass alle Objekte in der Anzeigeliste Zugriff
auf die Methoden der IEventDispatcher-Schnittstelle haben.
Hinzufügen von Ereignis-Listenern
Die addEventListener()-Methode ist die wichtigste Methode der IEventDispatcher-Schnittstelle. Sie setzen sie ein,
um Listener-Funktionen zu registrieren. Die beiden erforderlichen Parameter sind type und listener. Verwenden
Sie den Parameter type, um den Ereignistyp anzugeben. Mit dem Parameter listener geben Sie die Listener-
Funktion an, die beim Auftreten eines Ereignisses ausgeführt wird. Der Parameter listener kann ein Verweis auf
eine Funktion oder eine Klassenmethode sein.
Verwenden Sie keine Klammer, wenn Sie den listener-Parameter spezifizieren. Beim folgenden Aufruf der
addEventListener()-Methode wird die clickHandler()-Funktion beispielsweise ohne Klammern angegeben:
addEventListener(MouseEvent.CLICK, clickHandler)
Mit dem Parameter useCapture der addEventListener()-Methode können Sie die Ereignisablaufphase festlegen,
in der der Listener aktiv ist. Wenn useCapture den Wert true hat, ist der Listener während der Empfangsphase des
Ereignisablaufs aktiv. Wenn useCapture den Wert false hat, ist der Listener während der Zielphase und der
Aufstiegsphase des Ereignisablaufs aktiv. Damit in allen Phasen des Ereignisablaufs auf das Ereignis gewartet wird,
müssen Sie addEventListener() zweimal aufrufen: einmal mit useCapture für den Werttrue und einmal
mituseCapture für den Wert false.
Letzte Aktualisierung 27.6.2012
148