Actionscript 3 Entwicklerhandbuch

ACTIONSCRIPT 3.0 ENTWICKLERHANDBUCH
Verarbeiten von Ereignissen
Der Parameter priority der addEventListener()-Methode ist kein offizieller Bestandteil des DOM3-
Ereignismodells. Er wurde in ActionScript 3.0 aufgenommen, um eine höhere Flexibilität beim Organisieren von
Ereignis-Listenern zu ermöglichen. Beim Aufrufen von addEventListener() können Sie die Priorität des jeweiligen
Ereignis-Listeners festlegen, indem Sie als priority-Parameter einen Ganzzahlwert übergeben. Der Standardwert ist
0. Sie können jedoch sowohl negative als auch positive Werte angeben. Je größer die Zahl ist, desto eher wird der
entsprechende Ereignis-Listener abgearbeitet. Ereignis-Listener mit derselben Priorität werden in der Reihenfolge des
Hinzufügens abgearbeitet. Je eher ein Listener hinzugefügt wurde, desto eher wird er auch abgearbeitet.
Mit dem Parameter useWeakReference können Sie festlegen, ob es sich um einen schwachen oder normalen Verweis
auf die Listener-Funktion handelt. Durch Festlegen von true für diesen Parameter können Sie Situationen vermeiden,
in denen Listener-Funktionen im Speicher zurückbleiben, auch wenn sie nicht mehr benötigt werden. In Flash Player
und AIR wird ein Verfahren mit der Bezeichnung Garbage Collection (automatische Speicherbereinigung) verwendet,
um nicht mehr verwendete Objekte aus dem Speicher zu entfernen. Objekte gelten als nicht mehr verwendet, wenn
keine Verweise auf sie vorhanden sind. Bei der Speicherbereinigung werden schwache Verweise nicht berücksichtigt.
Das bedeutet, dass Listener-Funktionen mit ausschließlich schwachen Verweisen bei der Speicherbereinigung entfernt
werden.
Entfernen von Ereignisprozeduren
Mit der removeEventListener()-Methode können Sie einen Ereignis-Listener entfernen, den Sie nicht mehr
benötigen. Es empfiehlt sich, alle nicht mehr benötigten Listener zu entfernen. Erforderliche Parameter sind
eventName und listener, die identisch sind mit den erforderlichen Parametern für die addEventListener()-
Methode. Rufen Sie sich in Erinnerung, dass in allen Phasen des Ereignisablaufs auf das Ereignis gewartet werden
kann, wenn Sie addEventListener() zweimal aufrufen: einmal mit dem Wert true für useCapture und einmal mit
dem Wert false. Damit beide Ereignis-Listener wieder entfernt werden, müssen Sie removeEventListener()
ebenfalls zweimal aufrufen: einmal mit dem Wert true für useCapture und einmal mit dem Wert false.
Auslösen von Ereignissen
Erfahrene Programmierer können die dispatchEvent()-Methode einsetzen, um ein benutzerdefiniertes
Ereignisobjekt in den Ereignisablauf einzufügen. Der einzige für diese Methode zulässige Parameter ist ein Verweis
auf ein Ereignisobjekt, das eine Instanz der Event-Klasse oder einer ihrer Unterklassen sein muss. Nach dem Auslösen
des Ereignisses ist als target-Eigenschaft des Ereignisobjekts das Objekt eingetragen, für das dispatchEvent()
aufgerufen wurde.
Überprüfen auf vorhandene Ereignis-Listener
Die letzten beiden Methoden der IEventDispatcher-Schnittstelle stellen nützliche Informationen über das
Vorhandensein von Ereignis-Listenern bereit. Die hasEventListener()-Methode gibt true zurück, wenn für einen
bestimmten Ereignistyp und das angegebene Anzeigelistenobjekt ein Ereignis-Listener gefunden wurde. Die
willTrigger()-Methode gibt ebenfalls true zurück, wenn für ein bestimmtes Anzeigelistenobjekt ein Ereignis-
Listener gefunden wurde. Bei willTrigger() wird jedoch nicht nur dieses eine Objekt in der Anzeigeliste überprüft,
sondern für alle Phasen des Ereignisablaufs auch alle Vorgänger dieses Objekts.
Letzte Aktualisierung 27.6.2012
149