flash.eventsNetMonitorEvent Ein NetMonitor-Objekt setzt NetMonitorEvent-Objekte ab, wenn ein NetStream-Objekt erstellt wird.flash.events:Event Ein NetMonitor-Objekt setzt NetMonitorEvent-Objekte ab, wenn ein NetStream-Objekt erstellt wird. netStreamCreateflash.events:NetMonitorEvent:NET_STREAM_CREATEflash.events:NetMonitorEventNetMonitorEvent Erstellt ein Ereignisobjekt, das Informationen über netStreamCreate-Ereignisse enthält.typeStringDer Ereignistyp. Ereignis-Listener können über die übernommene Eigenschaft type auf diese Informationen zugreifen. Es gibt nur einen Ereignistyp: NetMonitorEvent.NET_STREAM_CREATE. bubblesBooleanfalseLegt fest, ob das Ereignisobjekt an der Bubbling-Phase des Ereignisablaufs teilnimmt. Ereignis-Listener können über die übernommene Eigenschaft bubbles auf diese Informationen zugreifen. cancelableBooleanfalseBestimmt, ob das Ereignisobjekt abgebrochen werden kann. Ereignis-Listener können über die übernommene Eigenschaft cancelable auf diese Informationen zugreifen. netStreamflash.net:NetStreamnullDas neue NetStream-Objekt, das erstellt wurde. Ereignis-Listener können über die netStream-Eigenschaft auf diese Informationen zugreifen. Konstruktor für NetMonitorEvent-Objekte. Erstellt ein Ereignisobjekt, das Informationen über netStreamCreate-Ereignisse enthält. Ereignisobjekte werden Ereignis-Listenern als Parameter übergeben. NetMonitorEvent.NET_STREAM_CREATEclone Erstellt eine Kopie des NetMonitorEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.Ein neues NetMonitorEvent-Objekt mit Eigenschaftswerten, die denen des Originals entsprechen. flash.events:Event Erstellt eine Kopie des NetMonitorEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht. toString Gibt einen String zurück, der alle Eigenschaften des NetMonitorEvent-Objekts enthält.Ein String, der alle Eigenschaften des NetMonitorEvent-Objekts enthält. String Gibt einen String zurück, der alle Eigenschaften des NetMonitorEvent-Objekts enthält. Das folgende Format wird verwendet:

[NetMonitorEvent type=Wert bubbles=Wert cancelable=Wert netStream=Wert]

NET_STREAM_CREATE Die NetMonitorEvent.NET_STREAM_CREATE-Konstante definiert den Wert der type-Eigenschaft eines netStreamCreate-Ereignisobjekts.netStreamCreateString Die NetMonitorEvent.NET_STREAM_CREATE-Konstante definiert den Wert der type-Eigenschaft eines netStreamCreate-Ereignisobjekts.

Das netStreamCreate-Ereignis hat folgende Eigenschaften:

EigenschaftWertnetStreamDas NetStream-Objekt, das erstellt wurde.bubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.targetDas Objekt, das eine Sitzung beginnt oder beendet.
netStream Das neue NetStream-Objekt.flash.net:NetStream Das neue NetStream-Objekt.
TimerEvent Ein Timer-Objekt löst ein TimerEvent-Objekt aus, wenn das Timer-Objekt das von der Timer.delay-Eigenschaft angegebene Intervall erreich.Ereignisobjekte für Timer-Ereignisse. flash.events:Event Ein Timer-Objekt löst ein TimerEvent-Objekt aus, wenn das Timer-Objekt das von der Timer.delay-Eigenschaft angegebene Intervall erreich. Im folgenden Beispiel wird anhand der Klasse „TimerExample“ erläutert, wie die Listener-Methode timerHandler() instanziiert und für auszulösende neue „TimerEvent“-Ereignisse (bei Aufruf der Timer-Methode start()) konfiguriert werden kann. package { import flash.utils.Timer; import flash.events.TimerEvent; import flash.display.Sprite; public class TimerEventExample extends Sprite { public function TimerEventExample() { var myTimer:Timer = new Timer(1000, 2); myTimer.addEventListener(TimerEvent.TIMER, timerHandler); myTimer.start(); } public function timerHandler(event:TimerEvent):void { trace("timerHandler: " + event); } } } flash.utils.TimertimerCompleteflash.events:TimerEvent:TIMER_COMPLETEflash.events:TimerEventflash.utils.Timer.timerCompletetimerflash.events:TimerEvent:TIMERflash.events:TimerEventflash.utils.Timer.timerTimerEvent Erstellt ein Ereignisobjekt mit bestimmten Informationen, die für timer-Ereignisse wichtig sind.typeString Der Ereignistyp. Ereignis-Listener können über die übernommene Eigenschaft type auf diese Informationen zugreifen. bubblesBooleanfalseLegt fest, ob das Ereignisobjekt eine Bubbling-Phase durchführt. Ereignis-Listener können über die übernommene Eigenschaft bubbles auf diese Informationen zugreifen. cancelableBooleanfalseBestimmt, ob das Ereignisobjekt abgebrochen werden kann. Ereignis-Listener können über die übernommene Eigenschaft cancelable auf diese Informationen zugreifen. Konstruktor für TimerEvent-Objekte. Erstellt ein Ereignisobjekt mit bestimmten Informationen, die für timer-Ereignisse wichtig sind. Ereignisobjekte werden Ereignis-Listenern als Parameter übergeben. clone Erstellt eine Kopie des TimerEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.Ein neues TimerEvent-Objekt mit Eigenschaftswerten, die denen des Originals entsprechen. flash.events:Event Erstellt eine Kopie des TimerEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht. toString Gibt eine Zeichenfolge zurück, die alle Eigenschaften des TimerEvent-Objekts enthält.Eine Zeichenfolge, die alle Eigenschaften des TimerEvent-Objekts enthält. String Gibt eine Zeichenfolge zurück, die alle Eigenschaften des TimerEvent-Objekts enthält. Der String liegt im folgenden Format vor:

[TimerEvent type= value bubbles= value cancelable= value ]

updateAfterEvent Weist Flash Player oder die AIR-Laufzeitumgebung nach Abschluss der Verarbeitung dieses Ereignisses zur Wiedergabe an, wenn die Anzeigeliste geändert wurde. Weist Flash Player oder die AIR-Laufzeitumgebung nach Abschluss der Verarbeitung dieses Ereignisses zur Wiedergabe an, wenn die Anzeigeliste geändert wurde. Nachstehend finden Sie ein Beispiel für die TimerEvent.updateAfterEvent()-Methode. function onTimer(event:TimerEvent):void { if (40 < my_mc.x && my_mc.x < 375) { my_mc.x-= 50; } else { my_mc.x=374; } event.updateAfterEvent(); } var moveTimer:Timer=new Timer(50,250); moveTimer.addEventListener(TimerEvent.TIMER,onTimer); moveTimer.start(); TIMER_COMPLETE Definiert den Wert der Eigenschaft „type“ eines timerComplete-Ereignisobjekts.timerCompleteString Definiert den Wert der Eigenschaft type eines timerComplete-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.targetDas Timer-Objekt, das seine Anforderungen abgearbeitet hat.
flash.utils.Timer.timerComplete
TIMER Definiert den Wert der Eigenschaft „type“ eines timer-Ereignisobjekts.timerString Definiert den Wert der Eigenschaft type eines timer-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.targetDas Timer-Objekt, das sein Intervall erreicht hat.
flash.utils.Timer.timer
IOErrorEvent Ein IOErrorEvent-Objekt wird ausgelöst, wenn ein Eingabe- oder Ausgabevorgang aufgrund eines Fehlers fehlschlägt.Ereignisobjekte für IOErrorEvent-Ereignisse. flash.events:ErrorEvent Ein IOErrorEvent-Objekt wird ausgelöst, wenn ein Eingabe- oder Ausgabevorgang aufgrund eines Fehlers fehlschlägt.

Sie können prüfen, ob error-Ereignisse ohne Listener vorliegen, indem Sie die Debugger-Version von Flash Player oder AIR Debug Launcher (ADL) verwenden. Es wird der String angezeigt, der vom text-Parameter des IOErrorEvent-Konstruktors definiert wird.

Im folgenden Beispiel wird anhand der Klasse IOErrorEventExample gezeigt, wie ein Fehlerereignisobjekt ausgelöst wird, wenn versucht wird, eine nicht vorhandene Datei zu laden. In diesem Beispiel werden die folgenden Aufgaben ausgeführt:
  1. Der Klassenkonstruktor erstellt eine neue Instanz eines URLLoader-Objekts und weist ihr die Variable loader zu.
  2. Mit der URLLoader-Instanz wird ein Ereignis-Listener vom Typ ioError instanziiert, die mit der Abonnentenmethode ioErrorHandler() verknüpft ist. Die Methode dient zum Drucken von Informationen über das Ereignis mithilfe der Methode trace().
  3. Der Konstruktor erstellt eine neue Instanz eines URLRequest-Objekts (request) und übergibt dabei MissingFile.xml, damit der Dateiname und -speicherort bekannt sind.
  4. Die Variable request wird anschließend an loader.load() übergeben. Diese Methode versucht, die fehlende Datei zu laden. Da die Datei fehlt, sendet die Ereignisprozedur ein ioError-Ereignis.

Hinweise:

  • Für die Kompilierung der SWF-Datei müssen Sie die Option „Sicherheit bei lokaler Wiedergabe“ auf „Nur auf lokale Dateien zugreifen“ einstellen.
  • Auf der Ebene der SWF-Datei darf sich keine Datei mit dem Namen „MissingFile.xml“ befinden.

package { import flash.display.Sprite; import flash.events.IOErrorEvent; import flash.net.URLLoader; import flash.net.URLRequest; public class IOErrorEventExample extends Sprite { public function IOErrorEventExample() { var loader:URLLoader = new URLLoader(); loader.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler); var request:URLRequest = new URLRequest("MissingFile.xml"); loader.load(request); } private function ioErrorHandler(event:IOErrorEvent):void { trace("ioErrorHandler: " + event); } } }
IO_ERRORioErrorflash.events:IOErrorEvent:IO_ERRORflash.events:IOErrorEventflash.display.LoaderInfo.ioErrorflash.media.Sound.ioErrorflash.net.SecureSocket.ioErrorflash.net.Socket.ioErrorflash.net.FileReference.ioErrorflash.net.NetConnection.ioErrorflash.net.NetStream.ioErrorflash.net.URLLoader.ioErrorflash.net.URLStream.ioErrorflash.net.XMLSocket.ioErrorIOErrorEventflash.events:IOErrorEvent:STANDARD_ERROR_IO_ERRORflash.events:IOErrorEventIOErrorEventflash.events:IOErrorEvent:STANDARD_INPUT_IO_ERRORflash.events:IOErrorEventIOErrorEventflash.events:IOErrorEvent:STANDARD_OUTPUT_IO_ERRORflash.events:IOErrorEventIOErrorEvent Erstellt ein Ereignisobjekt, das bestimmte Informationen über ioError-Ereignisse enthält.typeString Der Ereignistyp. Ereignis-Listener können über die übernommene Eigenschaft type auf diese Informationen zugreifen. Es gibt nur einen Typ eines Eingabe/Ausgabe-Fehlerereignisses: IOErrorEvent.IO_ERROR. bubblesBooleanfalseBestimmt, ob das Ereignisobjekt an der Bubbling-Phase des Ereignisablaufs teilnimmt. Ereignis-Listener können über die übernommene Eigenschaft bubbles auf diese Informationen zugreifen. cancelableBooleanfalseBestimmt, ob das Ereignisobjekt abgebrochen werden kann. Ereignis-Listener können über die übernommene Eigenschaft cancelable auf diese Informationen zugreifen. textStringDer als Fehlermeldung anzuzeigende Text. Ereignis-Listener können über die Eigenschaft text auf diese Informationen zugreifen. idint0Eine mit dem spezifischen Fehler verknüpfte Referenznummer (wird nur in Adobe AIR unterstützt). Konstruktor für IOErrorEvent-Objekte. Erstellt ein Ereignisobjekt, das bestimmte Informationen über ioError-Ereignisse enthält. Ereignisobjekte werden Ereignis-Listenern als Parameter übergeben. IO_ERRORclone Erstellt eine Kopie des IOErrorEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.Ein neues IOErrorEvent-Objekt mit Eigenschaftswerten, die denen des Originals entsprechen. flash.events:Event Erstellt eine Kopie des IOErrorEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht. toString Gibt eine Zeichenfolge zurück, die alle Eigenschaften des IOErrorEvent-Objekts enthält.Eine Zeichenfolge, die alle Eigenschaften des IOErrorEvent-Objekts enthält. String Gibt eine Zeichenfolge zurück, die alle Eigenschaften des IOErrorEvent-Objekts enthält. Der String liegt im folgenden Format vor:

[IOErrorEvent type=Wert bubbles=Wert cancelable=Wert text=Wert errorID=Wert] Die errorId-Eigenschaft ist nur in Adobe AIR verfügbar

IO_ERROR Definiert den Wert der Eigenschaft „type“ eines ioError-Ereignisobjekts.ioErrorString Definiert den Wert der Eigenschaft type eines ioError-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.errorIDDie Referenznummer des spezifischen Fehlers (nur AIR).targetDas Netzwerkobjekt, bei dem der Eingabe/Ausgabe-Fehler auftritt.textDer als Fehlermeldung anzuzeigende Text.
flash.display.LoaderInfo.ioErrorflash.media.Sound.ioErrorflash.net.SecureSocket.ioErrorflash.net.Socket.ioErrorflash.net.FileReference.ioErrorflash.net.NetConnection.ioErrorflash.net.NetStream.ioErrorflash.net.URLLoader.ioErrorflash.net.URLStream.ioErrorflash.net.XMLSocket.ioError
STANDARD_ERROR_IO_ERROR Das standardErrorIoError-Ereignis wird abgesetzt, wenn beim Lesen von Daten aus dem standardError-Stream eines NativeProcess-Objekts ein Fehler auftritt.standardErrorIoErrorString Das standardErrorIoError-Ereignis wird abgesetzt, wenn beim Lesen von Daten aus dem standardError-Stream eines NativeProcess-Objekts ein Fehler auftritt.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesNein.cancelableNein. Es gibt kein Standardverhalten, das abgebrochen werden kann.errorIDDie Verweisnummer, die dem spezifischen Fehler zugeordnet ist.targetDas Objekt, bei dem der Fehler aufgetreten ist. textDer als Fehlermeldung anzuzeigende Text.
STANDARD_INPUT_IO_ERROR Das standardInputIoError-Ereignis wird abgesetzt, wenn beim Schreiben von Daten in den standardInput-Stream eines NativeProcess-Objekts ein Fehler auftritt.standardInputIoErrorString Das standardInputIoError-Ereignis wird abgesetzt, wenn beim Schreiben von Daten in den standardInput-Stream eines NativeProcess-Objekts ein Fehler auftritt.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesNein.cancelableNein. Es gibt kein Standardverhalten, das abgebrochen werden kann.errorIDDie Verweisnummer, die dem spezifischen Fehler zugeordnet ist.targetDas Objekt, bei dem der Fehler aufgetreten ist. textDer als Fehlermeldung anzuzeigende Text.
STANDARD_OUTPUT_IO_ERROR Das standardOutputIoError-Ereignis wird abgesetzt, wenn beim Lesen von Daten aus dem standardOutput-Stream eines NativeProcess-Objekts ein Fehler auftritt.standardOutputIoErrorString Das standardOutputIoError-Ereignis wird abgesetzt, wenn beim Lesen von Daten aus dem standardOutput-Stream eines NativeProcess-Objekts ein Fehler auftritt.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesNein.cancelableNein. Es gibt kein Standardverhalten, das abgebrochen werden kann.errorIDDie Verweisnummer, die dem spezifischen Fehler zugeordnet ist.targetDas Objekt, bei dem der Fehler aufgetreten ist. textDer als Fehlermeldung anzuzeigende Text.
NetStatusEvent Ein NetConnection-, NetStream- oder SharedObject-Objekt löst NetStatusEvent-Objekte aus, wenn es seinen Status meldet.Ereignisobjekte für NetStatusEvent-Ereignisse. flash.events:Event Ein NetConnection-, NetStream- oder SharedObject-Objekt löst NetStatusEvent-Objekte aus, wenn es seinen Status meldet. Es gibt nur einen Typ eines status-Ereignisses: NetStatusEvent.NET_STATUS. Im folgenden Beispiel wird ein Video-Objekt mit den Klassen NetConnection und NetStream verwendet, um eine FLV-Datei zu laden und abzuspielen.

Bei diesem Beispiel wird die netStatusHandler-Methode als Listener für das NetStatusEvent-Ereignis NetConnection.netStatus registriert. Sobald der Status (Erfolg/Fehler) des NetConnection.connect()-Versuchs feststeht, wird diese Methode vom netStatus-Ereignis ausgelöst. Wenn der Versuch, eine Verbindung zum NetConnection-Objekt herzustellen, erfolgreich ist (wenn also die Eigenschaft info des vom netStatus-Ereignis ausgelösten NetStatusEvent-Objekts die code-Eigenschaft für Erfolg aufweist), werden die Video- und NetStream-Objekte erstellt und die Methoden Video.attachNetStream() und NetStream.play() aufgerufen.

Hinweis: Zur Ausführung dieses Beispiels benötigen Sie eine FLV-Datei, deren Name und Speicherort mit der an videoURL übergebenen Variablen übereinstimmt. In diesem Fall ist das eine FLV-Datei mit dem Namen „Video.flv“, die in dem Ordner abgelegt ist, in dem sich die SWF-Datei befindet.

package { import flash.display.Sprite; import flash.events.*; import flash.media.Video; import flash.net.NetConnection; import flash.net.NetStream; public class NetStatusEventExample extends Sprite { private var videoURL:String = "Video.flv"; private var connection:NetConnection; private var stream:NetStream; public function NetStatusEventExample() { connection = new NetConnection(); connection.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler); connection.addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler); connection.connect(null); } private function netStatusHandler(event:NetStatusEvent):void { switch (event.info.code) { case "NetConnection.Connect.Success": connectStream(); break; case "NetStream.Play.StreamNotFound": trace("Unable to locate video: " + videoURL); break; } } private function connectStream():void { var stream:NetStream = new NetStream(connection); stream.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler); stream.addEventListener(AsyncErrorEvent.ASYNC_ERROR, asyncErrorHandler); var video:Video = new Video(); video.attachNetStream(stream); stream.play(videoURL); addChild(video); } private function securityErrorHandler(event:SecurityErrorEvent):void { trace("securityErrorHandler: " + event); } private function asyncErrorHandler(event:AsyncErrorEvent):void { // ignore AsyncErrorEvent events. } } }
flash.net.NetConnectionflash.net.NetStreamflash.net.SharedObjectNetStatusEvent.NET_STATUSnetStatusflash.events:NetStatusEvent:NET_STATUSflash.events:NetStatusEventflash.events.NetStatusEvent.infoflash.net.NetConnection.netStatusflash.net.NetStream.netStatusflash.net.SharedObject.netStatusNetStatusEvent Erstellt ein Ereignisobjekt, das Informationen über netStatus-Ereignisse enthält.typeString Der Ereignistyp. Ereignis-Listener können über die übernommene Eigenschaft type auf diese Informationen zugreifen. Es gibt nur einen Typ eines status-Ereignisses: NetStatusEvent.NET_STATUS. bubblesBooleanfalseBestimmt, ob das Ereignisobjekt an der Bubbling-Phase des Ereignisablaufs teilnimmt. Ereignis-Listener können über die übernommene Eigenschaft bubbles auf diese Informationen zugreifen. cancelableBooleanfalseBestimmt, ob das Ereignisobjekt abgebrochen werden kann. Ereignis-Listener können über die übernommene Eigenschaft cancelable auf diese Informationen zugreifen. infoObjectnullEin Objekt mit Eigenschaften, die den Status des Objekts beschreiben. Ereignis-Listener können über die Eigenschaft info auf dieses Objekt zugreifen. Konstruktor für NetStatusEvent-Objekte. Erstellt ein Ereignisobjekt, das Informationen über netStatus-Ereignisse enthält. Ereignisobjekte werden Ereignis-Listenern als Parameter übergeben. flash.events.NetStatusEvent.NET_STATUSclone Erstellt eine Kopie des NetStatusEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.Ein neues NetStatusEvent-Objekt mit Eigenschaftswerten, die denen des Originals entsprechen. flash.events:Event Erstellt eine Kopie des NetStatusEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht. toString Gibt eine Zeichenfolge zurück, die alle Eigenschaften des NetStatusEvent-Objekts enthält.Eine Zeichenfolge, die alle Eigenschaften des NetStatusEvent-Objekts enthält. String Gibt eine Zeichenfolge zurück, die alle Eigenschaften des NetStatusEvent-Objekts enthält. Der String liegt im folgenden Format vor:

[NetStatusEvent type=Wert bubbles=Wert cancelable=Wert info=Wert]

NET_STATUS Definiert den Wert der Eigenschaft type eines netStatus-Ereignisobjekts.netStatusString Definiert den Wert der Eigenschaft type eines netStatus-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.infoEin Objekt mit Eigenschaften, die den Status oder die Fehlerbedingung des Objekts beschreiben.targetDas NetConnection- oder NetStream-Objekt, dessen Status protokolliert wird.
flash.events.NetStatusEvent.infoflash.net.NetConnection.netStatusflash.net.NetStream.netStatusflash.net.SharedObject.netStatus
info Ein Objekt mit Eigenschaften, die den Status oder die Fehlerbedingung des Objekts beschreiben.Object Ein Objekt mit Eigenschaften, die den Status oder die Fehlerbedingung des Objekts beschreiben.

Das Informationsobjekt kann eine code-Eigenschaft besitzen, in der eine Zeichenfolge enthalten ist, die ein bestimmtes Ereignis oder eine level-Eigenschaft darstellt, die wiederum eine "status" oder "error" lautende Zeichenfolge enthält.

Das Informationsobjekt kann auch etwas anderes sein. Die Eigenschaften code und level funktionieren bei einigen Implementierungen möglicherweise nicht korrekt, und einige Server senden andere Objekte.

P2P-Verbindungen senden Meldungen an eine NetConnection mit einem stream-Parameter im Informationsobjekt, der angibt, zu welchem NetStream die Meldung gehört.

Beispielsweise senden die Flex Data Services sogenannte Message-Objekte, die zu Fehlermeldungen führen, wenn Sie versuchen, auf eine der Eigenschaften code oder level zuzugreifen.

In der folgenden Tabelle sind die möglichen Stringwerte der Eigenschaften code und level aufgeführt.

Code-EigenschaftLevel-EigenschaftBedeutung"NetConnection.Call.BadVersion""error"Paket wurde in einem nicht erkannten Format kodiert."NetConnection.Call.Failed""error"Die NetConnection.call()-Methode konnte die serverseitige Methode bzw. den serverseitigen Befehl nicht aufrufen."NetConnection.Call.Prohibited""error"Ein Action Message Format (AMF)-Vorgang wurde aus Sicherheitsgründen verhindert. Entweder befindet sich die AMF URL nicht in derselben Domäne wie die Datei mit dem Code, der die NetConnection.call()-Methode aufruft, oder der AMF-Server hat keine Richtliniendatei, die die Domäne der Datei mit dem Code, der die NetConnection.call()-Methode aufruft, als vertrauenswürdig einstuft. "NetConnection.Connect.AppShutdown""error"Die serverseitige Anwendung wird heruntergefahren."NetConnection.Connect.Closed""status"Die Verbindung wurde erfolgreich geschlossen."NetConnection.Connect.Failed""error"Der Versuch zur Herstellung einer Verbindung ist fehlgeschlagen."NetConnection.Connect.IdleTimeout""status"Flash Media Server hat die Verbindung zum Client getrennt, da der Client länger als die für <MaxIdleTime> konfigurierte Zeit im Leerlauf war. Bei Flash Media Server ist <AutoCloseIdleClients> standardmäßig deaktiviert. Wenn die Funktion aktiviert ist, ist der Standardwert für die Zeitüberschreitung 3600 Sekunden (1 Stunde). Weitere Informationen finden Sie unter Close idle connections. "NetConnection.Connect.InvalidApp""error"Der Anwendungsname, der im Aufruf von NetConnection.connect() angegeben wurde, ist ungültig."NetConnection.Connect.NetworkChange""status"

Flash Player hat eine Netzwerkänderung erkannt, zum Beispiel eine unterbrochene drahtlose Verbindung, ein erfolgreicher drahtloses Verbindungsaufbau oder ein abgetrenntes Netzwerkkabel.

Verwenden Sie dieses Ereignis, um zu prüfen, ob es eine Netzwerkschnittstellenänderung gab. Verwenden Sie dieses Ereignis nicht, um Ihre NetConnection-Neuverbindungslogik zu implementieren. Ihre NetConnection-Neuverbindungslogik können Sie mit "NetConnection.Connect.Closed" implementieren.

"NetConnection.Connect.Rejected""error"Der Verbindungsversuch verfügt nicht über eine Berechtigung für den Zugriff auf die Anwendung."NetConnection.Connect.Success""status"Der Versuch zur Herstellung einer Verbindung war erfolgreich."NetGroup.Connect.Failed""error"Der Versuch zur Herstellung einer NetGroup-Verbindung ist fehlgeschlagen. Die info.group-Eigenschaft gibt an, welche NetGroup fehlgeschlagen ist."NetGroup.Connect.Rejected""error"Die NetGroup ist nicht autorisiert zu funktionieren. Die info.group-Eigenschaft gibt an, welche NetGroup abgelehnt wurde."NetGroup.Connect.Succcess""status"Die NetGroup wurde erfolgreich konstruiert und zum Funktionieren autorisiert. Die info.group-Eigenschaft gibt an, welche NetGroup erfolgreich war."NetGroup.LocalCoverage.Notify""status"Wird gesendet, wenn ein Teil des Gruppenadressraums, für den dieser Knoten zuständig ist, geändert wird."NetGroup.MulticastStream.PublishNotify""status"Wird gesendet, wenn ein neuer benannter Stream in der NetGroup-Gruppe erkannt wird. Die info.name:String-Eigenschaft ist der Name des erkannten Streams."NetGroup.MulticastStream.UnpublishNotify""status"Wird gesendet, wenn ein benannter Stream nicht mehr in der Gruppe verfügbar ist. Die info.name:String-Eigenschaft ist der Name des Streams, der nicht mehr verfügbar ist."NetGroup.Neighbor.Connect""status"Wird gesendet, wenn ein Nachbar eine Verbindung zu diesem Knoten herstellt. Die info.neighbor:String-Eigenschaft ist die Gruppenadresse des Nachbarn. Die info.peerID:String-Eigenschaft ist die Peer-ID des Nachbarn."NetGroup.Neighbor.Disconnect""status"Wird gesendet, wenn ein Nachbar die Verbindung zu diesem Knoten trennt. Die info.neighbor:String-Eigenschaft ist die Gruppenadresse des Nachbarn. Die info.peerID:String-Eigenschaft ist die Peer-ID des Nachbarn."NetGroup.Posting.Notify""status"Wird gesendet, wenn ein neues Gruppenposting empfangen wird. Die info.message:Object-Eigenschaft ist die Nachricht. Die info.messageID:String-Eigenschaft ist die messageID dieser Nachricht."NetGroup.Replication.Fetch.Failed""status"Wird gesendet, wenn eine Abrufanforderung für ein Objekt (zuvor mit NetGroup.Replication.Fetch.SendNotify angekündigt) fehlschlägt oder abgelehnt wird. Es wird ein neuer Versuch für das Objekt gestartet, wenn es immer noch angefordert wird. Die info.index:Number-Eigenschaft ist der Index des angeforderten Objekts."NetGroup.Replication.Fetch.Result""status"Wird gesendet, wenn eine Abrufanforderung von einem Nachbarn erfüllt wurde. Die info.index:Number-Eigenschaft ist der Objektindex dieses Ergebnisses. Die info.object:Object-Eigenschaft ist der Wert dieses Objekts. Dieser Index wird automatisch aus dem Want-Satz entfernt. Wenn das Objekt ungültig ist, kann dieser Index dem Want-Satz mit NetGroup.addWantObjects() erneut hinzugefügt werden."NetGroup.Replication.Fetch.SendNotify""status"Wird gesendet, wenn das Objektreplikationssystem eine Anforderung für ein Objekt an einen Nachbarn sendet. Die info.index:Number-Eigenschaft ist der Index des angeforderten Objekts."NetGroup.Replication.Request""status"Wird gesendet, wenn ein Nachbar ein Objekt angefordert hat, das dieser Knoten mit NetGroup.addHaveObjects() angekündigt hat. Diese Anforderung muss letztendlich entweder mit NetGroup.writeRequestedObject() oder mit NetGroup.denyRequestedObject() beantwortet werden. Beachten Sie, dass die Antwort asynchron sein kann. Die info.index:Number-Eigenschaft ist der Index des angeforderten Objekts. Die info.requestID:int-Eigenschaft ist die ID dieser Anforderung, die von NetGroup.writeRequestedObject() oder NetGroup.denyRequestedObject() verwendet wird."NetGroup.SendTo.Notify""status"Wird gesendet, wenn eine an diesen Knoten gerichtete Nachricht nicht empfangen wurde. Die info.message:Object-Eigenschaft ist die Nachricht. Die info.from:String-Eigenschaft ist die groupAddress, von der die Nachricht empfangen wurde. Die info.fromLocal:Boolean-Eigenschaft hat den Wert TRUE, wenn die Nachricht von diesem Knoten gesendet wurde (der lokale Knoten also der Zielgruppenaddresse am nächsten ist) und FALSE, wenn die Nachricht von einem anderen Knoten empfangen wurde. Um rekursives Routing zu implementieren, muss die Nachricht mit NetGroup.sendToNearest() erneut gesendet werden, wenn info.fromLocal den Wert FALSE hat."NetStream.Buffer.Empty""status"Flash Player empfängt Daten nicht schnell genug, um den Puffer zu füllen. Der Datenfluss wird unterbrochen, bis der Pufferspeicher wieder gefüllt ist. Dann wird die NetStream.Buffer.Full-Meldung gesendet und die Wiedergabe des Streams fortgesetzt."NetStream.Buffer.Flush""status"Der Datenstream ist abgeschlossen, der Puffer wird geleert."NetStream.Buffer.Full""status"Der Puffer ist voll, und der Stream wird wiedergegeben."NetStream.Connect.Closed""status"Die P2P-Verbindung wurde erfolgreich beendet. Die info.stream-Eigenschaft gibt an, welcher Stream beendet wurde."NetStream.Connect.Failed""error"Der P2P-Verbindungsversuch ist fehlgeschlagen. Die info.stream-Eigenschaft gibt an, welcher Stream fehlgeschlagen ist."NetStream.Connect.Rejected""error"Der P2P-Verbindungsversuch verfügt nicht über die Berechtigung für den Zugriff auf den anderen Peer. Die info.stream-Eigenschaft gibt an, welcher Stream abgelehnt wurde."NetStream.Connect.Success""status"Der P2P-Verbindungsversuch war erfolgreich. Die info.stream-Eigenschaft gibt an, welcher Stream erfolgreich war."NetStream.DRM.UpdateNeeded""status"Ein NetStream-Objekt versucht, geschützten Inhalt abzuspielen, das erforderliche Flash Access-Modul ist jedoch entweder nicht vorhanden oder aufgrund der geltenden Richtlinie nicht berechtigt oder nicht mit dem aktuellen Player kompatibel. Um das Modul oder den Player zu aktualisieren, verwenden Sie die update()-Methode von flash.system.SystemUpdater. "NetStream.Failed""error"(Flash Media Server) Aus einem anderen als in den anderen Ereigniscodes aufgeführten Gründen ist ein Fehler aufgetreten. "NetStream.MulticastStream.Reset""status"Ein Multicast-Abonnement hat den Fokus auf einen anderen Stream geändert, der mit demselben Namen in derselben Gruppe veröffentlicht wird. Lokale Überschreibungen von Multicast-Streamparametern gehen verloren. Wenden Sie die lokalen Überschreibungen erneut an, andernfalls werden die Standardparameter des neuen Streams verwendet."NetStream.Pause.Notify""status"Der Stream wurde unterbrochen."NetStream.Play.Failed""error"Es ist ein Fehler bei der Wiedergabe aufgetreten. Die Ursache für diesen Fehler wird nicht in dieser Tabelle aufgeführt. Eventuell hat der Abonnent keinen Lesezugriff."NetStream.Play.FileStructureInvalid""error"(AIR and Flash Player 9.0.115.0) Die Anwendung erkennt eine ungültige Dateistruktur und versucht nicht, diesen Dateityp abzuspielen. "NetStream.Play.InsufficientBW"„Warnung“(Flash Media Server) Der Client verfügt nicht über ausreichend Bandbreite, um die Daten mit normaler Geschwindigkeit abzuspielen. "NetStream.Play.NoSupportedTrackFound""error"(AIR and Flash Player 9.0.115.0) Die Anwendung erkennt keine unterstützten Titel (Video, Audio oder Daten) und versucht nicht, die Datei abzuspielen."NetStream.Play.PublishNotify""status"Die erste Veröffentlichung an einen Stream wird an alle Abonnenten gesendet."NetStream.Play.Reset""status"Verursacht durch das Zurücksetzen der Wiedergabeliste."NetStream.Play.Start""status"Die Wiedergabe hat begonnen."NetStream.Play.Stop""status"Die Wiedergabe wurde angehalten."NetStream.Play.StreamNotFound""error"Die an die Methode NetStream.play() übergebene Datei wurde nicht gefunden."NetStream.Play.Transition""status"(Flash Media Server 3.5) Der Server hat den Befehl zum Wechseln auf einen anderen Stream infolge eines Bitrate-Streamwechsels erhalten. Dieser Code zeigt ein Erfolgsstatusereignis für den NetStream.play2()-Aufruf zum Initiieren eines Streamwechsels an. Ist der Wechsel nicht erfolgreich, so sendet der Server stattdessen ein NetStream.Play.Failed-Ereignis. Beim Streamwechsel wird ein onPlayStatus-Ereignis mit dem Code „NetStream.Play.TransitionComplete“ ausgelöst. Für Flash Player 10 und neuere Versionen."NetStream.Play.UnpublishNotify""status"Eine Anweisung zur Rücknahme der Veröffentlichung aus einem Stream wird an alle Abonnenten gesendet."NetStream.Publish.BadName""error"Versuch, einen Stream zu veröffentlichen, der bereits von einer anderen Person veröffentlicht wurde."NetStream.Publish.Idle""status"Der Herausgeber des Streams ist inaktiv und überträgt keine Daten."NetStream.Publish.Start""status"Das Veröffentlichen war erfolgreich."NetStream.Record.AlreadyExists""status"Der Stream, der aufgezeichnet wird, ist einer Datei zugeordnet, die bereits von einem anderen Stream aufgezeichnet wird. Dies kann durch eine falsche Konfiguration virtueller Ordner verursacht werden."NetStream.Record.Failed""error"Ein Versuch, einen Stream aufzuzeichnen, ist fehlgeschlagen."NetStream.Record.NoAccess""error"Versuch, einen Stream aufzuzeichnen, der noch wiedergegeben wird, oder der Client besitzt keine Zugriffsrechte."NetStream.Record.Start""status"Die Aufzeichnung hat begonnen."NetStream.Record.Stop""status"Aufzeichnung angehalten."NetStream.Seek.Failed""error"Die Suche schlug fehlt. Dies kann auftreten, wenn der Stream nicht gesucht werden kann."NetStream.Seek.InvalidTime""error"Bei einem progressiv heruntergeladenen Video hat der Benutzer eine Position gesucht, die hinter dem Ende der bisher heruntergeladenen Videodaten bzw. hinter dem Ende der fertig heruntergeladenen Videodatei liegt. Die Eigenschaft info.details des Ereignisobjekts enthält einen Zeitcode, der die letzte gültige Suchposition angibt."NetStream.Seek.Notify""status"

Der Suchvorgang ist abgeschlossen.

Wird gesendet, wenn NetStream.seek() für einen Stream im AS3 NetStream-Datengenerierungsmodus aufgerufen wird. Das Info-Objekt wird erweitert, um info.seekPoint einzubeziehen, das denselben Wert hat, der an NetStream.seek() übergeben wird.

"NetStream.Step.Notify""status"Der Schrittvorgang ist abgeschlossen."NetStream.Unpause.Notify""status"Der Stream wird fortgesetzt."NetStream.Unpublish.Success""status"Der Unveröffentlichungs-Vorgang war erfolgreich."SharedObject.BadPersistence""error"Es wurde eine Anfrage zur Erstellung eines freigegebenen Objekts mit Persistenzflags gestellt. Diese Anforderung kann jedoch nicht gewährt werden, da das Objekt bereits mit anderen Flags erstellt wurde."SharedObject.Flush.Failed""error"Der Status „pending“ ist aufgelöst, aber der Aufruf SharedObject.flush() ist fehlgeschlagen."SharedObject.Flush.Success""status"Der Status „pending“ ist aufgelöst, und der Aufruf SharedObject.flush() wurde erfolgreich durchgeführt."SharedObject.UriMismatch""error"Es wurde versucht, eine Verbindung mit einem NetConnection-Objekt herzustellen, das einen anderen URI (URL) als das freigegebene Objekt aufweist.

Falls wiederholt Pufferfehler angezeigt werden, sollten Sie versuchen, den Puffer mit der Eigenschaft NetStream.bufferTime zu ändern.

Das folgende Beispiel zeigt eine Ereignisprozedurfunktion, die auf den "NetStream.Seek.InvalidTime"-Fehler prüft. Der "NetStream.Seek.InvalidTime"-Fehler tritt auf, wenn der Benutzer versucht, über das Ende des heruntergeladenen Streams hinaus einen Suchlauf durchzuführen. Im Beispiel wird der Wert der info.code-Eigenschaft des Ereignisobjekts getestet. Falls der Fehler auftritt, wird die eventObj.info.details-Eigenschaft einer Variablen zugewiesen, die als Parameter für die seek()-Methode des Streams verwendet wird. Die eventObj.info.details-Eigenschaft enthält die letzte gültige Position, die zur Verarbeitung des Fehlers verfügbar ist. Der Benutzer geht also zu einer gültigen Position am Ende des heruntergeladenen Streams. function videoStatus(eventObj:NetStatusEvent):Void { switch(eventObj.info.code) { case "NetStream.Seek.InvalidTime": { var validSeekTime:Number = eventObj.info.details; nStream.seek(validSeekTime); break; } } }
NetConnection-KlasseNetStream-KlasseNetGroup-Klasse
UncaughtErrorEvents Die UncaughtErrorEvents-Klasse bietet eine Möglichkeit, Ereignisse für nicht erfasste Fehler zu empfangen.flash.events:EventDispatcher Die UncaughtErrorEvents-Klasse bietet eine Möglichkeit, Ereignisse für nicht erfasste Fehler zu empfangen. Eine Instanz dieser Klasse setzt ein uncaughtError-Ereignis ab, wenn ein Laufzeitfehler auftritt und der Fehler in Ihrem Code nicht erfasst und verarbeitet wird.

Mit den folgenden Eigenschaften können Sie auf eine UncaughtErrorEvents-Instanz zugreifen:

  • LoaderInfo.uncaughtErrorEvents: zum Erkennen nicht erfasster Fehler im Code, der in derselben SWF-Datei definiert ist.
  • Loader.uncaughtErrorEvents: zum Erkennen nicht erfasster Fehler im Code, der in der SWF-Datei definiert ist, die von einem Loader-Objekt geladen wird.

Um einen Fehler direkt abzufangen und ein nicht erfasstes Fehlerereignis zu verhindern, gehen Sie folgendermaßen vor:

  • Verwenden Sie einen try..catch-Block, um Code zu isolieren, der möglicherweise einen synchronen Fehler ausgibt.
  • Wenn Sie einen Vorgang ausführen, der beim Auftreten eines Fehlers ein Ereignis absetzt, registrieren Sie einen Listener für dieses Fehlerereignis.

Wenn es sich bei dem von einem Loader-Objekt geladenen Inhalt um eine AVM1 (ActionScript 2)-SWF-Datei handelt, führen nicht erfasste Fehler in der AVM1-SWF-Datei nicht zu einem uncaughtError-Ereignis. Außerdem führen JavaScript-Fehler in HTML-Inhalten, die in ein HTMLLoader-Objekt (einschließlich eines Flex-HTML-Steuerungselements) geladen werden, nicht zu einem uncaughtError-Ereignis.

LoaderInfo.uncaughtErrorEventsLoader.uncaughtErrorEventsUncaughtErrorEventuncaughtError Wird abgesetzt, wenn ein Fehler auftritt und der Entwicklercode den Fehler nicht erkennt und verarbeitet.flash.events.UncaughtErrorEvent.UNCAUGHT_ERRORflash.events.UncaughtErrorEvent Wird abgesetzt, wenn ein Fehler auftritt und der Entwicklercode den Fehler nicht erkennt und verarbeitet. UncaughtErrorEvents Erstellt eine UncaughtErrorEvents-Instanz. Erstellt eine UncaughtErrorEvents-Instanz. Entwickler sollten UncaughtErrorEvents-Instanzen nicht direkt erstellen. Um auf ein UncaughtErrorEvents-Objekt zuzugreifen, verwenden Sie eine der folgenden Eigenschaften:
  • LoaderInfo.uncaughtErrorEvents: zum Erkennen nicht erfasster Fehler im Code, der in derselben SWF-Datei definiert ist.
  • Loader.uncaughtErrorEvents: zum Erkennen nicht erfasster Fehler im Code, der in der SWF-Datei definiert ist, die von einem Loader-Objekt geladen wird.
LoaderInfo.uncaughtErrorEventsLoader.uncaughtErrorEvents
MouseEvent Ein MouseEvent-Objekt wird in den Ereignisablauf gesendet, wenn Mausereignisse auftreten.Ereignisobjekte für Mouse-Ereignisse. flash.events:Event Ein MouseEvent-Objekt wird in den Ereignisablauf gesendet, wenn Mausereignisse auftreten. Ein Mausereignis wird im Allgemeinen durch ein Benutzereingabegerät wie z. B. eine Maus oder ein Trackball erzeugt, das einen Zeiger verwendet.

Wenn verschachtelte Knoten involviert sind, zielen Mausereignisse auf den tiefstmöglich verschachtelten Knoten, der in der Anzeigeliste sichtbar ist. Dieser Knoten wird als Zielknoten bezeichnet. Damit ein übergeordnetes Element eines Zielknotens eine Benachrichtigung bei einem Mausereignis empfängt, verwenden Sie EventDispatcher.addEventListener() an dem übergeordneten Knoten. Dabei muss der Parameter type auf das Mausereignis gesetzt werden, das Sie erfassen möchten.

Im folgenden Beispiel wird anhand der Klassen MouseEventExample und ChildSprite erläutert, wie Mausereignisse bei einem einfachen Bild ausgelöst werden. In diesem Beispiel werden die folgenden Aufgaben ausgeführt:
  1. Im Beispiel werden Eigenschaften für die Größe (100 x 100 Pixel) und die Hintergrundfarbe (Orange) zur späteren Verwendung beim Zeichnen des Quadrats deklariert.
  2. Der Konstruktor erstellt das neue ChildSprite-Objekt child. Der Konstruktor zeichnet zuerst ein orangefarbenes Quadrat mit einer Größe von 100 x 100 Pixeln an den Koordinaten (0,0), indem er die Methode draw() aufruft und anschließend sieben Ereignis-Listener bzw. -Abonnenten hinzufügt.
    • click/clickHandler(): Wird ausgelöst, wenn der Benutzer einmal mit der linken Maustaste auf das Quadrat klickt.
    • doubleClick/doubleClickHandler(): Wird ausgelöst, wenn der Benutzer mit der linken Maustaste auf das Quadrat doppelklickt.
    • mouseDown/mouseDownHandler(): Wenn auf das ChildSprite-Objekt (das orangefarbene Quadrat) geklickt wird, wird eine trace()-Meldung angezeigt. ChildSprite.draw() wird aufgerufen, wodurch ein dunkelgelbes Quadrat anstelle des hellblauen aus mouseOverHandler() gezeichnet wird. Mit der Methode mouseDownHandler() werden auch ein mouseMove-Ereignis-Listener und ein mouseMoveHandler()-Abonnent (siehe Beschreibung unten) für die Verarbeitung der Mausbewegungen hinzugefügt. Als Nächstes wird die startDrag()-Methode aufgerufen, die das Ziehen des Sprite-Objekts ermöglicht.
    • mouseOut/mouseOutHandler(): Wird ausgelöst, wenn der Mauszeiger vom Quadrat wegbewegt wird. Die draw()-Methode wird aufgerufen, um die normale Größe und Farbe des Quadrats wiederherzustellen.
    • mouseOver/mouseOverHandler(): Wird ausgelöst, wenn sich der Mauszeiger über dem Quadrat befindet. Mit dieser Methode wird das Quadrat größer und mit dunkelgelber Hintergrundfarbe neu gezeichnet.
    • mouseUp/mouseUpHandler(): Wenn die Maustaste losgelassen wird, wird der mouseMove-Ereignis-Listener entfernt, und stopDrag wird aufgerufen. Hiermit wird das Quadrat an seiner Position fixiert.
    • mouseMove/mouseMoveHandler(): Wird als Teil der mouseDownHandler()-Funktion aufgerufen und ausgelöst, wenn der Benutzer die linke Maustaste gedrückt hält und das Quadrat zieht.
    • mouseWheel/mouseWheelHandler(): Wird ausgelöst, wenn der Benutzer das Mausrad dreht, während sich der Mauszeiger auf dem Quadrat befindet.
  3. Die ChildSprite-Instanz child wird der Anzeigeliste mithilfe der Methode addChild(), die ein sofortiges Zeichnen des orangefarbenen Quadrats bewirkt, hinzugefügt.

Hinweise:

  • Die MouseEventExample-Klasse muss der Dokumentenstamm sein.
  • Bei einigen der oben aufgeführten Ereignis-Listener-Methoden wird eine lokale sprite-Variable deklariert, der die Umwandlung von event.target in den Typ „Sprite“ zugewiesen wird.
package { import flash.display.Sprite; public class MouseEventExample extends Sprite { private var size:uint = 100; private var bgColor:uint = 0xFFCC00; public function MouseEventExample() { var child:ChildSprite = new ChildSprite(); addChild(child); } } } import flash.display.Sprite; import flash.events.MouseEvent; class ChildSprite extends Sprite { private var size:uint = 50; private var overSize:uint = 60; private var backgroundColor:uint = 0xFFCC00; private var overColor:uint = 0xCCFF00; private var downColor:uint = 0x00CCFF; public function ChildSprite() { draw(size, size, backgroundColor); doubleClickEnabled = true; addEventListener(MouseEvent.CLICK, clickHandler); addEventListener(MouseEvent.DOUBLE_CLICK, doubleClickHandler); addEventListener(MouseEvent.MOUSE_DOWN, mouseDownHandler); addEventListener(MouseEvent.MOUSE_OUT, mouseOutHandler); addEventListener(MouseEvent.MOUSE_OVER, mouseOverHandler); addEventListener(MouseEvent.MOUSE_UP, mouseUpHandler); addEventListener(MouseEvent.MOUSE_WHEEL, mouseWheelHandler); } private function draw(w:uint, h:uint, bgColor:uint):void { graphics.clear(); graphics.beginFill(bgColor); graphics.drawRect(0, 0, w, h); graphics.endFill(); } private function clickHandler(event:MouseEvent):void { trace("clickHandler"); } private function doubleClickHandler(event:MouseEvent):void { trace("doubleClickHandler"); } private function mouseDownHandler(event:MouseEvent):void { trace("mouseDownHandler"); draw(overSize, overSize, downColor); var sprite:Sprite = Sprite(event.target); sprite.addEventListener(MouseEvent.MOUSE_MOVE, mouseMoveHandler); sprite.startDrag(); } private function mouseMoveHandler(event:MouseEvent):void { trace("mouseMoveHandler"); event.updateAfterEvent(); } private function mouseOutHandler(event:MouseEvent):void { trace("mouseOutHandler"); draw(size, size, backgroundColor); } private function mouseOverHandler(event:MouseEvent):void { trace("mouseOverHandler"); draw(overSize, overSize, overColor); } private function mouseWheelHandler(event:MouseEvent):void { trace("mouseWheelHandler delta: " + event.delta); } private function mouseUpHandler(event:MouseEvent):void { trace("mouseUpHandler"); var sprite:Sprite = Sprite(event.target); sprite.removeEventListener(MouseEvent.MOUSE_MOVE, mouseMoveHandler); sprite.stopDrag(); draw(overSize, overSize, overColor); } }
clickflash.events:MouseEvent:CLICKflash.events:MouseEventflash.display.InteractiveObject.clickcontextMenuflash.events:MouseEvent:CONTEXT_MENUflash.events:MouseEventdoubleClickflash.events:MouseEvent:DOUBLE_CLICKflash.events:MouseEventflash.display.InteractiveObject.doubleClickmiddleClickflash.events:MouseEvent:MIDDLE_CLICKflash.events:MouseEventflash.display.InteractiveObject.middleClickmiddleMouseDownflash.events:MouseEvent:MIDDLE_MOUSE_DOWNflash.events:MouseEventflash.display.InteractiveObject.middleMouseDownmiddleMouseUpflash.events:MouseEvent:MIDDLE_MOUSE_UPflash.events:MouseEventflash.display.InteractiveObject.middleMouseUpmouseDownflash.events:MouseEvent:MOUSE_DOWNflash.events:MouseEventflash.display.InteractiveObject.mouseDownmouseMoveflash.events:MouseEvent:MOUSE_MOVEflash.events:MouseEvent Das folgende Beispiel ist ein einfaches Zeichenprogramm. Der Benutzer kann auf dem Haupt-Sprite-Objekt zeichnen oder auf einen kleineren rechteckigen Sprite-Objekt.

Im Konstruktor wird ein rechteckiges innerRect-Sprite-Objekt erstellt und der Linienstil wird auf grün eingestellt. Der Linienstil für das Zeichnen im MouseEvent_MOUSE_MOVEExample-Sprite-Container wird auf rot eingestellt. Separate Ereignis-Listeners für die MouseEvent.MOUSE_UP- und MouseEvent.MOUSE_DOWN-Ereignisse werden für das Haupt-Sprite-Objekt der Anwendung und das innerRect-Sprite-Objekt hinzugefügt. In beiden Fällen verschieben die Listener-Methoden für Mouse-Down-Ereignisse die aktuelle Zeichenposition zur Position des Mauszeigers und fügen einen Listener für das MouseEvent.MOUSE_MOVE-Ereignis hinzu. Wenn der Mauszeiger verschoben wird, folgen die aufgerufenen Listener-Methoden dem Zeiger und zeichnen mit der graphics.LineTo()-Methode eine Linie. (Hinweis: Das innerRect-Sprite-Objekt verdeckt die roten Linien des Haupt-Sprite-Objekts, die hinter dem Rechteck gezeichnet sind.) Wenn das MouseEvent.MOUSE_UP-Ereignis auftritt, wird der Listener für das MOUSE_MOVE-Ereignis entfernet und das Zeichnen wird beendet.

package { import flash.display.Sprite; import flash.display.Graphics; import flash.events.MouseEvent; public class MouseEvent_MOUSE_MOVEExample extends Sprite { private var innerRect:Sprite = new Sprite(); public function MouseEvent_MOUSE_MOVEExample() { graphics.lineStyle(3, 0xFF0000, 1); stage.addEventListener(MouseEvent.MOUSE_DOWN, mouseDownHandler); stage.addEventListener(MouseEvent.MOUSE_UP, mouseUpHandler); innerRect.graphics.lineStyle(1, 0x00FF00, 1); innerRect.graphics.beginFill(0xFFFFFF); innerRect.graphics.drawRect(10, 10, 200, 200); innerRect.graphics.endFill(); innerRect.addEventListener(MouseEvent.MOUSE_DOWN, innerRectMouseDownHandler); innerRect.addEventListener(MouseEvent.MOUSE_UP, innerRectMouseUpHandler); addChild(innerRect); } private function mouseDownHandler(event:MouseEvent):void { graphics.moveTo(event.stageX, event.stageY); stage.addEventListener(MouseEvent.MOUSE_MOVE, mouseMoveHandler); } private function mouseMoveHandler(event:MouseEvent):void { graphics.lineTo(event.stageX, event.stageY); } private function mouseUpHandler(event:MouseEvent):void { stage.removeEventListener(MouseEvent.MOUSE_MOVE, mouseMoveHandler); } private function innerRectMouseDownHandler(event:MouseEvent):void { innerRect.graphics.moveTo(event.localX, event.localY); innerRect.addEventListener(MouseEvent.MOUSE_MOVE, innerRectMouseMoveHandler); } private function innerRectMouseMoveHandler(event:MouseEvent):void { innerRect.graphics.lineTo(event.localX, event.localY); } private function innerRectMouseUpHandler(event:MouseEvent):void { innerRect.removeEventListener(MouseEvent.MOUSE_MOVE, innerRectMouseMoveHandler); } } }
flash.display.InteractiveObject.mouseMove
mouseOutflash.events:MouseEvent:MOUSE_OUTflash.events:MouseEventflash.display.InteractiveObject.mouseOutmouseOverflash.events:MouseEvent:MOUSE_OVERflash.events:MouseEventflash.display.InteractiveObject.mouseOvermouseUpflash.events:MouseEvent:MOUSE_UPflash.events:MouseEventflash.display.InteractiveObject.mouseUpmouseWheelflash.events:MouseEvent:MOUSE_WHEELflash.events:MouseEventflash.display.InteractiveObject.mouseWheelrightClickflash.events:MouseEvent:RIGHT_CLICKflash.events:MouseEventflash.display.InteractiveObject.rightClickRightMouseDownflash.events:MouseEvent:RIGHT_MOUSE_DOWNflash.events:MouseEventflash.display.InteractiveObject.rightMouseDownrightMouseUpflash.events:MouseEvent:RIGHT_MOUSE_UPflash.events:MouseEventflash.display.InteractiveObject.rightMouseUprollOutflash.events:MouseEvent:ROLL_OUTflash.events:MouseEventflash.display.InteractiveObject.rollOutrollOverflash.events:MouseEvent:ROLL_OVERflash.events:MouseEventflash.display.InteractiveObject.rollOverMouseEvent Erstellt ein Ereignisobjekt, das Informationen über Mausereignisse enthält.typeString Der Ereignistyp. Mögliche Werte sind: MouseEvent.CLICK, MouseEvent.DOUBLE_CLICK, MouseEvent.MOUSE_DOWN, MouseEvent.MOUSE_MOVE, MouseEvent.MOUSE_OUT, MouseEvent.MOUSE_OVER, MouseEvent.MOUSE_UP, MouseEvent.MIDDLE_CLICK, MouseEvent.MIDDLE_MOUSE_DOWN, MouseEvent.MIDDLE_MOUSE_UP, MouseEvent.RIGHT_CLICK, MouseEvent.RIGHT_MOUSE_DOWN, MouseEvent.RIGHT_MOUSE_UP, MouseEvent.MOUSE_WHEEL, MouseEvent.ROLL_OUT und MouseEvent.ROLL_OVER. bubblesBooleantrue Legt fest, ob das Ereignisobjekt an der Bubbling-Phase des Ereignisablaufs teilnimmt. cancelableBooleanfalseBestimmt, ob das Ereignisobjekt abgebrochen werden kann. localXNumberunknownDie horizontale Koordinate, an der das Ereignis aufgetreten ist, in Relation zum umgebenden Sprite. localYNumberunknownDie vertikale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden Sprite-Objekt steht. relatedObjectflash.display:InteractiveObjectnullDie andere InteractiveObject-Instanz, die von dem Ereignis betroffen ist. Wenn beispielsweise ein mouseOut-Ereignis auftritt, stellt relatedObject das Anzeigelistenobjekt dar, auf das das Zeigegerät jetzt zeigt. ctrlKeyBooleanfalseUnter Windows oder Linux wird damit angezeigt, ob die Strg-Taste aktiviert ist. Unter Mac OS wird damit angezeigt, ob die Ctrl-Taste oder die Befehlstaste aktiviert ist. altKeyBooleanfalseGibt an, ob die Alt-Taste aktiviert ist (nur Windows oder Linux). shiftKeyBooleanfalseGibt an, ob der Umschalttasten-Modifizierer aktiviert ist. buttonDownBooleanfalseGibt an, ob die primäre Maustaste gedrückt wird. deltaint0Gibt an, wie viele Zeilen pro Raststellung des Mausrads durchlaufen werden sollen. Ein positiver Deltawert bedeutet einen Bildlauf nach oben. Ein negativer Wert steht für einen Bildlauf nach unten. Typische Werte sind 1 bis 3, wobei ein schnellerer Bildlauf größere Werte zur Folge haben kann. Dieser Parameter wird nur für das Ereignis MouseEvent.mouseWheel verwendet. commandKeyBooleanfalse(nur AIR); gibt an, ob die Befehlstaste aktiviert ist (nur Mac). Dieser Parameter wird nur für die folgenden Ereignisse verwendet MouseEvent.click, MouseEvent.mouseDown, MouseEvent.mouseUp, MouseEvent.middleClick, MouseEvent.middleMouseDown, MouseEvent.middleMouseUp, MouseEvent.rightClick, MouseEvent.rightMouseDown, MouseEvent.rightMouseUp und MouseEvent.doubleClick. Dieser Parameter gilt nur für Adobe AIR. Setzen Sie ihn nicht für Flash Player-Inhalte. controlKeyBooleanfalse(nur AIR); gibt an, ob die Ctrl- oder Strg-Taste aktiviert ist. Dieser Parameter wird nur für die folgenden Ereignisse verwendet MouseEvent.click, MouseEvent.mouseDown, MouseEvent.mouseUp, MouseEvent.middleClick, MouseEvent.middleMouseDown, MouseEvent.middleMouseUp, MouseEvent.rightClick, MouseEvent.rightMouseDown, MouseEvent.rightMouseUp und MouseEvent.doubleClick. Dieser Parameter gilt nur für Adobe AIR. Setzen Sie ihn nicht für Flash Player-Inhalte. clickCountint0(nur AIR); gibt an, ob das Mausereignis Teil einer Sequenz mit mehreren Klicks ist oder nicht. Dieser Parameter hat den Wert null für alle Mausereignisse außer MouseEvent.mouseDown, MouseEvent.mouseUp, MouseEvent.middleMouseDown, MouseEvent.middleMouseUp, MouseEvent.rightMouseDown und MouseEvent.rightMouseUp. Das Warten auf einfache Klicks, Doppelklicks und Sequenzen mit mehreren Klicks ist mit dem clickCount-Parameter möglich. Dieser Parameter gilt nur für Adobe AIR. Setzen Sie ihn nicht für Flash Player-Inhalte. Konstruktor für MouseEvent-Objekte. Erstellt ein Ereignisobjekt, das Informationen über Mausereignisse enthält. Ereignisobjekte werden Ereignis-Listenern als Parameter übergeben. clone Erstellt eine Kopie des MouseEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.Ein neues MouseEvent-Objekt mit Eigenschaftswerten, die denen des Originals entsprechen. flash.events:Event Erstellt eine Kopie des MouseEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht. toString Gibt eine Zeichenfolge zurück, die alle Eigenschaften des MouseEvent-Objekts enthält.Eine Zeichenfolge, die alle Eigenschaften des MouseEvent-Objekts enthält. String Gibt eine Zeichenfolge zurück, die alle Eigenschaften des MouseEvent-Objekts enthält. Der String liegt im folgenden Format vor:

[MouseEvent type= value bubbles= value cancelable= value ... delta= value ]

updateAfterEvent Weist Flash Player oder Adobe AIR nach Abschluss der Verarbeitung dieses Ereignisses zur Wiedergabe an, wenn die Anzeigeliste geändert wurde. Weist Flash Player oder Adobe AIR nach Abschluss der Verarbeitung dieses Ereignisses zur Wiedergabe an, wenn die Anzeigeliste geändert wurde. CLICK Definiert den Wert der Eigenschaft type eines Klickereignisobjekts.clickString Definiert den Wert der Eigenschaft type eines click-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertaltKeytrue, wenn die Alt-Taste aktiv ist (Windows).bubblestruebuttonDownFür Klick-Ereignisse ist dieser Wert immer false.cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.commandKeytrue unter Mac OS, falls die Befehlstaste aktiviert ist; false, wenn sie deaktiviert ist. Unter Windows immer false controlKeytrue, wenn die Strg- oder Ctrl-Taste aktiv ist; false, wenn sie nicht aktiv ist.ctrlKeytrue unter Windows oder Linux, wenn die Strg-Taste aktiv ist. true unter Mac OS, falls die Strg-Taste oder die Befehlstaste aktiv ist. Andernfalls wird false zurückgegeben.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.localXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, in Relation zum umgebenden Sprite.localYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden Sprite-Objekt steht.shiftKeytrue, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist.stageXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.stageYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.targetDie InteractiveObject-Instanz unter dem Zeigegerät. Das unter target angegebene Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet.
flash.display.InteractiveObject.click
CONTEXT_MENU Die MouseEvent.CONTEXT_MENU-Konstante definiert den Wert der type-Eigenschaft eines contextMenu-Ereignisobjekts.contextMenuString Die MouseEvent.CONTEXT_MENU-Konstante definiert den Wert der type-Eigenschaft eines contextMenu-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertaltKeytrue, wenn die Alt-Taste aktiv ist (Windows).bubblestruebuttonDowntrue, wenn die rechte Maustaste gedrückt wird; andernfalls false.cancelablefalse. Das Standardverhalten kann nicht abgebrochen werden.commandKeytrue unter Mac OS, falls die Befehlstaste aktiviert ist; false, wenn sie deaktiviert ist. Unter Windows immer false controlKeytrue, wenn die Strg- oder Ctrl-Taste aktiv ist; false, wenn sie nicht aktiv ist.ctrlKeytrue unter Windows oder Linux, wenn die Strg-Taste aktiv ist. true unter Mac OS, falls die Strg-Taste oder die Befehlstaste aktiv ist. Andernfalls wird false zurückgegeben.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.localXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, in Relation zum umgebenden Sprite.localYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden Sprite-Objekt steht.shiftKeytrue, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist.clickCountAnzahl der Mausklicks, um anzuzeigen, ob das Ereignis Teil einer Sequenz mit mehreren Klicks ist.stageXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.stageYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.targetDie InteractiveObject-Instanz unter dem Zeigegerät. Das unter target angegebene Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet.
DOUBLE_CLICK Definiert den Wert der Eigenschaft type eines doubleClick-Ereignisobjekts.doubleClickString Definiert den Wert der Eigenschaft type eines doubleClick-Ereignisobjekts. Die doubleClickEnabled-Eigenschaft muss true sein, damit ein Objekt das doubleClick-Ereignis auslösen kann.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertaltKeytrue, wenn die Alt-Taste aktiv ist (Windows).bubblestruebuttonDownFür Doppelklick-Ereignisse ist dieser Wert immer false.cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.commandKeytrue unter Mac OS, falls die Befehlstaste aktiviert ist; false, wenn sie deaktiviert ist. Unter Windows immer false controlKeytrue, wenn die Strg- oder Ctrl-Taste aktiv ist; false, wenn sie nicht aktiv ist.ctrlKeytrue unter Windows oder Linux, wenn die Strg-Taste aktiv ist. true unter Mac OS, falls die Strg-Taste oder die Befehlstaste aktiv ist. Andernfalls wird false zurückgegeben.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.localXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, in Relation zum umgebenden Sprite.localYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden Sprite-Objekt steht.shiftKeytrue, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist.stageXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.stageYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.targetDie InteractiveObject-Instanz unter dem Zeigegerät. Das unter target angegebene Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet.
flash.display.InteractiveObject.doubleClick
MIDDLE_CLICK Definiert den Wert der type-Eigenschaft eines middleClick-Ereignisobjekts.middleClickString Definiert den Wert der type-Eigenschaft eines middleClick-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertaltKeytrue, wenn die Alt-Taste aktiv ist (Windows).bubblestruebuttonDownFür Mittelklick-Ereignisse ist diese Eigenschaft immer false.cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.commandKeytrue unter Mac OS, falls die Befehlstaste aktiviert ist; false, wenn sie deaktiviert ist. Unter Windows immer false controlKeytrue, wenn die Strg- oder Ctrl-Taste aktiv ist; false, wenn sie nicht aktiv ist.ctrlKeytrue unter Windows oder Linux, wenn die Strg-Taste aktiv ist. true unter Mac OS, falls die Strg-Taste oder die Befehlstaste aktiv ist. Andernfalls wird false zurückgegeben.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.localXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, in Relation zum umgebenden Sprite.localYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden Sprite-Objekt steht.shiftKeytrue, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist.stageXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.stageYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.targetDie InteractiveObject-Instanz unter dem Zeigegerät. Das unter target angegebene Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet.
flash.display.InteractiveObject.middleClick
MIDDLE_MOUSE_DOWN Definiert den Wert der type-Eigenschaft eines middleMouseDown-Ereignisobjekts.middleMouseDownString Definiert den Wert der type-Eigenschaft eines middleMouseDown-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertaltKeytrue, wenn die Alt-Taste aktiv ist (Windows).bubblestruebuttonDowntrue, wenn die mittlere Maustaste gedrückt wird; andernfalls false.cancelablefalse. Das Standardverhalten kann nicht abgebrochen werden.commandKeytrue unter Mac OS, falls die Befehlstaste aktiviert ist; false, wenn sie deaktiviert ist. Unter Windows immer false controlKeytrue, wenn die Strg- oder Ctrl-Taste aktiv ist; false, wenn sie nicht aktiv ist.ctrlKeytrue unter Windows oder Linux, wenn die Strg-Taste aktiv ist. true unter Mac OS, falls die Strg-Taste oder die Befehlstaste aktiv ist. Andernfalls wird false zurückgegeben.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.localXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, in Relation zum umgebenden Sprite.localYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden Sprite-Objekt steht.shiftKeytrue, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist.clickCountAnzahl der Mausklicks, um anzuzeigen, ob das Ereignis Teil einer Sequenz mit mehreren Klicks ist.stageXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.stageYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.targetDie InteractiveObject-Instanz unter dem Zeigegerät. Das unter target angegebene Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet.
flash.display.InteractiveObject.middleMouseDown
MIDDLE_MOUSE_UP Definiert den Wert der type-Eigenschaft eines middleMouseUp-Ereignisobjekts.middleMouseUpString Definiert den Wert der type-Eigenschaft eines middleMouseUp-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertaltKeytrue, wenn die Alt-Taste aktiv ist (Windows).bubblestruebuttonDowntrue, wenn die mittlere Maustaste gedrückt wird; andernfalls false.cancelablefalse. Das Standardverhalten kann nicht abgebrochen werden.commandKeytrue unter Mac OS, falls die Befehlstaste aktiviert ist; false, wenn sie deaktiviert ist. Unter Windows immer false controlKeytrue, wenn die Strg- oder Ctrl-Taste aktiv ist; false, wenn sie nicht aktiv ist.ctrlKeytrue unter Windows oder Linux, wenn die Strg-Taste aktiv ist. true unter Mac OS, falls die Strg-Taste oder die Befehlstaste aktiv ist. Andernfalls wird false zurückgegeben.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.localXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, in Relation zum umgebenden Sprite.localYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden Sprite-Objekt steht.shiftKeytrue, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist.clickCountAnzahl der Mausklicks, um anzuzeigen, ob das Ereignis Teil einer Sequenz mit mehreren Klicks ist.stageXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.stageYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.targetDie InteractiveObject-Instanz unter dem Zeigegerät. Das unter target angegebene Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet.
flash.display.InteractiveObject.middleMouseUp
MOUSE_DOWN Definiert den Wert der Eigenschaft type eines mouseDown-Ereignisobjekts.mouseDownString Definiert den Wert der Eigenschaft type eines mouseDown-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertaltKeytrue, wenn die Alt-Taste aktiv ist (Windows).bubblestruebuttonDowntrue, wenn die primäre Maustaste gedrückt wird; andernfalls false.cancelablefalse. Das Standardverhalten kann nicht abgebrochen werden.commandKeytrue unter Mac OS, falls die Befehlstaste aktiviert ist; false, wenn sie deaktiviert ist. Unter Windows immer false controlKeytrue, wenn die Strg- oder Ctrl-Taste aktiv ist; false, wenn sie nicht aktiv ist.ctrlKeytrue unter Windows und Linux, wenn die Strg-Taste aktiv ist. true unter Mac OS, falls die Strg-Taste oder die Befehlstaste aktiv ist. Andernfalls wird false zurückgegeben.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.localXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, in Relation zum umgebenden Sprite.localYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden Sprite-Objekt steht.shiftKeytrue, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist.clickCountAnzahl der Mausklicks, um anzuzeigen, ob das Ereignis Teil einer Sequenz mit mehreren Klicks ist.stageXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.stageYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.targetDie InteractiveObject-Instanz unter dem Zeigegerät. Das unter target angegebene Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet.
Die Verwendung dieser Konstante wird im Beispiel für die MOUSE_MOVE-Konstante veranschaulicht.
flash.display.InteractiveObject.mouseDown
MOUSE_MOVE Definiert den Wert der Eigenschaft type eines mouseMove-Ereignisobjekts.mouseMoveString Definiert den Wert der Eigenschaft type eines mouseMove-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertaltKeytrue, wenn die Alt-Taste aktiv ist (Windows).bubblestruebuttonDowntrue, wenn die primäre Maustaste gedrückt wird; andernfalls false.cancelablefalse. Das Standardverhalten kann nicht abgebrochen werden.commandKeytrue unter Mac OS, falls die Befehlstaste aktiviert ist; false, wenn sie deaktiviert ist. Unter Windows immer false controlKeytrue, wenn die Strg- oder Ctrl-Taste aktiv ist; false, wenn sie nicht aktiv ist.ctrlKeytrue unter Windows oder Linux, wenn die Strg-Taste aktiv ist. true unter Mac OS, falls die Strg-Taste oder die Befehlstaste aktiv ist. Andernfalls wird false zurückgegeben.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.localXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, in Relation zum umgebenden Sprite.localYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden Sprite-Objekt steht.shiftKeytrue, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist.stageXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.stageYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.targetDie InteractiveObject-Instanz unter dem Zeigegerät. Das unter target angegebene Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet.
Das folgende Beispiel ist ein einfaches Zeichenprogramm. Der Benutzer kann auf dem Haupt-Sprite-Objekt zeichnen oder auf einen kleineren rechteckigen Sprite-Objekt.

Im Konstruktor wird ein rechteckiges innerRect-Sprite-Objekt erstellt und der Linienstil wird auf grün eingestellt. Der Linienstil für das Zeichnen im MouseEvent_MOUSE_MOVEExample-Sprite-Container wird auf rot eingestellt. Separate Ereignis-Listeners für die MouseEvent.MOUSE_UP- und MouseEvent.MOUSE_DOWN-Ereignisse werden für das Haupt-Sprite-Objekt der Anwendung und das innerRect-Sprite-Objekt hinzugefügt. In beiden Fällen verschieben die Listener-Methoden für Mouse-Down-Ereignisse die aktuelle Zeichenposition zur Position des Mauszeigers und fügen einen Listener für das MouseEvent.MOUSE_MOVE-Ereignis hinzu. Wenn der Mauszeiger verschoben wird, folgen die aufgerufenen Listener-Methoden dem Zeiger und zeichnen mit der graphics.LineTo()-Methode eine Linie. (Hinweis: Das innerRect-Sprite-Objekt verdeckt die roten Linien des Haupt-Sprite-Objekts, die hinter dem Rechteck gezeichnet sind.) Wenn das MouseEvent.MOUSE_UP-Ereignis auftritt, wird der Listener für das MOUSE_MOVE-Ereignis entfernet und das Zeichnen wird beendet.

package { import flash.display.Sprite; import flash.display.Graphics; import flash.events.MouseEvent; public class MouseEvent_MOUSE_MOVEExample extends Sprite { private var innerRect:Sprite = new Sprite(); public function MouseEvent_MOUSE_MOVEExample() { graphics.lineStyle(3, 0xFF0000, 1); stage.addEventListener(MouseEvent.MOUSE_DOWN, mouseDownHandler); stage.addEventListener(MouseEvent.MOUSE_UP, mouseUpHandler); innerRect.graphics.lineStyle(1, 0x00FF00, 1); innerRect.graphics.beginFill(0xFFFFFF); innerRect.graphics.drawRect(10, 10, 200, 200); innerRect.graphics.endFill(); innerRect.addEventListener(MouseEvent.MOUSE_DOWN, innerRectMouseDownHandler); innerRect.addEventListener(MouseEvent.MOUSE_UP, innerRectMouseUpHandler); addChild(innerRect); } private function mouseDownHandler(event:MouseEvent):void { graphics.moveTo(event.stageX, event.stageY); stage.addEventListener(MouseEvent.MOUSE_MOVE, mouseMoveHandler); } private function mouseMoveHandler(event:MouseEvent):void { graphics.lineTo(event.stageX, event.stageY); } private function mouseUpHandler(event:MouseEvent):void { stage.removeEventListener(MouseEvent.MOUSE_MOVE, mouseMoveHandler); } private function innerRectMouseDownHandler(event:MouseEvent):void { innerRect.graphics.moveTo(event.localX, event.localY); innerRect.addEventListener(MouseEvent.MOUSE_MOVE, innerRectMouseMoveHandler); } private function innerRectMouseMoveHandler(event:MouseEvent):void { innerRect.graphics.lineTo(event.localX, event.localY); } private function innerRectMouseUpHandler(event:MouseEvent):void { innerRect.removeEventListener(MouseEvent.MOUSE_MOVE, innerRectMouseMoveHandler); } } }
flash.display.InteractiveObject.mouseMove
MOUSE_OUT Definiert den Wert der Eigenschaft type eines mouseOut-Ereignisobjekts.mouseOutString Definiert den Wert der Eigenschaft type eines mouseOut-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertaltKeytrue, wenn die Alt-Taste aktiv ist (Windows).bubblestruebuttonDowntrue, wenn die primäre Maustaste gedrückt wird; andernfalls false.cancelablefalse. Das Standardverhalten kann nicht abgebrochen werden.commandKeytrue unter Mac OS, falls die Befehlstaste aktiviert ist; false, wenn sie deaktiviert ist. Unter Windows immer false controlKeytrue, wenn die Strg- oder Ctrl-Taste aktiv ist; false, wenn sie nicht aktiv ist.ctrlKeytrue unter Windows oder Linux, wenn die Strg-Taste aktiv ist. true unter Mac OS, falls die Strg-Taste oder die Befehlstaste aktiv ist. Andernfalls wird false zurückgegeben.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.relatedObjectDas Anzeigelistenobjekt, auf das das Zeigegerät jetzt zeigt.localXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, in Relation zum umgebenden Sprite.localYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden Sprite-Objekt steht.shiftKeytrue, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist.stageXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.stageYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.targetDie InteractiveObject-Instanz unter dem Zeigegerät. Das unter target angegebene Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet.
flash.display.InteractiveObject.mouseOut
MOUSE_OVER Definiert den Wert der Eigenschaft type eines mouseOver-Ereignisobjekts.mouseOverString Definiert den Wert der Eigenschaft type eines mouseOver-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertaltKeytrue, wenn die Alt-Taste aktiv ist (Windows).bubblestruebuttonDowntrue, wenn die primäre Maustaste gedrückt wird; andernfalls false.cancelablefalse. Das Standardverhalten kann nicht abgebrochen werden.commandKeytrue unter Mac OS, falls die Befehlstaste aktiviert ist; false, wenn sie deaktiviert ist. Unter Windows immer false controlKeytrue, wenn die Strg- oder Ctrl-Taste aktiv ist; false, wenn sie nicht aktiv ist.ctrlKeytrue unter Windows oder Linux, wenn die Strg-Taste aktiv ist. true unter Mac OS, falls die Strg-Taste oder die Befehlstaste aktiv ist. Andernfalls wird false zurückgegeben.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.relatedObjectDas Anzeigelistenobjekt, auf das das Zeigegerät gezeigt hat.localXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, in Relation zum umgebenden Sprite.localYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden Sprite-Objekt steht.shiftKeytrue, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist.stageXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.stageYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.targetDie InteractiveObject-Instanz unter dem Zeigegerät. Das unter target angegebene Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet.
flash.display.InteractiveObject.mouseOver
MOUSE_UP Definiert den Wert der Eigenschaft type eines mouseUp-Ereignisobjekts.mouseUpString Definiert den Wert der Eigenschaft type eines mouseUp-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertaltKeytrue, wenn die Alt-Taste aktiv ist (Windows).bubblestruebuttonDowntrue, wenn die primäre Maustaste gedrückt wird; andernfalls false.cancelablefalse. Das Standardverhalten kann nicht abgebrochen werden.commandKeytrue unter Mac OS, falls die Befehlstaste aktiviert ist; false, wenn sie deaktiviert ist. Unter Windows immer false controlKeytrue, wenn die Strg- oder Ctrl-Taste aktiv ist; false, wenn sie nicht aktiv ist.ctrlKeytrue unter Windows oder Linux, wenn die Strg-Taste aktiv ist. true unter Mac OS, falls die Strg-Taste oder die Befehlstaste aktiv ist. Andernfalls wird false zurückgegeben.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.localXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, in Relation zum umgebenden Sprite.localYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden Sprite-Objekt steht.shiftKeytrue, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist.clickCountAnzahl der Mausklicks, um anzuzeigen, ob das Ereignis Teil einer Sequenz mit mehreren Klicks ist.stageXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.stageYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.targetDie InteractiveObject-Instanz unter dem Zeigegerät. Das unter target angegebene Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet.
Die Verwendung dieser Konstante wird im Beispiel für die MOUSE_MOVE-Konstante veranschaulicht.
flash.display.InteractiveObject.mouseUp
MOUSE_WHEEL Definiert den Wert der Eigenschaft type eines mouseWheel-Ereignisobjekts.mouseWheelString Definiert den Wert der Eigenschaft type eines mouseWheel-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertaltKeytrue, wenn die Alt-Taste aktiv ist (Windows).bubblestruebuttonDowntrue, wenn die primäre Maustaste gedrückt wird; andernfalls false.cancelablefalse. Das Standardverhalten kann nicht abgebrochen werden.commandKeytrue unter Mac OS, falls die Befehlstaste aktiviert ist; false, wenn sie deaktiviert ist. Unter Windows immer false controlKeytrue, wenn die Strg- oder Ctrl-Taste aktiv ist; false, wenn sie nicht aktiv ist.ctrlKeytrue unter Windows oder Linux, wenn die Strg-Taste aktiv ist. true unter Mac OS, falls die Strg-Taste oder die Befehlstaste aktiv ist. Andernfalls wird false zurückgegeben.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.deltaDie Anzahl der Zeilen, die jede Raststellung im Mausrad repräsentiert.localXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, in Relation zum umgebenden Sprite.localYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden Sprite-Objekt steht.shiftKeytrue, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist.stageXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.stageYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.targetDie InteractiveObject-Instanz unter dem Zeigegerät. Das unter target angegebene Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet.
flash.display.InteractiveObject.mouseWheel
RIGHT_CLICK Definiert den Wert der type-Eigenschaft eines rightClick-Ereignisobjekts.rightClickString Definiert den Wert der type-Eigenschaft eines rightClick-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertaltKeytrue, wenn die Alt-Taste aktiv ist (Windows).bubblestruebuttonDownFür Rechtsklick-Ereignisse ist diese Eigenschaft immer false.cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.commandKeytrue unter Mac OS, falls die Befehlstaste aktiviert ist; false, wenn sie deaktiviert ist. Unter Windows immer false controlKeytrue, wenn die Strg- oder Ctrl-Taste aktiv ist; false, wenn sie nicht aktiv ist.ctrlKeytrue unter Windows oder Linux, wenn die Strg-Taste aktiv ist. true unter Mac OS, falls die Strg-Taste oder die Befehlstaste aktiv ist. Andernfalls wird false zurückgegeben.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.localXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, in Relation zum umgebenden Sprite.localYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden Sprite-Objekt steht.shiftKeytrue, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist.stageXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.stageYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.targetDie InteractiveObject-Instanz unter dem Zeigegerät. Das unter target angegebene Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet.
flash.display.InteractiveObject.rightClick
RIGHT_MOUSE_DOWN Definiert den Wert der type-Eigenschaft eines rightMouseDown-Ereignisobjekts.rightMouseDownString Definiert den Wert der type-Eigenschaft eines rightMouseDown-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertaltKeytrue, wenn die Alt-Taste aktiv ist (Windows).bubblestruebuttonDownFür Rechtsklick-Ereignisse ist diese Eigenschaft immer true.cancelablefalse. Das Standardverhalten kann nicht abgebrochen werden.commandKeytrue unter Mac OS, falls die Befehlstaste aktiviert ist; false, wenn sie deaktiviert ist. Unter Windows immer false controlKeytrue, wenn die Strg- oder Ctrl-Taste aktiv ist; false, wenn sie nicht aktiv ist.ctrlKeytrue unter Windows oder Linux, wenn die Strg-Taste aktiv ist. true unter Mac OS, falls die Strg-Taste oder die Befehlstaste aktiv ist. Andernfalls wird false zurückgegeben.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.localXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, in Relation zum umgebenden Sprite.localYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden Sprite-Objekt steht.shiftKeytrue, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist.clickCountAnzahl der Mausklicks, um anzuzeigen, ob das Ereignis Teil einer Sequenz mit mehreren Klicks ist.stageXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.stageYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.targetDie InteractiveObject-Instanz unter dem Zeigegerät. Das unter target angegebene Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet.
flash.display.InteractiveObject.rightMouseDown
RIGHT_MOUSE_UP Definiert den Wert der type-Eigenschaft eines rightMouseUp-Ereignisobjekts.rightMouseUpString Definiert den Wert der type-Eigenschaft eines rightMouseUp-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertaltKeytrue, wenn die Alt-Taste aktiv ist (Windows).bubblestruebuttonDowntrue, wenn die rechte Maustaste gedrückt wird; andernfalls false.cancelablefalse. Das Standardverhalten kann nicht abgebrochen werden.commandKeytrue unter Mac OS, falls die Befehlstaste aktiviert ist; false, wenn sie deaktiviert ist. Unter Windows immer false controlKeytrue, wenn die Strg- oder Ctrl-Taste aktiv ist; false, wenn sie nicht aktiv ist.ctrlKeytrue unter Windows oder Linux, wenn die Strg-Taste aktiv ist. true unter Mac OS, falls die Strg-Taste oder die Befehlstaste aktiv ist. Andernfalls wird false zurückgegeben.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.localXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, in Relation zum umgebenden Sprite.localYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden Sprite-Objekt steht.shiftKeytrue, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist.clickCountAnzahl der Mausklicks, um anzuzeigen, ob das Ereignis Teil einer Sequenz mit mehreren Klicks ist.stageXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.stageYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.targetDie InteractiveObject-Instanz unter dem Zeigegerät. Das unter target angegebene Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet.
flash.display.InteractiveObject.rightMouseUp
ROLL_OUT Definiert den Wert der Eigenschaft type eines rollOut-Ereignisobjekts.rollOutString Definiert den Wert der Eigenschaft type eines rollOut-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertaltKeytrue, wenn die Alt-Taste aktiv ist (Windows).bubblesfalsebuttonDowntrue, wenn die primäre Maustaste gedrückt wird; andernfalls false.cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.commandKeytrue unter Mac OS, falls die Befehlstaste aktiviert ist; false, wenn sie deaktiviert ist. Unter Windows immer false controlKeytrue, wenn die Strg- oder Ctrl-Taste aktiv ist; false, wenn sie nicht aktiv ist.ctrlKeytrue unter Windows oder Linux, wenn die Strg-Taste aktiv ist. true unter Mac OS, falls die Strg-Taste oder die Befehlstaste aktiv ist. Andernfalls wird false zurückgegeben.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.relatedObjectDas Anzeigelistenobjekt, auf das das Zeigegerät jetzt zeigt.localXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, in Relation zum umgebenden Sprite.localYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden Sprite-Objekt steht.shiftKeytrue, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist.stageXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.stageYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.targetDie InteractiveObject-Instanz unter dem Zeigegerät. Das unter target angegebene Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet.
flash.display.InteractiveObject.rollOut
ROLL_OVER Definiert den Wert der Eigenschaft type eines rollOver-Ereignisobjekts.rollOverString Definiert den Wert der Eigenschaft type eines rollOver-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertaltKeytrue, wenn die Alt-Taste aktiv ist (Windows).bubblesfalsebuttonDowntrue, wenn die primäre Maustaste gedrückt wird; andernfalls false.cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.commandKeytrue unter Mac OS, falls die Befehlstaste aktiviert ist; false, wenn sie deaktiviert ist. Unter Windows immer false controlKeytrue, wenn die Strg- oder Ctrl-Taste aktiv ist; false, wenn sie nicht aktiv ist.ctrlKeytrue unter Windows oder Linux, wenn die Strg-Taste aktiv ist. true unter Mac OS, falls die Strg-Taste oder die Befehlstaste aktiv ist. Andernfalls wird false zurückgegeben.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.relatedObjectDas Anzeigelistenobjekt, auf das das Zeigegerät gezeigt hat.localXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, in Relation zum umgebenden Sprite.localYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden Sprite-Objekt steht.shiftKeytrue, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist.stageXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.stageYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.targetDie InteractiveObject-Instanz unter dem Zeigegerät. Das unter target angegebene Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet.
flash.display.InteractiveObject.rollOver
altKey Gibt an, ob die Alt-Taste aktiviert (true) oder deaktiviert (false) ist.Boolean Gibt an, ob die Alt-Taste aktiviert (true) oder deaktiviert (false) ist. Wird nur für Windows unterstützt. Unter anderen Betriebssystemen ist diese Eigenschaft immer auf false gesetzt. buttonDown Gibt an, ob die primäre Maustaste gedrückt (true) ist oder nicht (false).Boolean Gibt an, ob die primäre Maustaste gedrückt (true) ist oder nicht (false). clickCount Gibt an, ob das Mouse-Down-Ereignis Teil einer Sequenz mit mehreren Klicks ist oder nicht.int Gibt an, ob das Mouse-Down-Ereignis Teil einer Sequenz mit mehreren Klicks ist oder nicht. Dieser Parameter hat den Wert null für alle Mausereignisse außer MouseEvent.mouseDown, MouseEvent.mouseUp, MouseEvent.middleMouseDown, MouseEvent.middleMouseUp, MouseEvent.rightMouseDown und MouseEvent.rightMouseUp. Das Warten auf einfache Klicks, Doppelklicks und Sequenzen mit mehreren Klicks ist mit dem clickCount-Parameter möglich. Zum Beispiel haben die ersten Ereignisse MouseEvent.mouseDown und MouseEvent.mouseUp für clickCount den Wert 1 und die zweiten MouseEvent.mouseDown- und MouseEvent.mouseUp-Ereignisse in einer Doppelklicksequenz haben für clickCount den Wert 2. Wenn die Maus ausreichend bewegt wird oder die Mehrfachklicksequenz unterbrochen wird, hat das nächste MouseEvent.mouseDown für clickCount den Wert 1. Das doubleClick-Ereignis wird weiterhin wie erwartet ausgelöst. commandKey Gibt an, ob die Befehlstaste aktiviert ist (nur Mac). Der Wert der commandKey-Eigenschaft hat denselben Wert wie die ctrlKey-Eigenschaft auf dem Mac.Boolean Gibt an, ob die Befehlstaste aktiviert ist (nur Mac).

Der Wert der commandKey-Eigenschaft hat denselben Wert wie die ctrlKey-Eigenschaft auf dem Mac. Ist unter Windows und Linux immer „false“.

controlKey Gibt an, ob unter Mac OS die Ctrl-Taste oder unter Windows oder Linux die Strg-Taste aktiviert ist.Boolean Gibt an, ob unter Mac OS die Ctrl-Taste oder unter Windows oder Linux die Strg-Taste aktiviert ist. ctrlKey Gibt unter Windows oder Linux an, ob die Strg-Taste aktiviert (true) oder deaktiviert (false) ist.Boolean Gibt unter Windows oder Linux an, ob die Strg-Taste aktiviert (true) oder deaktiviert (false) ist. Unter Mac wird damit angezeigt, ob die Ctrl-Taste oder die Befehlstaste aktiviert ist. delta Gibt an, wie viele Zeilen pro Raststellung des Mausrads durchlaufen werden sollen.int Gibt an, wie viele Zeilen pro Raststellung des Mausrads durchlaufen werden sollen. Ein positiver Deltawert bedeutet einen Bildlauf nach oben. Ein negativer Wert steht für einen Bildlauf nach unten. Typische Werte sind 1 bis 3, wobei ein schnellerer Bildlauf größere Werte zur Folge haben kann. Diese Einstellung hängt von dem Gerät und dem Betriebssystem ab und wird in der Regel vom Benutzer eingestellt. Diese Eigenschaft gilt nur für das Ereignis MouseEvent.mouseWheel. isRelatedObjectInaccessible Falls „true“, ist die relatedObject-Eigenschaft aus Gründen, die mit der Sicherheitssandbox zusammenhängen, auf null gesetzt.Boolean Wenn true, ist die relatedObject-Eigenschaft aus Gründen, die mit der Sicherheitssandbox zusammenhängen, auf null gesetzt. Ist der Nominalwert von relatedObject ein Verweis auf ein DisplayObject in einer anderen Sandbox, wird relatedObject auf null gesetzt, es sei denn, die Berechtigung gilt über die Sandboxgrenzen hinweg für beide Richtungen. Die Berechtigung wird eingerichtet, indem aus einer SWF-Datei Security.allowDomain() aufgerufen wird oder eine Richtliniendatei vom Server einer Bilddatei bereitgestellt und die LoaderContext.checkPolicyFile-Eigenschaft beim Laden des Bilds gesetzt wird. MouseEvent.relatedObjectSecurity.allowDomain()LoaderContext.checkPolicyFilelocalX Die horizontale Koordinate, an der das Ereignis aufgetreten ist, in Relation zum umgebenden Sprite.Number Die horizontale Koordinate, an der das Ereignis aufgetreten ist, in Relation zum umgebenden Sprite. Die Verwendung dieser Eigenschaft wird im Beispiel für die MOUSE_MOVE-Konstante veranschaulicht. localY Die vertikale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden Sprite-Objekt steht.Number Die vertikale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden Sprite-Objekt steht. Die Verwendung dieser Eigenschaft wird im Beispiel für die MOUSE_MOVE-Konstante veranschaulicht. relatedObject Ein Verweis auf ein Anzeigelistenobjekt, das in Relation zum Ereignis steht.flash.display:InteractiveObject Ein Verweis auf ein Anzeigelistenobjekt, das in Relation zum Ereignis steht. Wenn beispielsweise ein mouseOut-Ereignis auftritt, stellt relatedObject das Anzeigelistenobjekt dar, auf das das Zeigegerät jetzt zeigt. Diese Eigenschaft gilt für die Ereignisse mouseOut, mouseOver, rollOut und rollOver.

Der Wert dieser Eigenschaft kann in zwei Fällen null sein: Wenn es kein verwandtes Objekt gibt oder wenn es eines gibt, dieses aber eine Sicherheitssandbox ist, auf die Sie keinen Zugriff haben. Verwenden Sie die isRelatedObjectInaccessible()-Eigenschaft, um festzustellen, welcher dieser Gründe zutrifft.

MouseEvent.isRelatedObjectInaccessible
shiftKey Gibt an, ob die Umschalttaste aktiviert (true) oder deaktiviert (false) ist.Boolean Gibt an, ob die Umschalttaste aktiviert (true) oder deaktiviert (false) ist. stageX Die horizontale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.Number Die horizontale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten. Diese Eigenschaft wird berechnet, wenn die Eigenschaft localX eingerichtet wird. Die Verwendung dieser Eigenschaft wird im Beispiel für die MOUSE_MOVE-Konstante veranschaulicht. stageY Die vertikale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.Number Die vertikale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten. Diese Eigenschaft wird berechnet, wenn die Eigenschaft localY eingerichtet wird. Die Verwendung dieser Eigenschaft wird im Beispiel für die MOUSE_MOVE-Konstante veranschaulicht.
IEventDispatcher Die IEventDispatcher-Schnittstelle definiert Methoden zum Hinzufügen bzw. Entfernen von Ereignis-Listenern, prüft, ob bestimmte Typen von Ereignis-Listenern registriert sind und löst Ereignisse aus. Die IEventDispatcher-Schnittstelle definiert Methoden zum Hinzufügen bzw. Entfernen von Ereignis-Listenern, prüft, ob bestimmte Typen von Ereignis-Listenern registriert sind und löst Ereignisse aus.

Ereignisziele sind ein wichtiger Bestandteil des Ereignismodells in Flash® Player und Adobe AIR. Das Ereignisziel dient als zentraler Punkt bei dem Ablauf der Ereignisse durch die Hierarchie der Anzeigeliste. Wenn ein Ereignis wie ein Mausklick oder ein Tastenanschlag eintritt, wird vom Root der Anzeigeliste aus ein Ereignisobjekt in den Ereignisablauf gesendet. Dieser Weg zum Ereignisziel und zurück ist im Prinzip in drei Phasen unterteilt: die Aufnahmephase umfasst den Weg vom Root zum letzten Knoten vor dem Ereigniszielknoten, die Zielphase umfasst nur den Ereigniszielknoten, und die Bubbling-Phase umfasst alle weiteren Knoten, auf die das Objekt auf dem Rückweg zum Root der Anzeigeliste trifft.

Im Allgemeinen besteht der einfachste Weg für eine benutzerdefinierte Klasse, die Fähigkeit zum Auslösen eines Ereignisses zu erhalten darin, die EventDispatcher-Klasse zu erweitern. Wenn dies nicht möglich ist (d. h., wenn die Klasse bereits eine andere Klasse erweitert), können Sie stattdessen die IEventDispatcher-Schnittstelle implementieren, ein EventDispatcher-Mitglied erstellen und einfache Hooks schreiben, um alle Aufrufe an einen aggregierten EventDispatcher zu leiten.

Im folgenden Beispiel wird anhand der Klassen IEventDispatcherExample und DecoratedDispatcher erläutert, wie die IEventDispatcher-Klasse implementiert und verwendet werden kann. Im Beispiel wird jede DecoratedDispatcher-Methode auf die gleiche Weise wie bei EventDispatcher implementiert. Innerhalb des Kontruktors für IEventDispatcherExample wird eine neue Instanz (decorDispatcher) der DecoratedDispatcher-Klasse erstellt, und die Variable decorDispatcher wird verwendet, um addEventListener() zusammen mit dem benutzerdefinierten doSomething-Ereignis aufzurufen. Letzteres wird im Anschluss von didSomething() verarbeitet, und es wird eine Textzeile unter Verwendung von trace() gedruckt. package { import flash.events.Event; import flash.display.Sprite; public class IEventDispatcherExample extends Sprite { public function IEventDispatcherExample() { var decorDispatcher:DecoratedDispatcher = new DecoratedDispatcher(); decorDispatcher.addEventListener("doSomething", didSomething); decorDispatcher.dispatchEvent(new Event("doSomething")); } public function didSomething(evt:Event):void { trace(">> didSomething"); } } } import flash.events.IEventDispatcher; import flash.events.EventDispatcher; import flash.events.Event; class DecoratedDispatcher implements IEventDispatcher { private var dispatcher:EventDispatcher; public function DecoratedDispatcher() { dispatcher = new EventDispatcher(this); } public function addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void{ dispatcher.addEventListener(type, listener, useCapture, priority); } public function dispatchEvent(evt:Event):Boolean{ return dispatcher.dispatchEvent(evt); } public function hasEventListener(type:String):Boolean{ return dispatcher.hasEventListener(type); } public function removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void{ dispatcher.removeEventListener(type, listener, useCapture); } public function willTrigger(type:String):Boolean { return dispatcher.willTrigger(type); } }
addEventListener Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird.typeStringDer Typ des Ereignisses. listenerFunctionDie 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.
useCaptureBooleanfalseBestimmt, 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. priorityint0Die 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. useWeakReferenceBooleanfalseBestimmt, 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.

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

dispatchEvent Sendet ein Ereignis in den Ereignisablauf.Der Wert true (sofern nicht preventDefault()) wird bei dem Ereignis aufgerufen. In diesem Fall wird false zurückgegeben. Booleaneventflash.events:EventDas Ereignisobjekt, das in den Ereignisablauf gesendet wird. Sendet ein Ereignis in den Ereignisablauf. Das Ereignisziel ist das EventDispatcher-Objekt, für das die Methode dispatchEvent() aufgerufen wird. hasEventListener Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.Der Wert true, wenn ein Listener des angegebenen Typs registriert ist; andernfalls false. BooleantypeStringDer Typ des Ereignisses. Ü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.

willTrigger()
removeEventListener Entfernt einen Listener aus dem EventDispatcher-Objekt.typeStringDer Typ des Ereignisses. listenerFunctionDas zu entfernende Listener-Objekt. useCaptureBooleanfalseGibt 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. Entfernt einen Listener aus dem EventDispatcher-Objekt. Wenn kein entsprechender Listener mit dem EventDispatcher-Objekt registriert ist, hat ein Aufruf dieser Methode keine Auswirkungen. willTrigger Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner übergeordneten Objekte ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist.Der Wert true, wenn ein Listener des angegebenen Typs ausgelöst wird; andernfalls false. BooleantypeStringDer Typ des Ereignisses. Ü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.

SQLErrorEvent Eine SQLErrorEvent-Instanz wird von einer SQLConnection- oder SQLStatement-Instanz ausgelöst, wenn während der Ausführung eines Datenbankvorgangs im asynchronen Modus ein Fehler auftritt.flash.events:ErrorEvent Eine SQLErrorEvent-Instanz wird von einer SQLConnection- oder SQLStatement-Instanz ausgelöst, wenn während der Ausführung eines Datenbankvorgangs im asynchronen Modus ein Fehler auftritt. Die SQLErrorEvent-Instanz, die als Ereignisobjekt an Listener übergeben wird, ermöglicht den Zugriff auf Informationen über die Ursache des Fehlers und den Vorgang, der ausgeführt werden sollte.

Die spezifischen Details des Fehlers finden sich im SQLError-Objekt der error-Eigenschaft der SQLErrorEvent-Instanz.

flash.errors.SQLErrorflash.data.SQLConnectionflash.data.SQLStatementerrorflash.events:SQLErrorEvent:ERRORflash.events:SQLErrorEventflash.data.SQLConnectionflash.data.SQLStatementflash.errors.SQLErrorSQLErrorEvent Erstellt ein SQLErrorEvent-Objekt, das als Argument an Ereignis-Listener übergeben wird.typeString Der Typ des Ereignisses, aufrufbar über die type-Eigenschaft. Das SQLErrorEvent definiert einen Ereignistyp, das error-Ereignis, das von der SQLErrorEvent.ERROR-Konstante repräsentiert wird. bubblesBooleanfalse Legt fest, ob das Ereignisobjekt an der Bubbling-Phase des Ereignisablaufs teilnimmt. Der Standardwert ist false. cancelableBooleanfalseBestimmt, ob das Ereignisobjekt abgebrochen werden kann. Der Standardwert ist false. errorflash.errors:SQLErrornullDas SQLError-Objekt, das die Details zum Fehler enthält. Dient zum Erstellen eines neuen SQLErrorEvent-Objekts. Erstellt ein SQLErrorEvent-Objekt, das als Argument an Ereignis-Listener übergeben wird. flash.errors.SQLError;ERRORclone Erstellt eine Kopie des SQLErrorEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.Ein neues SQLErrorEvent-Objekt mit Eigenschaftswerten, die denen des Originals entsprechen. flash.events:Event Erstellt eine Kopie des SQLErrorEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht. toString Gibt einen String zurück, der alle Eigenschaften des SQLErrorEvent-Objekts enthält.Ein String, der alle Eigenschaften des SQLErrorEvent-Objekts enthält. String Gibt einen String zurück, der alle Eigenschaften des SQLErrorEvent-Objekts enthält. Der String liegt im folgenden Format vor:

[SQLErrorEvent type=Wert bubbles=Wert cancelable=Wert error=Wert]

Der Fehlerwert hat das folgende Format: SQLError : Meldungswert code=Wert operation=Wert

ERROR Die SQLErrorEvent.ERROR-Konstante definiert den Wert der type-Eigenschaft eines error-Ereignisses, das ausgelöst wird, wenn ein Aufruf einer Methode einer SQLConnection-Instanz oder einer SQLStatement-Instanz mit einem Fehler beendet wird.errorString Die SQLErrorEvent.ERROR-Konstante definiert den Wert der type-Eigenschaft eines error-Ereignisses, das ausgelöst wird, wenn ein Aufruf einer Methode einer SQLConnection-Instanz oder einer SQLStatement-Instanz mit einem Fehler beendet wird. Das error-Ereignis hat folgende Eigenschaften: EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.errorEin SQLError-Objekt, das Informationen über den aufgetretenen Fehlertyp und den Vorgang, der den Fehler ausgelöst hat, enthält.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.targetDas SQLConnection- oder SQLStatement-Objekt, dessen Fehlerstatus gemeldet wird. flash.data.SQLConnectionflash.data.SQLStatementflash.errors.SQLErrorerror Ein SQLError-Objekt, das ausführliche Informationen zur Ursache des Fehlers enthält.flash.errors:SQLError Ein SQLError-Objekt, das ausführliche Informationen zur Ursache des Fehlers enthält.
ErrorEvent Ein Objekt setzt ein ErrorEvent-Objekt ab, wenn ein Fehler zum Fehlschlagen eines asynchronen Vorgangs führt.Ereignisobjekte für ErrorEvent-Ereignisse. flash.events:TextEvent Ein Objekt setzt ein ErrorEvent-Objekt ab, wenn ein Fehler zum Fehlschlagen eines asynchronen Vorgangs führt.

Die ErrorEvent-Klasse definiert nur einen Typ von error-Ereignis: ErrorEvent.ERROR. Die ErrorEvent-Klasse dient auch als Basisklasse für verschiedene andere Fehlerereignisklassen, darunter AsyncErrorEvent, IOErrorEvent, SecurityErrorEvent, SQLErrorEvent und UncaughtErrorEvent.

Sie können feststellen, ob es error-Ereignisse gibt, die keine Listener haben, indem Sie einen Listener für das uncaughtError-Ereignis (UncaughtErrorEvent.UNCAUGHT_ERROR) registrieren.

Ein nicht erfasster Fehler produziert auch ein Fehlerdialogfeld mit dem Fehlerereignis, wenn Inhalt in der Debugger-Version von Flash Player oder der Anwendung „AIR Debug Launcher“ (ADL) ausgeführt wird.

Im folgenden Beispiel wird die Verwendung einer einzelnen Fehlerprozedur (errorHandler()), die mehrere Arten von Fehlerereignissen erfasst, demonstriert. Wenn ein ioError-Ereignis eintritt, versucht die Prozedur einen Ladevorgang aus dem Netzwerk. Hierbei wird ein securityError ausgelöst.

Hinweis: Dieses Beispiel funktioniert nicht, wenn sich eine Datei mit dem Namen „MissingFile.xml“ im gleichen Ordner wie die SWF-Datei befindet.

package { import flash.display.Sprite; import flash.net.URLLoader; import flash.net.URLRequest; import flash.events.*; public class ErrorEventExample extends Sprite { private var loader:URLLoader; private var request:URLRequest; public function ErrorEventExample() { loader = new URLLoader(); loader.addEventListener(IOErrorEvent.IO_ERROR, errorHandler); loader.addEventListener(SecurityErrorEvent.SECURITY_ERROR, errorHandler); request = new URLRequest(); loadFromFileSystem(); } private function loadFromFileSystem():void { request.url = "MissingFile.xml"; loader.load(request); } private function loadFromNetwork():void { request.url = "http://www.[yourDomain].com/MissingFile.xml"; loader.load(request); } private function errorHandler(event:ErrorEvent):void { trace("errorHandler: " + event); if(event is IOErrorEvent) { loadFromNetwork(); } } } }
UncaughtErrorEventerrorflash.events:ErrorEvent:ERRORflash.events:ErrorEventErrorEvent Erstellt ein Ereignisobjekt, das Informationen über Fehlerereignisse enthält.typeString Der Ereignistyp. Ereignis-Listener können über die übernommene Eigenschaft type auf diese Informationen zugreifen. Es gibt nur einen Typ eines Fehlerereignisses: ErrorEvent.ERROR. bubblesBooleanfalseLegt fest, ob das Ereignisobjekt eine Bubbling-Phase durchführt. Ereignis-Listener können über die übernommene Eigenschaft bubbles auf diese Informationen zugreifen. cancelableBooleanfalseBestimmt, ob das Ereignisobjekt abgebrochen werden kann. Ereignis-Listener können über die übernommene Eigenschaft cancelable auf diese Informationen zugreifen. textStringDer als Fehlermeldung anzuzeigende Text. Ereignis-Listener können über die Eigenschaft text auf diese Informationen zugreifen. idint0Eine mit dem spezifischen Fehler verknüpfte Referenznummer (wird nur in Adobe AIR unterstützt). Konstruktor für ErrorEvent-Objekte. Erstellt ein Ereignisobjekt, das Informationen über Fehlerereignisse enthält. Ereignisobjekte werden Ereignis-Listenern als Parameter übergeben. clone Erstellt eine Kopie des ErrorEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.Ein neues ErrorEvent-Objekt mit Eigenschaftswerten, die denen des Originals entsprechen. flash.events:Event Erstellt eine Kopie des ErrorEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht. toString Gibt eine Zeichenfolge zurück, die alle Eigenschaften des ErrorEvent-Objekts enthält.Eine Zeichenfolge, die alle Eigenschaften des ErrorEvent-Objekts enthält. String Gibt eine Zeichenfolge zurück, die alle Eigenschaften des ErrorEvent-Objekts enthält. Der String liegt im folgenden Format vor:

[ErrorEvent type=Wert bubbles=Wert cancelable=Wert text=Wert errorID=Wert]

Hinweis: Der errorId-Wert, der von der toString()-Methode zurückgegeben wird, ist nur für Adobe AIR verfügbar. Während Flash Player 10.1 die errorID-Eigenschaft unterstützt, wird durch den Aufruf von toString() für das ErrorEvent-Objekt in Flash Player nicht der errorId-Wert bereitgestellt.

ERROR Definiert den Wert der Eigenschaft „type“ eines error-Ereignisobjekts.errorString Definiert den Wert der Eigenschaft type eines error-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.targetDas Objekt, bei dem der Netzwerkvorgang fehlschlägt.textDer als Fehlermeldung anzuzeigende Text.
errorID Enthält die Verweisnummer, die dem spezifischen Fehler zugeordnet ist.int Enthält die Verweisnummer, die dem spezifischen Fehler zugeordnet ist. Bei einem selbst definierten ErrorEvent-Objekt entspricht diese Nummer dem Wert des im Konstruktor bereitgestellten id-Parameters.
SoftKeyboardTrigger Die SoftKeyboardTrigger-Klasse definiert die möglichen Werte für die triggerType-Eigenschaft der SoftKeyboardEvent-Klasse.Definiert die möglichen Werte für die triggerType-Eigenschaft der SoftKeyboardEvent-Klasse. Object Die SoftKeyboardTrigger-Klasse definiert die möglichen Werte für die triggerType-Eigenschaft der SoftKeyboardEvent-Klasse. Diese Werte geben an, welcher Aktionstyp ein SoftKeyboard-Aktivierungsereignis ausgelöst hat. CONTENT_TRIGGERED Ein Funktionsaufruf hat das Ereignis ausgelöst.contentTriggeredStringZeigt an, dass das Ereignis durch einen Funktionsaufruf ausgelöst wurde. Ein Funktionsaufruf hat das Ereignis ausgelöst. USER_TRIGGERED Eine Benutzeraktion hat das Ereignis ausgelöst.userTriggeredStringZeigt an, dass das Ereignis durch eine Benutzeraktion ausgelöst wurde. Eine Benutzeraktion hat das Ereignis ausgelöst. Typische Benutzeraktionen, die dieses Ereignis auslösen können, sind das Schließen der Tastatur oder das Betätigen der Zurück-Taste. TransformGestureEvent Die TransformGestureEvent-Klasse ermöglicht die Verarbeitung komplexer Bewegungseingabeereignisse (zum Beispiel das Bewegen von Fingern über einen Touchscreen), die das Gerät oder Betriebssystem als Geste interpretiert.bietet Unterstützung für die Ereignisverarbeitung bei Berührungsbewegungsinteraktionen flash.events:GestureEvent Die TransformGestureEvent-Klasse ermöglicht die Verarbeitung komplexer Bewegungseingabeereignisse (zum Beispiel das Bewegen von Fingern über einen Touchscreen), die das Gerät oder Betriebssystem als Geste interpretiert. Eine Geste kann einen oder mehrere Berührungspunkte aufweisen. Wenn ein Benutzer mit einem Gerät mit Touchscreen, zum Beispiel Mobiltelefon oder Tablet, interagiert, setzt er normalerweise einen Finger oder Touchpen auf den Bildschirm und bewegt ihn. Mithilfe der GestureEvent-, PressAndTapGestureEvent- und TransformGestureEvent-Klasse können Sie Anwendungen entwickeln, die auf diese Benutzerinteraktion reagieren. Erstellen Sie mit den hier oder in den verwandten GestureEvent- und TouchEvent-Klassen definierten Ereignistypen Ereignis-Listener. Verwenden Sie außerdem die Eigenschaften und Methoden dieser Klassen, um Ereignisprozeduren zu konstruieren, die auf die Berührung des Benutzers mit dem Gerät reagieren.

Ein Gerät oder Betriebssystem interpretiert die Gesteneingabe. Verschiedene Geräte oder Betriebssysteme haben unterschiedliche Anforderungen für die einzelnen Gestentypen. Eine Swipe-Geste auf einem Gerät kann andere Eingabebewegungen erfordern als eine Swipe-Geste auf einem anderen Gerät. Wie das Gerät oder Betriebssystem Berührungen als eine bestimmte Geste interpretiert, können Sie der Dokumentation der jeweiligen Hardware oder des Betriebssystems entnehmen.

Stellen Sie mithilfe der Multitouch-Klasse fest, welche Berührungsinteraktionen die aktuelle Umgebung unterstützt, und verwalten Sie die ggf. unterstützten Berührungsinteraktionen.

Hinweis: Wenn Objekte auf der Anzeigeliste verschachtelt sind, zielen Berührungsereignisse auf das am weitesten verschachtelte Objekt, das auf der Anzeigeliste zu sehen ist. Dieses Objekt wird als Zielknoten bezeichnet. Damit der Vorfahre des Knotens (ein Objekt in der Anzeigeliste, das den Zielknoten enthält) über ein Berührungsereignis benachrichtigt wird, verwenden Sie EventDispatcher.addEventListener() für den Vorfahrenknoten. Dabei sollte der type-Parameter auf das Berührungsereignis gesetzt werden, das Sie erkennen möchten.

Während der Benutzer das Gerät berührt, sind die scale-, rotation- und offset-Eigenschaft des TransformGestureEvent-Objekts inkrementelle Werte aus dem vorherigen Gestenereignis. Wenn eine Geste zum Beispiel ein Anzeigeobjekt vergrößert, ändern sich die scale-Werte nacheinander vielleicht auf 1.03, 1.01, 1.01, 1.02 und zeigen damit an, dass das Anzeigeobjekt beim Ende der Geste das 1,0717-Fache der ursprünglichen Größe aufweist.

Für TransformGestureEvent-Objekte werden Eigenschaften, die von der aktuellen Geste nicht geändert werden, auf Identitätswerte gesetzt. Eine Bildlaufgeste weist zum Beispiel keine Dreh- oder Skalierungstransformation auf, weshalb der rotation-Wert des Ereignisobjekts 0 ist und die Eigenschaften scaleX und scaleY den Wert 1 haben.

Die folgenden Beispiele zeigen die Ereignisverarbeitung für GESTURE_ROTATE-Ereignisse. Während der Benutzer eine Drehgeste auf dem berührungsempfindlichen Gerät ausführt, dreht sich mySprite und in myTextField wird die aktuelle Phase angezeigt. Multitouch.inputMode = MultitouchInputMode.GESTURE; var mySprite = new Sprite(); mySprite.addEventListener(TransformGestureEvent.GESTURE_ROTATE , onRotate ); mySprite.graphics.beginFill(0x336699); mySprite.graphics.drawRect(0, 0, 100, 80); var myTextField = new TextField(); myTextField.y = 200; addChild(mySprite); addChild(myTextField); function onRotate(evt:TransformGestureEvent):void { evt.target.rotation -= 45; if (evt.phase==GesturePhase.BEGIN) { myTextField.text = "Begin"; } if (evt.phase==GesturePhase.UPDATE) { myTextField.text = "Update"; } if (evt.phase==GesturePhase.END) { myTextField.text = "End"; } } Das folgende Beispiel zeigt, wie Transformationsgestenereignisse verarbeitet werden. In diesem Beispiel wird davon ausgegangen, dass Sie auf Ihrem lokalen System ein Bild namens „african_elephant.jpg“ im selben Verzeichnis wie die TransformGestureExample2-Klasse vorliegen haben. Das Beispiel stammt von Christian Cantrell und wird ausführlicher in seiner Kurzanleitung beschrieben: Multi-touch and gesture support on the Flash Platform. package { import flash.display.Bitmap; import flash.display.Sprite; import flash.events.TransformGestureEvent; import flash.text.TextField; import flash.text.TextFormat; import flash.ui.Multitouch; import flash.ui.MultitouchInputMode; [SWF(width=320, height=460, frameRate=24, backgroundColor=0x000000)] public class TransformGestureExample2 extends Sprite { [Embed(source="african_elephant.jpg")] public var ElephantImage:Class; public var scaleDebug:TextField; public var rotateDebug:TextField; public function TransformGestureExample2() { // Debug var tf:TextFormat = new TextFormat(); tf.color = 0xffffff; tf.font = "Helvetica"; tf.size = 11; this.scaleDebug = new TextField(); this.scaleDebug.width = 310; this.scaleDebug.defaultTextFormat = tf; this.scaleDebug.x = 2; this.scaleDebug.y = 2; this.stage.addChild(this.scaleDebug); this.rotateDebug = new TextField(); this.rotateDebug.width = 310; this.rotateDebug.defaultTextFormat = tf; this.rotateDebug.x = 2; this.rotateDebug.y = 15; this.stage.addChild(this.rotateDebug); var elephantBitmap:Bitmap = new ElephantImage(); var elephant:Sprite = new Sprite(); elephant.addChild(elephantBitmap); elephant.x = 160; elephant.y = 230; elephantBitmap.x = (300 - (elephantBitmap.bitmapData.width / 2)) * -1; elephantBitmap.y = (400 - (elephantBitmap.bitmapData.height / 2)) *-1; this.addChild(elephant); Multitouch.inputMode = MultitouchInputMode.GESTURE; elephant.addEventListener(TransformGestureEvent.GESTURE_ZOOM, onZoom); elephant.addEventListener(TransformGestureEvent.GESTURE_ROTATE, onRotate); } private function onZoom(e:TransformGestureEvent):void { this.scaleDebug.text = (e.scaleX + ", " + e.scaleY); var elephant:Sprite = e.target as Sprite; elephant.scaleX *= e.scaleX; elephant.scaleY *= e.scaleY; } private function onRotate(e:TransformGestureEvent):void { var elephant:Sprite = e.target as Sprite; this.rotateDebug.text = String(e.rotation); elephant.rotation += e.rotation; } } }
flash.ui.Multitouchflash.events.TouchEventflash.events.GestureEventflash.events.PressAndTapGestureEventflash.events.MouseEventflash.events.EventDispatcher.addEventListener()gesturePanflash.events:TransformGestureEvent:GESTURE_PANflash.events:TransformGestureEvent Die folgenden Beispiele zeigen die Ereignisverarbeitung für GESTURE_PAN-Ereignisse. Während der Benutzer eine Bildlaufgeste auf dem berührungsempfindlichen Gerät ausführt, wird in myTextField die aktuelle Phase angezeigt. Multitouch.inputMode = MultitouchInputMode.GESTURE; var mySprite = new Sprite(); mySprite.addEventListener(TransformGestureEvent.GESTURE_PAN , onPan); mySprite.graphics.beginFill(0x336699); mySprite.graphics.drawRect(0, 0, 100, 80); var myTextField = new TextField(); myTextField.y = 200; addChild(mySprite); addChild(myTextField); function onPan(evt:TransformGestureEvent):void { evt.target.localX++; if (evt.phase==GesturePhase.BEGIN) { myTextField.text = "Begin"; } if (evt.phase==GesturePhase.UPDATE) { myTextField.text = "Update"; } if (evt.phase==GesturePhase.END) { myTextField.text = "End"; } } flash.display.InteractiveObject.gesturePanflash.events.GesturePhasegestureRotateflash.events:TransformGestureEvent:GESTURE_ROTATEflash.events:TransformGestureEvent Die folgenden Beispiele zeigen die Ereignisverarbeitung für GESTURE_ROTATE-Ereignisse. Während der Benutzer eine Drehgeste auf dem berührungsempfindlichen Gerät ausführt, dreht sich mySprite und in myTextField wird die aktuelle Phase angezeigt. Multitouch.inputMode = MultitouchInputMode.GESTURE; var mySprite = new Sprite(); mySprite.addEventListener(TransformGestureEvent.GESTURE_ROTATE , onRotate ); mySprite.graphics.beginFill(0x336699); mySprite.graphics.drawRect(0, 0, 100, 80); var myTextField = new TextField(); myTextField.y = 200; addChild(mySprite); addChild(myTextField); function onRotate(evt:TransformGestureEvent):void { evt.target.rotation -= 45; if (evt.phase==GesturePhase.BEGIN) { myTextField.text = "Begin"; } if (evt.phase==GesturePhase.UPDATE) { myTextField.text = "Update"; } if (evt.phase==GesturePhase.END) { myTextField.text = "End"; } } flash.display.InteractiveObject.gestureRotateflash.events.GesturePhasegestureSwipeflash.events:TransformGestureEvent:GESTURE_SWIPEflash.events:TransformGestureEvent Die folgenden Beispiele zeigen die Ereignisverarbeitung für GESTURE_SWIPE-Ereignisse. Während der Benutzer eine Swipe-Geste auf dem berührungsempfindlichen Gerät ausführt, wird myTextField mit der Phase all ausgefüllt, welche die einzige Phase für Swipe-Ereignisse ist. Multitouch.inputMode = MultitouchInputMode.GESTURE; var mySprite = new Sprite(); mySprite.addEventListener(TransformGestureEvent.GESTURE_SWIPE , onSwipe); mySprite.graphics.beginFill(0x336699); mySprite.graphics.drawRect(0, 0, 100, 80); var myTextField = new TextField(); myTextField.y = 200; addChild(mySprite); addChild(myTextField); function onSwipe(evt:TransformGestureEvent):void { if (evt.offsetX == 1 ) { myTextField.text = "right"; } if (evt.offsetY == -1) { myTextField.text = "up"; } myTextField.text = evt.phase; } flash.display.InteractiveObject.gestureSwipeflash.events.GesturePhasegestureZoomflash.events:TransformGestureEvent:GESTURE_ZOOMflash.events:TransformGestureEvent Die folgenden Beispiele zeigen die Ereignisverarbeitung für GESTURE_ZOOM-Ereignisse. Während der Benutzer eine Zoom-Geste auf dem berührungsempfindlichen Gerät ausführt, wird in myTextField die aktuelle Phase angezeigt. Multitouch.inputMode = MultitouchInputMode.GESTURE; var mySprite = new Sprite(); mySprite.addEventListener(TransformGestureEvent.GESTURE_ZOOM , onZoom); mySprite.graphics.beginFill(0x336699); mySprite.graphics.drawRect(0, 0, 100, 80); var myTextField = new TextField(); myTextField.y = 200; addChild(mySprite); addChild(myTextField); function onZoom(evt:TransformGestureEvent):void { evt.target.scaleX++; if (evt.phase==GesturePhase.BEGIN) { myTextField.text = "Begin"; } if (evt.phase==GesturePhase.UPDATE) { myTextField.text = "Update"; } if (evt.phase==GesturePhase.END) { myTextField.text = "End"; } } flash.display.InteractiveObject.gestureZoomflash.events.GesturePhaseTransformGestureEvent Erstellt ein Event-Objekt, das Informationen zu komplexen Multitouch-Ereignissen enthält, zum Beispiel, wenn ein Benutzer seinen Finger über einen Bildschirm bewegt.typeString Der Ereignistyp. Mögliche Werte sind: TransformGestureEvent.GESTURE_PAN, TransformGestureEvent.GESTURE_ROTATE, TransformGestureEvent.GESTURE_SWIPE und TransformGestureEvent.GESTURE_ZOOM. bubblesBooleantrue Legt fest, ob das Ereignisobjekt an der Bubbling-Phase des Ereignisablaufs teilnimmt. cancelableBooleanfalseBestimmt, ob das Ereignisobjekt abgebrochen werden kann. phaseStringnullDieser Wert verfolgt den Anfang, den Fortschritt und das Ende einer Berührungsgeste. Mögliche Werte sind: GesturePhase.BEGIN, GesturePhase.END und GesturePhase.UPDATE. localXNumber0Die horizontale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden Anzeigeobjekt steht. localYNumber0Die vertikale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden Anzeigeobjekt steht. scaleXNumber1.0Die horizontale Skalierung des Anzeigeobjekts. scaleYNumber1.0Die vertikale Skalierung des Anzeigeobjekts. rotationNumber0Der aktuelle Drehwinkel des Anzeigeobjekt entlang der z-Achse in Grad. offsetXNumber0Die horizontale Versetzung des Anzeigeobjekts von seiner ursprünglichen Position. offsetYNumber0Die vertikale Versetzung des Anzeigeobjekts von seiner ursprünglichen Position. ctrlKeyBooleanfalseUnter Windows oder Linux wird damit angezeigt, ob die Strg-Taste aktiviert ist. Unter Mac OS wird damit angezeigt, ob die Ctrl-Taste oder die Befehlstaste aktiviert ist. altKeyBooleanfalseGibt an, ob die Alt-Taste aktiviert ist (nur Windows oder Linux). shiftKeyBooleanfalseGibt an, ob der Umschalttasten-Modifizierer aktiviert ist. commandKeyBooleanfalse(nur AIR); gibt an, ob die Befehlstaste aktiviert ist (nur Mac). Dieser Parameter gilt nur für Adobe AIR. Setzen Sie ihn nicht für Flash Player-Inhalte. controlKeyBooleanfalse(nur AIR); gibt an, ob die Ctrl- oder Strg-Taste aktiviert ist. Dieser Parameter gilt nur für Adobe AIR. Setzen Sie ihn nicht für Flash Player-Inhalte. Konstruktor für TransformGestureEvent-Objekte. Erstellt ein Event-Objekt, das Informationen zu komplexen Multitouch-Ereignissen enthält, zum Beispiel, wenn ein Benutzer seinen Finger über einen Bildschirm bewegt. Ereignisobjekte werden Ereignis-Listenern als Parameter übergeben. flash.ui.Multitouchflash.events.TouchEventflash.events.GestureEventflash.events.PressAndTapGestureEventflash.events.GesturePhaseflash.events.MouseEventflash.events.EventDispatcher.addEventListener()clone Erstellt eine Kopie des TransformGestureEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.Ein neues TransformGestureEvent-Objekt mit Eigenschaftswerten, die denen des Originals entsprechen. flash.events:Event Erstellt eine Kopie des TransformGestureEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht. toString Gibt einen String zurück, der alle Eigenschaften des TransformGestureEvent-Objekts enthält.Ein String, der alle Eigenschaften des TransformGestureEvent-Objekts enthält. String Gibt einen String zurück, der alle Eigenschaften des TransformGestureEvent-Objekts enthält. Der String liegt im folgenden Format vor:

[TransformGestureEvent type=Wert bubbles=Wert cancelable=Wert ... ]

GESTURE_PAN Definiert den Wert der type-Eigenschaft eines GESTURE_PAN-Berührungsereignisobjekts.gesturePanString Definiert den Wert der type-Eigenschaft eines GESTURE_PAN-Berührungsereignisobjekts.

Das abgesetzte TransformGestureEvent-Objekt hat folgende Eigenschaften:

EigenschaftWertaltKeytrue, wenn die Alt-Taste aktiviert ist (Windows oder Linux).bubblestruecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.commandKeytrue unter Mac OS, falls die Befehlstaste aktiviert ist; false, wenn sie deaktiviert ist. Unter Windows immer false controlKeytrue, wenn die Strg- oder Ctrl-Taste aktiv ist; false, wenn sie nicht aktiv ist.ctrlKeytrue unter Windows oder Linux, wenn die Strg-Taste aktiv ist. true unter Mac OS, falls die Strg-Taste oder die Befehlstaste aktiv ist. Andernfalls wird false zurückgegeben.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.phaseDie aktuelle Phase im Ereignisablauf; ein Wert aus der GesturePhase-Klasse.localXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden Anzeigeobjekt steht.localYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden Anzeigeobjekt steht.scaleXDie horizontale Skalierung des Anzeigeobjekts seit dem vorherigen Gestenereignis. Für Bildlaufgesten ist dieser Wert 1.scaleYDie vertikale Skalierung des Anzeigeobjekts seit dem vorherigen Gestenereignis. Für Bildlaufgesten ist dieser Wert 1.rotationDer aktuelle Drehwinkel des Anzeigeobjekts um die z-Achse seit dem vorherigen Gestenereignis in Grad. Für Bildlaufgesten ist dieser Wert 0.offsetXDie horizontale Versetzung des Anzeigeobjekts von seiner Position beim vorherigen Gestenereignis.offsetYDie vertikale Versetzung des Anzeigeobjekts von seiner Position beim vorherigen Gestenereignis.shiftKeytrue, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist.targetDie InteractiveObject-Instanz unter dem Touchpen oder Finger. Das unter target angegebene Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet.
Die folgenden Beispiele zeigen die Ereignisverarbeitung für GESTURE_PAN-Ereignisse. Während der Benutzer eine Bildlaufgeste auf dem berührungsempfindlichen Gerät ausführt, wird in myTextField die aktuelle Phase angezeigt. Multitouch.inputMode = MultitouchInputMode.GESTURE; var mySprite = new Sprite(); mySprite.addEventListener(TransformGestureEvent.GESTURE_PAN , onPan); mySprite.graphics.beginFill(0x336699); mySprite.graphics.drawRect(0, 0, 100, 80); var myTextField = new TextField(); myTextField.y = 200; addChild(mySprite); addChild(myTextField); function onPan(evt:TransformGestureEvent):void { evt.target.localX++; if (evt.phase==GesturePhase.BEGIN) { myTextField.text = "Begin"; } if (evt.phase==GesturePhase.UPDATE) { myTextField.text = "Update"; } if (evt.phase==GesturePhase.END) { myTextField.text = "End"; } }
flash.display.InteractiveObject.gesturePanflash.events.GesturePhase
GESTURE_ROTATE Definiert den Wert der type-Eigenschaft eines GESTURE_ROTATE-Berührungsereignisobjekts.gestureRotateString Definiert den Wert der type-Eigenschaft eines GESTURE_ROTATE-Berührungsereignisobjekts.

Das abgesetzte TransformGestureEvent-Objekt hat folgende Eigenschaften:

EigenschaftWertaltKeytrue, wenn die Alt-Taste aktiviert ist (Windows oder Linux).bubblestruecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.commandKeytrue unter Mac OS, falls die Befehlstaste aktiviert ist; false, wenn sie deaktiviert ist. Unter Windows immer false controlKeytrue, wenn die Strg- oder Ctrl-Taste aktiv ist; false, wenn sie nicht aktiv ist.ctrlKeytrue unter Windows oder Linux, wenn die Strg-Taste aktiv ist. true unter Mac OS, falls die Strg-Taste oder die Befehlstaste aktiv ist. Andernfalls wird false zurückgegeben.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.phaseDie aktuelle Phase im Ereignisablauf; ein Wert aus der GesturePhase-Klasse.localXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden Anzeigeobjekt steht.localYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden Anzeigeobjekt steht.scaleXDie horizontale Skalierung des Anzeigeobjekts seit dem vorherigen Gestenereignis.scaleYDie vertikale Skalierung des Anzeigeobjekts seit dem vorherigen Gestenereignis.rotationDer aktuelle Drehwinkel des Anzeigeobjekts um die z-Achse seit dem vorherigen Gestenereignis in Grad.offsetXDie horizontale Versetzung des Anzeigeobjekts von seiner Position beim vorherigen Gestenereignis.offsetYDie vertikale Versetzung des Anzeigeobjekts von seiner Position beim vorherigen Gestenereignis.shiftKeytrue, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist.targetDie InteractiveObject-Instanz unter dem Touchpen oder Finger. Das unter target angegebene Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet.
Die folgenden Beispiele zeigen die Ereignisverarbeitung für GESTURE_ROTATE-Ereignisse. Während der Benutzer eine Drehgeste auf dem berührungsempfindlichen Gerät ausführt, dreht sich mySprite und in myTextField wird die aktuelle Phase angezeigt. Multitouch.inputMode = MultitouchInputMode.GESTURE; var mySprite = new Sprite(); mySprite.addEventListener(TransformGestureEvent.GESTURE_ROTATE , onRotate ); mySprite.graphics.beginFill(0x336699); mySprite.graphics.drawRect(0, 0, 100, 80); var myTextField = new TextField(); myTextField.y = 200; addChild(mySprite); addChild(myTextField); function onRotate(evt:TransformGestureEvent):void { evt.target.rotation -= 45; if (evt.phase==GesturePhase.BEGIN) { myTextField.text = "Begin"; } if (evt.phase==GesturePhase.UPDATE) { myTextField.text = "Update"; } if (evt.phase==GesturePhase.END) { myTextField.text = "End"; } }
flash.display.InteractiveObject.gestureRotateflash.events.GesturePhase
GESTURE_SWIPE Definiert den Wert der type-Eigenschaft eines GESTURE_SWIPE-Berührungsereignisobjekts.gestureSwipeString Definiert den Wert der type-Eigenschaft eines GESTURE_SWIPE-Berührungsereignisobjekts.

Das abgesetzte TransformGestureEvent-Objekt hat folgende Eigenschaften:

EigenschaftWertaltKeytrue, wenn die Alt-Taste aktiviert ist (Windows oder Linux).bubblestruecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.commandKeytrue unter Mac OS, falls die Befehlstaste aktiviert ist; false, wenn sie deaktiviert ist. Unter Windows immer false controlKeytrue, wenn die Strg- oder Ctrl-Taste aktiv ist; false, wenn sie nicht aktiv ist.ctrlKeytrue unter Windows oder Linux, wenn die Strg-Taste aktiv ist. true unter Mac OS, falls die Strg-Taste oder die Befehlstaste aktiv ist. Andernfalls wird false zurückgegeben.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.phaseDie aktuelle Phase im Ereignisablauf. Für Swipe-Ereignisse ist dieser Wert immer all entsprechend dem Wert GesturePhase.ALL, nachdem dieses Ereignis abgesetzt wurde.localXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, in Relation zum umgebenden Sprite.localYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden Sprite-Objekt steht.scaleXDie horizontale Skalierung des Anzeigeobjekts. Für Swipe-Gesten ist dieser Wert 1scaleYDie vertikale Skalierung des Anzeigeobjekts. Für Swipe-Gesten ist dieser Wert 1rotationDer aktuelle Drehwinkel des Anzeigeobjekt entlang der z-Achse in Grad. Für Swipe-Gesten ist dieser Wert 0offsetXGibt die horizontale Richtung an: 1 für „nach rechts“ und -1 für „nach links“.offsetYGibt die vertikale Richtung an: 1 für „nach unten“ und -1 für „nach oben“.shiftKeytrue, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist.targetDie InteractiveObject-Instanz unter dem Touchpen oder Finger. Das unter target angegebene Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet.
Die folgenden Beispiele zeigen die Ereignisverarbeitung für GESTURE_SWIPE-Ereignisse. Während der Benutzer eine Swipe-Geste auf dem berührungsempfindlichen Gerät ausführt, wird myTextField mit der Phase all ausgefüllt, welche die einzige Phase für Swipe-Ereignisse ist. Multitouch.inputMode = MultitouchInputMode.GESTURE; var mySprite = new Sprite(); mySprite.addEventListener(TransformGestureEvent.GESTURE_SWIPE , onSwipe); mySprite.graphics.beginFill(0x336699); mySprite.graphics.drawRect(0, 0, 100, 80); var myTextField = new TextField(); myTextField.y = 200; addChild(mySprite); addChild(myTextField); function onSwipe(evt:TransformGestureEvent):void { if (evt.offsetX == 1 ) { myTextField.text = "right"; } if (evt.offsetY == -1) { myTextField.text = "up"; } myTextField.text = evt.phase; }
flash.display.InteractiveObject.gestureSwipeflash.events.GesturePhase
GESTURE_ZOOM Definiert den Wert der type-Eigenschaft eines GESTURE_ZOOM-Berührungsereignisobjekts.gestureZoomString Definiert den Wert der type-Eigenschaft eines GESTURE_ZOOM-Berührungsereignisobjekts.

Das abgesetzte TransformGestureEvent-Objekt hat folgende Eigenschaften:

EigenschaftWertaltKeytrue, wenn die Alt-Taste aktiviert ist (Windows oder Linux).bubblestruecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.commandKeytrue unter Mac OS, falls die Befehlstaste aktiviert ist; false, wenn sie deaktiviert ist. Unter Windows immer false controlKeytrue, wenn die Strg- oder Ctrl-Taste aktiv ist; false, wenn sie nicht aktiv ist.ctrlKeytrue unter Windows oder Linux, wenn die Strg-Taste aktiv ist. true unter Mac OS, falls die Strg-Taste oder die Befehlstaste aktiv ist. Andernfalls wird false zurückgegeben.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.phaseDie aktuelle Phase im Ereignisablauf; ein Wert aus der GesturePhase-Klasse.localXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden Anzeigeobjekt steht.localYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden Anzeigeobjekt steht.scaleXDie horizontale Skalierung des Anzeigeobjekts seit dem vorherigen Gestenereignis.scaleYDie vertikale Skalierung des Anzeigeobjekts seit dem vorherigen Gestenereignis.rotationDer aktuelle Drehwinkel des Anzeigeobjekts um die z-Achse seit dem vorherigen Gestenereignis in Grad.offsetXDie horizontale Versetzung des Anzeigeobjekts von seiner Position beim vorherigen Gestenereignis.offsetYDie vertikale Versetzung des Anzeigeobjekts von seiner Position beim vorherigen Gestenereignis.shiftKeytrue, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist.targetDie InteractiveObject-Instanz unter dem Touchpen oder Finger. Das unter target angegebene Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet.
Die folgenden Beispiele zeigen die Ereignisverarbeitung für GESTURE_ZOOM-Ereignisse. Während der Benutzer eine Zoom-Geste auf dem berührungsempfindlichen Gerät ausführt, wird in myTextField die aktuelle Phase angezeigt. Multitouch.inputMode = MultitouchInputMode.GESTURE; var mySprite = new Sprite(); mySprite.addEventListener(TransformGestureEvent.GESTURE_ZOOM , onZoom); mySprite.graphics.beginFill(0x336699); mySprite.graphics.drawRect(0, 0, 100, 80); var myTextField = new TextField(); myTextField.y = 200; addChild(mySprite); addChild(myTextField); function onZoom(evt:TransformGestureEvent):void { evt.target.scaleX++; if (evt.phase==GesturePhase.BEGIN) { myTextField.text = "Begin"; } if (evt.phase==GesturePhase.UPDATE) { myTextField.text = "Update"; } if (evt.phase==GesturePhase.END) { myTextField.text = "End"; } }
flash.display.InteractiveObject.gestureZoomflash.events.GesturePhase
offsetX Die horizontale Versetzung des Anzeigeobjekts seit dem vorherigen Gestenereignis.Number Die horizontale Versetzung des Anzeigeobjekts seit dem vorherigen Gestenereignis. offsetY Die vertikale Versetzung des Anzeigeobjekts seit dem vorherigen Gestenereignis.Number Die vertikale Versetzung des Anzeigeobjekts seit dem vorherigen Gestenereignis. rotation Der aktuelle Drehwinkel des Anzeigeobjekts um die z-Achse seit dem vorherigen Gestenereignis in Grad.Number Der aktuelle Drehwinkel des Anzeigeobjekts um die z-Achse seit dem vorherigen Gestenereignis in Grad. scaleX Die horizontale Skalierung des Anzeigeobjekts seit dem vorherigen Gestenereignis.Number Die horizontale Skalierung des Anzeigeobjekts seit dem vorherigen Gestenereignis. scaleY Die vertikale Skalierung des Anzeigeobjekts seit dem vorherigen Gestenereignis.Number Die vertikale Skalierung des Anzeigeobjekts seit dem vorherigen Gestenereignis.
NativeDragEvent Native Drag-Ereignisse werden von den interaktiven Objekten ausgelöst, die an einem Drag & Drop-Vorgang beteiligt sind.flash.events:MouseEvent Native Drag-Ereignisse werden von den interaktiven Objekten ausgelöst, die an einem Drag & Drop-Vorgang beteiligt sind.

Das initiierende Objekt löst folgende Ereignisse aus:

  • nativeDragStart: Zu Beginn des Ziehvorgangs.
  • nativeDragUpdate: Während des Ziehvorgangs.
  • nativeDragComplete: Wenn der Benutzer das gezogene Element loslässt (egal, ob das Ablegen akzeptiert wurde oder nicht).

Das initiierende Objekt ist das interaktive Objekt, das im Aufruf von NativeDragManager.doDrag(), mit dem der Ziehvorgang beginnt, an das NativeDragManager-Objekt übergeben wird.

Potenzielle interaktive Zielobjekte lösen folgende Ereignisse aus:

  • nativeDragEnter: Wenn sich die Ziehbewegung über die Objektgrenzen auf das Objekt bewegt.
  • nativeDragOver: Wenn die Ziehbewegung innerhalb der Objektgrenzen verbleibt.
  • nativeDragExit: Wenn die Ziehbewegung die Objektgrenzen verlässt.
  • nativeDragDrop: Wenn der Benutzer das gezogene Element über dem Objekt loslässt und das Objekt das Ablegen durch einen früheren Aufruf von NativeDragManager.acceptDragDrop() akzeptiert hat.

Normalerweise evaluiert die Prozedur für das nativeDragEnter- oder nativeDragOver-Ereignis die gezogenen Daten zusammen mit den zulässigen Ziehaktionen, um festzustellen, ob ein interaktives Objekt das Ablegen akzeptieren kann. Um festzulegen, dass ein interaktives Objekt ein gültiges Ziel ist, muss die Ereignisprozedur die NativeDragManager.acceptDrop()-Funktion aufrufen, die einen Verweis an das Objekt übergibt. Wenn der Benutzer die Maustaste über dem vorgesehenen Objekt loslässt, wird dieses zum Ablageziel und löst das nativeDragDrop-Ereignis aus.

Jedes Objekt vom Typ InteractiveObject kann ein Ziehinitiator oder ein Ablageziel sein.

flash.desktop.NativeDragManagerflash.desktop.Clipboardflash.desktop.NativeDragOptionsflash.desktop.NativeDragActionsflash.display.InteractiveObjectnativeDragCompleteflash.events:NativeDragEvent:NATIVE_DRAG_COMPLETEflash.events:NativeDragEventWird vom Quell-InteractiveObject abgesetzt, wenn eine Drag-and-Drop-Geste endet. flash.display.InteractiveObject.nativeDragCompleteflash.desktop.NativeDragActionsnativeDragDropflash.events:NativeDragEvent:NATIVE_DRAG_DROPflash.events:NativeDragEventWird vom InteractiveObject abgesetzt, wenn eine Drag-and-Drop-Geste über dem Objekt endet. flash.display.InteractiveObject.nativeDragDropnativeDragEnterflash.events:NativeDragEvent:NATIVE_DRAG_ENTERflash.events:NativeDragEventWird vom InteractiveObject abgesetzt, wenn eine Drag-and-Drop-Geste in die Objektbegrenzungen eintritt. flash.display.InteractiveObject.nativeDragEnternativeDragExitflash.events:NativeDragEvent:NATIVE_DRAG_EXITflash.events:NativeDragEventWird vom InteractiveObject abgesetzt, wenn eine Drag-and-Drop-Geste die Objektbegrenzungen verlässt. flash.display.InteractiveObject.nativeDragExitnativeDragOverflash.events:NativeDragEvent:NATIVE_DRAG_OVERflash.events:NativeDragEventWird vom InteractiveObject abgesetzt, während sich eine Drag-and-Drop-Geste über dem Objekt abspielt. flash.display.InteractiveObject.nativeDragOvernativeDragStartflash.events:NativeDragEvent:NATIVE_DRAG_STARTflash.events:NativeDragEventWird zu Beginn einer nativen Drag-and-Drop-Geste vom Quell-InteractiveObject abgesetzt. flash.display.InteractiveObject.nativeDragStartnativeDragUpdateflash.events:NativeDragEvent:NATIVE_DRAG_UPDATEflash.events:NativeDragEventWird vom Quell-InteractiveObject abgesetzt, während eine Drag-and-Drop-Geste stattfindet. flash.display.InteractiveObject.nativeDragUpdateNativeDragEvent Erstellt ein Event-Objekt mit spezifischen Informationen, die für native Ziehen-und-Ablegen-Ereignisse relevant sind.typeString Der Ereignistyp. Mögliche Werte sind: NativeDragEvent.NATIVE_DRAG_START, NativeDragEvent.NATIVE_DRAG_UPDATE, NativeDragEvent.NATIVE_DRAG_ENTER, NativeDragEvent.NATIVE_DRAG_OVER, NativeDragEvent.NATIVE_DRAG_EXIT, NativeDragEvent.NATIVE_DRAG_DROP und NativeDragEvent.NATIVE_DRAG_COMPLETE. bubblesBooleanfalseGibt an, ob das Ereignisobjekt an der Bubbling-Phase des Ereignisablaufs beteiligt ist. cancelableBooleantrueGibt an, ob das Ereignisobjekt abgebrochen werden kann. localXNumberunknownDie horizontale Koordinate, an der das Ereignis aufgetreten ist, in Relation zum umgebenden Sprite. localYNumberunknownDie vertikale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden Sprite-Objekt steht. relatedObjectflash.display:InteractiveObjectnullDas entsprechende interaktive Anzeigeobjekt. clipboardflash.desktop:ClipboardnullDas Clipboard-Objekt mit den zu übertragenden Daten. allowedActionsflash.desktop:NativeDragOptionsnullDas NativeDragOptions-Objekt, das die zulässigen Aktionen definiert (verschieben, kopieren und verknüpfen). dropActionStringnullDie aktuelle Aktion. controlKeyBooleanfalseGibt an, ob die Strg-Taste aktiviert ist. altKeyBooleanfalseGibt an, ob die Alt-Taste aktiviert ist. shiftKeyBooleanfalseGibt an, ob der Umschalttasten-Modifizierer aktiviert ist. commandKeyBooleanfalseGibt an, ob die Befehlstaste aktiviert ist. Erstellt ein Event-Objekt mit spezifischen Informationen, die für native Ziehen-und-Ablegen-Ereignisse relevant sind.

Ereignisobjekte werden Ereignis-Listenern als Parameter übergeben. Das Auslösen eines Ziehereignisses löst nicht das zugehörige Verhalten aus.

clone Erstellt eine Kopie dieses NativeDragEvent-Objekts.Ein neues NativeDragEvent-Objekt mit Eigenschaftswerten, die denen des Originals entsprechen. flash.events:Event Erstellt eine Kopie dieses NativeDragEvent-Objekts. toString Formatiert die Eigenschaften dieses NativeDragEvent-Objekts als ein String.Die Eigenschaften dieses NativeDragEvent-Objekts als ein String. String Formatiert die Eigenschaften dieses NativeDragEvent-Objekts als ein String.

Der String liegt im folgenden Format vor:

[NativeDragEvent type=Wert bubbles=Wert cancelable=Wert ... commandKey=Wert]

NATIVE_DRAG_COMPLETE NativeDragEvent.NATIVE_DRAG_COMPLETE definiert den Wert der type-Eigenschaft eines nativeDragComplete-Ereignisobjekts.nativeDragCompleteStringWird vom Quell-InteractiveObject abgesetzt, wenn eine Drag-and-Drop-Geste endet. NativeDragEvent.NATIVE_DRAG_COMPLETE definiert den Wert der type-Eigenschaft eines nativeDragComplete-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertallowedActionsDas NativeDragOptions-Objekt, das die für diesen Ziehvorgang relevanten Aktionen angibt.bubblestruecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.clipboardDas Clipboard-Objekt, das die gezogenen Daten enthält. dropActionDie vom Ablageziel gewählte Aktion (oder none, wenn keine Aktion festgelegt wurde).
flash.display.InteractiveObject.nativeDragCompleteflash.desktop.NativeDragActions
NATIVE_DRAG_DROP NativeDragEvent.NATIVE_DRAG_DROP definiert den Wert der type-Eigenschaft eines nativeDragDrop-Ereignisobjekts.nativeDragDropStringWird vom InteractiveObject abgesetzt, wenn eine Drag-and-Drop-Geste über dem Objekt endet. NativeDragEvent.NATIVE_DRAG_DROP definiert den Wert der type-Eigenschaft eines nativeDragDrop-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertallowedActionsDas NativeDragOptions-Objekt, das die für diesen Ziehvorgang relevanten Aktionen angibt.bubblestruecancelabletrue; das Abbrechen dieses Ereignisses bricht den Ziehvorgang ab.clipboardDas Clipboard-Objekt, das die gezogenen Daten enthält. Die Zwischenablage kann auch gelesen werden, wenn das Objekt, das dieses Ereignis auslöst, sich nicht in derselben Sicherheitsdomäne wie der Initiator befindet.dropActionDie vom Ablageziel gewählte Aktion (oder none, wenn keine Aktion festgelegt wurde).
flash.display.InteractiveObject.nativeDragDrop
NATIVE_DRAG_ENTER NativeDragEvent.NATIVE_DRAG_ENTER definiert den Wert der type-Eigenschaft eines nativeDragEnter-Ereignisobjekts.nativeDragEnterStringWird vom InteractiveObject abgesetzt, wenn eine Drag-and-Drop-Geste in die Objektbegrenzungen eintritt. NativeDragEvent.NATIVE_DRAG_ENTER definiert den Wert der type-Eigenschaft eines nativeDragEnter-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertallowedActionsDas NativeDragOptions-Objekt, das die für diesen Ziehvorgang relevanten Aktionen angibt.bubblestruecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.clipboardDas Clipboard-Objekt, das die gezogenen Daten enthält. Die Zwischenablage kann nur gelesen werden, wenn das Objekt, das dieses Ereignis auslöst, sich in derselben Sicherheitsdomäne wie der Initiator befindet.dropActionDie vom Ablageziel gewählte Aktion (oder none, wenn keine Aktion festgelegt wurde).
flash.display.InteractiveObject.nativeDragEnter
NATIVE_DRAG_EXIT NativeDragEvent.NATIVE_DRAG_EXIT definiert den Wert der type-Eigenschaft eines nativeDragExit-Ereignisobjekts.nativeDragExitStringWird vom InteractiveObject abgesetzt, wenn eine Drag-and-Drop-Geste die Objektbegrenzungen verlässt. NativeDragEvent.NATIVE_DRAG_EXIT definiert den Wert der type-Eigenschaft eines nativeDragExit-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertallowedActionsDas NativeDragOptions-Objekt, das die für diesen Ziehvorgang relevanten Aktionen angibt.bubblestruecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.clipboardDas Clipboard-Objekt, das die gezogenen Daten enthält. Die Zwischenablage kann nur gelesen werden, wenn das Objekt, das dieses Ereignis auslöst, sich in derselben Sicherheitsdomäne wie der Initiator befindet.dropActionDie vom Ablageziel gewählte Aktion (oder none, wenn keine Aktion festgelegt wurde).
flash.display.InteractiveObject.nativeDragExit
NATIVE_DRAG_OVER NativeDragEvent.NATIVE_DRAG_OVER definiert den Wert der type-Eigenschaft eines nativeDragOver-Ereignisobjekts.nativeDragOverStringWird vom InteractiveObject abgesetzt, während sich eine Drag-and-Drop-Geste über dem Objekt abspielt. NativeDragEvent.NATIVE_DRAG_OVER definiert den Wert der type-Eigenschaft eines nativeDragOver-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertallowedActionsDas NativeDragOptions-Objekt, das die für diesen Ziehvorgang relevanten Aktionen angibt.bubblestruecancelabletrue; das Abbrechen dieses Ereignisses bricht den Ziehvorgang ab.clipboardDas Clipboard-Objekt, das die gezogenen Daten enthält. Die Zwischenablage kann nur gelesen werden, wenn das Objekt, das dieses Ereignis auslöst, sich in derselben Sicherheitsdomäne wie der Initiator befindet.dropActionDie vom Ablageziel gewählte Aktion (oder none, wenn keine Aktion festgelegt wurde).
flash.display.InteractiveObject.nativeDragOver
NATIVE_DRAG_START NativeDragEvent.NATIVE_DRAG_START definiert den Wert der type-Eigenschaft eines nativeDragStart-Ereignisobjekts.nativeDragStartStringWird zu Beginn einer nativen Drag-and-Drop-Geste vom Quell-InteractiveObject abgesetzt. NativeDragEvent.NATIVE_DRAG_START definiert den Wert der type-Eigenschaft eines nativeDragStart-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertallowedActionsDas NativeDragOptions-Objekt, das die für diesen Ziehvorgang relevanten Aktionen angibt.bubblestruecancelabletrue; das Abbrechen dieses Ereignisses bricht den Ziehvorgang ab.clipboardDas Clipboard-Objekt, das die gezogenen Daten enthält. dropActionDie vom Ablageziel gewählte Aktion (oder none, wenn keine Aktion festgelegt wurde).
flash.display.InteractiveObject.nativeDragStart
NATIVE_DRAG_UPDATE NativeDragEvent.NATIVE_DRAG_UPDATE definiert den Wert der type-Eigenschaft eines nativeDragUpdate-Ereignisobjekts.nativeDragUpdateStringWird vom Quell-InteractiveObject abgesetzt, während eine Drag-and-Drop-Geste stattfindet. NativeDragEvent.NATIVE_DRAG_UPDATE definiert den Wert der type-Eigenschaft eines nativeDragUpdate-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertallowedActionsDas NativeDragOptions-Objekt, das die für diesen Ziehvorgang relevanten Aktionen angibt.bubblestruecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.clipboardDas Clipboard-Objekt, das die gezogenen Daten enthält. dropActionDie vom Ablageziel gewählte Aktion (oder none, wenn keine Aktion festgelegt wurde).
flash.display.InteractiveObject.nativeDragUpdate
allowedActions Das NativeDragOptions-Objekt, das die Aktionen festlegt, die vom Anzeigeobjekt, das diesen Ziehvorgang eingeleitet hat, zugelassen sind.flash.desktop:NativeDragOptions Das NativeDragOptions-Objekt, das die Aktionen festlegt, die vom Anzeigeobjekt, das diesen Ziehvorgang eingeleitet hat, zugelassen sind. flash.desktop.NativeDragOptionsclipboard Das Clipboard-Objekt, das in diesem Ziehvorgang die Daten enthält.flash.desktop:Clipboard Das Clipboard-Objekt, das in diesem Ziehvorgang die Daten enthält.

Wenn sich das Objekt, das das Ereignis auslöst, nicht in derselben Sicherheitsdomäne befindet wie das initiierende Objekt, kann die Zwischenablage nur in der Prozedur für ein nativeDragDrop-Ereignis gelesen werden.

flash.desktop.Clipboard
dropAction Die aktuelle Aktion.String Die aktuelle Aktion. Im nativeDragComplete-Ereignis protokolliert die dropAction-Eigenschaft die endgültige Aktion.
PressAndTapGestureEvent Mit der PressAndTapGestureEvent-Klasse können Sie Drücken-und-Tippen-Gesten auf berührungsempfindlichen Geräten verarbeiten.bietet Unterstützung für die Ereignisverarbeitung für Drücken-und-Tippen-Gesten flash.events:GestureEvent Mit der PressAndTapGestureEvent-Klasse können Sie Drücken-und-Tippen-Gesten auf berührungsempfindlichen Geräten verarbeiten. Objekte, die Eigenschaften von der InteractiveObject-Klasse erben, erfassen den primären Berührungspunkt (Drücken) und einen sekundären Berührungspunkt (Tippen) im abgesetzten Ereignisobjekt. Die Drücken-und-Tippen-Geste wird normalerweise verwendet, um ein Kontextmenü aufzurufen. Das folgende Beispiel zeigt die Ereignisverarbeitung für das GESTURE_PRESS_AND_TAP-Ereignis. Während der Benutzer eine Drücken-und-Tippen-Geste auf dem berührungsempfindlichen Gerät ausführt, dreht sich mySprite und in myTextField wird die aktuelle Phase angezeigt. Multitouch.inputMode = MultitouchInputMode.GESTURE; var mySprite = new Sprite(); mySprite.addEventListener(PressAndTapGestureEvent.GESTURE_PRESS_AND_TAP , onPressAndTap ); mySprite.graphics.beginFill(0x336699); mySprite.graphics.drawRect(0, 0, 100, 80); var myTextField = new TextField(); myTextField.y = 200; addChild(mySprite); addChild(myTextField); function onPressAndTap(evt:PressAndTapGestureEvent):void { evt.target.rotation -= 45; if (evt.phase==GesturePhase.BEGIN) { myTextField.text = "Begin"; } if (evt.phase==GesturePhase.UPDATE) { myTextField.text = "Update"; } if (evt.phase==GesturePhase.END) { myTextField.text = "End"; } } flash.ui.Multitouchflash.display.InteractiveObjectflash.events.TouchEventflash.events.GestureEventflash.events.MouseEventflash.events.EventDispatcher.addEventListener()gesturePressAndTapflash.events:PressAndTapGestureEvent:GESTURE_PRESS_AND_TAPflash.events:PressAndTapGestureEventflash.display.InteractiveObject.gesturePressAndTapflash.events.GesturePhasePressAndTapGestureEvent Erstellt ein Event-Objekt, das Informationen zu komplexen Mehrfinger-Ereignissen enthält, zum Beispiel, wenn ein Benutzer ein kontextabhängiges Popupmenü aufruft.typeString Der Typ des Ereignisses: PressAndTapGestureEvent.GESTURE_PRESS_AND_TAP. bubblesBooleantrue Legt fest, ob das Ereignisobjekt an der Bubbling-Phase des Ereignisablaufs teilnimmt. cancelableBooleanfalseBestimmt, ob das Ereignisobjekt abgebrochen werden kann. phaseStringnullDieser Wert verfolgt den Anfang, den Fortschritt und das Ende einer Berührungsgeste. Mögliche Werte sind: GesturePhase.BEGIN, GesturePhase.END, GesturePhase.UPDATE oder GesturePhase.ALL. localXNumber0Die horizontale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden Anzeigeobjekt steht. localYNumber0Die vertikale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden Anzeigeobjekt steht. tapLocalXNumber0Die horizontale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden interaktiven Objekt steht. tapLocalYNumber0Die vertikale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden interaktiven Objekt steht. ctrlKeyBooleanfalseUnter Windows oder Linux wird damit angezeigt, ob die Strg-Taste aktiviert ist. Unter Mac OS wird damit angezeigt, ob die Ctrl-Taste oder die Befehlstaste aktiviert ist. altKeyBooleanfalseGibt an, ob die Alt-Taste aktiviert ist (nur Windows oder Linux). shiftKeyBooleanfalseGibt an, ob der Umschalttasten-Modifizierer aktiviert ist. commandKeyBooleanfalse(nur AIR); gibt an, ob die Befehlstaste aktiviert ist (nur Mac). Dieser Parameter gilt nur für Adobe AIR. Setzen Sie ihn nicht für Flash Player-Inhalte. controlKeyBooleanfalse(nur AIR); gibt an, ob die Ctrl- oder Strg-Taste aktiviert ist. Dieser Parameter gilt nur für Adobe AIR. Setzen Sie ihn nicht für Flash Player-Inhalte. Konstruktor für PressAndTapGestureEvent-Objekte. Erstellt ein Event-Objekt, das Informationen zu komplexen Mehrfinger-Ereignissen enthält, zum Beispiel, wenn ein Benutzer ein kontextabhängiges Popupmenü aufruft. Ereignisobjekte werden Ereignis-Listenern als Parameter übergeben. flash.ui.Multitouchflash.events.TouchEventflash.events.GestureEventflash.events.GesturePhaseflash.events.MouseEventflash.events.EventDispatcher.addEventListener()clone Erstellt eine Kopie des PressAndTapGestureEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.Ein neues PressAndTapGestureEvent-Objekt mit Eigenschaftswerten, die denen des Originals entsprechen. flash.events:Event Erstellt eine Kopie des PressAndTapGestureEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht. toString Gibt einen String zurück, der alle Eigenschaften des PressAndTapGestureEvent-Objekts enthält.Ein String, der alle Eigenschaften des PressAndTapGestureEvent-Objekts enthält. String Gibt einen String zurück, der alle Eigenschaften des PressAndTapGestureEvent-Objekts enthält. Der String liegt im folgenden Format vor:

[PressAndTapGestureEvent type=Wert bubbles=Wert cancelable=Wert ... ]

GESTURE_PRESS_AND_TAP Definiert den Wert der type-Eigenschaft eines GESTURE_PRESS_AND_TAP-Berührungsereignisobjekts.gesturePressAndTapString Definiert den Wert der type-Eigenschaft eines GESTURE_PRESS_AND_TAP-Berührungsereignisobjekts.

Das abgesetzte PressAndTapGestureEvent-Objekt hat folgende Eigenschaften:

EigenschaftWertaltKeytrue, wenn die Alt-Taste aktiviert ist (Windows oder Linux).bubblestruecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.commandKeytrue unter Mac OS, falls die Befehlstaste aktiviert ist; false, wenn sie deaktiviert ist. Unter Windows immer false controlKeytrue, wenn die Strg- oder Ctrl-Taste aktiv ist; false, wenn sie nicht aktiv ist.ctrlKeytrue unter Windows oder Linux, wenn die Strg-Taste aktiv ist. true unter Mac OS, falls die Strg-Taste oder die Befehlstaste aktiv ist. Andernfalls wird false zurückgegeben.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.eventPhaseDie aktuelle Phase, während das Ereignis die Objekthierarchie durchläuft; ein numerischer Wert, der angibt, ob das Ereignis erfasst wird (1), beim Ziel angekommen ist (2) oder aufsteigt (3).localXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden Anzeigeobjekt steht.localYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden Anzeigeobjekt steht.phaseDie aktuelle Phase in einem Ereignisablauf; ein Wert aus der GesturePhase-Klasse. Mögliche Werte sind: GesturePhase.BEGIN, GesturePhase.UPDATE, GesturePhase.END oder GesturePhase.ALL. Eine Drücken-und-Tippen-Geste generiert entweder eine Abfolge von GesturePhase.BEGIN, GesturePhase.UPDATE, GesturePhase.END oder die Geste generiert eine einzelne GesturePhase.ALL-Phase.shiftKeytrue, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist.stageXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.stageYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.tapLocalXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden interaktiven Objekt steht.tapLocalYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden interaktiven Objekt steht.tapStageXDie horizontale Koordinate, an der die Tippberührung aufgetreten ist, in globalen Bühnenkoordinaten.tapStageYDie vertikale Koordinate, an der die Tippberührung aufgetreten ist, in globalen Bühnenkoordinaten.targetDie InteractiveObject-Instanz unter dem Touchpen oder Finger. Das unter target angegebene Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet.
flash.display.InteractiveObject.gesturePressAndTapflash.events.GesturePhase
tapLocalX Die horizontale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden interaktiven Objekt steht.Number Die horizontale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden interaktiven Objekt steht. tapLocalY Die vertikale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden interaktiven Objekt steht.Number Die vertikale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden interaktiven Objekt steht. tapStageX Die horizontale Koordinate, an der die Tippberührung aufgetreten ist, in globalen Bühnenkoordinaten.Number Die horizontale Koordinate, an der die Tippberührung aufgetreten ist, in globalen Bühnenkoordinaten. Diese Eigenschaft wird berechnet, wenn die Eigenschaft tapLocalX eingerichtet wird. tapStageY Die vertikale Koordinate, an der die Tippberührung aufgetreten ist, in globalen Bühnenkoordinaten.Number Die vertikale Koordinate, an der die Tippberührung aufgetreten ist, in globalen Bühnenkoordinaten. Diese Eigenschaft wird berechnet, wenn die Eigenschaft tapLocalX eingerichtet wird.
GeolocationEvent Ein Geolocation-Objekt setzt GeolocationEvent-Objekte ab, wenn es Updates vom Lokalisierungssender, der in das Gerät eingebaut ist, empfängt.flash.events:Event Ein Geolocation-Objekt setzt GeolocationEvent-Objekte ab, wenn es Updates vom Lokalisierungssender, der in das Gerät eingebaut ist, empfängt. updateflash.events:GeolocationEvent:UPDATEflash.events:GeolocationEventGeolocationEvent Erstellt ein GeolocationEvent-Objekt, das Informationen über den Standort des Geräts enthält.typeString Gibt den Ereignistyp an. Ereignis-Listener können über die übernommene Eigenschaft type auf diese Informationen zugreifen. Es gibt nur einen Typ eines Updateereignisses: GeolocationEvent.UPDATE. bubblesBooleanfalseGibt an, ob das Ereignis ein Bubbling-Ereignis ist (propagiert werden kann). Ereignis-Listener können über die übernommene Eigenschaft bubbles auf diese Informationen zugreifen. cancelableBooleanfalseLegt fest, ob das Ereignisobjekt abgebrochen werden kann. Ereignis-Listener können über die übernommene Eigenschaft cancelable auf diese Informationen zugreifen. latitudeNumber0Gibt den Breitengrad an. Der Wert kann im folgenden Bereich liegen: (-90 <= Breite <= +90). longitudeNumber0Gibt den Längengrad an. Der Wert kann im folgenden Bereich liegen: (-180 <= Länge <= +180). altitudeNumber0Gibt die Höhe in Metern an. hAccuracyNumber0Gibt die horizontale Genauigkeit in Metern an. vAccuracyNumber0Gibt die vertikale Genauigkeit in Metern an. speedNumber0 Geschwindigkeit in Meter pro Sekunde. headingNumber0Gibt die Bewegungsrichtung in Grad an (in Relation zum geografischen Norden). timestampNumber0Gibt den Zeitstempel des Updates der Geolokalisierung an. Konstruktor für GeolocationEvent-Objekte. Erstellt ein GeolocationEvent-Objekt, das Informationen über den Standort des Geräts enthält. Ereignisobjekte werden Ereignis-Listenern als Parameter übergeben. clone Erstellt eine Kopie des GeolocationEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.Ein neues GeolocationEvent-Objekt mit Eigenschaftswerten, die denen des Originals entsprechen. flash.events:Event Erstellt eine Kopie des GeolocationEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht. toString Gibt einen String zurück, der alle Eigenschaften des GeolocationEvent-Objekts enthält.Ein String, der alle Eigenschaften des GeolocationEvent-Objekts enthält. String Gibt einen String zurück, der alle Eigenschaften des GeolocationEvent-Objekts enthält. Der String liegt im folgenden Format vor:

[GeolocationEvent type=Wert bubbles=Wert cancelable=Wert status=Wert]

UPDATE Definiert den Wert der type-Eigenschaft eines GeolocationEvent-Ereignisobjekts.updateString Definiert den Wert der type-Eigenschaft eines GeolocationEvent-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.targetDas Geolocation-Objekt, das Daten empfängt.
altitude Die Höhe in Metern.Number Die Höhe in Metern.

Wenn Höhenangaben vom Gerät nicht unterstützt werden, wird diese Eigenschaft auf NaN gesetzt.

heading Die Bewegungsrichtung in Grad (in Relation zum geografischen Norden).Number Die Bewegungsrichtung in Grad (in Relation zum geografischen Norden). Dies ist nicht das Gleiche wie die Peilung („bearing“), wobei die Bewegungsrichtung in Bezug auf einen anderen Punkt angegeben wird.

Hinweis: Bei Android-Geräten wird „heading“ nicht unterstützt. Der Wert der heading-Eigenschaft ist immer NaN (Not a Number, keine Zahl).

horizontalAccuracy Die horizontale Genauigkeit in Metern.Number Die horizontale Genauigkeit in Metern. latitude Der Breitengrad.Number Der Breitengrad. Der Breitengradwert liegt im folgenden Bereich: (-90 <= latitude <= 90). Negative Breite ist „Süd“ und positive Breite ist „Nord“. longitude Der Längengrad.Number Der Längengrad. Der Längengradwert liegt im folgenden Bereich: (-180 <= longitude < 180). Negative Länge ist „West“ und positive Länge ist „Ost“. speed Die Geschwindigkeit in Meter pro Sekunde.Number Die Geschwindigkeit in Meter pro Sekunde. timestamp Die Anzahl der Millisekunden seit der Initialisierung der Laufzeitumgebung bis zum Auftreten des Ereignisses.Number Die Anzahl der Millisekunden seit der Initialisierung der Laufzeitumgebung bis zum Auftreten des Ereignisses. Wenn das Gerät zum Beispiel 4 Sekunden nach der Initialisierung der Anwendung Beschleunigungsdaten erfasst, wird die timestamp-Eigenschaft des Ereignisses auf 4000 gesetzt. verticalAccuracy Die vertikale Genauigkeit in Metern.Number Die vertikale Genauigkeit in Metern.
MediaEvent Die CameraRoll- und CameraUI-Klassen setzen MediaEvent-Objekte ab, wenn ein Medienstream verfügbar ist.flash.events:Event Die CameraRoll- und CameraUI-Klassen setzen MediaEvent-Objekte ab, wenn ein Medienstream verfügbar ist.

Die CameraRoll-Klasse setzt ein MediaEvent-Objekt des Typsselect ab, wenn der Benutzer ein Bild auswählt. Die CameraUI-Klasse setzt ein MediaEvent-Objekt des Typs complete ab, wenn ein Bild oder Video, dass mit der Gerätekamera aufgenommen wurde, zurückgegeben wird.

CameraRollCameraUIcompleteflash.events:MediaEvent:COMPLETEflash.events:MediaEventDer complete-Ereignistyp. selectflash.events:MediaEvent:SELECTflash.events:MediaEventDer select-Ereignistyp. MediaEvent Erstellt ein MediaEvent-Objekt, das Informationen zu der verfügbaren Mediendatei enthält.typeStringDer Ereignistyp. bubblesBooleanfalseLegt fest, ob das Ereignisobjekt eine Bubbling-Phase durchführt. cancelableBooleanfalseBestimmt, ob das Ereignisobjekt abgebrochen werden kann. dataflash.media:MediaPromisenullDas MediaPromise-Objekt, das dem ausgewählten Bild entspricht. Konstruktor für MediaEvent-Objekte. Erstellt ein MediaEvent-Objekt, das Informationen zu der verfügbaren Mediendatei enthält. Ereignisobjekte werden Ereignis-Listenern als Parameter übergeben. clone Erstellt eine Kopie des MediaEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.ein neues MediaEvent-Objekt mit Eigenschaftswerten, die denen des Originals entsprechen. flash.events:Event Erstellt eine Kopie des MediaEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht. toString Gibt eine Zeichenfolge zurück, die alle Eigenschaften des MediaEvent-Objekts enthält.ein neues MediaEvent-Objekt mit Eigenschaftswerten, die denen des Originals entsprechen. String Gibt eine Zeichenfolge zurück, die alle Eigenschaften des MediaEvent-Objekts enthält. Das folgende Format wird verwendet:

[MediaEvent type=Wert bubbles=Wert cancelable=Wert data=Wert ]

COMPLETE Eine Konstante für das complete-MediaEvent.completeStringDer complete-Ereignistyp. Eine Konstante für das complete-MediaEvent.

Definiert den Wert der type-Eigenschaft eines MediaEvent-Ereignisobjekts. Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.dataDas MediaPromise-Objekt der verfügbaren Medieninstanz.
SELECT Eine Konstante für das select-MediaEvent.selectStringDer select-Ereignistyp. Eine Konstante für das select-MediaEvent.

Definiert den Wert der type-Eigenschaft eines MediaEvent-Ereignisobjekts. Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.dataDas MediaPromise-Objekt der verfügbaren Medieninstanz.
data Das MediaPromise-Objekt für die verfügbare Mediendatei.flash.media:MediaPromise Das MediaPromise-Objekt für die verfügbare Mediendatei.
StageVideoEvent Ein StageVideo-Objekt setzt ein StageVideoEvent-Objekt ab, nachdem sowohl die attachNetStream()-Methode des StageVideo-Objekts als auch die play()-Methode des angehängten NetStream-Objekts aufgerufen wurden.Ereignisobjekte für StageVideo-Ereignisse. flash.events:Event Ein StageVideo-Objekt setzt ein StageVideoEvent-Objekt ab, nachdem sowohl die attachNetStream()-Methode des StageVideo-Objekts als auch die play()-Methode des angehängten NetStream-Objekts aufgerufen wurden. Je nach Plattform können außerdem Änderungen am Wiedergabestatus zum Absetzen des Ereignisses führen. Der Typ von StageVideoEvent ist StageVideoEvent.RENDER_STATE. renderStateflash.events:StageVideoEvent:RENDER_STATEflash.events:StageVideoEventflash.events.StageVideoEvent.RENDER_STATEflash.events.StageVideoEvent.RENDER_STATUS_UNAVAILABLEflash.events.StageVideoEvent.RENDER_STATUS_SOFTWAREflash.events.StageVideoEvent.RENDER_STATUS_ACCELERATEDStageVideoEvent Erstellt ein Ereignisobjekt, das Informationen über StageVideo-Ereignisse enthält.typeString Der Ereignistyp. Ereignis-Listener können über die übernommene Eigenschaft type auf diese Informationen zugreifen. Der Typ von StageVideoEvent ist StageVideoEvent.RENDER_STATE. bubblesBooleanfalseBestimmt, ob das Ereignisobjekt an der Bubbling-Phase des Ereignisablaufs teilnimmt. Ereignis-Listener können über die übernommene Eigenschaft bubbles auf diese Informationen zugreifen. cancelableBooleanfalseBestimmt, ob das Ereignisobjekt abgebrochen werden kann. Ereignis-Listener können über die übernommene Eigenschaft cancelable auf diese Informationen zugreifen. statusStringnullGibt den Status des StageVideo-Zielobjekts an. colorSpaceStringnullDer Farbraum, der vom angezeigten Video verwendet wird. Konstruktor für StageVideoEvent-Objekte. Erstellt ein Ereignisobjekt, das Informationen über StageVideo-Ereignisse enthält. Ereignisobjekte werden Ereignis-Listenern als Parameter übergeben. flash.media.StageVideoflash.display.Stage.stageVideosflash.events.StageVideoEvent.RENDER_STATERENDER_STATE Die StageVideoEvent.RENDER_STATE-Konstante definiert den Wert der type-Eigenschaft eines renderState-Ereignisobjekts.renderStateString Die StageVideoEvent.RENDER_STATE-Konstante definiert den Wert der type-Eigenschaft eines renderState-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.colorSpaceDie verfügbaren Farbräume für die Wiedergabe des Videos.currentTargetDas Objekt, welches das StageVideoEvent-Objekt aktiv mit einem Ereignis-Listener verarbeitet.statusGibt an, ob das Video von der Hardware gerendert (dekodiert und angezeigt) wird, von der Software, oder gar nicht.targetDas StageVideo-Objekt, dessen Zustand sich geändert hat.
flash.events.StageVideoEvent.RENDER_STATEflash.events.StageVideoEvent.RENDER_STATUS_UNAVAILABLEflash.events.StageVideoEvent.RENDER_STATUS_SOFTWAREflash.events.StageVideoEvent.RENDER_STATUS_ACCELERATED
RENDER_STATUS_ACCELERATED Zeigt an, dass das Video von der Hardware dekodiert und angezeigt wird.acceleratedString Zeigt an, dass das Video von der Hardware dekodiert und angezeigt wird.

Dieser Wert ist einer der möglichen Werte der status-Eigenschaft des StageVideoEvent-Objekts.

status
RENDER_STATUS_SOFTWARE Zeigt an, dass das Video von der Software dekodiert und angezeigt wird.softwareString Zeigt an, dass das Video von der Software dekodiert und angezeigt wird.

Dieser Wert ist einer der möglichen Werte der status-Eigenschaft des StageVideoEvent-Objekts.

Wenn die Plattform zum Beispiel das Dekodieren und Anzeigen des Audio- oder Videocodecs des Videos nicht unterstützt, hat das StageVideoEvent-Objekt diesen status-Wert.

status
RENDER_STATUS_UNAVAILABLE Zeigt an, dass die Anzeige des Videos mit dem StageVideo-Objekt nicht möglich war.unavailableString Zeigt an, dass die Anzeige des Videos mit dem StageVideo-Objekt nicht möglich war.

Dieser Wert ist einer der möglichen Werte der status-Eigenschaft des StageVideoEvent-Objekts.

Beispiel: Eine Plattform unterstützt das Decodieren und Anzeigen des Audio- oder Videocodecs des Videos weder mit Software noch mit Hardware. In diesem Fall hat das StageVideoEvent-Objekt diesen status-Wert.

Dieser status-Wert wird auch verwendet, wenn keine Hardware-Decoder verfügbar sind. Dies kann bei AIR für TV vorkommen. Aus Gründen der Abwärtskompatibilität mit früheren Versionen ermöglicht AIR für TV die Verwendung eines Video-Objekts für die Hardwaredekodierung und -anzeige. Mit einem Video-Objekt verwenden Sie den zugrunde liegenden Hardware-Decoder und haben deshalb ein StageVideo-Objekt weniger zur Verfügung. Es wird empfohlen, ein StageVideo-Objekt für die Videodekodierung und -anzeige mittels Hardware zu verwenden.

status
colorSpace Der Farbraum, der vom Video verwendet wird, das im StageVideo-Objekt angezeigt wird.String Der Farbraum, der vom Video verwendet wird, das im StageVideo-Objekt angezeigt wird. flash.media.StageVideostatus Der Status des StageVideo-Objekts.String Der Status des StageVideo-Objekts. flash.events.StageVideoEvent.RENDER_STATUS_UNAVAILABLEflash.events.StageVideoEvent.RENDER_STATUS_SOFTWAREflash.events.StageVideoEvent.RENDER_STATUS_ACCELERATED
LocationChangeEvent Ein HTMLLoader- oder StageWebView-Objekt setzt ein LocationChangeEvent-Objekt ab, wenn eine neue Seite geladen wird.flash.events:Event Ein HTMLLoader- oder StageWebView-Objekt setzt ein LocationChangeEvent-Objekt ab, wenn eine neue Seite geladen wird.

Es gibt zwei LocationChangeEvent-Typen:

  • LocationChangeEvent.LOCATION_CHANGING: wird vor einer Änderung abgesetzt, die über den in einem StageWebView-Objekt angezeigten Inhalt initiiert wird. Kann abgebrochen werden.
  • LocationChangeEvent.LOCATION_CHANGE: wird nach jeder Positionsänderung abgesetzt. Kann nicht abgebrochen werden.
StageWebViewLocationChangeEvent Erstellt ein LocationChangeEvent-Objekt.typeStringbubblesBooleanfalsecancelableBooleanfalselocationStringnull Erstellt ein LocationChangeEvent-Objekt. clone flash.events:Event toString Gibt einen String zurück, der alle Eigenschaften des LocationChangeEvent-Objekts enthält.String Gibt einen String zurück, der alle Eigenschaften des LocationChangeEvent-Objekts enthält. Der String liegt im folgenden Format vor:

[LocationChangeEvent type=Wert bubbles=Wert cancelable=Wert eventPhase=Wert location=Wert

LOCATION_CHANGE Wird nach jeder Positionsänderung abgesetzt.locationChangeString Wird nach jeder Positionsänderung abgesetzt. LOCATION_CHANGING Die LOCATION_CHANGING-Konstante definiert den Wert der type-Eigenschaft des LocationChangeEvent-Objekts, das vor einer Änderung der Seitenposition abgesetzt wird.locationChangingString Die LOCATION_CHANGING-Konstante definiert den Wert der type-Eigenschaft des LocationChangeEvent-Objekts, das vor einer Änderung der Seitenposition abgesetzt wird. location Die Ziel-URL der Änderung.String Die Ziel-URL der Änderung.
NetDataEvent Ein NetStream-Objekt setzt ein NetDataEvent-Objekt ab, wenn im Medienstream eine Datennachricht erkannt wird.flash.events:Event Ein NetStream-Objekt setzt ein NetDataEvent-Objekt ab, wenn im Medienstream eine Datennachricht erkannt wird.

Ein NetDataEvent wird für die folgenden Nachrichten abgesetzt:

  • onCuePoint
  • onImageData
  • onMetaData
  • onPlayStatus (für den Code NetStream.Play.Complete)
  • onTextData
  • onXMPData
NetDataEvent Erstellt ein Ereignisobjekt, das Informationen über Mediendatenereignisse enthält.typeString Der Ereignistyp. Ereignis-Listener können über die übernommene Eigenschaft type auf diese Informationen zugreifen. bubblesBooleanfalseLegt fest, ob das Ereignisobjekt an der Bubbling-Phase des Ereignisablaufs teilnimmt. Ereignis-Listener können über die übernommene Eigenschaft bubbles auf diese Informationen zugreifen. cancelableBooleanfalseBestimmt, ob das Ereignisobjekt abgebrochen werden kann. Ereignis-Listener können über die übernommene Eigenschaft cancelable auf diese Informationen zugreifen. timestampNumber0Zeitstempel der Datenmeldung infoObjectnullDatenmeldungsobjekt Erstellt ein Ereignisobjekt, das Informationen über Mediendatenereignisse enthält. Ereignisobjekte werden Ereignis-Listenern als Parameter übergeben. clone Erstellt eine Kopie des NetDataEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.Ein neues NetDataEvent-Objekt mit Eigenschaftswerten, die denen des Originals entsprechen. flash.events:Event Erstellt eine Kopie des NetDataEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht. toString Gibt einen String zurück, der alle Eigenschaften des NetDataEvent-Objekts enthält.Ein String, der alle Eigenschaften des NetMediaEvent-Objekts enthält. String Gibt einen String zurück, der alle Eigenschaften des NetDataEvent-Objekts enthält. Das folgende Format wird verwendet:

[NetDataEvent type=Wert bubbles=Wert cancelable=Wert timestamp=Wert]

MEDIA_TYPE_DATA Die NetDataEvent.MEDIA_TYPE_DATA-Konstante definiert den Wert der type-Eigenschaft des NetDataEvent-Objekts, das abgesetzt wird, wenn das NetStream-Objekt eine Datennachricht im Medienstream erkennt.mediaTypeDataString Die NetDataEvent.MEDIA_TYPE_DATA-Konstante definiert den Wert der type-Eigenschaft des NetDataEvent-Objekts, das abgesetzt wird, wenn das NetStream-Objekt eine Datennachricht im Medienstream erkennt. info Ein Datenobjekt, das die Nachricht beschreibt.Object Ein Datenobjekt, das die Nachricht beschreibt. Das info-Objekt hat zwei Eigenschaften: info.handler und info.args. info.handler ist der Name der Prozedur, zum Beispiel „onMetaData“ oder „onXMPData“. info.args ist ein Array von Argumenten. timestamp Der Zeitstempel der Datenmeldung im Medienstream.Number Der Zeitstempel der Datenmeldung im Medienstream.
NativeProcessExitEvent Dieses Ereignis wird vom NativeProcess-Objekt abgesetzt, wenn der Prozess beendet wird.flash.events:Event Dieses Ereignis wird vom NativeProcess-Objekt abgesetzt, wenn der Prozess beendet wird. Es ist möglich, dass dieses Ereignis nie abgesetzt wird. Wenn zum Beispiel der untergeordnete Prozess länger andauert als die AIR-Anwendung, die ihn erstellt hat, wird das Ereignis nicht abgesetzt. flash.desktop.NativeProcessexitflash.events:NativeProcessExitEvent:EXITflash.events:NativeProcessExitEventNativeProcessExitEvent Erstellt ein NativeProcessExitEvent, das spezifische Informationen zum Beenden-Code eines NativeProcess enthält typeString Der Typ des Ereignisses, auf den als Event.type zugegriffen werden kann. bubblesBooleanfalse Bestimmt, ob das Ereignisobjekt an der Bubbling-Phase des Ereignisablaufs teilnimmt. Der Standardwert ist false. cancelableBooleanfalseBestimmt, ob das Ereignisobjekt abgebrochen werden kann. Der Standardwert lautet false. exitCodeNumberunknownZahl, die der Prozess beim Beenden an das Betriebssystem zurückgegeben hat. Erstellt ein NativeProcessExitEvent, das spezifische Informationen zum Beenden-Code eines NativeProcess enthält clone Erstellt eine Kopie des NativeProcessExitEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.Ein neues NativeProcessExitEvent-Objekt mit Eigenschaftswerten, die denen des Originals entsprechen. flash.events:Event Erstellt eine Kopie des NativeProcessExitEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht. toString Gibt einen String zurück, der alle Eigenschaften des NativeProcessExitEvent-Objekts enthält.Eine Zeichenfolge, die alle Eigenschaften des ProgressEvent-Objekts enthält. String Gibt einen String zurück, der alle Eigenschaften des NativeProcessExitEvent-Objekts enthält. Der String liegt im folgenden Format vor:

[NativeProcessExitEvent type=Wert bubbles=Wert cancelable=Wert exitCode=Wert]

EXIT Definiert den Wert der type-Eigenschaft eines exit-Ereignisobjekts.exitString Definiert den Wert der type-Eigenschaft eines exit-Ereignisobjekts. exitCode Der Beenden-Code, den der native Prozess beim Beenden an das Host-Betriebssystem zurückgegeben hat.Number Der Beenden-Code, den der native Prozess beim Beenden an das Host-Betriebssystem zurückgegeben hat. Wenn die AIR-Anwendung den Prozess durch einen Aufruf der exit()-Methode des NativeProcess-Objekts beendet, wird die exitCode-Eigenschaft auf NaN (not a number, keine Zahl) gesetzt. HINWEIS: Unter Windows-Betriebssystemen kann dieser Wert auf 259 (STILL_ACTIVE) gesetzt werden, wenn der Prozess nicht beendet wurde, aber die Laufzeitumgebung beendet wird oder ein Fehler aufgetreten ist. Um die Verwechslung mit diesem Zustand zu vermeiden, verwenden Sie 259 nicht als Rückgabecode in einem nativen Prozess.
DNSResolverEvent Die DNSResolverEvent-Klasse stellt die Ergebnisse einer DNS-Nachschlageoperation dar.flash.events:Event Die DNSResolverEvent-Klasse stellt die Ergebnisse einer DNS-Nachschlageoperation dar.

Verwenden Sie die lookup()-Methode von DNSResolver, um eine DNS-Abfrage zu initiieren. Von der Abfrage zurückgegebene Ressourcendatensätze werden im Array resourceRecords dieses DNSResolverEvent-Objekts platziert.

DNSResolverlookupflash.events:DNSResolverEvent:LOOKUPflash.events:DNSResolverEventWird von einem DNSResolver-Objekt abgesetzt, wenn eine Nachschlageoperation beendet ist. DNSResolverEvent Erstellt ein DNSResolverEvent-Objekt, das die Ergebnisse einer DNS-Nachschlageoperation enthält.typeString Der Ereignistyp. Mögliche Werte sind:DNSResolverEvent.LOOKUP bubblesBooleanfalse Bestimmt, ob das Ereignisobjekt an der Bubbling-Phase des Ereignisablaufs teilnimmt. cancelableBooleanfalseBestimmt, ob das Ereignisobjekt abgebrochen werden kann. hostStringDer Abfragestring, zum Beispiel Hostname, IP-Adresse oder der Service-Locator, der im Aufruf der lookup()-Methode der DNSResolver-Klasse verwendet wurde, auf die das neue Ereignis reagiert. resourceRecordsArraynullEine Liste der zurückgegebenen DNS-Ressourcendatensätze. Erstellt ein DNSResolverEvent-Objekt, das die Ergebnisse einer DNS-Nachschlageoperation enthält. Ereignisobjekte werden Ereignis-Listenern als Parameter übergeben. clone Erstellt eine Kopie des DNSResolverEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.Ein neues ServerSocketConnectEvent-Objekt mit Eigenschaftswerten, die denen des Originals entsprechen. flash.events:Event Erstellt eine Kopie des DNSResolverEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht. toString Gibt einen String zurück, der alle Eigenschaften des DNSResolverEvent-Objekts enthält.Eine Zeichenfolge, die alle Eigenschaften des ProgressEvent-Objekts enthält. String Gibt einen String zurück, der alle Eigenschaften des DNSResolverEvent-Objekts enthält. Der String liegt im folgenden Format vor:

[DNSResolverEvent type=Wert bubbles=Wert cancelable=Wert host=Wert resourceRecords=Wert]

LOOKUP Definiert den Wert der type-Eigenschaft eines Nachschlageereignisobjekts.lookupStringWird von einem DNSResolver-Objekt abgesetzt, wenn eine Nachschlageoperation beendet ist. Definiert den Wert der type-Eigenschaft eines lookup-Ereignisobjekts. host Der Abfragestring, zum Beispiel Hostname, IP-Adresse oder der Service-Locator, der im Aufruf der lookup()-Methode der DNSResolver-Klasse verwendet wurde, auf die dieses Ereignis reagiert.StringDer Abfragestring, der in der Nachschlageoperation verwendet wird. Der Abfragestring, zum Beispiel Hostname, IP-Adresse oder der Service-Locator, der im Aufruf der lookup()-Methode der DNSResolver-Klasse verwendet wurde, auf die dieses Ereignis reagiert. resourceRecords Ein Array, das die Ressourcendatensätze enthält, die von der DNS-Nachschlageoperation zurückgegeben wurden.Array Ein Array, das die Ressourcendatensätze enthält, die von der DNS-Nachschlageoperation zurückgegeben wurden.
Event Die Event-Klasse wird als Basisklasse bei der Erstellung von Ereignisobjekten verwendet, die beim Auftreten eines Ereignisses als Parameter an Ereignis-Listener übergeben werden.Basisklasse des Ereignisobjekts. Object Die Event-Klasse wird als Basisklasse bei der Erstellung von Ereignisobjekten verwendet, die beim Auftreten eines Ereignisses als Parameter an Ereignis-Listener übergeben werden.

Die Eigenschaften der Event-Klasse enthalten allgemeine Informationen über ein Ereignis, z. B. den Ereignistyp und ob das Standardverhalten eines Ereignisses abgebrochen werden kann. Für viele Ereignisse, beispielsweise die von den Konstanten der Event-Klasse dargestellten Ereignisse, sind die allgemeinen Informationen ausreichend. Andere Ereignisse benötigen jedoch ausführlichere Informationen. Ereignisse, die mit einem Mausklick verknüpft sind, erfordern beispielsweise zusätzliche Informationen über die Position des Klick-Ereignisses, und ob bestimmte Tasten während des Klick-Ereignisses gedrückt wurden. Diese zusätzlichen Informationen können Sie durch das Erweitern der Event-Klasse an Ereignis-Listener übergeben. Genau dies wird von der MouseEvent-Klasse vorgenommen. Die ActionScript 3.0-API definiert verschiedene Unterklassen der Event-Klasse für allgemeine Ereignisse, die zusätzliche Informationen erfordern. Ereignisse, die mit den einzelnen Event-Unterklassen verknüpft sind, sind in der Dokumentation der einzelnen Klassen beschrieben.

Die Methoden der Event-Klasse können in den Ereignis-Listener-Funktionen eingesetzt werden, um das Verhalten des Ereignisobjekts zu beeinflussen. Einigen Ereignissen ist ein Standardverhalten zugewiesen. So markiert das doubleClick-Ereignis z. B. standardmäßig das zum Zeitpunkt des Ereignisses unter dem Mauszeiger befindliche Wort. Ihr Ereignis-Listener kann dieses Verhalten abbrechen, indem er die preventDefault()-Methode aufruft. Sie können auch den aktuellen Ereignis-Listener zum letzten Listener machen, der ein Ereignis verarbeitet, indem Sie die stopPropagation()- oder stopImmediatePropagation()-Methode aufrufen.

Weitere Informationsquellen:

  • Eine hilfreiche Beschreibung der Zeitgebung von Ereignissen, Codeausführung und Darstellung zur Laufzeit im Blogeintrag von Ted Patrick: Flash Player Mental Model - The Elastic Racetrack.
  • Ein Blogeintrag von Johannes Tacskovics zur Zeitgebung von Bildereignissen wie ENTER_FRAME, EXIT_FRAME: The MovieClip Lifecycle.
  • Ein Artikel von Trevor McCauley über die Reihenfolge von ActionScript-Operationen: Order of Operations in ActionScript.
  • Ein Blogeintrag von Matt Przybylski zum Erstellen von benutzerdefinierten Ereignissen: AS3: Custom Events.
Im folgenden Beispiel wird anhand der EventExample-Klasse und der benutzerdefinierten Klasse Square die Verwaltung von Ereignis-Bubbling demonstriert. package { import flash.display.Sprite; import flash.events.Event; import flash.events.MouseEvent; public class EventExample extends Sprite { public function EventExample() { var square_0:Square = new Square(300, 0x336633); addChild(square_0); var square_1:Square = new Square(250, 0x669966); square_0.addChild(square_1); var square_2:Square = new Square(200, 0x66CC66); square_1.addChild(square_2); var square_3:Square = new Square(150, 0xAA0000); square_3.shouldBubble = false; square_2.addChild(square_3); var square_4:Square = new Square(100, 0x66FF66); square_3.addChild(square_4); var square_5:Square = new Square(50, 0xCC0000); square_5.shouldBubble = false; square_4.addChild(square_5); this.addEventListener(MouseEvent.CLICK, clickHandler); } private function clickHandler(e:Event):void { trace(">> stage: " + e.type + " event from " + e.target.name + " called on " + this.name); trace(">> --------------------------------------------"); } } } import flash.display.Sprite; import flash.events.Event; import flash.events.MouseEvent; class Square extends Sprite { private var sideLen:int; private var color:Number; public var shouldBubble:Boolean = true; public function Square(sideLen:int, color:Number) { this.sideLen = sideLen; this.color = color; init(); draw(); } private function init():void { buttonMode = true; this.addEventListener(MouseEvent.CLICK, firstClickHandler); this.addEventListener(MouseEvent.CLICK, secondClickHandler); this.addEventListener(MouseEvent.CLICK, thirdClickHandler); } private function draw():void { this.graphics.beginFill(color); this.graphics.drawRect(0, 0, sideLen, sideLen); } private function firstClickHandler(e:Event):void { trace(">> 1e: " + e.type + " event from " + e.target.name + " called on " + this.name); if(!shouldBubble) { e.stopPropagation(); } } private function secondClickHandler(e:Event):void { trace(">> 2e: " + e.type + " event from " + e.target.name + " called on " + this.name); if(!shouldBubble) { e.stopImmediatePropagation(); trace(">> --------------------------------------------"); } } private function thirdClickHandler(e:Event):void { trace(">> 3e: " + e.type + " event from " + e.target.name + " called on " + this.name); } } Im folgenden Beispiel wird der Unterschied zwischen den Ereignissen ADDED und ADDED_TO_STAGE sowie den Ereignissen REMOVED und REMOVED_FROM_STAGE interaktiv gezeigt. Durch Klicken auf ein Sprite wird es mit seinem gesamten geschachtelten Inhalt von der Bühne entfernt. Durch Klicken auf das größte Sprite werden ein REMOVED-Ereignis sowie drei REMOVED_FROM_STAGE-Ereignisse ausgelöst. package { import flash.display.Sprite; import flash.events.*; public class EventExample2 extends Sprite { public function EventExample2():void { var parentSprite:Sprite = createSprite("parentSprite",200); var childSprite:Sprite = createSprite("childSprite",100); var childOfChildSprite:Sprite = createSprite("childOfChildSprite",50); trace(":: Adding to Stage ::"); this.addChild(parentSprite); trace(":: Adding to Stage ::"); parentSprite.addChild(childSprite); trace(":: Adding to Stage ::"); childSprite.addChild(childOfChildSprite); } private function createSprite(name:String,size:uint):Sprite { trace(":: Creating Sprite ::"); var newSprite:Sprite = new Sprite(); newSprite.name = name; newSprite.graphics.beginFill(0xFFFFFF * Math.random(),1); newSprite.graphics.drawRect(0,0,size,size); newSprite.graphics.endFill(); newSprite.addEventListener(Event.ADDED, spriteAdded); newSprite.addEventListener(Event.ADDED_TO_STAGE, spriteAddedToStage); newSprite.addEventListener(Event.REMOVED, spriteRemoved); newSprite.addEventListener(Event.REMOVED_FROM_STAGE, spriteRemovedFromStage); newSprite.addEventListener(MouseEvent.CLICK, remove); return newSprite; } private function remove(event:Event) { if(event.target == event.currentTarget) { trace(":: Removing Clicked Sprite ::"); var target:Sprite = Sprite(event.target); target.parent.removeChild(target); } } private function spriteRemovedFromStage(event:Event):void { trace("REMOVED_FROM_STAGE: " + event.target.name + " : " + event.currentTarget.name); } private function spriteRemoved(event:Event):void { trace("REMOVED: " + event.target.name + " from " + event.currentTarget.name); } private function spriteAddedToStage(event:Event):void { trace("ADDED_TO_STAGE: " + event.target.name + " : " + event.currentTarget.name); } private function spriteAdded(event:Event):void { trace("ADDED: " + event.target.name + " within " + event.currentTarget.name); } } }
flash.events.EventDispatcheractivateflash.events:Event:ACTIVATEflash.events:Eventflash.events.EventDispatcher.activateDEACTIVATEaddedToStageflash.events:Event:ADDED_TO_STAGEflash.events:Eventflash.display.DisplayObject.addedToStageADDEDREMOVEDREMOVED_FROM_STAGEaddedflash.events:Event:ADDEDflash.events:Eventflash.display.DisplayObject.addedADDED_TO_STAGEREMOVEDREMOVED_FROM_STAGEcancelflash.events:Event:CANCELflash.events:Eventflash.net.FileReference.cancelchangeflash.events:Event:CHANGEflash.events:Eventflash.text.TextField.changeflash.events.TextEvent.TEXT_INPUTcopyflash.events:Event:CLEARflash.events:Eventflash.display.InteractiveObject.clearcloseflash.events:Event:CLOSEflash.events:Eventflash.net.Socket.closeflash.net.XMLSocket.closeflash.display.NativeWindow.closeclosingflash.events:Event:CLOSINGflash.events:Eventflash.display.NativeWindow.closingcompleteflash.events:Event:COMPLETEflash.events:Eventflash.display.LoaderInfo.completeflash.html.HTMLLoader.completeflash.media.Sound.completeflash.net.FileReference.completeflash.net.URLLoader.completeflash.net.URLStream.completeconnectflash.events:Event:CONNECTflash.events:Eventflash.net.Socket.connectflash.net.XMLSocket.connectcopyflash.events:Event:COPYflash.events:Eventflash.display.InteractiveObject.copycutflash.events:Event:CUTflash.events:Eventflash.display.InteractiveObject.cutdeactivateflash.events:Event:DEACTIVATEflash.events:Eventflash.events.EventDispatcher.deactivateACTIVATEdisplayingflash.events:Event:DISPLAYINGflash.events:Eventflash.display.NativeMenu.displayingflash.display.NativeMenuItem.displayingenterFrameflash.events:Event:ENTER_FRAMEflash.events:Eventflash.display.DisplayObject.enterFrameexitingflash.events:Event:EXITINGflash.events:Eventflash.desktop.NativeApplication.exitingexitFrameflash.events:Event:EXIT_FRAMEflash.events:Eventflash.display.DisplayObject.exitFrameframeConstructedflash.events:Event:FRAME_CONSTRUCTEDflash.events:Eventflash.display.DisplayObject.frameConstructedfullScreenflash.events:Event:FULLSCREENflash.events:Eventflash.display.Stage.fullScreenhtmlBoundsChangeflash.events:Event:HTML_BOUNDS_CHANGEflash.events:EventhtmlBoundsChange-EreignishtmlDOMInitializeflash.events:Event:HTML_DOM_INITIALIZEflash.events:EventhtmlDOMInitialize-EreignishtmlRenderflash.events:Event:HTML_RENDERflash.events:EventhtmlRender-Ereignisid3flash.events:Event:ID3flash.events:Eventflash.media.Sound.id3initflash.events:Event:INITflash.events:Eventflash.display.LoaderInfo.initlocationChangeflash.events:Event:LOCATION_CHANGEflash.events:EventlocationChange-EreignismouseLeaveflash.events:Event:MOUSE_LEAVEflash.events:Eventflash.display.Stage.mouseLeaveflash.events.MouseEventnetworkChangeflash.events:Event:NETWORK_CHANGEflash.events:Eventflash.desktop.NativeApplication.networkChangeopenflash.events:Event:OPENflash.events:Eventflash.display.LoaderInfo.openflash.media.Sound.openflash.net.FileReference.openflash.net.URLLoader.openflash.net.URLStream.openpasteflash.events:Event:PASTEflash.events:Eventflash.display.InteractiveObject.pasteflash.events.Eventflash.events:Event:PREPARINGflash.events:Eventflash.display.NativeMenu.preparingflash.display.NativeMenuItem.preparingremovedFromStageflash.events:Event:REMOVED_FROM_STAGEflash.events:Eventflash.display.DisplayObject.removedFromStageADDEDREMOVEDADDED_TO_STAGEremovedflash.events:Event:REMOVEDflash.events:Eventflash.display.DisplayObject.removedADDEDADDED_TO_STAGEREMOVED_FROM_STAGErenderflash.events:Event:RENDERflash.events:Eventflash.display.DisplayObject.renderflash.display.Stage.invalidate()resizeflash.events:Event:RESIZEflash.events:Eventflash.display.Stage.resizescrollflash.events:Event:SCROLLflash.events:Eventflash.text.TextField.scrollflash.html.HTMLLoader.scrollselectAllflash.events:Event:SELECT_ALLflash.events:Eventflash.display.InteractiveObject.selectAllselectflash.events:Event:SELECTflash.events:Eventflash.net.FileReference.selectflash.display.NativeMenu.selectflash.display.NativeMenuItem.selectsoundCompleteflash.events:Event:SOUND_COMPLETEflash.events:Eventflash.media.SoundChannel.soundCompleteflash.events.Eventflash.events:Event:STANDARD_ERROR_CLOSEflash.events:Eventflash.events.Eventflash.events:Event:STANDARD_INPUT_CLOSEflash.events:Eventflash.events.Eventflash.events:Event:STANDARD_OUTPUT_CLOSEflash.events:EventtabChildrenChangeflash.events:Event:TAB_CHILDREN_CHANGEflash.events:Eventflash.display.InteractiveObject.tabChildrenChangetabEnabledChangeflash.events:Event:TAB_ENABLED_CHANGEflash.events:Eventflash.display.InteractiveObject.tabEnabledChangetabIndexChangeflash.events:Event:TAB_INDEX_CHANGEflash.events:Eventflash.display.InteractiveObject.tabIndexChangetextInteractionModeChangeflash.events:Event:TEXT_INTERACTION_MODE_CHANGEflash.events:Eventflash.text.TextField.textInteractionModeChangeunloadflash.events:Event:UNLOADflash.events:Eventflash.display.LoaderInfo.unloaduserIdleflash.events:Event:USER_IDLEflash.events:Eventflash.desktop.NativeApplication.userIdleuserIdleflash.events:Event:USER_PRESENTflash.events:Eventflash.desktop.NativeApplication.userPresentEvent Erstellt ein Ereignisobjekt, das als ein Parameter an Ereignis-Listener übergeben wird.typeString Der Typ des Ereignisses, auf den als Event.type zugegriffen werden kann. bubblesBooleanfalse Bestimmt, ob das Ereignisobjekt an der Bubbling-Phase des Ereignisablaufs teilnimmt. Der Standardwert ist false. cancelableBooleanfalseBestimmt, ob das Ereignisobjekt abgebrochen werden kann. Der Standardwert lautet false. Dient zum Erstellen eines neuen Ereignisobjekts. Erstellt ein Ereignisobjekt, das als ein Parameter an Ereignis-Listener übergeben wird. clone Dupliziert eine Instanz einer Event-Unterklasse.Ein mit dem Original identisches neues Ereignisobjekt. flash.events:Event Dupliziert eine Instanz einer Event-Unterklasse.

Gibt ein neues Ereignisobjekt zurück, das eine Kopie der ursprünglichen Instanz des Ereignisobjekts ist. Normalerweise rufen Sie clone() nicht auf; es wird automatisch von der EventDispatcher-Klasse aufgerufen, wenn Sie ein Ereignis neu auslösen, das heißt, wenn Sie dispatchEvent(event) von einer Prozedur aus aufrufen, die event verarbeitet.

Das neue Ereignisobjekt übernimmt alle Eigenschaften des Originals.

Wenn Sie Ihre eigene benutzerdefinierte Event-Klasse erstellen, müssen Sie die übernommene Event.clone()-Methode außer Kraft setzen, um die Eigenschaften Ihrer benutzerdefinierten Klasse zu duplizieren. Wenn Sie nicht alle der Ereignis-Unterklasse hinzugefügten Eigenschaften eingestellt haben, weisen sie nicht die korrekten Werte auf, wenn Listener das neu ausgelöste Ereignis verarbeiten.

In dem folgenden Beispiel ist PingEvent eine Unterklasse von Event und implementiert aus diesem Grund eine eigene Version von clone().

class PingEvent extends Event { var URL:String; public override function clone():Event { return new PingEvent(type, bubbles, cancelable, URL); } }
formatToString Eine Dienstprogrammfunktion zur Implementierung der toString()-Methode in benutzerdefinierten ActionScript 3.0 Event-Klassen.Der Name Ihrer benutzerdefinierten Event-Klasse und der String-Wert Ihres ...arguments-Parameters. StringclassNameStringDer Name Ihrer benutzerdefinierten Event-Klasse. Im obigen Beispiel lautet der className-Parameter PingEvent. argumentsDie Eigenschaften der Event-Klasse und die Eigenschaften, die Sie Ihrer benutzerdefinierten Event-Klasse hinzufügen. Im vorigen Beispiel umfasst der ...arguments-Parameter type, bubbles, cancelable, eventPhase und URL. Eine Dienstprogrammfunktion zur Implementierung der toString()-Methode in benutzerdefinierten ActionScript 3.0 Event-Klassen. Das Außerkraftsetzen der toString()-Methode wird empfohlen, ist jedoch nicht erforderlich.
	 class PingEvent extends Event {
	  var URL:String;
	 
	 public override function toString():String { 
	  return formatToString("PingEvent", "type", "bubbles", "cancelable", "eventPhase", "URL"); 
	    }
	 }
	 
isDefaultPrevented Überprüft, ob die preventDefault()-Methode bei dem Ereignis aufgerufen wurde.Wenn preventDefault() aufgerufen wurde, wird true zurückgegeben, andernfalls wird false zurückgegeben. Boolean Überprüft, ob die preventDefault()-Methode bei dem Ereignis aufgerufen wurde. Wenn die preventDefault()-Methode aufgerufen wurde, wird true zurückgegeben, andernfalls wird false zurückgegeben. flash.events.Event.preventDefault()preventDefault Bricht das Standardverhalten eines Ereignisses ab, wenn dieses Verhalten abgebrochen werden kann. Bricht das Standardverhalten eines Ereignisses ab, wenn dieses Verhalten abgebrochen werden kann.

Vielen Ereignissen sind Standardverhalten zugewiesen, die standardmäßig ausgeführt werden. Wenn ein Benutzer beispielsweise Text in ein Textfeld eingibt, so besteht das Standardverhalten darin, dass die Zeichen in dem Textfeld angezeigt werden. Da das Standardverhalten des TextEvent.TEXT_INPUT-Ereignisses abgebrochen werden kann, können Sie die Anzeige der Zeichen mithilfe der Methode preventDefault() verhindern.

Ein Beispiel für ein Verhalten, das nicht abgebrochen werden kann, ist das Standardverhalten, das dem Event.REMOVED-Ereignis zugewiesen ist. Dieses Verhalten wird immer dann erzeugt, wenn Flash Player ein Anzeigeobjekt aus der Anzeigeliste entfernt. Dieses Standardverhalten (das Entfernen des Elements) kann nicht abgebrochen werden, daher hat die Methode preventDefault() keine Auswirkung auf dieses Standardverhalten.

Mit der Eigenschaft Event.cancelable können Sie überprüfen, ob Sie das einem bestimmten Ereignis zugewiesene Standardverhalten abbrechen können. Wenn der Wert von Event.cancelable auf true lautet, kann preventDefault() zum Abbruch des Ereignisses verwendet werden. Ansonsten hat preventDefault() keine Auswirkungen.

flash.events.Event.isDefaultPrevented()Event.cancelable
stopImmediatePropagation Verhindert die Verarbeitung von Ereignis-Listenern im aktuellen Knoten und in Knoten, die dem aktuellen Knoten im Ereignisablauf nachfolgen. Verhindert die Verarbeitung von Ereignis-Listenern im aktuellen Knoten und in Knoten, die dem aktuellen Knoten im Ereignisablauf nachfolgen. Diese Methode wirkt sich sofort und auf die Ereignis-Listener im aktuellen Knoten aus. Im Gegensatz dazu wirkt sich die Methode stopPropagation() nicht aus, bis alle Ereignis-Listener im aktuellen Knoten vollständig verarbeitet wurden.

Hinweis: Diese Methode bricht nicht das diesem Ereignis zugewiesene Standardverhalten ab. Weitere Informationen zu dieser Funktionalität finden Sie unter preventDefault().

flash.events.Event.stopPropagation()flash.events.Event.preventDefault()
stopPropagation Verhindert die Verarbeitung von Ereignis-Listenern in Knoten, die dem aktuellen Knoten im Ereignisablauf nachfolgen. Verhindert die Verarbeitung von Ereignis-Listenern in Knoten, die dem aktuellen Knoten im Ereignisablauf nachfolgen. Diese Methode wirkt sich nicht auf Ereignis-Listener im aktuellen Knoten (currentTarget) aus. Im Gegensatz dazu verhindert die Methode stopImmediatePropagation() die Verarbeitung von Ereignis-Listenern im aktuellen und in den nachfolgenden Knoten. Weitere Aufrufe dieser Methode haben keine Auswirkungen. Diese Methode kann in jeder Phase des Ereignisablaufs aufgerufen werden.

Hinweis: Diese Methode bricht nicht das diesem Ereignis zugewiesene Standardverhalten ab. Weitere Informationen zu dieser Funktionalität finden Sie unter preventDefault().

flash.events.Event.stopImmediatePropagation()flash.events.Event.preventDefault()
toString Gibt eine Zeichenfolge zurück, die alle Eigenschaften des Ereignisobjekts enthält.Eine Zeichenfolge, die alle Eigenschaften des Ereignisobjekts enthält. String Gibt eine Zeichenfolge zurück, die alle Eigenschaften des Ereignisobjekts enthält. Der String liegt im folgenden Format vor:

[Event type=Wert bubbles=Wert cancelable=Wert]

ACTIVATE Die ACTIVATE-Konstante bestimmt den Wert der type-Eigenschaft eines activate-Ereignisobjekts.activateString Die ACTIVATE-Konstante bestimmt den Wert der type-Eigenschaft eines activate-Ereignisobjekts.

Hinweis: Dieses Ereignis verfügt weder über eine Aufnahmephase noch über eine Bubbling-Phase. Das bedeutet, dass Ereignis-Listener potenziellen Zielen direkt hinzugefügt werden müssen, unabhängig davon, ob sich das Ziel in der Anzeigeliste befindet oder nicht.

AIR für TV setzt dieses Ereignis niemals ab. Sie können es jedoch manuell absetzen.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.targetJede DisplayObject-Instanz, die einen Listener besitzt, der für das activate-Ereignis registriert ist.
flash.events.EventDispatcher.activateDEACTIVATE
ADDED_TO_STAGE Die Event.ADDED_TO_STAGE-Konstante definiert den Wert der type-Eigenschaft eines addedToStage-Ereignisobjekts.addedToStageString Die Event.ADDED_TO_STAGE-Konstante definiert den Wert der type-Eigenschaft eines addedToStage-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.targetDie DisplayObject-Instanz, die der Anzeigeliste für die Bühne hinzugefügt wird. Dies erfolgt entweder direkt oder über das Hinzufügen einer Unterstruktur, die die DisplayObject-Instanz enthält. Wenn die DisplayObject-Instanz direkt hinzugefügt wird, findet das added-Ereignis vor diesem Ereignis statt.
flash.display.DisplayObject.addedToStageADDEDREMOVEDREMOVED_FROM_STAGE
ADDED Die Event.ADDED-Konstante definiert den Wert der type-Eigenschaft eines added-Ereignisobjekts.addedString Die Event.ADDED-Konstante definiert den Wert der type-Eigenschaft eines added-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblestruecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.targetDie DisplayObject-Instanz, die in die Anzeigeliste aufgenommen wird. Das unter target angegebene Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet.
flash.display.DisplayObject.addedADDED_TO_STAGEREMOVEDREMOVED_FROM_STAGE
CANCEL Die Event.CANCEL-Konstante definiert den Wert der type-Eigenschaft eines cancel-Ereignisobjekts.cancelString Die Event.CANCEL-Konstante definiert den Wert der type-Eigenschaft eines cancel-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.targetEin Verweis auf das Objekt, dessen Operation abgebrochen wurde.
flash.net.FileReference.cancel
CHANGE Die Event.CHANGE-Konstante definiert den Wert der type-Eigenschaft eines change-Ereignisobjekts.changeString Die Event.CHANGE-Konstante definiert den Wert der type-Eigenschaft eines change-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblestruecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.targetDas Objekt, dessen Wert geändert wurde. Das unter target angegebene Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet.
flash.text.TextField.changeflash.events.TextEvent.TEXT_INPUT
CLEAR Die Event.CLEAR-Konstante definiert den Wert der type-Eigenschaft eines clear-Ereignisobjekts.clearString Die Event.CLEAR-Konstante definiert den Wert der type-Eigenschaft eines clear-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.targetJede IntertactiveObject-Instanz, die einen Listener besitzt, der für das clear-Ereignis registriert ist.

Hinweis: TextField-Objekte lösen folgende Ereignisse nicht aus: clear, copy, cut, paste und selectAll. TextField-Objekte enthalten die Befehle „Ausschneiden“, „Kopieren“, „Einfügen“, „Löschen“ und „Alles auswählen“ immer im Kontextmenü. Diese Befehle können aus dem Kontextmenü von TextField-Objekten nicht entfernt werden. Bei TextField-Objekten werden beim Auswählen dieser Befehle (oder der entsprechenden Zugriffstastenkombinationen) keine clear-, copy-, cut-, paste- oder selectAll-Ereignisse ausgelöst. Andere Klassen, die die InteractiveObject-Klasse erweitern, darunter Komponenten, die mit der Flash Text Engine (FTE) erstellt wurden, setzen diese Ereignisse jedoch in Reaktion auf Benutzeraktionen wie Tastaturbefehle und Kontextmenüs ab.

flash.display.InteractiveObject.clear
CLOSE Die Event.CLOSE-Konstante definiert den Wert der type-Eigenschaft eines close-Ereignisobjekts.closeString Die Event.CLOSE-Konstante definiert den Wert der type-Eigenschaft eines close-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.targetDas Objekt, dessen Verbindung geschlossen wurde.
flash.net.Socket.closeflash.net.XMLSocket.closeflash.display.NativeWindow.close
CLOSING Die Event.CLOSING-Konstante definiert den Wert der type-Eigenschaft eines closing-Ereignisobjekts.closingString Die Event.CLOSING-Konstante definiert den Wert der type-Eigenschaft eines closing-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsecancelabletrue; das Abbrechen dieses Ereignisobjekts stoppt den Schließvorgang.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.targetDas Objekt, dessen Verbindung geschlossen werden soll.
flash.display.NativeWindow.closing
COMPLETE Die Event.COMPLETE-Konstante definiert den Wert der type-Eigenschaft eines complete-Ereignisobjekts.completeString Die Event.COMPLETE-Konstante definiert den Wert der type-Eigenschaft eines complete-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.targetDas Netzwerkobjekt, dessen Ladevorgang beendet ist.
flash.display.LoaderInfo.completeflash.html.HTMLLoader.completeflash.media.Sound.completeflash.net.FileReference.completeflash.net.URLLoader.completeflash.net.URLStream.complete
CONNECT Die Event.CONNECT-Konstante definiert den Wert der type-Eigenschaft eines connect-Ereignisobjekts.connectString Die Event.CONNECT-Konstante definiert den Wert der type-Eigenschaft eines connect-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.targetDas Socket- oder XMLSocket-Objekt, das eine Netzwerkverbindung hergestellt hat.
flash.net.Socket.connectflash.net.XMLSocket.connect
COPY Definiert den Wert der type-Eigenschaft eines copy-Ereignisobjekts.copyString Definiert den Wert der type-Eigenschaft eines copy-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.targetJede IntertactiveObject-Instanz, die einen Listener besitzt, der für das copy-Ereignis registriert ist.

Hinweis: TextField-Objekte lösen folgende Ereignisse nicht aus: clear, copy, cut, paste und selectAll. TextField-Objekte enthalten die Befehle „Ausschneiden“, „Kopieren“, „Einfügen“, „Löschen“ und „Alles auswählen“ immer im Kontextmenü. Diese Befehle können aus dem Kontextmenü von TextField-Objekten nicht entfernt werden. Bei TextField-Objekten werden beim Auswählen dieser Befehle (oder der entsprechenden Zugriffstastenkombinationen) keine clear-, copy-, cut-, paste- oder selectAll-Ereignisse ausgelöst. Andere Klassen, die die InteractiveObject-Klasse erweitern, darunter Komponenten, die mit der Flash Text Engine (FTE) erstellt wurden, setzen diese Ereignisse jedoch in Reaktion auf Benutzeraktionen wie Tastaturbefehle und Kontextmenüs ab.

flash.display.InteractiveObject.copy
CUT Definiert den Wert der type-Eigenschaft eines cut-Ereignisobjekts.cutString Definiert den Wert der type-Eigenschaft eines cut-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.targetJede IntertactiveObject-Instanz, die einen Listener besitzt, der für das cut-Ereignis registriert ist.

Hinweis: TextField-Objekte lösen folgende Ereignisse nicht aus: clear, copy, cut, paste und selectAll. TextField-Objekte enthalten die Befehle „Ausschneiden“, „Kopieren“, „Einfügen“, „Löschen“ und „Alles auswählen“ immer im Kontextmenü. Diese Befehle können aus dem Kontextmenü von TextField-Objekten nicht entfernt werden. Bei TextField-Objekten werden beim Auswählen dieser Befehle (oder der entsprechenden Zugriffstastenkombinationen) keine clear-, copy-, cut-, paste- oder selectAll-Ereignisse ausgelöst. Andere Klassen, die die InteractiveObject-Klasse erweitern, darunter Komponenten, die mit der Flash Text Engine (FTE) erstellt wurden, setzen diese Ereignisse jedoch in Reaktion auf Benutzeraktionen wie Tastaturbefehle und Kontextmenüs ab.

flash.display.InteractiveObject.cut
DEACTIVATE Die Event.DEACTIVATE-Konstante definiert den Wert der type-Eigenschaft eines deactivate-Ereignisobjekts.deactivateString Die Event.DEACTIVATE-Konstante definiert den Wert der type-Eigenschaft eines deactivate-Ereignisobjekts.

Hinweis: Dieses Ereignis verfügt weder über eine Aufnahmephase noch über eine Bubbling-Phase. Das bedeutet, dass Ereignis-Listener potenziellen Zielen direkt hinzugefügt werden müssen, unabhängig davon, ob sich das Ziel in der Anzeigeliste befindet oder nicht.

AIR für TV setzt dieses Ereignis niemals ab. Sie können es jedoch manuell absetzen.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.targetJede DisplayObject-Instanz, die einen Listener besitzt, der für das deactivate-Ereignis registriert ist.
flash.events.EventDispatcher.deactivateACTIVATE
DISPLAYING Die Event.DISPLAYING-Konstante definiert den Wert der type-Eigenschaft eines displaying-Ereignisobjekts.displayingString Die Event.DISPLAYING-Konstante definiert den Wert der type-Eigenschaft eines displaying-Ereignisobjekts.

Hinweis: Dieses Ereignis durchläuft keine "Erfassungsphase" und wird direkt an das Ziel gesendet – unabhängig davon, ob sich dieses auf der Anzeigeliste befindet.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsecancelablefalsecurrentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.targetDas Objekt, das angezeigt werden soll.
flash.display.NativeMenu.displayingflash.display.NativeMenuItem.displaying
ENTER_FRAME Die Event.ENTER_FRAME-Konstante definiert den Wert der type-Eigenschaft eines enterFrame-Ereignisobjekts.enterFrameString Die Event.ENTER_FRAME-Konstante definiert den Wert der type-Eigenschaft eines enterFrame-Ereignisobjekts.

Hinweis: Dieses Ereignis verfügt weder über eine Aufnahmephase noch über eine Bubbling-Phase. Das bedeutet, dass Ereignis-Listener potenziellen Zielen direkt hinzugefügt werden müssen, unabhängig davon, ob sich das Ziel in der Anzeigeliste befindet oder nicht.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.targetJede DisplayObject-Instanz, die einen Listener besitzt, der für das enterFrame-Ereignis registriert ist.
flash.display.DisplayObject.enterFrame
EXITING Die Event.EXITING-Konstante definiert den Wert der type-Eigenschaft eines exiting-Ereignisobjekts.exitingString Die Event.EXITING-Konstante definiert den Wert der type-Eigenschaft eines exiting-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsecancelabletrue; das Abbrechen dieses Ereignisobjekts stoppt den Beenden-Vorgang.currentTargetDas NativeApplication-Objekt.targetDas NativeApplication-Objekt.
flash.desktop.NativeApplication.exiting
EXIT_FRAME Die Event.EXIT_FRAME-Konstante definiert den Wert der type-Eigenschaft eines exitFrame-Ereignisobjekts.exitFrameString Die Event.EXIT_FRAME-Konstante definiert den Wert der type-Eigenschaft eines exitFrame-Ereignisobjekts.

Hinweis: Dieses Ereignis verfügt weder über eine Aufnahmephase noch über eine Bubbling-Phase. Das bedeutet, dass Ereignis-Listener potenziellen Zielen direkt hinzugefügt werden müssen, unabhängig davon, ob sich das Ziel in der Anzeigeliste befindet oder nicht.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.targetJede DisplayObject-Instanz, die einen Listener besitzt, der für das enterFrame-Ereignis registriert ist.
flash.display.DisplayObject.exitFrame
FRAME_CONSTRUCTED Die Event.FRAME_CONSTRUCTED-Konstante definiert den Wert der type-Eigenschaft eines frameConstructed-Ereignisobjekts.frameConstructedString Die Event.FRAME_CONSTRUCTED-Konstante definiert den Wert der type-Eigenschaft eines frameConstructed-Ereignisobjekts.

Hinweis: Dieses Ereignis verfügt weder über eine Aufnahmephase noch über eine Bubbling-Phase. Das bedeutet, dass Ereignis-Listener potenziellen Zielen direkt hinzugefügt werden müssen, unabhängig davon, ob sich das Ziel in der Anzeigeliste befindet oder nicht.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.targetJede DisplayObject-Instanz, die einen Listener besitzt, der für das frameConstructed-Ereignis registriert ist.
flash.display.DisplayObject.frameConstructed
FULLSCREEN Die Event.FULL_SCREEN-Konstante definiert den Wert der type-Eigenschaft eines fullScreen-Ereignisobjekts.fullScreenString Die Event.FULL_SCREEN-Konstante definiert den Wert der type-Eigenschaft eines fullScreen-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.targetDas Stage-Objekt.
flash.display.Stage.fullScreen
HTML_BOUNDS_CHANGE Die Event.HTML_BOUNDS_CHANGE-Konstante definiert den Wert der type-Eigenschaft eines htmlBoundsChange-Ereignisobjekts.htmlBoundsChangeString Die Event.HTML_BOUNDS_CHANGE-Konstante definiert den Wert der type-Eigenschaft eines htmlBoundsChange-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas HTMLLoader-Objekt.targetDas HTMLLoader-Objekt.
htmlBoundsChange-Ereignis
HTML_DOM_INITIALIZE Die Event.HTML_DOM_INITIALIZE-Konstante definiert den Wert der type-Eigenschaft eines htmlDOMInitialize-Ereignisobjekts.htmlDOMInitializeString Die Event.HTML_DOM_INITIALIZE-Konstante definiert den Wert der type-Eigenschaft eines htmlDOMInitialize-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas HTMLLoader-Objekt.targetDas HTMLLoader-Objekt.
htmlDOMInitialize-Ereignis
HTML_RENDER Die Event.HTML_RENDER-Konstante definiert den Wert der type-Eigenschaft eines htmlRender-Ereignisobjekts.htmlRenderString Die Event.HTML_RENDER-Konstante definiert den Wert der type-Eigenschaft eines htmlRender-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas HTMLLoader-Objekt.targetDas HTMLLoader-Objekt.
htmlRender-Ereignis
ID3 Die Event.ID3-Konstante definiert den Wert der type-Eigenschaft eines id3-Ereignisobjekts.id3String Die Event.ID3-Konstante definiert den Wert der type-Eigenschaft eines id3-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.targetDas Sound-Objekt, über das die MP3-Datei geladen wird, für die nun ID3-Daten verfügbar sind. Das unter target angegebene Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet.
flash.media.Sound.id3
INIT Die Event.INIT-Konstante definiert den Wert der type-Eigenschaft eines init-Ereignisobjekts.initString Die Event.INIT-Konstante definiert den Wert der type-Eigenschaft eines init-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.targetDas LoaderInfo-Objekt, das mit der zu ladenden SWF-Datei verknüpft ist.
flash.display.LoaderInfo.init
LOCATION_CHANGE Die Event.LOCATION_CHANGE-Konstante definiert den Wert der type-Eigenschaft eines locationChange-Ereignisobjekts.locationChangeString Die Event.LOCATION_CHANGE-Konstante definiert den Wert der type-Eigenschaft eines locationChange-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas HTMLLoader-Objekt.targetDas HTMLLoader-Objekt.
locationChange-Ereignis
MOUSE_LEAVE Die Event.MOUSE_LEAVE-Konstante definiert den Wert der type-Eigenschaft eines mouseLeave-Ereignisobjekts.mouseLeaveString Die Event.MOUSE_LEAVE-Konstante definiert den Wert der type-Eigenschaft eines mouseLeave-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.targetDas Stage-Objekt. Das unter target angegebene Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet.
flash.display.Stage.mouseLeaveflash.events.MouseEvent
NETWORK_CHANGE Die Event.NETWORK_CHANGE-Konstante definiert den Wert der type-Eigenschaft eines networkChange-Ereignisobjekts.networkChangeString Die Event.NETWORK_CHANGE-Konstante definiert den Wert der type-Eigenschaft eines networkChange-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.targetDas NativeApplication-Objekt.
flash.desktop.NativeApplication.networkChange
OPEN Die Event.OPEN-Konstante definiert den Wert der type-Eigenschaft eines open-Ereignisobjekts.openString Die Event.OPEN-Konstante definiert den Wert der type-Eigenschaft eines open-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.targetDas Netzwerkobjekt, über das eine Verbindung geöffnet wurde.
flash.display.LoaderInfo.openflash.media.Sound.openflash.net.FileReference.openflash.net.URLLoader.openflash.net.URLStream.open
PASTE Die Event.PASTE-Konstante definiert den Wert der type-Eigenschaft eines paste-Ereignisobjekts.pasteString Die Event.PASTE-Konstante definiert den Wert der type-Eigenschaft eines paste-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.targetJede IntertactiveObject-Instanz, die einen Listener besitzt, der für das paste-Ereignis registriert ist.

Hinweis: TextField-Objekte lösen folgende Ereignisse nicht aus: clear, copy, cut, paste und selectAll. TextField-Objekte enthalten die Befehle „Ausschneiden“, „Kopieren“, „Einfügen“, „Löschen“ und „Alles auswählen“ immer im Kontextmenü. Diese Befehle können aus dem Kontextmenü von TextField-Objekten nicht entfernt werden. Bei TextField-Objekten werden beim Auswählen dieser Befehle (oder der entsprechenden Zugriffstastenkombinationen) keine clear-, copy-, cut-, paste- oder selectAll-Ereignisse ausgelöst. Andere Klassen, die die InteractiveObject-Klasse erweitern, darunter Komponenten, die mit der Flash Text Engine (FTE) erstellt wurden, setzen diese Ereignisse jedoch in Reaktion auf Benutzeraktionen wie Tastaturbefehle und Kontextmenüs ab.

flash.display.InteractiveObject.paste
PREPARING Die Event.PREPARING-Konstante definiert den Wert der type-Eigenschaft eines preparing-Ereignisobjekts.preparingString Die Event.PREPARING-Konstante definiert den Wert der type-Eigenschaft eines preparing-Ereignisobjekts.

Hinweis: Dieses Ereignis durchläuft keine "Erfassungsphase" und wird direkt an das Ziel gesendet – unabhängig davon, ob sich dieses auf der Anzeigeliste befindet.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsecancelablefalsecurrentTargetDas Objekt, das dieses Ereignis abgesetzt hat.targetDas Objekt, das dieses Ereignis abgesetzt hat.
flash.display.NativeMenu.preparingflash.display.NativeMenuItem.preparing
REMOVED_FROM_STAGE Die Event.REMOVED_FROM_STAGE-Konstante definiert den Wert der type-Eigenschaft eines removedFromStage-Ereignisobjekts.removedFromStageString Die Event.REMOVED_FROM_STAGE-Konstante definiert den Wert der type-Eigenschaft eines removedFromStage-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.targetDie DisplayObject-Instanz, die aus der Anzeigeliste für die Bühne entfernt wird. Dies erfolgt entweder direkt oder über das Entfernen einer Unterstruktur, die die DisplayObject-Instanz enthält. Wenn die DisplayObject-Instanz direkt entfernt wird, findet das removed-Ereignis vor diesem Ereignis statt.
flash.display.DisplayObject.removedFromStageADDEDREMOVEDADDED_TO_STAGE
REMOVED Die Event.REMOVED-Konstante definiert den Wert der type-Eigenschaft eines removed-Ereignisobjekts.removedString Die Event.REMOVED-Konstante definiert den Wert der type-Eigenschaft eines removed-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblestruecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.targetDie DisplayObject-Instanz, die aus der Anzeigeliste entfernt werden soll. Das unter target angegebene Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet.
flash.display.DisplayObject.removedADDEDADDED_TO_STAGEREMOVED_FROM_STAGE
RENDER Die Event.RENDER-Konstante definiert den Wert der type-Eigenschaft eines render-Ereignisobjekts.renderString Die Event.RENDER-Konstante definiert den Wert der type-Eigenschaft eines render-Ereignisobjekts.

Hinweis: Dieses Ereignis verfügt weder über eine Aufnahmephase noch über eine Bubbling-Phase. Das bedeutet, dass Ereignis-Listener potenziellen Zielen direkt hinzugefügt werden müssen, unabhängig davon, ob sich das Ziel in der Anzeigeliste befindet oder nicht.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsecancelablefalse. Das Standardverhalten kann nicht abgebrochen werden.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.targetJede DisplayObject-Instanz, die einen Listener besitzt, der für das render-Ereignis registriert ist.
flash.display.DisplayObject.renderflash.display.Stage.invalidate()
RESIZE Die Event.RESIZE-Konstante definiert den Wert der type-Eigenschaft eines resize-Ereignisobjekts.resizeString Die Event.RESIZE-Konstante definiert den Wert der type-Eigenschaft eines resize-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.targetDas Stage-Objekt.
flash.display.Stage.resize
SCROLL Die Event.SCROLL-Konstante definiert den Wert der type-Eigenschaft eines scroll-Ereignisobjekts.scrollString Die Event.SCROLL-Konstante definiert den Wert der type-Eigenschaft eines scroll-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.targetDas TextField-Objekt, für das ein Bildlauf durchgeführt wurde. Die target-Eigenschaft entspricht nicht immer dem Objekt in der Anzeigeliste, das den Ereignis-Listener registriert hat. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet.
flash.text.TextField.scrollflash.html.HTMLLoader.scroll
SELECT_ALL Die Event.SELECT_ALL-Konstante definiert den Wert der type-Eigenschaft eines selectALL-Ereignisobjekts.selectAllString Die Event.SELECT_ALL-Konstante definiert den Wert der type-Eigenschaft eines selectALL-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.targetJede IntertactiveObject-Instanz, die einen Listener besitzt, der für das selectAll-Ereignis registriert ist.

Hinweis: TextField-Objekte lösen folgende Ereignisse nicht aus: clear, copy, cut, paste und selectAll. TextField-Objekte enthalten die Befehle „Ausschneiden“, „Kopieren“, „Einfügen“, „Löschen“ und „Alles auswählen“ immer im Kontextmenü. Diese Befehle können aus dem Kontextmenü von TextField-Objekten nicht entfernt werden. Bei TextField-Objekten werden beim Auswählen dieser Befehle (oder der entsprechenden Zugriffstastenkombinationen) keine clear-, copy-, cut-, paste- oder selectAll-Ereignisse ausgelöst. Andere Klassen, die die InteractiveObject-Klasse erweitern, darunter Komponenten, die mit der Flash Text Engine (FTE) erstellt wurden, setzen diese Ereignisse jedoch in Reaktion auf Benutzeraktionen wie Tastaturbefehle und Kontextmenüs ab.

flash.display.InteractiveObject.selectAll
SELECT Die Event.SELECT-Konstante definiert den Wert der type-Eigenschaft eines select-Ereignisobjekts.selectString Die Event.SELECT-Konstante definiert den Wert der type-Eigenschaft eines select-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.targetDas Objekt, auf dem ein Objekt ausgewählt wurde.
flash.net.FileReference.selectflash.display.NativeMenu.selectflash.display.NativeMenuItem.select
SOUND_COMPLETE Die Event.SOUND_COMPLETE-Konstante definiert den Wert der type-Eigenschaft eines soundComplete-Ereignisobjekts.soundCompleteString Die Event.SOUND_COMPLETE-Konstante definiert den Wert der type-Eigenschaft eines soundComplete-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.targetDas SoundChannel-Objekt, in dem die Wiedergabe eines Sounds beendet wurde.
flash.media.SoundChannel.soundComplete
STANDARD_ERROR_CLOSE Die Event.STANDARD_ERROR_CLOSE-Konstante definiert den Wert der type-Eigenschaft eines standardErrorClose-Ereignisobjekts.standardErrorCloseString Die Event.STANDARD_ERROR_CLOSE-Konstante definiert den Wert der type-Eigenschaft eines standardErrorClose-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.targetDas NativeProcess-Objekt.
STANDARD_INPUT_CLOSE Die Event.STANDARD_INPUT_CLOSE-Konstante definiert den Wert der type-Eigenschaft eines standardInputClose-Ereignisobjekts.standardInputCloseString Die Event.STANDARD_INPUT_CLOSE-Konstante definiert den Wert der type-Eigenschaft eines standardInputClose-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.targetDas NativeProcess-Objekt.
STANDARD_OUTPUT_CLOSE Die Event.STANDARD_OUTPUT_CLOSE-Konstante definiert den Wert der type-Eigenschaft eines standardOutputClose-Ereignisobjekts.standardOutputCloseString Die Event.STANDARD_OUTPUT_CLOSE-Konstante definiert den Wert der type-Eigenschaft eines standardOutputClose-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.targetDas NativeProcess-Objekt.
TAB_CHILDREN_CHANGE Die Event.TAB_CHILDREN_CHANGE-Konstante definiert den Wert der type-Eigenschaft eines tabChildrenChange-Ereignisobjekts.tabChildrenChangeString Die Event.TAB_CHILDREN_CHANGE-Konstante definiert den Wert der type-Eigenschaft eines tabChildrenChange-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblestruecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.targetDas Objekt, dessen tabChildren-Flag sich geändert hat. Das unter target angegebene Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet.
flash.display.InteractiveObject.tabChildrenChange
TAB_ENABLED_CHANGE Die Event.TAB_ENABLED_CHANGE-Konstante definiert den Wert der type-Eigenschaft eines tabEnabledChange-Ereignisobjekts.tabEnabledChangeString Die Event.TAB_ENABLED_CHANGE-Konstante definiert den Wert der type-Eigenschaft eines tabEnabledChange-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblestruecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.targetDas interaktive Objekt (InteractiveObject), dessen tabEnabled-Flag sich geändert hat. Das unter target angegebene Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet.
flash.display.InteractiveObject.tabEnabledChange
TAB_INDEX_CHANGE Die Event.TAB_INDEX_CHANGE-Konstante definiert den Wert der type-Eigenschaft eines tabIndexChange-Ereignisobjekts.tabIndexChangeString Die Event.TAB_INDEX_CHANGE-Konstante definiert den Wert der type-Eigenschaft eines tabIndexChange-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblestruecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.targetDas Objekt dessen Tabulatorindex (tabIndex) sich geändert hat. Das unter target angegebene Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet.
flash.display.InteractiveObject.tabIndexChange
TEXT_INTERACTION_MODE_CHANGE Die Event.TEXT_INTERACTION_MODE_CHANGE-Konstante definiert den Wert der type-Eigenschaft eines Interaktionsmodusereignisobjekts.textInteractionModeChangeString Die Event.TEXT_INTERACTION_MODE_CHANGE-Konstante definiert den Wert der type-Eigenschaft eines interaction mode-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.targetDas TextField-Objekt, dessen „interaction mode“-Eigenschaft geändert wird. Unter Android kann der Interaktionsmodus zum Beispiel über das Kontextmenü zu SELECTION (Auswahl) geändert werden. Die target-Eigenschaft entspricht nicht immer dem Objekt in der Anzeigeliste, das den Ereignis-Listener registriert hat. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet.
flash.text.TextField.textInteractionModeChange
UNLOAD Die Event.UNLOAD-Konstante definiert den Wert der type-Eigenschaft eines unload-Ereignisobjekts.unloadString Die Event.UNLOAD-Konstante definiert den Wert der type-Eigenschaft eines unload-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.targetDas LoaderInfo-Objekt, das mit der zu entfernenden oder zu ersetzenden SWF-Datei verknüpft ist.
flash.display.LoaderInfo.unload
USER_IDLE Die Event.USER_IDLE-Konstante definiert den Wert der type-Eigenschaft eines userIdle-Ereignisobjekts.userIdleString Die Event.USER_IDLE-Konstante definiert den Wert der type-Eigenschaft eines userIdle-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.targetDas NativeApplication-Objekt.
flash.desktop.NativeApplication.userIdle
USER_PRESENT Die Event.USER_PRESENT-Konstante definiert den Wert der type-Eigenschaft eines userPresent-Ereignisobjekts.userPresentString Die Event.USER_PRESENT-Konstante definiert den Wert der type-Eigenschaft eines userPresent-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.targetDas NativeApplication-Objekt.
flash.desktop.NativeApplication.userPresent
bubbles Gibt an, ob es sich bei dem Ereignis um ein Bubbling-Ereignis handelt.Boolean Gibt an, ob es sich bei dem Ereignis um ein Bubbling-Ereignis handelt. Wenn das Ereignis eine Bubbling-Phase ausführen kann, lautet der Wert true, andernfalls false.

Wenn ein Ereignis auftritt, durchläuft es die drei Phasen des Ereignisablaufs: die Aufnahmephase, die vom Anfang der Anzeigelistenhierarchie bis zum Knoten direkt vor dem Zielknoten verläuft; die Zielphase, die den Zielknoten umfasst; und die Bubbling-Phase, die von dem Zielknoten nachfolgenden Knoten bis zur Anzeigelistenhierarchie verläuft.

Einige Ereignisse, wie zum Beispiel activate und unload, haben keine Bubbling-Phase. Die Eigenschaft bubbles weist für Ereignisse ohne Bubbling-Phase den Wert false auf.

cancelable Gibt an, ob das mit dem Ereignis verknüpfte Verhalten verhindert werden kann.Boolean Gibt an, ob das mit dem Ereignis verknüpfte Verhalten verhindert werden kann. Wenn das Verhalten abgebrochen werden kann, lautet der Wert true, andernfalls false. Event.preventDefault()currentTarget Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.Object Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. Wenn ein Benutzer auf eine OK-Schaltfläche klickt, kann es sich bei dem Zielknoten um den Knoten handeln, in dem die Schaltfläche enthalten ist, oder um eines der übergeordneten Elemente, die einen Ereignis-Listener für dieses Ereignis registriert hatten. eventPhase Die aktuelle Phase im Ereignisablauf.uint Die aktuelle Phase im Ereignisablauf. Diese Eigenschaft kann die folgenden numerischen Werte enthalten:
  • Die Aufnahmephase (EventPhase.CAPTURING_PHASE).
  • Die Zielphase (EventPhase.AT_TARGET).
  • Die Bubbling-Phase (EventPhase.BUBBLING_PHASE).
target Das Ereignis-Ziel.Object Das Ereignis-Ziel. Diese Eigenschaft enthält den Zielknoten. Wenn ein Benutzer beispielsweise auf eine OK-Schaltfläche klickt, ist der Zielknoten der Anzeigelistenknoten, der diese Schaltfläche enthält. type Der Typ des Ereignisses.String Der Ereignistyp. Der Typ ist abhängig von der Groß- und Kleinschreibung.
TextEvent Ein Objekt sendet ein TextEvent-Objekt, wenn ein Benutzer Text in ein Textfeld eingibt oder auf einen Hyperlink in einem HTML-konformen Textfeld klickt.Ereignisobjekte für TextEvent-Ereignisse. flash.events:Event Ein Objekt sendet ein TextEvent-Objekt, wenn ein Benutzer Text in ein Textfeld eingibt oder auf einen Hyperlink in einem HTML-konformen Textfeld klickt. Es gibt zwei Arten von Textereignissen: TextEvent.LINK und TextEvent.TEXT_INPUT. Im folgenden Beispiel werden mit der Klasse „TextEventExample“ Textfelder erstellt und Listener für verschiedene Textereignisse in diesen Textfeldern eingerichtet. In diesem Beispiel werden die folgenden Aufgaben ausgeführt:
  1. Im Beispiel werden Konstanten für die beiden später verwendeten URLs deklariert.
  2. Im Beispiel werden zwei Variablen vom Typ „TextField“ für die spätere Verwendung deklariert.
  3. Der Klassenkonstruktor ruft die folgenden beiden Methoden auf:
    • init() initialisiert die TextField-Objekte und fügt Ereignis-Listener hinzu.
    • draw() fügt die TextField-Objekte der Anzeigeliste hinzu und weist den anzuzeigenden Text zu.
  4. Die Listener linkHandler() und textInputHandler() reagieren auf die für ihren Ereignistyp relevanten Ereignisse. Mit der Methode linkHandler() wird ein Webbrowser geöffnet (falls dies noch nicht der Fall ist), und die URL-Adresse, auf die geklickt wurde, wird angesteuert. Mit der Methode textInputHandler() werden lediglich Informationen angezeigt, wenn eine Taste im zugehörigen Textfeld gedrückt wird.

Hinweis: Die Domäne in diesem Beispiel ist fiktiv. [yourDomain] muss durch einen tatsächlichen Domänennamen ausgetauscht werden.

package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldType; import flash.text.TextFieldAutoSize; import flash.events.TextEvent; import flash.events.TextEvent; import flash.net.URLRequest; import flash.net.navigateToURL; public class TextEventExample extends Sprite { private const DOMAIN_1_URL:String = "http://www.[yourDomain].com"; private const DOMAIN_2_URL:String = "http://www.[yourDomain].com"; private var linkTxt:TextField; private var textInputTxt:TextField; public function TextEventExample() { init(); draw(); } private function init():void { linkTxt = new TextField(); linkTxt.addEventListener(TextEvent.LINK, linkHandler); linkTxt.height = 60; linkTxt.autoSize = TextFieldAutoSize.LEFT; linkTxt.multiline = true; textInputTxt = new TextField(); textInputTxt.addEventListener(TextEvent.TEXT_INPUT, textInputHandler); textInputTxt.type = TextFieldType.INPUT; textInputTxt.background = true; textInputTxt.border = true; textInputTxt.height = 20; } private function draw():void { addChild(linkTxt); linkTxt.htmlText += createLink(DOMAIN_1_URL, "Click to go to first domain"); linkTxt.htmlText += "<br />"; linkTxt.htmlText += createLink(DOMAIN_2_URL, "Click to go to second domain"); addChild(textInputTxt); textInputTxt.y = linkTxt.height; textInputTxt.text = "type here"; } private function createLink(url:String, text:String):String { var link:String = ""; link += "<font color='#0000FF'>"; link += "<u>"; link += "<b>"; link += "<a href='event:" + url + "'>" + text + "</a>"; link += "</b>"; link += "</u>"; link += "</font>"; return link; } private function linkHandler(e:TextEvent):void { var request:URLRequest = new URLRequest(e.text); navigateToURL(request); } private function textInputHandler(e:TextEvent):void { trace(">> ============================"); trace(">> e.text: " + e.text); trace(">> textInputTxt.text: " + textInputTxt.text); } } }
flash.text.TextFieldlinkflash.events:TextEvent:LINKflash.events:TextEvent In diesem Beispiel wird ein Textereignis ausgelöst, wenn ein Benutzer auf einen Hyperlink im HTML-Text klickt. Abhängig vom Link wird der Benutzer zu einer bestimmten Website geleitet (basierend auf dem Betriebssystem) oder es wird ein Kreis gezeichnet (basierend auf dem vom Benutzer ausgewählten Radius).

Es wird ein Textfeld erstellt und dessen Inhalt wird mithilfe der Eigenschaft htmlText auf einen String im HTML-Format festgelegt. Die Hyperlinks sind unterstrichen, damit sie vom Benutzer leichter erkannt werden. (Adobe Flash Player ändert den Mauszeiger nur, wenn sich der Zeiger über dem Link befindet.) Um sicherzustellen, dass der Mausklick des Benutzers eine ActionScript-Methode aufruft, beginnt die URL des Hyperlinks mit dem String "event:", und für das TextEvent.LINK-Ereignis wird ein Listener hinzugefügt.

Die linkHandler()-Methode, die beim Klicken des Benutzers auf einen Hyperlink ausgelöst wird, verwaltet alle Link-Ereignisse für das Textfeld. Die erste if-Anweisung überprüft die text-Eigenschaft des Ereignisses, die den Rest der URL nach dem "event:"-String enthält. Wenn der Benutzer auf den Link für das Betriebssystem geklickt hat, wird der Name des aktuellen Betriebssystems des Benutzers aus der Capabilities.os-Eigenschaft des Systems verwendet, um den Benutzer zu der entsprechenden Website zu leiten. Andernfalls wird der ausgewählte Radius, der von der text-Eigenschaft des Ereignisses übergeben wird, verwendet, um einen Kreis unter dem Textfeld zu zeichnen. Jedes Mal, wenn der Benutzer auf den Radius-Link klickt, wird der zuvor gezeichnete Kreis gelöscht und ein neuer Kreis mit dem ausgewählten Radius gezeichnet.

package { import flash.display.Sprite; import flash.events.TextEvent; import flash.errors.IOError; import flash.events.IOErrorEvent; import flash.system.Capabilities; import flash.net.navigateToURL; import flash.net.URLRequest; import flash.text.TextField; import flash.text.TextFieldAutoSize; import flash.display.Shape; import flash.display.Graphics; public class TextEvent_LINKExample extends Sprite { private var myCircle:Shape = new Shape(); public function TextEvent_LINKExample() { var myTextField:TextField = new TextField(); myTextField.autoSize = TextFieldAutoSize.LEFT; myTextField.multiline = true; myTextField.background = true; myTextField.htmlText = "Draw a circle with the radius of <u><a href=\"event:20\">20 pixels</a></u>.<br>" + "Draw a circle with the radius of <u><a href=\"event:50\">50 pixels</a></u>.<br><br>" + "<u><a href=\"event:os\">Learn about your operating system.</a></u><br>"; myTextField.addEventListener(TextEvent.LINK, linkHandler); this.addChild(myTextField); this.addChild(myCircle); } private function linkHandler(e:TextEvent):void { var osString:String = Capabilities.os; if(e.text == "os") { if (osString.search(/Windows/) != -1 ){ navigateToURL(new URLRequest("http://www.microsoft.com/"), "_self"); }else if (osString.search(/Mac/) != -1 ) { navigateToURL(new URLRequest("http://www.apple.com/"), "_self"); } else if (osString.search(/linux/i)!= -1) { navigateToURL(new URLRequest("http://www.tldp.org/"), "_self"); } } else { myCircle.graphics.clear(); myCircle.graphics.beginFill(0xFF0000); myCircle.graphics.drawCircle(100, 150, Number(e.text)); myCircle.graphics.endFill(); } } } }
textflash.text.TextField.link
textInputflash.events:TextEvent:TEXT_INPUTflash.events:TextEvent Im folgenden Beispiel wird der Benutzer durch das Generieren eines speziellen Kombinationsschlüssels (ähnlich einem Kennwort) geleitet. Dieser Kombinationsschlüssel besteht aus sieben alphanumerischen Zeichen, wobei das zweite und das fünfte Zeichen Ziffern sind.

Drei Textfelder für Anweisungen, die Benutzereingabe und die Warnungen (Fehlermeldungen) werden erstellt. Ein Ereignis-Listener wird hinzugefügt, um auf die Texteingabe des Benutzers zu reagieren, indem die Methode textInputHandler() ausgelöst wird. (Jedes Mal, wenn der Benutzer Text eingibt, wird ein TextEvent.TEXT_INPUT-Ereignis ausgelöst.

Hinweis: Die Textereignisse werden ausgelöst, wenn der Benutzer Textzeichen eingibt, aber nicht, wenn zum Beispiel die Rücktaste gedrückt wird. Um alle Tastaturereignisse zu erfassen, verwenden Sie einen Listener für das KeyboardEvent-Ereignis.)

Die Methode textInputHandler() kontrolliert und verwaltet die Benutzereingabe. Die Methode preventDefault() wird verwendet, um zu verhindern, dass Adobe Flash Player den Text sofort im Eingabetextfeld anzeigt. Die Anwendung ist dann für die Aktualisierung des Feldes zuständig. Um Löschungen oder Änderungen, die der Benutzer an den bereits eingegebenen Zeichen (result-String) vorgenommen hat, rückgängig zu machen, wird der Inhalt des Eingabetextfelds dem result-String zugewiesen, wenn ein Benutzer neue Zeichen eingibt. Um die Einheitlichkeit der Benutzeroberfläche zu gewährleisten, platziert die setSelection()-Methode die Einfügemarke hinter dem zuletzt ausgewählten Zeichen im Textfeld.

Die erste if-Anweisung in der textInputHandler()-Methode überprüft das zweite und das fünfte Zeichen des eingegebenen Kombinationsschlüssels, bei dem es sich jeweils um eine Ziffer handeln muss. Wenn die Benutzereingabe korrekt ist, wird die Methode updateCombination() aufgerufen und der Kombinationsschlüsselstring (result) wird an die Benutzereingabe angehängt. Die updateCombination()-Methode verschiebt auch die Einfügemarke hinter das ausgewählte Zeichen. Nachdem die sieben Zeichen eingegeben wurden, ändert die letzte if-Anweisung in der textInputHandler()-Methode den Typ des Textfelds inputTextField von INPUT zu DYNAMIC, was bedeutet, dass der Benutzer keine Zeichen mehr eingeben oder ändern kann.

package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldType; import flash.text.TextFieldAutoSize; import flash.events.TextEvent; public class TextEvent_TEXT_INPUTExample extends Sprite { private var instructionTextField:TextField = new TextField(); private var inputTextField:TextField = new TextField(); private var warningTextField:TextField = new TextField(); private var result:String = ""; public function TextEvent_TEXT_INPUTExample() { instructionTextField.x = 10; instructionTextField.y = 10; instructionTextField.background = true; instructionTextField.autoSize = TextFieldAutoSize.LEFT; instructionTextField.text = "Please enter a value in the format A#AA#AA,\n" + "where 'A' represents a letter and '#' represents a number.\n" + "(Note that once you input a character you can't change it.)" ; inputTextField.x = 10; inputTextField.y = 70; inputTextField.height = 20; inputTextField.width = 75; inputTextField.background = true; inputTextField.border = true; inputTextField.type = TextFieldType.INPUT; warningTextField.x = 10; warningTextField.y = 100; warningTextField.autoSize = TextFieldAutoSize.LEFT; inputTextField.addEventListener(TextEvent.TEXT_INPUT, textInputHandler); this.addChild(instructionTextField); this.addChild(inputTextField); this.addChild(warningTextField); } private function textInputHandler(event:TextEvent):void { var charExp:RegExp = /[a-zA-z]/; var numExp:RegExp = /[0-9]/; event.preventDefault(); inputTextField.text = result; inputTextField.setSelection(result.length + 1, result.length + 1); if (inputTextField.text.length == 1 || inputTextField.text.length == 4) { if(numExp.test(event.text) == true) { updateCombination(event.text); } else { warningTextField.text = "You need a single digit number."; } }else { if(charExp.test(event.text) == true) { updateCombination(event.text); } else { warningTextField.text = "You need an alphabet character."; } } if(inputTextField.text.length == 7) { inputTextField.type = TextFieldType.DYNAMIC; instructionTextField.text = "CONGRATULATIONS. You've done."; } } private function updateCombination(s:String):void { warningTextField.text = ""; result += s; inputTextField.text = result; inputTextField.setSelection(result.length + 1, result.length + 1); } } }
flash.text.TextField.textInputtext
TextEvent Erstellt ein Ereignisobjekt, das Informationen über Textereignisse enthält.typeString Der Ereignistyp. Ereignis-Listener können über die übernommene Eigenschaft type auf diese Informationen zugreifen. Folgende Werte sind möglich: TextEvent.LINK und TextEvent.TEXT_INPUT. bubblesBooleanfalseLegt fest, ob das Ereignisobjekt an der Bubbling-Phase des Ereignisablaufs teilnimmt. Ereignis-Listener können über die übernommene Eigenschaft bubbles auf diese Informationen zugreifen. cancelableBooleanfalseBestimmt, ob das Ereignisobjekt abgebrochen werden kann. Ereignis-Listener können über die übernommene Eigenschaft cancelable auf diese Informationen zugreifen. textStringVom Benutzer eingegebener Text. Ereignis-Listener können über die Eigenschaft text auf diese Informationen zugreifen. Konstruktor für TextEvent-Objekte. Erstellt ein Ereignisobjekt, das Informationen über Textereignisse enthält. Ereignisobjekte werden Ereignis-Listenern als Parameter übergeben. flash.text.TextFieldclone Erstellt eine Kopie des TextEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.Ein neues TextEvent-Objekt mit Eigenschaftswerten, die denen des Originals entsprechen. flash.events:Event Erstellt eine Kopie des TextEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht. toString Gibt eine Zeichenfolge zurück, die alle Eigenschaften des TextEvent-Objekts enthält.Eine Zeichenfolge, die alle Eigenschaften des TextEvent-Objekts enthält. String Gibt eine Zeichenfolge zurück, die alle Eigenschaften des TextEvent-Objekts enthält. Der String liegt im folgenden Format vor:

[TextEvent type=Wert bubbles=Wert cancelable=Wert text=Wert]

LINK Definiert den Wert der Eigenschaft „type“ eines link-Ereignisobjekts.linkString Definiert den Wert der Eigenschaft type eines link-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblestruecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.targetEs wurde auf das Textfeld mit dem Hyperlink geklickt. Das unter target angegebene Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet.textDer Rest der URL nach „event:“
In diesem Beispiel wird ein Textereignis ausgelöst, wenn ein Benutzer auf einen Hyperlink im HTML-Text klickt. Abhängig vom Link wird der Benutzer zu einer bestimmten Website geleitet (basierend auf dem Betriebssystem) oder es wird ein Kreis gezeichnet (basierend auf dem vom Benutzer ausgewählten Radius).

Es wird ein Textfeld erstellt und dessen Inhalt wird mithilfe der Eigenschaft htmlText auf einen String im HTML-Format festgelegt. Die Hyperlinks sind unterstrichen, damit sie vom Benutzer leichter erkannt werden. (Adobe Flash Player ändert den Mauszeiger nur, wenn sich der Zeiger über dem Link befindet.) Um sicherzustellen, dass der Mausklick des Benutzers eine ActionScript-Methode aufruft, beginnt die URL des Hyperlinks mit dem String "event:", und für das TextEvent.LINK-Ereignis wird ein Listener hinzugefügt.

Die linkHandler()-Methode, die beim Klicken des Benutzers auf einen Hyperlink ausgelöst wird, verwaltet alle Link-Ereignisse für das Textfeld. Die erste if-Anweisung überprüft die text-Eigenschaft des Ereignisses, die den Rest der URL nach dem "event:"-String enthält. Wenn der Benutzer auf den Link für das Betriebssystem geklickt hat, wird der Name des aktuellen Betriebssystems des Benutzers aus der Capabilities.os-Eigenschaft des Systems verwendet, um den Benutzer zu der entsprechenden Website zu leiten. Andernfalls wird der ausgewählte Radius, der von der text-Eigenschaft des Ereignisses übergeben wird, verwendet, um einen Kreis unter dem Textfeld zu zeichnen. Jedes Mal, wenn der Benutzer auf den Radius-Link klickt, wird der zuvor gezeichnete Kreis gelöscht und ein neuer Kreis mit dem ausgewählten Radius gezeichnet.

package { import flash.display.Sprite; import flash.events.TextEvent; import flash.errors.IOError; import flash.events.IOErrorEvent; import flash.system.Capabilities; import flash.net.navigateToURL; import flash.net.URLRequest; import flash.text.TextField; import flash.text.TextFieldAutoSize; import flash.display.Shape; import flash.display.Graphics; public class TextEvent_LINKExample extends Sprite { private var myCircle:Shape = new Shape(); public function TextEvent_LINKExample() { var myTextField:TextField = new TextField(); myTextField.autoSize = TextFieldAutoSize.LEFT; myTextField.multiline = true; myTextField.background = true; myTextField.htmlText = "Draw a circle with the radius of <u><a href=\"event:20\">20 pixels</a></u>.<br>" + "Draw a circle with the radius of <u><a href=\"event:50\">50 pixels</a></u>.<br><br>" + "<u><a href=\"event:os\">Learn about your operating system.</a></u><br>"; myTextField.addEventListener(TextEvent.LINK, linkHandler); this.addChild(myTextField); this.addChild(myCircle); } private function linkHandler(e:TextEvent):void { var osString:String = Capabilities.os; if(e.text == "os") { if (osString.search(/Windows/) != -1 ){ navigateToURL(new URLRequest("http://www.microsoft.com/"), "_self"); }else if (osString.search(/Mac/) != -1 ) { navigateToURL(new URLRequest("http://www.apple.com/"), "_self"); } else if (osString.search(/linux/i)!= -1) { navigateToURL(new URLRequest("http://www.tldp.org/"), "_self"); } } else { myCircle.graphics.clear(); myCircle.graphics.beginFill(0xFF0000); myCircle.graphics.drawCircle(100, 150, Number(e.text)); myCircle.graphics.endFill(); } } } }
textflash.text.TextField.link
TEXT_INPUT Definiert den Wert der type-Eigenschaft eines textInput-Ereignisobjekts.textInputString Definiert den Wert der Eigenschaft type eines textInput-Ereignisobjekts.

Hinweis: Dieses Ereignis wird für die Entf- und Rücktaste nicht ausgelöst.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblestruecancelabletrue; rufen Sie die Methode preventDefault() auf, um das Standardverhalten abzubrechen.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.targetDas Textfeld, in das die Zeichen eingegeben werden. Das Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet.textDas bzw. die Zeichen wird/werden vom Benutzer eingegeben.
Im folgenden Beispiel wird der Benutzer durch das Generieren eines speziellen Kombinationsschlüssels (ähnlich einem Kennwort) geleitet. Dieser Kombinationsschlüssel besteht aus sieben alphanumerischen Zeichen, wobei das zweite und das fünfte Zeichen Ziffern sind.

Drei Textfelder für Anweisungen, die Benutzereingabe und die Warnungen (Fehlermeldungen) werden erstellt. Ein Ereignis-Listener wird hinzugefügt, um auf die Texteingabe des Benutzers zu reagieren, indem die Methode textInputHandler() ausgelöst wird. (Jedes Mal, wenn der Benutzer Text eingibt, wird ein TextEvent.TEXT_INPUT-Ereignis ausgelöst.

Hinweis: Die Textereignisse werden ausgelöst, wenn der Benutzer Textzeichen eingibt, aber nicht, wenn zum Beispiel die Rücktaste gedrückt wird. Um alle Tastaturereignisse zu erfassen, verwenden Sie einen Listener für das KeyboardEvent-Ereignis.)

Die Methode textInputHandler() kontrolliert und verwaltet die Benutzereingabe. Die Methode preventDefault() wird verwendet, um zu verhindern, dass Adobe Flash Player den Text sofort im Eingabetextfeld anzeigt. Die Anwendung ist dann für die Aktualisierung des Feldes zuständig. Um Löschungen oder Änderungen, die der Benutzer an den bereits eingegebenen Zeichen (result-String) vorgenommen hat, rückgängig zu machen, wird der Inhalt des Eingabetextfelds dem result-String zugewiesen, wenn ein Benutzer neue Zeichen eingibt. Um die Einheitlichkeit der Benutzeroberfläche zu gewährleisten, platziert die setSelection()-Methode die Einfügemarke hinter dem zuletzt ausgewählten Zeichen im Textfeld.

Die erste if-Anweisung in der textInputHandler()-Methode überprüft das zweite und das fünfte Zeichen des eingegebenen Kombinationsschlüssels, bei dem es sich jeweils um eine Ziffer handeln muss. Wenn die Benutzereingabe korrekt ist, wird die Methode updateCombination() aufgerufen und der Kombinationsschlüsselstring (result) wird an die Benutzereingabe angehängt. Die updateCombination()-Methode verschiebt auch die Einfügemarke hinter das ausgewählte Zeichen. Nachdem die sieben Zeichen eingegeben wurden, ändert die letzte if-Anweisung in der textInputHandler()-Methode den Typ des Textfelds inputTextField von INPUT zu DYNAMIC, was bedeutet, dass der Benutzer keine Zeichen mehr eingeben oder ändern kann.

package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldType; import flash.text.TextFieldAutoSize; import flash.events.TextEvent; public class TextEvent_TEXT_INPUTExample extends Sprite { private var instructionTextField:TextField = new TextField(); private var inputTextField:TextField = new TextField(); private var warningTextField:TextField = new TextField(); private var result:String = ""; public function TextEvent_TEXT_INPUTExample() { instructionTextField.x = 10; instructionTextField.y = 10; instructionTextField.background = true; instructionTextField.autoSize = TextFieldAutoSize.LEFT; instructionTextField.text = "Please enter a value in the format A#AA#AA,\n" + "where 'A' represents a letter and '#' represents a number.\n" + "(Note that once you input a character you can't change it.)" ; inputTextField.x = 10; inputTextField.y = 70; inputTextField.height = 20; inputTextField.width = 75; inputTextField.background = true; inputTextField.border = true; inputTextField.type = TextFieldType.INPUT; warningTextField.x = 10; warningTextField.y = 100; warningTextField.autoSize = TextFieldAutoSize.LEFT; inputTextField.addEventListener(TextEvent.TEXT_INPUT, textInputHandler); this.addChild(instructionTextField); this.addChild(inputTextField); this.addChild(warningTextField); } private function textInputHandler(event:TextEvent):void { var charExp:RegExp = /[a-zA-z]/; var numExp:RegExp = /[0-9]/; event.preventDefault(); inputTextField.text = result; inputTextField.setSelection(result.length + 1, result.length + 1); if (inputTextField.text.length == 1 || inputTextField.text.length == 4) { if(numExp.test(event.text) == true) { updateCombination(event.text); } else { warningTextField.text = "You need a single digit number."; } }else { if(charExp.test(event.text) == true) { updateCombination(event.text); } else { warningTextField.text = "You need an alphabet character."; } } if(inputTextField.text.length == 7) { inputTextField.type = TextFieldType.DYNAMIC; instructionTextField.text = "CONGRATULATIONS. You've done."; } } private function updateCombination(s:String):void { warningTextField.text = ""; result += s; inputTextField.text = result; inputTextField.setSelection(result.length + 1, result.length + 1); } } }
flash.text.TextField.textInputtext
text Bei einem textInput-Ereignis das bzw. die vom Benutzer eingegebene(n) Zeichen.String Bei einem textInput-Ereignis das bzw. die vom Benutzer eingegebenen Zeichen. Bei einem link-Ereignis der Text des Attributs event des href-Attributs des <a>-Tags. Im folgenden Code wird gezeigt, wie das link-Ereignis ausgelöst wird, wenn ein Benutzer auf den Hypertext-Link klickt: import flash.text.TextField; import flash.events.TextEvent; var tf:TextField = new TextField(); tf.htmlText = "<a href='event:myEvent'>Click Me.</a>"; tf.addEventListener("link", clickHandler); addChild(tf); function clickHandler(e:TextEvent):void { trace(e.type); // link trace(e.text); // myEvent }
SampleDataEvent Wird abgesetzt, wenn ein Sound-Objekt neue Audiodaten anfordert oder wenn ein Microphone-Objekt neue Audiodaten bereitstellt.flash.events:Event Wird abgesetzt, wenn ein Sound-Objekt neue Audiodaten anfordert oder wenn ein Microphone-Objekt neue Audiodaten bereitstellt.

Dieses Ereignis hat zwei Verwendungen:

  • Um dynamisch generierte Audiodaten für ein Sound-Objekt bereitzustellen
  • Um Audiodaten für ein Microphone-Objekt abzurufen

Dynamisches Generieren von Audio mit dem Sound-Objekt Verwenden Sie das sampleData-Ereignis, um dynamisch generiertes Audio abzuspielen. In dieser Umgebung enthält das Sound-Objekt keine Sounddaten an sich. Es fungiert stattdessen als Socket für Sounddaten, die zum Objekt gestreamt werden. Das Streamen erfolgt mittels einer Funktion, die Sie dem sampleData Ereignis zuweisen.

Sie verwenden in Ihrer Funktion die ByteArray.writeFloat()-Methode, um in die data-Eigenschaft des Ereignisses zu schreiben, die die Beispieldaten, die Sie abspielen möchten, enthält.

Wenn ein Sound-Objekt keine MP3-Datei geladen hat und Sie seine play()-Methode aufrufen, setzt das Objekt sampleData-Ereignisse ab, um Soundsamples anzufordern. Das Sound-Objekt fährt während der Wiedergabe damit fort, Ereignisse abzusetzen, bis Sie keine Daten mehr bereitstellen oder bis die stop()-Methode des SoundChannel-Objekts aufgerufen wird.

Die Wartezeit des Ereignisses unterscheidet sich von Plattform zu Plattform und kann sich in zukünftigen Versionen von Flash Player oder AIR ändern. Verlassen Sie sich nicht auf eine bestimmte Wartezeit. Berechnen Sie sie stattdessen mit ((SampleDataEvent.position/44.1) - SoundChannelObject.position).

Stellen Sie der data-Eigenschaft des SampleDataEvent-Objekts zwischen 2048 und 8192 Samples bereit. Um die beste Leistung zu erzielen, stellen Sie so viele Beispiele wie möglich zur Verfügung. Je weniger Beispiele Sie zur Verfügung stellen, desto wahrscheinlicher ist es, dass während des Abspielens Knackgeräusche und Ähnliches auftritt. Dies kann von Plattform zu Plattform unterschiedlich sein und in verschiedenen Situationen auftreten, zum Beispiel wenn die Browsergröße verändert wird. Wenn Sie Code schreiben, der mit nur 2.048 Beispielen auf einer Plattform funktioniert, kann es vorkommen, dass derselbe Code auf einer anderen Plattform nicht so gut funktioniert. Wenn Sie die geringst mögliche Wartezeit benötigen, überlegen Sie sich, ob Sie die Menge der Daten vom Benutzer auswählen lassen.

Wenn Sie weniger als 2.048 Samples bereitstellen, spielt das Sound-Objekt die verbleibenden Samples ab und stoppt dann die Wiedergabe, als wäre das Ende der Sounddatei erreicht, und generiert ein complete-Ereignis.

Sie können die extract()-Methode eines Sound-Objekts verwenden, um seine Sounddaten zu extrahieren, die Sie dann in den dynamischen Stream für die Wiedergabe schreiben können.

Wenn Sie das sampleData-Ereignis mit einem Sound-Objekt verwenden, sind als weitere Sound-Methoden nur noch extract() und play() aktiviert. Das Aufrufen anderer Methoden oder Eigenschaften verursacht eine Ausnahme aufgrund eines ungültigen Aufrufs („invalid call“). Alle Methoden und Eigenschaften des SoundChannel-Objekts sind nach wie vor aktiviert.

Erfassen von Mikrofonaudio Verwenden Sie das sampleDataEreignis, um Audiodaten von einem Mikrofon zu erfassen. Wenn Sie einen Ereignis-Listener für das sampleData-Ereignis hinzufügen, setzt das Microphone-Objekt das Ereignis ab, sobald Audiosamples verfügbar sind.

Verwenden Sie in der Ereignisprozedurfunktion die ByteArray.readFloat()-Methode, um die data-Eigenschaft des Ereignisses zu lesen, die die Sampledaten enthält. Das Ereignis enthält mehrere Samples, deshalb sollten Sie eine while-Schleife verwenden, um die verfügbaren Daten zu lesen:

var soundBytes:ByteArray = new ByteArray(); while(event.data.bytesAvailable) { var sample:Number = event.data.readFloat(); soundBytes.writeFloat(sample); }
Das folgende Beispiel spielt eine einfache Sinuswelle ab. var mySound:Sound = new Sound(); function sineWaveGenerator(event:SampleDataEvent):void { for ( var c:int=0; c<8192; c++ ) { event.data.writeFloat(Math.sin((Number(c+event.position)/Math.PI/2))*0.25); event.data.writeFloat(Math.sin((Number(c+event.position)/Math.PI/2))*0.25); } } mySound.addEventListener(SampleDataEvent.SAMPLE_DATA,sineWaveGenerator); mySound.play();
flash.media.SoundsampleDataflash.events:SampleDataEvent:SAMPLE_DATAflash.events:SampleDataEventflash.media.Sound.sampleDataflash.events.SampleDataEventSampleDataEvent Erstellt ein Ereignisobjekt, das Informationen über Audiodatenereignisse enthält.typeString Der Ereignistyp. Dieser Wert lautet Event.SAMPLE_DATA. bubblesBooleanfalse Bestimmt, ob das Ereignisobjekt an der Bubbling-Phase des Ereignisablaufs teilnimmt. cancelableBooleanfalseBestimmt, ob das Ereignisobjekt abgebrochen werden kann. thepositionNumber0Die Position der Daten im Audiostream. thedataflash.utils:ByteArraynullEin Bytearray mit Daten. Erstellt ein Ereignisobjekt, das Informationen über Audiodatenereignisse enthält. Ereignisobjekte werden Ereignis-Listenern als Parameter übergeben. clone Erstellt eine Kopie des SampleDataEvent-Objekts und stellt den Wert aller Eigenschaften so ein, dass sie den Werten des Originals entsprechen.Ein neues SampleDataEvent-Objekt mit Eigenschaftswerten, die denen des Originals entsprechen. flash.events:Event Erstellt eine Kopie des SampleDataEvent-Objekts und stellt den Wert aller Eigenschaften so ein, dass sie den Werten des Originals entsprechen. toString Gibt einen String zurück, der alle Eigenschaften des SampleDataEvent-Objekts enthält.Ein String, der alle Eigenschaften des SampleDataEvent-Objekts enthält. String Gibt einen String zurück, der alle Eigenschaften des SampleDataEvent-Objekts enthält. Der String liegt im folgenden Format vor:

[SampleDataEvent type=Wert bubbles=Wert cancelable=Wert theposition=Wert thedata=Wert]

SAMPLE_DATA Definiert den Wert der type-Eigenschaft eines SampleDataEvent-Ereignisobjekts.sampleDataString Definiert den Wert der type-Eigenschaft eines SampleDataEvent-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.positionDer Speicherort, an dem die Audiodaten bereitgestellt sind.
flash.media.Sound.sampleDataflash.events.SampleDataEvent
data Die Daten im Audiostream.flash.utils:ByteArray Die Daten im Audiostream. position Die Position der Daten im Audiostream.Number Die Position der Daten im Audiostream.
HTTPStatusEvent Die Anwendung sendet HTTPStatusEvent-Objekte, wenn eine Netzwerkanfrage einen HTTP-Statuscode zurückgibt.flash.events:Event Die Anwendung sendet HTTPStatusEvent-Objekte, wenn eine Netzwerkanfrage einen HTTP-Statuscode zurückgibt.

HTTPStatusEvent-Objekte werden immer vor Fehler- oder Abschlussereignissen gesendet. Ein HTTPStatusEvent-Objekt muss nicht unbedingt auf einen Fehlerzustand hinweisen; es reflektiert einfach den HTTP-Statuscode (sofern vorhanden), der vom Netzwerkstapel bereitgestellt wird. Einige Flash Player-Umgebungen sind eventuell nicht in der Lage, HTTP-Statuscodes zu erfassen; in diesen Fällen wird immer ein Statuscode 0 gemeldet.

In Flash Player gibt es nur einen Typ HTTPStatus-Ereignis: httpStatus. In der AIR-Laufzeitumgebung kann ein FileReference, URLLoader oder URLStream registriert werden, um auf httpResponseStatus zu warten, wozu die Eigenschaften responseURL und responseHeaders gehören. Diese Eigenschaften sind in einem httpStatus-Ereignis nicht definiert.

Im folgenden Beispiel wird versucht, eine nicht vorhandene Datei vom Stammverzeichnis des Webservers unter http://www.[yourDomain].com zu laden. Dabei sollte ein httpStatusHandler-Ereignis mit Status 404 ausgelöst werden, der darauf hinweist, dass die Datei nicht gefunden wurde. Das Ereignis httpStatusHandler wird von der Methode httpStatusHandler() bearbeitet, mit der zwei Zeilen mit Informationen zum Ereignis gedruckt werden.

Hinweise:

  1. Um in diesem Beispiel ein securityError-Ereignis zu generieren, müssen Sie bei der Kompilierung der SWF-Datei die Einstellung „Sicherheit bei lokaler Wiedergabe“ auf „Nur auf Netzwerk zugreifen“ setzen.
  2. Sie benötigen einen Server, der auf http://www.[yourDomain].com ausgeführt wird und Port 80 überwacht. Ansonsten erhalten Sie ein httpStatusHandler-Ereignis mit Statuscode 0 statt 404.
  3. Es darf sich keine Datei mit dem Namen "MissingFile.html" im Stammverzeichnis des Webservers unter http://www.[yourDomain].com befinden. Ansonsten wird nicht das richtige httpStatusHandler-Ereignis empfangen.

package { import flash.display.Sprite; import flash.net.URLLoader; import flash.net.URLRequest; import flash.events.HTTPStatusEvent; public class HTTPStatusEventExample extends Sprite { public function HTTPStatusEventExample() { var loader:URLLoader = new URLLoader(); loader.addEventListener(HTTPStatusEvent.HTTP_STATUS, httpStatusHandler); var request:URLRequest = new URLRequest("http://www.[yourDomain].com/MissingFile.html"); loader.load(request); } private function httpStatusHandler(event:HTTPStatusEvent):void { trace("httpStatusHandler: " + event); trace("status: " + event.status); } } }
httpResponseStatusflash.events:HTTPStatusEvent:HTTP_RESPONSE_STATUSflash.events:HTTPStatusEventflash.net.URLStream.httpResponseStatusflash.net.FileReference.httpResponseStatushttpStatusflash.events:HTTPStatusEvent:HTTP_STATUSflash.events:HTTPStatusEventflash.display.LoaderInfo.httpStatusflash.net.FileReference.httpStatusflash.net.URLLoader.httpStatusflash.net.URLStream.httpStatusHTTPStatusEvent Erstellt ein Ereignisobjekt, das Informationen über HTTP-Status-Ereignisse enthält.typeString Der Ereignistyp. Ereignis-Listener können über die übernommene Eigenschaft type auf diese Informationen zugreifen. Es gibt nur einen Typ eines HTTPStatus-Ereignisses: HTTPStatusEvent.HTTP_STATUS. bubblesBooleanfalseBestimmt, ob das Ereignisobjekt an der Bubbling-Phase des Ereignisablaufs teilnimmt. Ereignis-Listener können über die übernommene Eigenschaft bubbles auf diese Informationen zugreifen. cancelableBooleanfalseBestimmt, ob das Ereignisobjekt abgebrochen werden kann. Ereignis-Listener können über die übernommene Eigenschaft cancelable auf diese Informationen zugreifen. statusint0Numerischer Status. Ereignis-Listener können über die Eigenschaft status auf diese Informationen zugreifen. Konstruktor für HTTPStatusEvent-Objekte. Erstellt ein Ereignisobjekt, das Informationen über HTTP-Status-Ereignisse enthält. Ereignisobjekte werden Ereignis-Listenern als Parameter übergeben. HTTP_STATUSclone Erstellt eine Kopie des HTTPStatusEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.Ein neues HTTPStatusEvent-Objekt mit Eigenschaftswerten, die denen des Originals entsprechen. flash.events:Event Erstellt eine Kopie des HTTPStatusEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht. toString Gibt eine Zeichenfolge zurück, die alle Eigenschaften des HTTPStatusEvent-Objekts enthält.Eine Zeichenfolge, die alle Eigenschaften des HTTPStatusEvent-Objekts enthält. String Gibt eine Zeichenfolge zurück, die alle Eigenschaften des HTTPStatusEvent-Objekts enthält. Der String liegt im folgenden Format vor:

[HTTPStatusEvent type=Wert bubbles=Wert cancelable=Wert status=Wert]

HTTP_RESPONSE_STATUS Anders als das httpStatus-Ereignis wird das httpResponseStatus-Ereignis ausgelöst, bevor Antwortdaten vorliegen.httpResponseStatusString Anders als das httpStatus-Ereignis wird das httpResponseStatus-Ereignis ausgelöst, bevor Antwortdaten vorliegen. Außerdem enthält das httpResponseStatus-Ereignis Werte für die Eigenschaften responseHeaders und responseURL (die für ein httpStatus-Ereignis nicht definiert sind). Beachten Sie, dass das Ereignis httpResponseStatus (falls vorhanden) vor (und zusätzlich zu) jedem complete- oder error-Ereignis gesendet wird.

Die HTTPStatusEvent.HTTP_RESPONSE_STATUS-Konstante definiert den Wert der type-Eigenschaft eines httpResponseStatus-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.responseURLDie URL, von der die Antwort zurückgegeben wurde.responseHeadersDie Antwortheader, die die Antwort zurückgegeben hat, als Array von URLRequestHeader-Objekten.statusDer vom Server zurückgegebene HTTP-Statuscode.targetDas Netzwerkobjekt, das den HTTP-Statuscode empfängt.
flash.net.URLStream.httpResponseStatusflash.net.FileReference.httpResponseStatus
HTTP_STATUS Die HTTPStatusEvent.HTTP_STATUS-Konstante definiert den Wert der type-Eigenschaft eines httpStatus-Ereignisobjekts.httpStatusString Die HTTPStatusEvent.HTTP_STATUS-Konstante definiert den Wert der type-Eigenschaft eines httpStatus-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.statusDer vom Server zurückgegebene HTTP-Statuscode.targetDas Netzwerkobjekt, das den HTTP-Statuscode empfängt.
flash.display.LoaderInfo.httpStatusflash.net.FileReference.httpStatusflash.net.URLLoader.httpStatusflash.net.URLStream.httpStatus
responseHeaders Die Antwortheader, die die Antwort zurückgegeben hat, als Array von URLRequestHeader-Objekten.Array Die Antwortheader, die die Antwort zurückgegeben hat, als Array von URLRequestHeader-Objekten. flash.net.URLRequestHeaderresponseURL Die URL, von der die Antwort zurückgegeben wurde.String Die URL, von der die Antwort zurückgegeben wurde. Bei Umleitungen ist dies eine andere URL als die Anforderungs-URL. status Der vom Server zurückgegebene HTTP-Statuscode.int Der vom Server zurückgegebene HTTP-Statuscode. So zeigt der Wert 404 beispielsweise an, dass der Server den angeforderten URI nicht gefunden hat. HTTP-Statuscodes finden Sie in den Abschnitten 10.4 und 10.5 der HTTP-Spezifikation unter http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html.

Wenn Flash Player oder AIR keinen Statuscode vom Server erhält oder keine Verbindung herstellen kann, wird der Standardwert 0 (null) an den Code übergeben. Dieser Wert kann von jedem Player generiert werden (wenn beispielsweise eine fehlerhafte URL angefordert wird). Er wird aber in jedem Fall vom Flash Player Plug-In generiert, wenn es in einem der folgenden Browser ausgeführt wird, die dem Player grundsätzlich keine HTTP-Statuscodes übergeben: Netscape, Mozilla, Safari, Opera und Internet Explorer für Macintosh.

FileListEvent Ein File-Objekt löst ein FileListEvent-Objekt aus, wenn ein Aufruf der getDirectoryListingAsync()-Methode eines File-Objekts erfolgreich einen Satz von Dateien und Ordnern auflistet oder wenn ein Benutzer Dateien nach einem Aufruf der browseForOpenMultiple()-Methode auswählt.Ein File-Objekt löst ein FileListEvent-Objekt nach erfolgreichen Aufrufen der getDirectoryListingAsync()- oder browseForOpenMultiple()-Methode auf. flash.events:Event Ein File-Objekt löst ein FileListEvent-Objekt aus, wenn ein Aufruf der getDirectoryListingAsync()-Methode eines File-Objekts erfolgreich einen Satz von Dateien und Ordnern auflistet oder wenn ein Benutzer Dateien nach einem Aufruf der browseForOpenMultiple()-Methode auswählt. File.getDirectoryListingAsync()directoryListingflash.events:FileListEvent:DIRECTORY_LISTINGflash.events:FileListEventselectMultipleflash.events:FileListEvent:SELECT_MULTIPLEflash.events:FileListEventFileListEvent Die Konstruktorfunktion für ein FileListEvent-Objekt.typeStringDer Ereignistyp. bubblesBooleanfalseBestimmt, ob das Ereignisobjekt aufsteigt (false für ein FileListEvent-Objekt). cancelableBooleanfalseBestimmt, ob das Event-Objekt abgebrochen werden kann (false für ein FileListEvent-Objekt). filesArraynullEin Array von File-Objekten. Die Konstruktorfunktion für ein FileListEvent-Objekt.

Die Laufzeitumgebung erstellt mithilfe dieser Klasse FileListEvent-Objekte. Sie verwenden diesen Konstruktor nicht direkt im Code.

DIRECTORY_LISTING Die Konstante FileListEvent.DIRECTORY_LISTING definiert den Wert der type-Eigenschaft des Ereignisobjekts für ein directoryListing-Ereignis.directoryListingString Die Konstante FileListEvent.DIRECTORY_LISTING definiert den Wert der type-Eigenschaft des Ereignisobjekts für ein directoryListing-Ereignis.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.filesEin Array von File-Objekten, das die gefundenen Dateien und Ordner repräsentiert.targetDas FileListEvent-Objekt.
SELECT_MULTIPLE Die Konstante FileListEvent.SELECT_MULTIPLE definiert den Wert der type-Eigenschaft des Ereignisobjekts für ein selectMultiple-Ereignis.selectMultipleString Die Konstante FileListEvent.SELECT_MULTIPLE definiert den Wert der type-Eigenschaft des Ereignisobjekts für ein selectMultiple-Ereignis. EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.filesEin Array von File-Objekten, das die ausgewählten Dateien repräsentiert.targetDas FileListEvent-Objekt. files Ein Array von File-Objekten, das die gefundenen oder ausgewählten Dateien und Verzeichnisse repräsentiert.Array Ein Array von File-Objekten, das die gefundenen oder ausgewählten Dateien und Verzeichnisse repräsentiert.

Für die File.getDirectoryListingAsync()-Methode ist dies die Liste der Dateien und Verzeichnisse, die auf der Stammebene des Odners gefunden wurden, das vom File-Objekt, das die Methode aufgerufen hat, repräsentiert wird. Für die File.browseForOpenMultiple()-Methode ist dies die Liste der vom Benutzer ausgewählten Dateien.

NativeWindowBoundsEvent Ein NativeWindow-Objekt löst ein NativeWindowBoundsEvent-Objekt aus, wenn die Größe oder Position des Fensters geändert wird.Ereignisobjekte für NativeWindow-Ereignisse, die die Größe und/oder Position des Fensters ändern. flash.events:Event Ein NativeWindow-Objekt löst ein NativeWindowBoundsEvent-Objekt aus, wenn die Größe oder Position des Fensters geändert wird.

Es gibt vier Arten von Ereignissen:

  • NativeWindowBoundsEvent.MOVING
  • NativeWindowBoundsEvent.MOVE
  • NativeWindowBoundsEvent.RESIZING
  • NativeWindowBoundsEvent.RESIZE
flash.events.NativeWindowBoundsEvent.MOVINGflash.events.NativeWindowBoundsEvent.MOVEflash.events.NativeWindowBoundsEvent.RESIZINGflash.events.NativeWindowBoundsEvent.RESIZEmoveflash.events:NativeWindowBoundsEvent:MOVEflash.events:NativeWindowBoundsEventWird von einem NativeWindow-Objekt abgesetzt, nachdem es verschoben wurde. flash.display.NativeWindowmovingflash.events:NativeWindowBoundsEvent:MOVINGflash.events:NativeWindowBoundsEventWird von einem NativeWindow-Objekt abgesetzt, bevor es verschoben wird. flash.display.NativeWindowresizeflash.events:NativeWindowBoundsEvent:RESIZEflash.events:NativeWindowBoundsEventWird von einem NativeWindow-Objekt abgesetzt, nachdem seine Größe geändert wurde. flash.display.NativeWindowresizingflash.events:NativeWindowBoundsEvent:RESIZINGflash.events:NativeWindowBoundsEventWird von einem NativeWindow-Objekt abgesetzt, bevor seine Größe geändert wird. flash.display.NativeWindowNativeWindowBoundsEvent Erstellt ein Event-Objekt mit spezifischen Informationen, die für Fenstergrenzen-Ereignisse relevant sind.typeString Der Ereignistyp. Folgende Werte sind möglich:
  • NativeWindowBoundsEvent.MOVING
  • NativeWindowBoundsEvent.MOVE
  • NativeWindowBoundsEvent.RESIZING
  • NativeWindowBoundsEvent.RESIZE
bubblesBooleanfalse Gibt an, ob das Ereignisobjekt an der Bubbling-Phase des Ereignisablaufs beteiligt ist. cancelableBooleanfalseGibt an, ob das Ereignisobjekt abgebrochen werden kann. beforeBoundsflash.geom:RectanglenullGibt die Grenzen vor der letzten oder der ausstehenden Änderung an. afterBoundsflash.geom:RectanglenullGibt die Grenzen nach der letzten oder der ausstehenden Änderung an.
Erstellt ein Event-Objekt mit spezifischen Informationen, die für Fenstergrenzen-Ereignisse relevant sind. Ereignisobjekte werden Ereignis-Listenern als Parameter übergeben.
clone Erstellt eine Kopie des NativeWindowBoundsEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.Ein neues NativeWindowBoundsEvent-Objekt mit Eigenschaftswerten, die denen des Originals entsprechen. flash.events:Event Erstellt eine Kopie des NativeWindowBoundsEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht. toString Gibt einen String zurück, der alle Eigenschaften des NativeWindowBoundsEvent-Objekts enthält.Ein String, der alle Eigenschaften des NativeWindowBoundsEvent-Objekts enthält. String Gibt einen String zurück, der alle Eigenschaften des NativeWindowBoundsEvent-Objekts enthält. Der String hat das folgende Format:

[NativeWindowBoundsEvent type=Wert bubbles=Wert cancelable=Wert previousDisplayState=Wert currentDisplayState=Wert]

MOVE Definiert den Wert der type-Eigenschaft eines move-Ereignisobjekts.moveStringWird von einem NativeWindow-Objekt abgesetzt, nachdem es verschoben wurde. Definiert den Wert der Eigenschaft type eines move-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftenWerteafterBoundsDie neuen Grenzen des Fensters.beforeBoundsDie alten Grenzen des Fensters.targetDas NativeWindow-Objekt, dessen Status sich gerade geändert hat. bubblesNein.currentTargetGibt das Objekt an, das das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.cancelablefalse; es gibt kein Standardverhalten, das abgebrochen werden kann.
flash.display.NativeWindow
MOVING Definiert den Wert der type-Eigenschaft eines moving-Ereignisobjekts.movingStringWird von einem NativeWindow-Objekt abgesetzt, bevor es verschoben wird. Definiert den Wert der type-Eigenschaft eines moving-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftenWerteafterBoundsDie Grenzen des Fenster nach der ausstehenden Änderung.beforeBoundsDie Grenzen des Fenster vor der ausstehenden Änderung.bubblesNein.cancelabletrue; das Abbrechen des Ereignisses verhindert das Verschieben des Fensters.currentTargetGibt das Objekt an, das das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.targetDas NativeWindow-Objekt, dessen Status sich gerade geändert hat.

Hinweis: Unter Linux wird die preventDefault()-methode für dieses Ereignis nicht unterstützt.

flash.display.NativeWindow
RESIZE Definiert den Wert der Eigenschaft type eines resize-Ereignisobjekts.resizeStringWird von einem NativeWindow-Objekt abgesetzt, nachdem seine Größe geändert wurde. Definiert den Wert der Eigenschaft type eines resize-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftenWerteafterBoundsDie neuen Grenzen des Fensters.beforeBoundsDie alten Grenzen des Fensters.targetDas NativeWindow-Objekt, dessen Status sich gerade geändert hat. bubblesNein.currentTargetGibt das Objekt an, das das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.cancelablefalse; es gibt kein Standardverhalten, das abgebrochen werden kann.
flash.display.NativeWindow
RESIZING Definiert den Wert der type-Eigenschaft eines resizing-Ereignisobjekts.resizingStringWird von einem NativeWindow-Objekt abgesetzt, bevor seine Größe geändert wird. Definiert den Wert der type-Eigenschaft eines resizing-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftenWerteafterBoundsDie Grenzen des Fenster nach der ausstehenden Änderung.beforeBoundsDie Grenzen des Fenster vor der ausstehenden Änderung.targetDas NativeWindow-Objekt, dessen Status sich gerade geändert hat. bubblesNein.currentTargetGibt das Objekt an, das das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.cancelabletrue; das Abbrechen des Ereignisses verhindert das Verschieben des Fensters.

Hinweis: Unter Linux wird die preventDefault()-methode für dieses Ereignis nicht unterstützt.

flash.display.NativeWindow
afterBounds Die Grenzen des Fensters nach der Änderung.flash.geom:Rectangle Die Grenzen des Fensters nach der Änderung.

Wenn es sich bei dem Ereignis um moving (Verschieben) oder resizing (Größe ändern) handelt, wurden die Grenzen noch nicht geändert; afterBounds gibt die neuen Grenzen an, falls das Ereignis nicht abgebrochen wird. Wenn es sich bei dem Ereignis um move oder resize handelt, gibt afterBounds die neuen Grenzen an.

beforeBounds Die Grenzen des Fensters vor der Änderung.flash.geom:Rectangle Die Grenzen des Fensters vor der Änderung.

Wenn es sich bei dem Ereignis um move oder resize handelt, wurden die Grenzen noch nicht geändert; beforeBounds gibt die aktuellen Grenzen an. Wenn es sich bei dem Ereignis um move oder resize handelt, gibt beforeBounds den Originalwert an.

SQLUpdateEvent Ein SQLUpdateEvent-Objekt wird von einem SQLConnection-Objekt ausgelöst, wenn in einer Tabelle, die der SQLConnection-Instanz zugeordnet ist, Daten geändert werden.flash.events:Event Ein SQLUpdateEvent-Objekt wird von einem SQLConnection-Objekt ausgelöst, wenn in einer Tabelle, die der SQLConnection-Instanz zugeordnet ist, Daten geändert werden. Eine Datenänderung kann auftreten, wenn eine SQL INSERT-, UPDATE- oder DELETE-Anweisung ausgeführt wurde, entweder direkt oder als Ergebnis einer Auslösung in Verbindung mit der Ausführung der Anweisung. Im folgenden Beispiel wird die Verwendung einer SQLUpdateEvent-Instanz als Antwort auf ein update-Ereignis gezeigt. var dbStatement:SQLStatement; function initConnection():void { var dbFile:File = new File(File.separator + "employee.db"); db.addEventListener(SQLEvent.OPEN, dbOpenHandler); db.addEventListener(SQLUpdateEvent.UPDATE, dbUpdateHandler); dbStatement.text = "UPDATE employees SET name = :name WHERE id = :id"; dbStatement.parameters[:name] = "Bruce"; dbStatement.parameters[:id] = 100; dbStatement.sqlConnection = db; db.open(dbFile); } function dbUpdateHandler(event:SQLUpdateEvent):void { trace(event.type + " for table '" + event.table + "' was fired for row with ID:" + event.rowID); } function dbOpenHandler(event:SQLEvent):void { dbStatement.execute(); } flash.data.SQLConnectiondeleteflash.events:SQLUpdateEvent:DELETEflash.events:SQLUpdateEventinsertflash.events:SQLUpdateEvent:INSERTflash.events:SQLUpdateEventupdateflash.events:SQLUpdateEvent:UPDATEflash.events:SQLUpdateEventSQLUpdateEvent Erstellt eine neue SQLUpdateEvent-Instanz.typeString Der Typ des Ereignisses, verfügbar über die type-Eigenschaft. bubblesBooleanfalse Legt fest, ob das Ereignisobjekt an der Bubbling-Phase des Ereignisablaufs teilnimmt. Der Standardwert ist false. cancelableBooleanfalseBestimmt, ob das Ereignisobjekt abgebrochen werden kann. Der Standardwert ist false. tableStringnullGibt den Namen der Tabelle an, deren Daten geändert wurden. rowIDNumber0Der eindeutige Zeilenbezeichner der Zeile, die eingefügt, gelöscht oder aktualisiert wurde. Dient zum Erstellen eines neuen SQLUpdateEvent-Objekts. Erstellt eine neue SQLUpdateEvent-Instanz. clone Erstellt eine Kopie des SQLUpdateEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.Ein neues SQLUpdateEvent-Objekt mit Eigenschaftswerten, die denen des Originals entsprechen. flash.events:Event Erstellt eine Kopie des SQLUpdateEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht. DELETE Die SQLUpdateEvent.DELETE-Konstante definiert den Wert der type-Eigenschaft eines delete-SQLConnection-Ereignisses.deleteString Die SQLUpdateEvent.DELETE-Konstante definiert den Wert der type-Eigenschaft eines delete-SQLConnection-Ereignisses. Das delete-Ereignis hat folgende Eigenschaften: EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.rowIDDer eindeutige Zeilenbezeichner der Zeile, die eingefügt, gelöscht oder aktualisiert wurde.targetDas SQLConnection-Objekt, für das der Vorgang ausgeführt wurde.tableDer Name der Tabelle, in der die Änderung aufgetreten ist. INSERT Die SQLUpdateEvent.INSERT-Konstante definiert den Wert der type-Eigenschaft eines insert-SQLConnection-Ereignisses.insertString Die SQLUpdateEvent.INSERT-Konstante definiert den Wert der type-Eigenschaft eines insert-SQLConnection-Ereignisses. Das insert-Ereignis hat folgende Eigenschaften: EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.rowIDDer eindeutige Zeilenbezeichner der Zeile, die eingefügt, gelöscht oder aktualisiert wurde.targetDas SQLConnection-Objekt, für das der Vorgang ausgeführt wurde.tableDer Name der Tabelle, in der die Änderung aufgetreten ist. UPDATE Die SQLUpdateEvent.UPDATE-Konstante definiert den Wert der type-Eigenschaft eines update-SQLConnection-Ereignisses.updateString Die SQLUpdateEvent.UPDATE-Konstante definiert den Wert der type-Eigenschaft eines update-SQLConnection-Ereignisses.

Das update-Ereignis hat folgende Eigenschaften:

EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.rowIDDer eindeutige Zeilenbezeichner der Zeile, die eingefügt, gelöscht oder aktualisiert wurde.targetDas SQLConnection-Objekt, für das der Vorgang ausgeführt wurde.tableDer Name der Tabelle, in der die Änderung aufgetreten ist.
rowID Der eindeutige Zeilenbezeichner der Zeile, die eingefügt, gelöscht oder aktualisiert wurde.Number Der eindeutige Zeilenbezeichner der Zeile, die eingefügt, gelöscht oder aktualisiert wurde.

Ein Zeilenbezeichner dient zur eindeutigen Kennzeichnung einer Zeile in einer Tabelle in der Datenbank. Der Wert wird häufig von der Datenbank erzeugt.

Den Zeilenbezeichner für die Ausführung einer SQL INSERT-Anweisung erhalten Sie über die Eigenschaft lastInsertRowID des „SQLResult“-Objekts, das durch die Methode getResult() des „SQLStatement“-Objekts zurückgegeben wird (wenn sie aufgerufen wird, nachdem SQLStatement das result-Ereignis ausgelöst hat).

Weitere Informationen zu Primärschlüsseln und generierten Zeilenbezeichnern finden Sie in den Abschnitten „CREATE TABLE“ und „Ausdrücke“ im Anhang „SQL-Unterstützung in lokalen Datenbanken“.

flash.data.SQLConnection.lastInsertRowIDflash.data.SQLResult.lastInsertRowID
table Der Name der Tabelle, deren Datenänderung zur Auslösung des Ereignisses geführt hat.String Der Name der Tabelle, deren Datenänderung zur Auslösung des Ereignisses geführt hat.
EventDispatcher Die EventDispatcher-Klasse ist die Basisklasse für alle runtime-Klassen, die Ereignisse auslösen.flash.events:IEventDispatcherObject Die EventDispatcher-Klasse ist die Basisklasse für alle --Klassen, die Ereignisse auslösen. Die EventDispatcher-Klasse implementiert die EventDispatcher-Schnittstelle und ist die Basisklasse der DisplayObject-Klasse. In der EventDispatcher-Klasse ist es möglich, dass jedes Objekt in der Anzeigeliste ein Ereignisziel sein kann, und als solches die Methoden der IEventDispatcher-Schnittstelle verwendet.

Ereignisziele sind ein wichtiger Bestandteil des Ereignismodells in Flash® Player und Adobe® AIR®. Das Ereignisziel dient als zentraler Punkt bei dem Ablauf der Ereignisse durch die Hierarchie der Anzeigeliste. Wenn ein Ereignis wie ein Mausklick oder ein Tastenanschlag eintritt, sendet Flash Player oder die AIR-Anwendung vom Root der Anzeigeliste aus ein Ereignisobjekt in den Ereignisablauf. Das Ereignisobjekt durchläuft die Anzeigeliste, bis es das Ereignisziel erreicht. An diesem Punkt angekommen, beginnt es den Rückweg durch die Anzeigeliste. Dieser Weg zum Ereignisziel und zurück ist im Prinzip in drei Phasen unterteilt: die Aufnahmephase umfasst den Weg vom Root zum letzten Knoten vor dem Ereigniszielknoten, die Zielphase umfasst nur den Ereigniszielknoten, und die Bubbling-Phase umfasst alle weiteren Knoten, auf die das Objekt auf dem Rückweg zum Root der Anzeigeliste trifft.

Im Allgemeinen besteht der einfachste Weg für eine benutzerdefinierte Klasse, die Fähigkeit zum Auslösen eines Ereignisses zu erhalten darin, die EventDispatcher-Klasse zu erweitern. Wenn dies nicht möglich ist (d. h., wenn die Klasse bereits eine andere Klasse erweitert), können Sie stattdessen die IEventDispatcher-Schnittstelle implementieren, ein EventDispatcher-Mitglied erstellen und einfache Hooks schreiben, um alle Aufrufe an einen aggregierten EventDispatcher zu leiten.

Im folgenden Beispiel wird anhand der Klassen EventDispatcherExample und CustomDispatcher (einer Unterklasse von EventDispatcher) erläutert, wie ein benutzerdefiniertes Ereignis erstellt und ausgelöst wird. In diesem Beispiel werden die folgenden Aufgaben ausgeführt:
  1. Der Konstruktor von EventDispatcherExample erstellt eine lokale dispatcher-Variable und weist sie einer neuen CustomDispatcher-Instanz zu.
  2. In CustomDispatcher wird der Name action für das Ereignis über einen String festgelegt, und die Methode doAction() wird deklariert. Bei Aufruf erstellt diese Methode das Ereignis action und löst es mit der Methode EventDispatcher.dispatchEvent() aus.
  3. Anschließend wird die Eigenschaft dispatcher verwendet, um den Ereignis-Listener action und die verknüpfte Abonnentenmethode actionHandler() zum Drucken von Informationen über das Ereignis beim Auslösungszeitpunkt hinzuzufügen.
  4. Die doAction()-Methode wird aufgerufen, und das action-Ereignis wird ausgelöst.
package { import flash.display.Sprite; import flash.events.Event; public class EventDispatcherExample extends Sprite { public function EventDispatcherExample() { var dispatcher:CustomDispatcher = new CustomDispatcher(); dispatcher.addEventListener(CustomDispatcher.ACTION, actionHandler); dispatcher.doAction(); } private function actionHandler(event:Event):void { trace("actionHandler: " + event); } } } import flash.events.EventDispatcher; import flash.events.Event; class CustomDispatcher extends EventDispatcher { public static var ACTION:String = "action"; public function doAction():void { dispatchEvent(new Event(CustomDispatcher.ACTION)); } }
deactivate [broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird.flash.events.Event.DEACTIVATEflash.events.Event [broadcast event] Wird ausgelöst, wenn die Flash Player- oder AIR-Anwendung den Fokus verliert und inaktiv wird. Bei diesem Ereignis handelt es sich um ein broadcast-Ereignis. Das bedeutet, dass es von allen EventDispatcher-Objekten ausgelöst wird, die einen Listener für dieses Ereignis registriert haben. Weitere Informationen zu broadcast-Ereignissen finden Sie im Abschnitt zur DisplayObject-Klasse. flash.display.DisplayObjectactivate [broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird.flash.events.Event.ACTIVATEflash.events.Event [broadcast event] Wird ausgelöst, wenn die Flash Player- oder AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird. Bei diesem Ereignis handelt es sich um ein broadcast-Ereignis. Das bedeutet, dass es von allen EventDispatcher-Objekten ausgelöst wird, die einen Listener für dieses Ereignis registriert haben. Weitere Informationen zu broadcast-Ereignissen finden Sie im Abschnitt zur DisplayObject-Klasse. flash.display.DisplayObjectEventDispatcher Aggregiert eine Instanz der EventDispatcher-Klasse.targetflash.events:IEventDispatchernullDas Zielobjekt für Ereignisse, die zum EventDispatcher-Objekt gesendet werden. Dieser Parameter wird verwendet, wenn die EventDispatcher-Instanz von einer Klasse aggregiert wird, die IEventDispatcher implementiert; dies ist notwendig, damit das enthaltene Objekt als Ziel für Ereignisse verwendet werden kann. Verwenden Sie diesen Parameter nicht in einfachen Fällen, in denen eine Klasse die EventDispatcher-Klasse erweitert. Aggregiert eine Instanz der EventDispatcher-Klasse.

Die EventDispatcher-Klasse wird im Allgemeinen als eine Basisklasse verwendet. Die meisten Entwickler brauchen diese Konstruktorfunktion also nicht zu verwenden. Dennoch wird dieser Konstruktor von erfahrenen Entwicklern benötigt, die die IEventDispatcher-Schnittstelle implementieren. Wenn Sie nicht in der Lage sind, die EventDispatcher-Klasse zu erweitern und stattdessen die IEventDispatcher-Schnittstelle implementieren müssen, verwenden Sie diesen Konstruktor, um eine Instanz der EventDispatcher-Klasse zu aggregieren.

addEventListener Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird.Der angegebene listener ist keine Funktion. ArgumentErrorArgumentErrortypeStringDer Typ des Ereignisses. listenerFunctionDie Listener-Funktion, die das Ereignis verarbeitet. Diese Funktion muss ein Ereignisobjekt als einzigen Parameter akzeptieren und darf keinen Wert zurückgeben, wie das nachfolgende Beispiel zeigt: function(evt:Event):void

Der Name der Funktion ist beliebig.

useCaptureBooleanfalse 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. Um auf das Ereignis in allen drei Phasen zu warten, rufen Sie addEventListener() zweimal auf; einmal ist useCapture auf true gesetzt, und beim zweiten Mal hat useCapture den Wert false. priorityint0Die Prioritätsstufe des Ereignis-Listeners. Die Priorität wird durch eine vorzeichenbehaftete 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. useWeakReferenceBooleanfalseBestimmt, 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 auf true setzen bei einem Listener, der eine verschachtelte innere Funktion ist, wird die Funktion vom Garbagekollektor entfernt. 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.

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 removeListener() 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 Aufnahmephase 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 Aufnahmephase 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 brauchen, entfernen sie ihn, indem Sie removeEventListener() aufrufen. Andernfalls könnte es zu Speicherproblemen kommen. Ereignis-Listener werden nicht automatisch aus dem Speicher entfernt, da der Garbage Collector den Listener nicht entfernt, solange das auslösende Objekt vorhanden ist (sofern der useWeakReference-Parameter auf true gesetzt ist).

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 wird, während mit diesem Knoten ein Ereignis durchgeführt wird, so wird der Ereignis-Listener während der aktuellen Phase nicht ausgelöst, kann aber während einer späteren Phase im Ereignisablauf ausgelöst werden, etwa während 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).

dispatchEvent Sendet ein Ereignis in den Ereignisablauf.Das Rekursionslimit für das Auslösen von Ereignissen wurde erreicht. ErrorErrorDer Wert true, wenn das Ereignis erfolgreich ausgelöst wurde. Der Wert false weist entweder auf einen Fehler hin oder auf die Tatsache, dass preventDefault() für das Ereignis aufgerufen worden ist. Booleaneventflash.events:EventDas 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 Zurücksenden des Ereignisses nur, wenn Sie eine neue Kopie des Ereignisses erstellen. Sendet ein Ereignis in den Ereignisablauf. Das Ereignisziel ist das EventDispatcher-Objekt, für das die Methode dispatchEvent() aufgerufen wird. hasEventListener Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.Der Wert true, wenn ein Listener des angegebenen Typs registriert ist; andernfalls false. BooleantypeStringDer Typ des Ereignisses. Ü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 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.

Wird hasEventListener() von einem LoaderInfo-Objekt aus aufgerufen, werden nur die Listener berücksichtigt, die dem Aufrufer zugänglich sind.

willTrigger()
removeEventListener Entfernt einen Listener aus dem EventDispatcher-Objekt.typeStringDer Typ des Ereignisses. listenerFunctionDas zu entfernende Listener-Objekt. useCaptureBooleanfalse Gibt an, ob der Listener für die Erfassungsphase oder die Ziel- und Bubbling-Phase registriert wurde. Wenn der Listener sowohl für die Aufnahme- 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. Entfernt einen Listener aus dem EventDispatcher-Objekt. Wenn kein entsprechender Listener mit dem EventDispatcher-Objekt registriert ist, hat ein Aufruf dieser Methode keine Auswirkungen. willTrigger Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner übergeordneten Objekte ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist.Der Wert true, wenn ein Listener des angegebenen Typs ausgelöst wird; andernfalls false. BooleantypeStringDer Typ des Ereignisses. Ü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 der hasEventListener()- und der willTrigger()-Methode besteht darin, dass die Methode hasEventListener() nur das Objekt untersucht, zu dem sie gehört, während die willTrigger()-Methode den gesamten Ereignisablauf auf das im Parameter type angegebene Ereignis untersucht.

Wird willTrigger() von einem LoaderInfo-Objekt aus aufgerufen, werden nur die Listener berücksichtigt, die dem Aufrufer zugänglich sind.

TouchEvent Mit der TouchEvent-Klasse können Sie Ereignisse auf Geräten verarbeiten, die den Benutzerkontakt mit dem Gerät erkennen (z. B. ein Finger auf einem Touchscreen).bietet Unterstützung für die Ereignisverarbeitung bei Berührungsinteraktionen flash.events:Event Mit der TouchEvent-Klasse können Sie Ereignisse auf Geräten verarbeiten, die den Benutzerkontakt mit dem Gerät erkennen (z. B. ein Finger auf einem Touchscreen). Wenn ein Benutzer mit einem Gerät mit Touchscreen, zum Beispiel bei einem Mobiltelefon oder Tablet, interagiert, setzt er normalerweise einen Finger oder Touchpen auf den Bildschirm und bewegt ihn. Mit der TouchEvent-Klasse können Sie Anwendungen entwickeln, die auf grundlegende Berührungsereignisse reagieren (zum Beispiel das einfache Tippen mit einem einzelnen Finger). Erstellen Sie Ereignis-Listener mit den Ereignistypen, die in dieser Klasse definiert sind. Für Benutzerinteraktionen mit mehreren Kontaktpunkten (zum Beispiel gleichzeitiges Bewegen mehrerer Finger über einen Touchscreen) verwenden Sie die verwandten GestureEvent-, PressAndTapGestureEvent- und TransformGestureEvent-Klassen. Verwenden Sie außerdem die Eigenschaften und Methoden dieser Klassen, um Ereignisprozeduren zu konstruieren, die auf die Berührung des Benutzers mit dem Gerät reagieren.

Stellen Sie mithilfe der Multitouch-Klasse fest, welche Berührungsinteraktionen die aktuelle Umgebung unterstützt, und verwalten Sie die ggf. unterstützten Berührungsinteraktionen.

Hinweis: Wenn Objekte auf der Anzeigeliste verschachtelt sind, zielen Berührungsereignisse auf das am weitesten verschachtelte Objekt, das auf der Anzeigeliste zu sehen ist. Dieses Objekt wird als Zielknoten bezeichnet. Damit der Vorfahre des Knotens (ein Objekt in der Anzeigeliste, das den Zielknoten enthält) über ein Berührungsereignis benachrichtigt wird, verwenden Sie EventDispatcher.addEventListener() für den Vorfahrenknoten. Dabei sollte der type-Parameter auf das Berührungsereignis gesetzt werden, das Sie erkennen möchten.

Das folgende Beispiel zeigt die Ereignisverarbeitung für TOUCH_BEGIN-, TOUCH_MOVE- und TOUCH_END-Ereignisse. Während sich der Kontaktpunkt über den Bildschirm bewegt (onTouchMove), wird die x-Koordinate in Relation zur Bühne in der Ausgabe verfolgt. Für den Sprite.startTouchDrag-Parameter in der onTouchBegin-Funktion ist der Wert für touchPointID der Wert, der dem Ereignisobjekt zugewiesen wurde. Der bounds-Parameter ist das Rechteck, das die Grenzen des übergeordneten Anzeigeobjekts definiert (bg ist ein Anzeigeobjekt, das MySprite enthält). Multitouch.inputMode = MultitouchInputMode.TOUCH_POINT; MySprite.addEventListener(TouchEvent.TOUCH_BEGIN, onTouchBegin); MySprite.addEventListener(TouchEvent.TOUCH_MOVE, onTouchMove); MySprite.addEventListener(TouchEvent.TOUCH_END, onTouchEnd); function onTouchBegin(eBegin:TouchEvent) { eBegin.target.startTouchDrag(eBegin.touchPointID, false, bg.getRect(this)); trace("touch begin"); } function onTouchMove(eMove:TouchEvent) { trace(eMove.stageX); } function onTouchEnd(eEnd:TouchEvent) { eEnd.target.stopTouchDrag(eEnd.touchPointID); trace("touch end"); } Das folgende Beispiel zeigt, wie Berührungsereignisse und Berührungsereignisphasen sowie die Multitouch.maxTouchPoints- und die touchPointID-Eigenschaften des Berührungsobjekts verarbeitet werden. Das Beispiel stammt von Christian Cantrell und wird ausführlicher in seiner Kurzanleitung beschrieben: Multi-touch and gesture support on the Flash Platform. package { import flash.display.Sprite; import flash.events.TouchEvent; import flash.text.AntiAliasType; import flash.text.TextField; import flash.text.TextFormat; import flash.ui.Multitouch; import flash.ui.MultitouchInputMode; [SWF(width=320, height=460, frameRate=24, backgroundColor=0xEB7F00)] public class TouchExample2 extends Sprite { private var dots:Object; private var labels:Object; private var labelFormat:TextFormat; private var dotCount:uint; private var dotsLeft:TextField; private static const LABEL_SPACING:uint = 15; public function TouchExample2() { super(); this.labelFormat = new TextFormat(); labelFormat.color = 0xACF0F2; labelFormat.font = "Helvetica"; labelFormat.size = 11; this.dotCount = 0; this.dotsLeft = new TextField(); this.dotsLeft.width = 300; this.dotsLeft.defaultTextFormat = this.labelFormat; this.dotsLeft.x = 3; this.dotsLeft.y = 0; this.stage.addChild(this.dotsLeft); this.updateDotsLeft(); this.dots = new Object(); this.labels = new Object(); Multitouch.inputMode = MultitouchInputMode.TOUCH_POINT; this.stage.addEventListener(TouchEvent.TOUCH_BEGIN, onTouchBegin); this.stage.addEventListener(TouchEvent.TOUCH_MOVE, onTouchMove); this.stage.addEventListener(TouchEvent.TOUCH_END, onTouchEnd); } private function onTouchBegin(e:TouchEvent):void { if (this.dotCount == Multitouch.maxTouchPoints) return; var dot:Sprite = this.getCircle(); dot.x = e.stageX; dot.y = e.stageY; this.stage.addChild(dot); dot.startTouchDrag(e.touchPointID, true); this.dots[e.touchPointID] = dot; ++this.dotCount; var label:TextField = this.getLabel(e.stageX + ", " + e.stageY); label.x = 3; label.y = this.dotCount * LABEL_SPACING; this.stage.addChild(label); this.labels[e.touchPointID] = label; this.updateDotsLeft(); } private function onTouchMove(e:TouchEvent):void { var label:TextField = this.labels[e.touchPointID]; label.text = (e.stageX + ", " + e.stageY); } private function onTouchEnd(e:TouchEvent):void { var dot:Sprite = this.dots[e.touchPointID]; var label:TextField = this.labels[e.touchPointID]; this.stage.removeChild(dot); this.stage.removeChild(label); delete this.dots[e.touchPointID]; delete this.labels[e.touchPointID]; --this.dotCount; this.updateDotsLeft(); } private function getCircle(circumference:uint = 40):Sprite { var circle:Sprite = new Sprite(); circle.graphics.beginFill(0x1695A3); circle.graphics.drawCircle(0, 0, circumference); return circle; } private function getLabel(initialText:String):TextField { var label:TextField = new TextField(); label.defaultTextFormat = this.labelFormat; label.selectable = false; label.antiAliasType = AntiAliasType.ADVANCED; label.text = initialText; return label; } private function updateDotsLeft():void { this.dotsLeft.text = "Touches Remaining: " + (Multitouch.maxTouchPoints - this.dotCount); } } }
flash.ui.Multitouchflash.events.GestureEventflash.events.TransformGestureEventflash.events.PressAndTapGestureEventflash.events.MouseEventflash.events.EventDispatcher.addEventListener()touchBeginflash.events:TouchEvent:TOUCH_BEGINflash.events:TouchEventflash.display.InteractiveObject.touchBegintouchEndflash.events:TouchEvent:TOUCH_ENDflash.events:TouchEventflash.display.InteractiveObject.touchEndtouchMoveflash.events:TouchEvent:TOUCH_MOVEflash.events:TouchEventflash.display.InteractiveObject.touchMovetouchOutflash.events:TouchEvent:TOUCH_OUTflash.events:TouchEventflash.display.InteractiveObject.touchOuttouchOverflash.events:TouchEvent:TOUCH_OVERflash.events:TouchEventflash.display.InteractiveObject.touchOvertouchRollOutflash.events:TouchEvent:TOUCH_ROLL_OUTflash.events:TouchEventflash.display.InteractiveObject.touchRollOuttouchRollOverflash.events:TouchEvent:TOUCH_ROLL_OVERflash.events:TouchEventflash.display.InteractiveObject.touchRollOvertouchTapflash.events:TouchEvent:TOUCH_TAPflash.events:TouchEvent Im folgenden Beispiel wird eine Meldung angezeigt, wenn bei einem Touchscreen auf das in mySprite gezeichnete Quadrat getippt wird: Multitouch.inputMode=MultitouchInputMode.TOUCH_POINT; var mySprite:Sprite = new Sprite(); var myTextField:TextField = new TextField(); mySprite.graphics.beginFill(0x336699); mySprite.graphics.drawRect(0,0,40,40); addChild(mySprite); mySprite.addEventListener(TouchEvent.TOUCH_TAP, taphandler); function taphandler(e:TouchEvent): void { myTextField.text = "I've been tapped"; myTextField.y = 50; addChild(myTextField); } flash.display.InteractiveObject.touchTapTouchEvent Erstellt ein Ereignisobjekt, das Informationen über Berührungsereignisse enthält.typeString Der Ereignistyp. Mögliche Werte sind: TouchEvent.TOUCH_BEGIN, TouchEvent.TOUCH_END, TouchEvent.TOUCH_MOVE, TouchEvent.TOUCH_OUT, TouchEvent.TOUCH_OVER, TouchEvent.TOUCH_ROLL_OUT, TouchEvent.TOUCH_ROLL_OVER und TouchEvent.TOUCH_TAP. bubblesBooleantrue Legt fest, ob das Ereignisobjekt an der Bubbling-Phase des Ereignisablaufs teilnimmt. cancelableBooleanfalseBestimmt, ob das Ereignisobjekt abgebrochen werden kann. touchPointIDint0Eine eindeutige Kennung (wie eine Ganzzahl), die dem Kontaktpunkt zugeordnet ist. isPrimaryTouchPointBooleanfalseGibt an, ob der erste Kontaktpunkt Mausereignissen zugeordnet ist. localXNumberunknownDie horizontale Koordinate, an der das Ereignis aufgetreten ist, in Relation zum umgebenden Sprite. localYNumberunknownDie vertikale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden Sprite-Objekt steht. sizeXNumberunknownBreite des Kontaktbereichs. sizeYNumberunknownHöhe des Kontaktbereichs. pressureNumberunknownEin Wert zwischen 0.0 und 1.0, der die Stärke des Kontakts mit dem Gerät angibt. Wenn das Gerät die Druck-Erkennung nicht unterstützt, ist dieser Wert1.0. relatedObjectflash.display:InteractiveObjectnullDie andere InteractiveObject-Instanz, die von dem Ereignis betroffen ist. Wenn beispielsweise ein touchOut-Ereignis auftritt, stellt relatedObject das Anzeigelistenobjekt dar, auf das das Zeigegerät jetzt zeigt. ctrlKeyBooleanfalseUnter Windows oder Linux wird damit angezeigt, ob die Strg-Taste aktiviert ist. Unter Mac OS wird damit angezeigt, ob die Ctrl-Taste oder die Befehlstaste aktiviert ist. altKeyBooleanfalseGibt an, ob die Alt-Taste aktiviert ist (nur Windows oder Linux). shiftKeyBooleanfalseGibt an, ob der Umschalttasten-Modifizierer aktiviert ist. commandKeyBooleanfalse(nur AIR); gibt an, ob die Befehlstaste aktiviert ist (nur Mac). Dieser Parameter gilt nur für Adobe AIR. Setzen Sie ihn nicht für Flash Player-Inhalte. controlKeyBooleanfalse(nur AIR); gibt an, ob die Ctrl- oder Strg-Taste aktiviert ist. Dieser Parameter gilt nur für Adobe AIR. Setzen Sie ihn nicht für Flash Player-Inhalte. Konstruktor für TouchEvent-Objekte. Erstellt ein Ereignisobjekt, das Informationen über Berührungsereignisse enthält. Ereignisobjekte werden Ereignis-Listenern als Parameter übergeben. clone Erstellt eine Kopie des TouchEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.Ein neues TouchEvent-Objekt mit Eigenschaftswerten, die denen des Originals entsprechen. flash.events:Event Erstellt eine Kopie des TouchEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht. toString Gibt einen String zurück, der alle Eigenschaften des TouchEvent-Objekts enthält.Ein String, der alle Eigenschaften des TouchEvent-Objekts enthält. String Gibt einen String zurück, der alle Eigenschaften des TouchEvent-Objekts enthält. Der String liegt im folgenden Format vor:

[TouchEvent type=Wert bubbles=Wert cancelable=Wert ... ]

updateAfterEvent Weist Flash Player oder Adobe AIR nach Abschluss der Verarbeitung dieses Ereignisses zur Wiedergabe an, wenn die Anzeigeliste geändert wurde. Weist Flash Player oder Adobe AIR nach Abschluss der Verarbeitung dieses Ereignisses zur Wiedergabe an, wenn die Anzeigeliste geändert wurde. TOUCH_BEGIN Definiert den Wert der type-Eigenschaft eines TOUCH_BEGIN-Berührungsereignisobjekts.touchBeginString Definiert den Wert der type-Eigenschaft eines TOUCH_BEGIN-Berührungsereignisobjekts.

Das abgesetzte TouchEvent-Objekt hat folgende Eigenschaften:

EigenschaftWertaltKeytrue, wenn die Alt-Taste aktiviert ist (Windows oder Linux).bubblestruecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.commandKeytrue unter Mac OS, falls die Befehlstaste aktiviert ist; false, wenn sie deaktiviert ist. Unter Windows immer false controlKeytrue, wenn die Strg- oder Ctrl-Taste aktiv ist; false, wenn sie nicht aktiv ist.ctrlKeytrue unter Windows oder Linux, wenn die Strg-Taste aktiv ist. true unter Mac OS, falls die Strg-Taste oder die Befehlstaste aktiv ist. Andernfalls wird false zurückgegeben.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.eventPhaseDie aktuelle Phase im Ereignisablauf.isRelatedObjectInaccessibletrue, wenn die relatedObject-Eigenschaft aufgrund von Sicherheitssandboxregeln den Wert null hat.localXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, in Relation zum umgebenden Sprite.localYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden Sprite-Objekt steht.pressureEin Wert zwischen 0.0 und 1.0, der die Stärke des Kontakts mit dem Gerät angibt. Wenn das Gerät die Druck-Erkennung nicht unterstützt, ist dieser Wert1.0.relatedObjectEin Verweis auf ein Anzeigelistenobjekt, das mit diesem Ereignis verwandt ist.shiftKeytrue, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist.sizeXBreite des Kontaktbereichs.sizeYHöhe des Kontaktbereichs.stageXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.stageYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.targetDie InteractiveObject-Instanz unter dem Touchpen oder Finger. Das unter target angegebene Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet.touchPointIDEine eindeutige Kennung (wie eine Ganzzahl), die dem Kontaktpunkt zugeordnet ist.
flash.display.InteractiveObject.touchBegin
TOUCH_END Definiert den Wert der type-Eigenschaft eines TOUCH_END-Berührungsereignisobjekts.touchEndString Definiert den Wert der type-Eigenschaft eines TOUCH_END-Berührungsereignisobjekts.

Das abgesetzte TouchEvent-Objekt hat folgende Eigenschaften:

EigenschaftWertaltKeytrue, wenn die Alt-Taste aktiviert ist (Windows oder Linux).bubblestruecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.commandKeytrue unter Mac OS, falls die Befehlstaste aktiviert ist; false, wenn sie deaktiviert ist. Unter Windows immer false controlKeytrue, wenn die Strg- oder Ctrl-Taste aktiv ist; false, wenn sie nicht aktiv ist.ctrlKeytrue unter Windows oder Linux, wenn die Strg-Taste aktiv ist. true unter Mac OS, falls die Strg-Taste oder die Befehlstaste aktiv ist. Andernfalls wird false zurückgegeben.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.eventPhaseDie aktuelle Phase im Ereignisablauf.isRelatedObjectInaccessibletrue, wenn die relatedObject-Eigenschaft aufgrund von Sicherheitssandboxregeln den Wert null hat.localXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, in Relation zum umgebenden Sprite.localYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden Sprite-Objekt steht.pressureEin Wert zwischen 0.0 und 1.0, der die Stärke des Kontakts mit dem Gerät angibt. Wenn das Gerät die Druck-Erkennung nicht unterstützt, ist dieser Wert1.0.relatedObjectEin Verweis auf ein Anzeigelistenobjekt, das mit diesem Ereignis verwandt ist.shiftKeytrue, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist.sizeXBreite des Kontaktbereichs.sizeYHöhe des Kontaktbereichs.stageXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.stageYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.targetDie InteractiveObject-Instanz unter dem Touchpen oder Finger. Das unter target angegebene Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet.touchPointIDEine eindeutige Kennung (wie eine Ganzzahl), die dem Kontaktpunkt zugeordnet ist.
flash.display.InteractiveObject.touchEnd
TOUCH_MOVE Definiert den Wert der type-Eigenschaft eines TOUCH_MOVE-Berührungsereignisobjekts.touchMoveString Definiert den Wert der type-Eigenschaft eines TOUCH_MOVE-Berührungsereignisobjekts.

Das abgesetzte TouchEvent-Objekt hat folgende Eigenschaften:

EigenschaftWertaltKeytrue, wenn die Alt-Taste aktiviert ist (Windows oder Linux).bubblestruecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.commandKeytrue unter Mac OS, falls die Befehlstaste aktiviert ist; false, wenn sie deaktiviert ist. Unter Windows immer false controlKeytrue, wenn die Strg- oder Ctrl-Taste aktiv ist; false, wenn sie nicht aktiv ist.ctrlKeytrue unter Windows oder Linux, wenn die Strg-Taste aktiv ist. true unter Mac OS, falls die Strg-Taste oder die Befehlstaste aktiv ist. Andernfalls wird false zurückgegeben.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.eventPhaseDie aktuelle Phase im Ereignisablauf.isRelatedObjectInaccessibletrue, wenn die relatedObject-Eigenschaft aufgrund von Sicherheitssandboxregeln den Wert null hat.localXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, in Relation zum umgebenden Sprite.localYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden Sprite-Objekt steht.pressureEin Wert zwischen 0.0 und 1.0, der die Stärke des Kontakts mit dem Gerät angibt. Wenn das Gerät die Druck-Erkennung nicht unterstützt, ist dieser Wert1.0.relatedObjectEin Verweis auf ein Anzeigelistenobjekt, das mit diesem Ereignis verwandt ist.shiftKeytrue, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist.sizeXBreite des Kontaktbereichs.sizeYHöhe des Kontaktbereichs.stageXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.stageYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.targetDie InteractiveObject-Instanz unter dem Touchpen oder Finger. Das unter target angegebene Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet.touchPointIDEine eindeutige Kennung (wie eine Ganzzahl), die dem Kontaktpunkt zugeordnet ist.
flash.display.InteractiveObject.touchMove
TOUCH_OUT Definiert den Wert der type-Eigenschaft eines TOUCH_OUT-Berührungsereignisobjekts.touchOutString Definiert den Wert der type-Eigenschaft eines TOUCH_OUT-Berührungsereignisobjekts.

Das abgesetzte TouchEvent-Objekt hat folgende Eigenschaften:

EigenschaftWertaltKeytrue, wenn die Alt-Taste aktiviert ist (Windows oder Linux).bubblestruecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.commandKeytrue unter Mac OS, falls die Befehlstaste aktiviert ist; false, wenn sie deaktiviert ist. Unter Windows immer false controlKeytrue, wenn die Strg- oder Ctrl-Taste aktiv ist; false, wenn sie nicht aktiv ist.ctrlKeytrue unter Windows oder Linux, wenn die Strg-Taste aktiv ist. true unter Mac OS, falls die Strg-Taste oder die Befehlstaste aktiv ist. Andernfalls wird false zurückgegeben.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.eventPhaseDie aktuelle Phase im Ereignisablauf.isRelatedObjectInaccessibletrue, wenn die relatedObject-Eigenschaft aufgrund von Sicherheitssandboxregeln den Wert null hat.localXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, in Relation zum umgebenden Sprite.localYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden Sprite-Objekt steht.pressureEin Wert zwischen 0.0 und 1.0, der die Stärke des Kontakts mit dem Gerät angibt. Wenn das Gerät die Druck-Erkennung nicht unterstützt, ist dieser Wert1.0.relatedObjectEin Verweis auf ein Anzeigelistenobjekt, das mit diesem Ereignis verwandt ist.shiftKeytrue, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist.sizeXBreite des Kontaktbereichs.sizeYHöhe des Kontaktbereichs.stageXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.stageYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.targetDie InteractiveObject-Instanz unter dem Touchpen oder Finger. Das unter target angegebene Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet.touchPointIDEine eindeutige Kennung (wie eine Ganzzahl), die dem Kontaktpunkt zugeordnet ist.
flash.display.InteractiveObject.touchOut
TOUCH_OVER Definiert den Wert der type-Eigenschaft eines TOUCH_OVER-Berührungsereignisobjekts.touchOverString Definiert den Wert der type-Eigenschaft eines TOUCH_OVER-Berührungsereignisobjekts.

Das abgesetzte TouchEvent-Objekt hat folgende Eigenschaften:

EigenschaftWertaltKeytrue, wenn die Alt-Taste aktiviert ist (Windows oder Linux).bubblestruecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.commandKeytrue unter Mac OS, falls die Befehlstaste aktiviert ist; false, wenn sie deaktiviert ist. Unter Windows immer false controlKeytrue, wenn die Strg- oder Ctrl-Taste aktiv ist; false, wenn sie nicht aktiv ist.ctrlKeytrue unter Windows oder Linux, wenn die Strg-Taste aktiv ist. true unter Mac OS, falls die Strg-Taste oder die Befehlstaste aktiv ist. Andernfalls wird false zurückgegeben.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.eventPhaseDie aktuelle Phase im Ereignisablauf.isRelatedObjectInaccessibletrue, wenn die relatedObject-Eigenschaft aufgrund von Sicherheitssandboxregeln den Wert null hat.localXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, in Relation zum umgebenden Sprite.localYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden Sprite-Objekt steht.pressureEin Wert zwischen 0.0 und 1.0, der die Stärke des Kontakts mit dem Gerät angibt. Wenn das Gerät die Druck-Erkennung nicht unterstützt, ist dieser Wert1.0.relatedObjectEin Verweis auf ein Anzeigelistenobjekt, das mit diesem Ereignis verwandt ist.shiftKeytrue, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist.sizeXBreite des Kontaktbereichs.sizeYHöhe des Kontaktbereichs.stageXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.stageYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.targetDie InteractiveObject-Instanz unter dem Touchpen oder Finger. Das unter target angegebene Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet.touchPointIDEine eindeutige Kennung (wie eine Ganzzahl), die dem Kontaktpunkt zugeordnet ist.
flash.display.InteractiveObject.touchOver
TOUCH_ROLL_OUT Definiert den Wert der type-Eigenschaft eines TOUCH_ROLL_OUT-Berührungsereignisobjekts.touchRollOutString Definiert den Wert der type-Eigenschaft eines TOUCH_ROLL_OUT-Berührungsereignisobjekts.

Das abgesetzte TouchEvent-Objekt hat folgende Eigenschaften:

EigenschaftWertaltKeytrue, wenn die Alt-Taste aktiviert ist (Windows oder Linux).bubblestruecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.commandKeytrue unter Mac OS, falls die Befehlstaste aktiviert ist; false, wenn sie deaktiviert ist. Unter Windows immer false controlKeytrue, wenn die Strg- oder Ctrl-Taste aktiv ist; false, wenn sie nicht aktiv ist.ctrlKeytrue unter Windows oder Linux, wenn die Strg-Taste aktiv ist. true unter Mac OS, falls die Strg-Taste oder die Befehlstaste aktiv ist. Andernfalls wird false zurückgegeben.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.eventPhaseDie aktuelle Phase im Ereignisablauf.isRelatedObjectInaccessibletrue, wenn die relatedObject-Eigenschaft aufgrund von Sicherheitssandboxregeln den Wert null hat.localXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, in Relation zum umgebenden Sprite.localYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden Sprite-Objekt steht.pressureEin Wert zwischen 0.0 und 1.0, der die Stärke des Kontakts mit dem Gerät angibt. Wenn das Gerät die Druck-Erkennung nicht unterstützt, ist dieser Wert1.0.relatedObjectEin Verweis auf ein Anzeigelistenobjekt, das mit diesem Ereignis verwandt ist.shiftKeytrue, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist.sizeXBreite des Kontaktbereichs.sizeYHöhe des Kontaktbereichs.stageXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.stageYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.targetDie InteractiveObject-Instanz unter dem Touchpen oder Finger. Das unter target angegebene Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet.touchPointIDEine eindeutige Kennung (wie eine Ganzzahl), die dem Kontaktpunkt zugeordnet ist.
flash.display.InteractiveObject.touchRollOut
TOUCH_ROLL_OVER Definiert den Wert der type-Eigenschaft eines TOUCH_ROLL_OVER-Berührungsereignisobjekts.touchRollOverString Definiert den Wert der type-Eigenschaft eines TOUCH_ROLL_OVER-Berührungsereignisobjekts.

Das abgesetzte TouchEvent-Objekt hat folgende Eigenschaften:

EigenschaftWertaltKeytrue, wenn die Alt-Taste aktiviert ist (Windows oder Linux).bubblestruecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.commandKeytrue unter Mac OS, falls die Befehlstaste aktiviert ist; false, wenn sie deaktiviert ist. Unter Windows immer false controlKeytrue, wenn die Strg- oder Ctrl-Taste aktiv ist; false, wenn sie nicht aktiv ist.ctrlKeytrue unter Windows oder Linux, wenn die Strg-Taste aktiv ist. true unter Mac OS, falls die Strg-Taste oder die Befehlstaste aktiv ist. Andernfalls wird false zurückgegeben.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.eventPhaseDie aktuelle Phase im Ereignisablauf.isRelatedObjectInaccessibletrue, wenn die relatedObject-Eigenschaft aufgrund von Sicherheitssandboxregeln den Wert null hat.localXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, in Relation zum umgebenden Sprite.localYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden Sprite-Objekt steht.pressureEin Wert zwischen 0.0 und 1.0, der die Stärke des Kontakts mit dem Gerät angibt. Wenn das Gerät die Druck-Erkennung nicht unterstützt, ist dieser Wert1.0.relatedObjectEin Verweis auf ein Anzeigelistenobjekt, das mit diesem Ereignis verwandt ist.shiftKeytrue, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist.sizeXBreite des Kontaktbereichs.sizeYHöhe des Kontaktbereichs.stageXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.stageYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.targetDie InteractiveObject-Instanz unter dem Touchpen oder Finger. Das unter target angegebene Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet.touchPointIDEine eindeutige Kennung (wie eine Ganzzahl), die dem Kontaktpunkt zugeordnet ist.
flash.display.InteractiveObject.touchRollOver
TOUCH_TAP Definiert den Wert der type-Eigenschaft eines TOUCH_TAP-Berührungsereignisobjekts.touchTapString Definiert den Wert der type-Eigenschaft eines TOUCH_TAP-Berührungsereignisobjekts.

Das abgesetzte TouchEvent-Objekt hat folgende Eigenschaften:

EigenschaftWertaltKeytrue, wenn die Alt-Taste aktiviert ist (Windows oder Linux).bubblestruecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.commandKeytrue unter Mac OS, falls die Befehlstaste aktiviert ist; false, wenn sie deaktiviert ist. Unter Windows immer false controlKeytrue, wenn die Strg- oder Ctrl-Taste aktiv ist; false, wenn sie nicht aktiv ist.ctrlKeytrue unter Windows oder Linux, wenn die Strg-Taste aktiv ist. true unter Mac OS, falls die Strg-Taste oder die Befehlstaste aktiv ist. Andernfalls wird false zurückgegeben.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.eventPhaseDie aktuelle Phase im Ereignisablauf.isRelatedObjectInaccessibletrue, wenn die relatedObject-Eigenschaft aufgrund von Sicherheitssandboxregeln den Wert null hat.localXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, in Relation zum umgebenden Sprite.localYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden Sprite-Objekt steht.pressureEin Wert zwischen 0.0 und 1.0, der die Stärke des Kontakts mit dem Gerät angibt. Wenn das Gerät die Druck-Erkennung nicht unterstützt, ist dieser Wert1.0.relatedObjectEin Verweis auf ein Anzeigelistenobjekt, das mit diesem Ereignis verwandt ist.shiftKeytrue, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist.sizeXBreite des Kontaktbereichs.sizeYHöhe des Kontaktbereichs.stageXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.stageYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.targetDie InteractiveObject-Instanz unter dem Touchpen oder Finger. Das unter target angegebene Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet.touchPointIDEine eindeutige Kennung (wie eine Ganzzahl), die dem Kontaktpunkt zugeordnet ist.
Im folgenden Beispiel wird eine Meldung angezeigt, wenn bei einem Touchscreen auf das in mySprite gezeichnete Quadrat getippt wird: Multitouch.inputMode=MultitouchInputMode.TOUCH_POINT; var mySprite:Sprite = new Sprite(); var myTextField:TextField = new TextField(); mySprite.graphics.beginFill(0x336699); mySprite.graphics.drawRect(0,0,40,40); addChild(mySprite); mySprite.addEventListener(TouchEvent.TOUCH_TAP, taphandler); function taphandler(e:TouchEvent): void { myTextField.text = "I've been tapped"; myTextField.y = 50; addChild(myTextField); }
flash.display.InteractiveObject.touchTap
altKey Gibt an, ob die Alt-Taste aktiviert (true) oder deaktiviert (false) ist.Boolean Gibt an, ob die Alt-Taste aktiviert (true) oder deaktiviert (false) ist. Wird nur für Windows und Linux unterstützt. commandKey Gibt an, ob die Befehlstaste aktiviert ist (nur Mac).Boolean Gibt an, ob die Befehlstaste aktiviert ist (nur Mac).

Unter Mac OS ist der Wert der commandKey-Eigenschaft identisch mit dem Wert der ctrlKey-Eigenschaft. Diese Eigenschaft ist unter Windows oder Linux immer „false“.

controlKey Gibt an, ob unter Mac OS die Ctrl-Taste oder unter Windows oder Linux die Strg-Taste aktiviert ist.Boolean Gibt an, ob unter Mac OS die Ctrl-Taste oder unter Windows oder Linux die Strg-Taste aktiviert ist. ctrlKey Gibt unter Windows oder Linux an, ob die Strg-Taste aktiviert (true) oder deaktiviert (false) ist.Boolean Gibt unter Windows oder Linux an, ob die Strg-Taste aktiviert (true) oder deaktiviert (false) ist. Unter Mac wird damit angezeigt, ob die Ctrl-Taste oder die Befehlstaste aktiviert ist. isPrimaryTouchPoint Gibt an, ob der erste Kontaktpunkt Mausereignissen zugeordnet ist.Boolean Gibt an, ob der erste Kontaktpunkt Mausereignissen zugeordnet ist. flash.events.MouseEventisRelatedObjectInaccessible Falls „true“, ist die relatedObject-Eigenschaft aus Gründen, die mit der Sicherheitssandbox zusammenhängen, auf null gesetzt.Boolean Wenn true, ist die relatedObject-Eigenschaft aus Gründen, die mit der Sicherheitssandbox zusammenhängen, auf null gesetzt. Ist der Nominalwert von relatedObject ein Verweis auf ein DisplayObject in einer anderen Sandbox, wird relatedObject auf null gesetzt, es sei denn, die Berechtigung gilt über die Sandboxgrenzen hinweg für beide Richtungen. Die Berechtigung wird eingerichtet, indem aus einer SWF-Datei Security.allowDomain() aufgerufen wird oder eine Richtliniendatei vom Server einer Bilddatei bereitgestellt und die LoaderContext.checkPolicyFile-Eigenschaft beim Laden des Bilds gesetzt wird. MouseEvent.relatedObjectSecurity.allowDomain()LoaderContext.checkPolicyFilelocalX Die horizontale Koordinate, an der das Ereignis aufgetreten ist, in Relation zum umgebenden Sprite.Number Die horizontale Koordinate, an der das Ereignis aufgetreten ist, in Relation zum umgebenden Sprite. localY Die vertikale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden Sprite-Objekt steht.Number Die vertikale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden Sprite-Objekt steht. pressure Ein Wert zwischen 0.0 und 1.0, der die Stärke des Kontakts mit dem Gerät angibt.Number Ein Wert zwischen 0.0 und 1.0, der die Stärke des Kontakts mit dem Gerät angibt. Wenn das Gerät die Druck-Erkennung nicht unterstützt, ist dieser Wert1.0. relatedObject Ein Verweis auf ein Anzeigelistenobjekt, das in Relation zum Ereignis steht.flash.display:InteractiveObject Ein Verweis auf ein Anzeigelistenobjekt, das in Relation zum Ereignis steht. Wenn beispielsweise ein touchOut-Ereignis auftritt, stellt relatedObject das Anzeigelistenobjekt dar, auf das das Zeigegerät jetzt zeigt. Diese Eigenschaft gilt für die Ereignisse touchOut, touchOver, touchRollOut und touchRollOver.

Der Wert dieser Eigenschaft kann in zwei Fällen null sein: Wenn es kein verwandtes Objekt gibt oder wenn es eines gibt, dieses aber eine Sicherheitssandbox ist, auf die Sie keinen Zugriff haben. Verwenden Sie die isRelatedObjectInaccessible()-Eigenschaft, um festzustellen, welcher dieser Gründe zutrifft.

TouchEvent.isRelatedObjectInaccessible
shiftKey Gibt an, ob die Umschalttaste aktiviert (true) oder deaktiviert (false) ist.Boolean Gibt an, ob die Umschalttaste aktiviert (true) oder deaktiviert (false) ist. sizeX Breite des Kontaktbereichs.Number Breite des Kontaktbereichs. sizeY Höhe des Kontaktbereichs.Number Höhe des Kontaktbereichs. stageX Die horizontale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.Number Die horizontale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten. Diese Eigenschaft wird berechnet, wenn die Eigenschaft localX eingerichtet wird. stageY Die vertikale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.Number Die vertikale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten. Diese Eigenschaft wird berechnet, wenn die Eigenschaft localY eingerichtet wird. touchPointID Eine eindeutige Kennung (wie eine Ganzzahl), die dem Kontaktpunkt zugeordnet ist.int Eine eindeutige Kennung (wie eine Ganzzahl), die dem Kontaktpunkt zugeordnet ist. Im folgenden Beispiel wird eine touchMoveID-Variable eingerichtet, um auf den richtigen touchPointID-Wert zu prüfen, bevor auf ein Berührungsverschiebungs-Ereignis reagiert wird. Andernfalls lösen auch andere Berührungseingaben diese Ereignisprozedur aus. Beachten Sie, dass sich die Listener für die Verschiebungs- und Endphasen auf der Bühne, nicht im Anzeigeobjekt befinden. Die Bühne wartet auf die Verschiebungs- oder Endphasen für den Fall, dass die Berührungsverschiebung des Benutzers über die Grenzen des Anzeigeobjekts hinausgeht. Multitouch.inputMode = MultitouchInputMode.TOUCH_POINT; var mySprite:Sprite = new Sprite(); mySprite.graphics.beginFill(0x336699); mySprite.graphics.drawRect(0,0,40,40); addChild(mySprite); var myTextField:TextField = new TextField(); addChild(myTextField); myTextField.width = 200; myTextField.height = 20; var touchMoveID:int = 0; mySprite.addEventListener(TouchEvent.TOUCH_BEGIN, onTouchBegin); function onTouchBegin(event:TouchEvent) { if(touchMoveID != 0) { myTextField.text = "already moving. ignoring new touch"; return; } touchMoveID = event.touchPointID; myTextField.text = "touch begin" + event.touchPointID; stage.addEventListener(TouchEvent.TOUCH_MOVE, onTouchMove); stage.addEventListener(TouchEvent.TOUCH_END, onTouchEnd); } function onTouchMove(event:TouchEvent) { if(event.touchPointID != touchMoveID) { myTextField.text = "ignoring unrelated touch"; return; } mySprite.x = event.stageX; mySprite.y = event.stageY; myTextField.text = "touch move" + event.touchPointID; } function onTouchEnd(event:TouchEvent) { if(event.touchPointID != touchMoveID) { myTextField.text = "ignoring unrelated touch end"; return; } touchMoveID = 0; stage.removeEventListener(TouchEvent.TOUCH_MOVE, onTouchMove); stage.removeEventListener(TouchEvent.TOUCH_END, onTouchEnd); myTextField.text = "touch end" + event.touchPointID; }
ServerSocketConnectEvent Ein ServerSocket-Objekt setzt ein ServerSocketConnectEvent-Objekt ab, wenn ein Client versucht, eine Verbindung zum Serversocket herzustellen.flash.events:Event Ein ServerSocket-Objekt setzt ein ServerSocketConnectEvent-Objekt ab, wenn ein Client versucht, eine Verbindung zum Serversocket herzustellen.

Die socket-Eigenschaft des ServerSocketConnectEvent-Objekts stellt das Socket-Objekt bereit, das für die nachfolgende Kommunikation zwischen dem Server und dem Client verwendet werden soll. Um die Verbindung abzulehnen, rufen Sie die close()-Methode des Socket-Objekts auf.

ServerSocket-KlasseServerSocketConnectEvent Erstellt ein ServerSocketConnectEvent-Objekt, das Informationen über eine Clientverbindung enthält.typeString Der Ereignistyp. Muss Folgendes sein: ServerSocketConnectEvent.CONNECT. bubblesBooleanfalse Bestimmt, ob das Ereignisobjekt an der Bubbling-Phase des Ereignisablaufs teilnimmt. Immer false cancelableBooleanfalseBestimmt, ob das Ereignisobjekt abgebrochen werden kann. Immer false. socketflash.net:SocketnullDer Socket für die neue Verbindung Erstellt ein ServerSocketConnectEvent-Objekt, das Informationen über eine Clientverbindung enthält. clone Erstellt eine Kopie des ServerSocketConnectEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.Ein neues ServerSocketConnectEvent-Objekt mit Eigenschaftswerten, die denen des Originals entsprechen. flash.events:Event Erstellt eine Kopie des ServerSocketConnectEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht. toString Gibt einen String zurück, der alle Eigenschaften des ServerSocketConnectEvent-Objekts enthält.Eine Zeichenfolge, die alle Eigenschaften des ServerSocketConnectEvent-Objekts enthält. String Gibt einen String zurück, der alle Eigenschaften des ServerSocketConnectEvent-Objekts enthält.

Der String liegt im folgenden Format vor:

[ServerSocketConnectEvent type=Wert bubbles=Wert cancelable=Wert socket=Wert]

CONNECT Definiert den Wert der type-Eigenschaft eines ServerSocketConnectEvent-Ereignisobjekts.connectStringWird von einem ServerSocket-Objekt abgesetzt, wenn eine Clientverbindung empfangen wird. Definiert den Wert der type-Eigenschaft eines ServerSocketConnectEvent-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalse.cancelablefalse, es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDieses ServerSocket-Objekt.targetDieses ServerSocket-Objekt.socketDas Socket-Objekt, das die neue Verbindung darstellt.
socket Der Socket für die neue Verbindung.flash.net:Socket Der Socket für die neue Verbindung.

Verwenden Sie dieses Socket-Objekt für die gesamte Kommunikation mit dem Client. Ihre Anwendung ist zuständig dafür, einen Verweis auf das Socket-Objekt zu verwalten. Andernfalls wird dieses Objekt bei der Speicherbereinigung (Garbage Collection) berücksichtig und kann zur Laufzeit ohne Warnung gelöscht werden.

SyncEvent 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.Ereignisobjekte für SyncEvent-Ereignisse. flash.events:Event 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. SharedObject-Klassesyncflash.events:SyncEvent:SYNCflash.events:SyncEventflash.net.SharedObject.syncSyncEvent Erstellt ein Ereignisobjekt, das Informationen über sync-Ereignisse enthält.typeStringDer Ereignistyp. Ereignis-Listener können über die übernommene Eigenschaft type auf diese Informationen zugreifen. Es gibt nur einen Typ eines sync-Ereignisses: SyncEvent.SYNC. bubblesBooleanfalseBestimmt, ob das Ereignisobjekt an der Bubbling-Phase des Ereignisablaufs teilnimmt. Ereignis-Listener können über die übernommene Eigenschaft bubbles auf diese Informationen zugreifen. cancelableBooleanfalseBestimmt, ob das Ereignisobjekt abgebrochen werden kann. Ereignis-Listener können über die übernommene Eigenschaft cancelable auf diese Informationen zugreifen. changeListArraynullEin Objekte-Array, das die Synchronisation mit dem freigegebenen Remote-Objekt (SharedObject) beschreibt. Ereignis-Listener können über die Eigenschaft changeList auf dieses Objekt zugreifen. Konstruktor für SyncEvent-Objekte. Erstellt ein Ereignisobjekt, das Informationen über sync-Ereignisse enthält. Ereignisobjekte werden Ereignis-Listenern als Parameter übergeben. changeListclone Erstellt eine Kopie des SyncEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.Ein neues SyncEvent-Objekt mit Eigenschaftswerten, die denen des Originals entsprechen. flash.events:Event Erstellt eine Kopie des SyncEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht. toString Gibt eine Zeichenfolge zurück, die alle Eigenschaften des SyncEvent-Objekts enthält.Eine Zeichenfolge, die alle Eigenschaften des SyncEvent-Objekts enthält. String 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]

SYNC Definiert den Wert der Eigenschaft type eines sync-Ereignisobjekts.syncString Definiert den Wert der Eigenschaft type eines sync-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsecancelablefalse. 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.
flash.net.SharedObject.sync
changeList Ein Array mit Objekten; jedes Objekt enthält Eigenschaften, die die geänderten Mitglieder eines gemeinsamen Remote-Objekts beschreiben.Array 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.

NetConnection-KlasseNetStream-Klasse
KeyboardEvent Ein KeyboardEvent-Objekt wird als Reaktion auf Tastatureingaben des Benutzers ausgelöst.Ereignisobjekte für Keyboard-Ereignisse. flash.events:Event Ein KeyboardEvent-Objekt wird als Reaktion auf Tastatureingaben des Benutzers ausgelöst. Es gibt zwei Arten von Tastaturereignissen: KeyboardEvent.KEY_DOWN und KeyboardEvent.KEY_UP

Da Zuordnungen zwischen Tasten und spezifischen Zeichen zwischen verschiedenen Geräten und Betriebssystemen variieren, verwenden Sie den Ereignistyp TextEvent für die Verarbeitung von eingegebenen Zeichen.

Um global auf Tastenereignisse zu warten, überwachen Sie die Aufnahme- und Ziel- oder Bubbling-Phase auf der Bühne.

Im folgenden Beispiel werden anhand der Klasse KeyboardEventExample Tastaturereignisse und die zugehörigen Listener-Funktionen erläutert. In diesem Beispiel werden die folgenden Aufgaben ausgeführt:
  1. Die neue Sprite-Instanz child wird erstellt.
  2. Es werden Eigenschaften für die spätere Verwendung bei der Festlegung von Farbe und Größe eines Quadrats deklariert.
  3. Mithilfe von Sprite-Methoden wird ein hellblaues Quadrat gezeichnet, das unter Zuhilfenahme der addChild()-Methode mit den Standardkoordinaten (0,0) auf der Bühne dargestellt wird.
  4. Es werden ein Mausereignis und zwei Tastaturereignisse hinzugefügt:
    • click/clickHandler, das ausgelöst wird, wenn Sie auf das Quadrat klicken, um den Fokus auf das child-Sprite zu verlagern, damit es auf Tastaturereignisse warten kann.
    • keyDown/keyDownHandler wird bei jedem Tastendruck ausgelöst. Die Abonnentenmethode druckt Informationen zum Ereignis mithilfe der trace()-Anweisung.
    • keyUp/keyUpHandler wird bei jedem Loslassen einer Taste ausgelöst.

Wenn Sie dieses Beispiel testen, müssen Sie zunächst auf das Quadrat klicken, damit das Tastaturereignis funktioniert.

Wenn Sie in Flash den Befehl „Film testen“ verwenden, reagiert möglicherweise die Authoring-Oberfläche anstelle des Ereignis-Listeners am child-Sprite auf bestimmte Tasten.

package { import flash.display.Sprite; import flash.display.DisplayObject; import flash.events.*; public class KeyboardEventExample extends Sprite { private var child:Sprite = new Sprite(); private var bgColor:uint = 0x00CCFF; private var size:uint = 80; public function KeyboardEventExample() { child.graphics.beginFill(bgColor); child.graphics.drawRect(0, 0, size, size); child.graphics.endFill(); addChild(child); child.addEventListener(MouseEvent.CLICK, clickHandler); child.addEventListener(KeyboardEvent.KEY_DOWN, keyDownHandler); child.addEventListener(KeyboardEvent.KEY_UP, keyUpHandler); } private function clickHandler(event:MouseEvent):void { stage.focus = child; } private function keyDownHandler(event:KeyboardEvent):void { trace("keyDownHandler: " + event.keyCode); trace("ctrlKey: " + event.ctrlKey); trace("keyLocation: " + event.keyLocation); trace("shiftKey: " + event.shiftKey); trace("altKey: " + event.altKey); } private function keyUpHandler(event:KeyboardEvent):void { trace("keyUpHandler: " + event.keyCode); } } }
KEY_DOWNKEY_UPKeyLocationkeyDownflash.events:KeyboardEvent:KEY_DOWNflash.events:KeyboardEventflash.display.InteractiveObject.keyDownkeyUpflash.events:KeyboardEvent:KEY_UPflash.events:KeyboardEventflash.display.InteractiveObject.keyUpKeyboardEvent Erstellt ein Ereignisobjekt, das bestimmte Informationen über Tastaturereignisse enthält.typeString Der Ereignistyp. Mögliche Werte sind: KeyboardEvent.KEY_DOWN und KeyboardEvent.KEY_UP bubblesBooleantrueBestimmt, ob das Ereignisobjekt an der Bubbling-Phase des Ereignisablaufs teilnimmt. cancelableBooleanfalseBestimmt, ob das Ereignisobjekt abgebrochen werden kann. charCodeValueuint0Der Zeichencodewert der gedrückten bzw. losgelassenen Taste. Die zurückgegebenen Codewerte sind Werte für die englische Tastatur. Wenn Sie beispielsweise auf einer japanischen Tastatur Umschalt+3 drücken, gibt Keyboard.charCode() wie auch bei einer englischen Tastatur das Zeichen # zurück. keyCodeValueuint0Der Tastencodewert der gedrückten bzw. losgelassenen Taste. keyLocationValueuint0Die Position der Taste auf der Tastatur. ctrlKeyValueBooleanfalseUnter Windows wird damit angezeigt, ob die Strg-Taste aktiviert ist. Unter Mac OS wird damit angezeigt, ob die Ctrl-Taste oder die Befehlstaste aktiviert ist. altKeyValueBooleanfalseGibt an, ob die Alt-Taste als Zusatztaste aktiviert ist (nur Windows). shiftKeyValueBooleanfalseGibt an, ob die Umschalttaste als Zusatztaste aktiviert ist. controlKeyValueBooleanfalseGibt an, ob unter Mac die Ctrl-Taste oder unter Windows oder Linux die Strg-Taste aktiviert ist. commandKeyValueBooleanfalseGibt an, ob die Befehlstaste aktiviert ist (nur Mac). Konstruktor für KeyboardEvent-Objekte. Erstellt ein Ereignisobjekt, das bestimmte Informationen über Tastaturereignisse enthält. Ereignisobjekte werden Ereignis-Listenern als Parameter übergeben. KEY_DOWNKEY_UPKeyboard.charCodeclone Erstellt eine Kopie des KeyboardEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.Ein neues KeyboardEvent-Objekt mit Eigenschaftswerten, die denen des Originals entsprechen. flash.events:Event Erstellt eine Kopie des KeyboardEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht. toString Gibt eine Zeichenfolge zurück, die alle Eigenschaften des KeyboardEvent-Objekts enthält.Eine Zeichenfolge, die alle Eigenschaften des KeyboardEvent-Objekts enthält. String Gibt eine Zeichenfolge zurück, die alle Eigenschaften des KeyboardEvent-Objekts enthält. Der String liegt im folgenden Format vor:

[KeyboardEvent type= value bubbles= value cancelable= value ... shiftKey= value ]

updateAfterEvent Gibt an, dass die Anzeige nach der Verarbeitung dieses Ereignisses wiedergegeben werden sollte, falls die Anzeigeliste geändert wurde Gibt an, dass die Anzeige nach der Verarbeitung dieses Ereignisses wiedergegeben werden sollte, falls die Anzeigeliste geändert wurde KEY_DOWN Die KeyboardEvent.KEY_DOWN-Konstante definiert den Wert der type-Eigenschaft eines keyDown-Ereignisobjekts.keyDownString Die KeyboardEvent.KEY_DOWN-Konstante definiert den Wert der type-Eigenschaft eines keyDown-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblestruecancelableWert true in AIR, Wert false in Flash Player; in AIR wird durch Abbrechen dieses Ereignisses verhindert, dass das Zeichen in ein Textfeld eingegeben wird.charCodeDer Zeichencodewert der gedrückten bzw. losgelassenen Taste.commandKeytrue unter Mac, wenn die Befehlstaste aktiviert ist. Andernfalls wird false zurückgegebencontrolKeytrue unter Windows und Linux, wenn die Strg-Taste aktiv ist. true unter Mac, wenn die Ctrl-Taste aktiviert ist. Andernfalls wird false zurückgegebenctrlKeytrue unter Windows und Linux, wenn die Strg-Taste aktiv ist. true unter Mac OS, falls die Strg-Taste oder die Befehlstaste aktiv ist. Andernfalls wird false zurückgegeben.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.keyCodeDer Tastencodewert der gedrückten bzw. losgelassenen Taste.KeyLocationDie Position der Taste auf der Tastatur.shiftKeytrue, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist.targetDie InteractiveObject-Instanz mit dem Fokus. Das unter target angegebene Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet.
flash.display.InteractiveObject.keyDown
KEY_UP Die KeyboardEvent.KEY_UP-Konstante definiert den Wert der type-Eigenschaft eines keyUp-Ereignisobjekts.keyUpString Die KeyboardEvent.KEY_UP-Konstante definiert den Wert der type-Eigenschaft eines keyUp-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblestruecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.charCodeEnthält den Zeichencodewert der gedrückten bzw. losgelassenen Taste.commandKeytrue unter Mac, wenn die Befehlstaste aktiviert ist. Andernfalls wird false zurückgegebencontrolKeytrue unter Windows und Linux, wenn die Strg-Taste aktiv ist. true unter Mac, wenn die Ctrl-Taste aktiviert ist. Andernfalls wird false zurückgegebenctrlKeytrue unter Windows, falls die Strg-Taste aktiv ist. true unter Mac OS, falls die Strg-Taste oder die Befehlstaste aktiv ist. Andernfalls wird false zurückgegeben.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.keyCodeDer Tastencodewert der gedrückten bzw. losgelassenen Taste.KeyLocationDie Position der Taste auf der Tastatur.shiftKeytrue, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist.targetDie InteractiveObject-Instanz mit dem Fokus. Das unter target angegebene Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet.
flash.display.InteractiveObject.keyUp
altKey Gibt unter Windows an, ob die Alt-Taste aktiviert ist (true) oder deaktiviert (false); gibt unter Mac OS an, ob die Wahltaste aktiviert ist.Boolean Gibt unter Windows an, ob die Alt-Taste aktiviert ist (true) oder deaktiviert (false); gibt unter Mac OS an, ob die Wahltaste aktiviert ist. charCode Enthält den Zeichencodewert der gedrückten bzw. losgelassenen Taste.uint Enthält den Zeichencodewert der gedrückten bzw. losgelassenen Taste. Die Codewerte sind Werte für die englische Tastatur. Wenn Sie beispielsweise auf einer japanischen Tastatur Umschalt+3 drücken, gibt charCode wie auch bei einer englischen Tastatur das Zeichen # zurück.

Hinweis: Wenn ein Eingabenmethoden-Editor (Input Method Editor/IME) ausgeführt wird, meldet charCode keine genauen Zeichencodes.

flash.system.IME
commandKey Gibt an, ob die Befehlstaste aktiviert (true) oder deaktiviert (false) ist.Boolean Gibt an, ob die Befehlstaste aktiviert (true) oder deaktiviert (false) ist. Wird nur unter Mac OS unterstützt. Unter Mac OS hat die commandKey-Eigenschaft denselben Wert wie die ctrlKey-Eigenschaft. controlKey Gibt an, ob die Ctrl-Taste aktiviert (true) oder deaktiviert (false) ist.Boolean Gibt an, ob die Ctrl-Taste aktiviert (true) oder deaktiviert (false) ist. Unter Windows und Linux ist dieser Wert auch „true“, wenn die Strg-Taste aktiviert ist. ctrlKey Zeigt unter Windows und Linux an, ob die Strg-Taste aktiviert (true) oder deaktiviert (false) ist; zeigt unter Mac OS an, ob die Ctrl-Taste oder die Befehlstaste aktiviert ist.Boolean Zeigt unter Windows und Linux an, ob die Strg-Taste aktiviert (true) oder deaktiviert (false) ist; zeigt unter Mac OS an, ob die Ctrl-Taste oder die Befehlstaste aktiviert ist. keyCode Der Tastencodewert der gedrückten bzw. losgelassenen Taste.uint Der Tastencodewert der gedrückten bzw. losgelassenen Taste.

Hinweis: Wenn ein Eingabenmethoden-Editor (Input Method Editor/IME) ausgeführt wird, meldet keyCode keine genauen Zeichencodes.

flash.system.IME
keyLocation Gibt die Position der Taste auf der Tastatur an.uint Gibt die Position der Taste auf der Tastatur an. Dies eignet sich beispielsweise zum Unterscheiden von Tasten, die mehrmals auf einer Tastatur vorhanden sind. Beispielsweise können Sie anhand des Wertes dieser Eigenschaft zwischen der linken und rechten Umschalttaste unterscheiden: KeyLocation.LEFT für die linke und KeyLocation.RIGHT für die rechte Umschalttaste. Ein weiteres Beispiel ist das Unterscheiden zwischen den Zahlentasten auf der Standardtastatur (KeyLocation.STANDARD) und den Zahlentasten im Ziffernblock (KeyLocation.NUM_PAD). shiftKey Gibt an, ob die Umschalttaste als Zusatztaste aktiviert (true) oder deaktiviert (false) ist.Boolean Gibt an, ob die Umschalttaste als Zusatztaste aktiviert (true) oder deaktiviert (false) ist.
NativeWindowDisplayStateEvent Ein NativeWindow-Objekt löst Ereignisse der NativeWindowCisplayStateEvent-Klasse aus, wenn sich der Fensteranzeigestatus ändert.Ereignisobjekte für NativeWindow-Ereignisse, die den Anzeigestatus des Fensters ändern. flash.events:Event Ein NativeWindow-Objekt löst Ereignisse der NativeWindowCisplayStateEvent-Klasse aus, wenn sich der Fensteranzeigestatus ändert. Es gibt zwei Arten von Ereignissen:
  • NativeWindowDisplayStateEvent.DISPLAY_STATE_CHANGING
  • NativeWindowDisplayStateEvent.DISPLAY_STATE_CHANGE
flash.events.NativeWindowDisplayStateEvent.DISPLAY_STATE_CHANGINGflash.events.NativeWindowDisplayStateEvent.DISPLAY_STATE_CHANGEdisplayStateChangeflash.events:NativeWindowDisplayStateEvent:DISPLAY_STATE_CHANGEflash.events:NativeWindowDisplayStateEventWird von einem NativeWindow-Objekt abgesetzt, nachdem sich der Anzeigestatus geändert hat. flash.display.NativeWindowdisplayStateChangingflash.events:NativeWindowDisplayStateEvent:DISPLAY_STATE_CHANGINGflash.events:NativeWindowDisplayStateEventWird von einem NativeWindow-Objekt abgesetzt, bevor sich der Anzeigestatus ändert. flash.display.NativeWindowNativeWindowDisplayStateEvent Erstellt ein Ereignisobjekt mit spezifischen Informationen, die für Fensteranzeigestatusereignisse relevant sind.typeString Der Ereignistyp. Folgende Werte sind möglich:
  • NativeWindowDisplayStateEvent.DISPLAY_STATE_CHANGING
  • NativeWindowDisplayStateEvent.DISPLAY_STATE_CHANGE
bubblesBooleantrue Bestimmt, ob das Ereignisobjekt an der Bubbling-Phase des Ereignisablaufs teilnimmt. cancelableBooleanfalseLegt fest, ob das Ereignisobjekt abgebrochen werden kann. beforeDisplayStateStringDer displayState vor der Änderung. afterDisplayStateStringDer displayState nach der Änderung.
Erstellt ein Ereignisobjekt mit spezifischen Informationen, die für Fensteranzeigestatusereignisse relevant sind. Ereignisobjekte werden Ereignis-Listenern als Parameter übergeben.
clone Erstellt eine Kopie des NativeWindowDisplayStateEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.Ein neues NativeWindowDisplayStateEvent-Objekt mit Eigenschaftswerten, die denen des Originals entsprechen. flash.events:Event Erstellt eine Kopie des NativeWindowDisplayStateEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht. toString Gibt einen String zurück, der alle Eigenschaften des NativeWindowDisplayStateEvent-Objekts enthält.Ein String, der alle Eigenschaften des NativeWindowDisplayStateEvent-Objekts enthält. String Gibt einen String zurück, der alle Eigenschaften des NativeWindowDisplayStateEvent-Objekts enthält. Der String hat das folgende Format:

[NativeWindowDisplayStateEvent type=Wert bubbles=Wert cancelable=Wert beforeDisplayState=Wert afterDisplayState=Wert]

DISPLAY_STATE_CHANGE Definiert den Wert der type-Eigenschaft eines displayStateChange-Ereignisobjekts.displayStateChangeStringWird von einem NativeWindow-Objekt abgesetzt, nachdem sich der Anzeigestatus geändert hat. Definiert den Wert der type-Eigenschaft eines displayStateChange-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftenWerteafterDisplayStateDer alte Anzeigestatus des Fensters.beforeDisplayStateDer neue Anzeigestatus des Fensters.targetDie NativeWindow-Instanz, deren Status sich gerade geändert hat. bubblesNein.currentTargetGibt das Objekt an, das das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.cancelablefalse; es gibt kein Standardverhalten, das abgebrochen werden kann.
flash.display.NativeWindow
DISPLAY_STATE_CHANGING Definiert den Wert der type-Eigenschaft eines displayStateChanging-Ereignisobjekts.displayStateChangingStringWird von einem NativeWindow-Objekt abgesetzt, bevor sich der Anzeigestatus ändert. Definiert den Wert der type-Eigenschaft eines displayStateChanging-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftenWerteafterDisplayStateDer Status des Fenster vor der ausstehenden Änderung.beforeDisplayStateDer Status des Fenster nach der ausstehenden Änderung.targetDie NativeWindow-Instanz, deren Status sich gerade geändert hat. bubblesNein.currentTargetGibt das Objekt an, das das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.cancelabletrue; das Abbrechen des Ereignisses verhindert die Änderung.
flash.display.NativeWindow
afterDisplayState Der Anzeigezustand des NativeWindow nach der Änderung.String Der Anzeigezustand des NativeWindow nach der Änderung.

Wenn es sich bei dem Ereignis um displayStateChanging handelt, wurde der Anzeigestatus noch nicht geändert. afterDisplayState zeigt den neuen Anzeigestatus an, wenn das Ereignis nicht abgebrochen wird. Wenn es sich bei dem Ereignis um displayStateChanged handelt, zeigt afterDisplayState den aktuellen Wert an.

beforeDisplayState Der Anzeigezustand des NativeWindow vor der Änderung.String Der Anzeigezustand des NativeWindow vor der Änderung.

Wenn es sich bei dem Ereignis um displayStateChanging handelt, wurde der Anzeigestatus noch nicht geändert; beforeDisplayState zeigt den aktuellen Anzeigestatus des Fensters an. Wenn es sich bei dem Ereignis um displayStateChanged handelt, zeigt beforeDisplayState den vorherigen Wert an.

VideoEvent Diese Ereignisklasse gibt den aktuellen Videorenderingstatus an.Gibt den aktuellen Status des Videorenderings an. flash.events:Event

Diese Ereignisklasse gibt den aktuellen Videorenderingstatus an. Verwenden Sie dieses Ereignis für die folgenden Zwecke:

  • Um festzustellen, wann sich die Größe der Videoanzeige ändert oder diese initialisiert wird. Verwenden Sie dieses Ereignis, anstatt ein Polling für Größenänderungen auszuführen. Wenn Sie dieses Ereignis empfangen, können Sie auf Video.videoSize und Video.videoHeight zugreifen, um die Abmessungen des zurzeit abgespielten Videos abzurufen.
  • Um festzustellen, ob das Video von der Software oder von der GPU dekodiert wird. Wenn die status-Eigenschaft „accelerated“ zurückgibt, sollten Sie nach Möglichkeit zur Verwendung der StageVideo-Klasse wechseln.
flash.events.StageVideoEventflash.events.StageVideoAvailabilityEventflash.display.Stage.stageVideosflash.media.Videoflash.net.NetStreamArbeiten mit VideosVideoEvent Konstruktor. typeStringDer Ereignistyp. Mögliche Werte sind: VideoEvent.RENDER_STATE. bubblesBooleanfalseGibt an, ob dieses Event-Objekt an der Bubbling-Phase des Ereignisflusses teilnimmt. cancelableBooleanfalseGibt an, ob Sie die Aktion, die dieses Ereignis auslöst, abbrechen können. statusStringnullDer Renderingstatus des Videos. Konstruktor.

Konstruktor.

RENDER_STATE Definiert den Wert der type-Eigenschaft eines renderState-Ereignisobjekts.renderStateStringDer Bezeichner für das renderState-Ereignis des Video-Objekts. Definiert den Wert der type-Eigenschaft eines renderState-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, das das Ereignis aktiv verarbeitet.statusDer vom Ereignis gemeldete Renderingstatus.targetDas Video-Objekt, das den Renderingstatus meldet.
RENDER_STATUS_ACCELERATED Nur zur internen Verwendung.acceleratedStringNur zur internen Verwendung.

Nur zur internen Verwendung. Verwenden Sie stattdessen flash.media.VideoStatus.ACCELERATED.

RENDER_STATUS_SOFTWARE Nur zur internen Verwendung.softwareStringNur zur internen Verwendung.

Nur zur internen Verwendung. Verwenden Sie stattdessen flash.media.VideoStatus.SOFTWARE.

RENDER_STATUS_UNAVAILABLE Nur zur internen Verwendung.unavailableStringNur zur internen Verwendung.

Nur zur internen Verwendung. Verwenden Sie stattdessen flash.media.VideoStatus.UNAVAILABLE.

status Gibt den Darstellungsstatus des VideoEvent-Objekts zurück.StringGibt den Darstellungsstatus des VideoEvent-Objekts zurück.

Gibt den Darstellungsstatus des VideoEvent-Objekts zurück. Mögliche Werte sind „unavailable“, „software“ und „accelerated“.

GestureEvent Mit der GestureEvent-Klasse können Sie Mehrfingerereignisse bei Geräten mit Erkennung komplexer Benutzergesten (z. B. Berühren eines Touchscreens mit zwei Fingern) verarbeiten.bietet Unterstützung für die Ereignisverarbeitung bei Berührungsinteraktionen flash.events:Event Mit der GestureEvent-Klasse können Sie Mehrfingerereignisse bei Geräten mit Erkennung komplexer Benutzergesten (z. B. Berühren eines Touchscreens mit zwei Fingern) verarbeiten. Wenn ein Benutzer mit einem Gerät mit Touchscreen, zum Beispiel Mobiltelefon oder Tablet, interagiert, setzt er normalerweise einen Finger oder Touchpen auf den Bildschirm und bewegt ihn. Mithilfe der GestureEvent- und TransformGestureEvent-Klasse können Sie Anwendungen entwickeln, die auf diese Benutzerinteraktion reagieren. Erstellen Sie mit den hier oder in den verwandten TouchEvent- und TransformGestureEvent-Klassen definierten Ereignistypen Ereignis-Listener. Verwenden Sie außerdem die Eigenschaften und Methoden dieser Klassen, um Ereignisprozeduren zu konstruieren, die auf die Berührung des Benutzers mit dem Gerät reagieren.

Stellen Sie mithilfe der Multitouch-Klasse fest, welche Berührungsinteraktionen die aktuelle Umgebung unterstützt, und verwalten Sie die ggf. unterstützten Berührungsinteraktionen.

Hinweis: Wenn Objekte auf der Anzeigeliste verschachtelt sind, zielen Berührungsereignisse auf das am weitesten verschachtelte Objekt, das auf der Anzeigeliste zu sehen ist. Dieses Objekt wird als Zielknoten bezeichnet. Damit der Vorfahre des Knotens (ein Objekt in der Anzeigeliste, das den Zielknoten enthält) über ein Berührungsereignis benachrichtigt wird, verwenden Sie EventDispatcher.addEventListener() für den Vorfahrenknoten. Dabei sollte der type-Parameter auf das Berührungsereignis gesetzt werden, das Sie erkennen möchten.

Das folgende Beispiel zeigt die Ereignisverarbeitung für das GESTURE_TWO_FINGER_TAP-Ereignis. Während der Benutzer eine Tippgeste mit zwei Fingern ausführt, dreht sich mySprite und myTextField wird mit der Phase all ausgefüllt, was die einzige Phase für Tippereignisse mit zwei Fingern ist. Andere Gesten aus der TransformGestureEvent-Klasse unterstützen Anfangs-, Update- und Endphasen. Multitouch.inputMode = MultitouchInputMode.GESTURE; var mySprite = new Sprite(); mySprite.addEventListener(GestureEvent.GESTURE_TWO_FINGER_TAP , onTwoFingerTap ); mySprite.graphics.beginFill(0x336699); mySprite.graphics.drawRect(0, 0, 100, 80); var myTextField = new TextField(); myTextField.y = 200; addChild(mySprite); addChild(myTextField); function onTwoFingerTap(evt:GestureEvent):void { evt.target.rotation -= 45; myTextField.text = evt.phase; //"all" }
flash.ui.Multitouchflash.events.TouchEventflash.events.TransformGestureEventflash.events.PressAndTapGestureEventflash.events.MouseEventflash.events.EventDispatcher.addEventListener()gestureTwoFingerTapflash.events:GestureEvent:GESTURE_TWO_FINGER_TAPflash.events:GestureEventflash.display.InteractiveObject.gestureTwoFingerTapflash.events.GesturePhaseGestureEvent Erstellt ein Event-Objekt mit Informationen zu Mehrfingerereignissen (zum Beispiel das gleichzeitige Drücken von zwei Fingern auf einen Touchscreen.typeString Der Ereignistyp. Der unterstützte Wert lautet: GestureEvent.GESTURE_TWO_FINGER_TAP. bubblesBooleantrue Legt fest, ob das Ereignisobjekt an der Bubbling-Phase des Ereignisablaufs teilnimmt. cancelableBooleanfalseBestimmt, ob das Ereignisobjekt abgebrochen werden kann. phaseStringnullEin Wert aus der GesturePhase-Klasse, die den Fortschritt der Berührungsgeste (begin, update, end oder all) angibt. localXNumber0Die horizontale Koordinate, an der das Ereignis aufgetreten ist, in Relation zum umgebenden Sprite. localYNumber0Die vertikale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden Sprite-Objekt steht. ctrlKeyBooleanfalseUnter Windows oder Linux wird damit angezeigt, ob die Strg-Taste aktiviert ist. Unter Mac OS wird damit angezeigt, ob die Ctrl-Taste oder die Befehlstaste aktiviert ist. altKeyBooleanfalseGibt an, ob die Alt-Taste aktiviert ist (nur Windows oder Linux). shiftKeyBooleanfalseGibt an, ob der Umschalttasten-Modifizierer aktiviert ist. commandKeyBooleanfalse(nur AIR); gibt an, ob die Befehlstaste aktiviert ist (nur Mac). Dieser Parameter gilt nur für Adobe AIR. Setzen Sie ihn nicht für Flash Player-Inhalte. controlKeyBooleanfalse(nur AIR); gibt an, ob die Ctrl- oder Strg-Taste aktiviert ist. Dieser Parameter gilt nur für Adobe AIR. Setzen Sie ihn nicht für Flash Player-Inhalte. Konstruktor für GestureEvent-Objekte. Erstellt ein Event-Objekt mit Informationen zu Mehrfingerereignissen (zum Beispiel das gleichzeitige Drücken von zwei Fingern auf einen Touchscreen. Ereignisobjekte werden Ereignis-Listenern als Parameter übergeben. flash.events.GesturePhaseclone Erstellt eine Kopie des GestureEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.Ein neues GestureEvent-Objekt mit Eigenschaftswerten, die denen des Originals entsprechen. flash.events:Event Erstellt eine Kopie des GestureEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht. toString Gibt einen String zurück, der alle Eigenschaften des GestureEvent-Objekts enthält.Ein String, der alle Eigenschaften des GestureEvent-Objekts enthält. String Gibt einen String zurück, der alle Eigenschaften des GestureEvent-Objekts enthält. Der String liegt im folgenden Format vor:

[GestureEvent type=Wert bubbles=Wert cancelable=Wert ... ]

updateAfterEvent Aktualisiert die Anzeige der Flash-Laufzeitumgebung nach der Verarbeitung des Gestenereignisses, für den Fall, dass die Anzeigeliste von der Ereignisprozedur geändert wurde. Aktualisiert die Anzeige der Flash-Laufzeitumgebung nach der Verarbeitung des Gestenereignisses, für den Fall, dass die Anzeigeliste von der Ereignisprozedur geändert wurde. GESTURE_TWO_FINGER_TAP Definiert den Wert der type-Eigenschaft eines GESTURE_TWO_FINGER_TAP-Gestenereignisobjekts.gestureTwoFingerTapString Definiert den Wert der type-Eigenschaft eines GESTURE_TWO_FINGER_TAP-Gestenereignisobjekts.

Das abgesetzte GestureEvent-Objekt hat folgende Eigenschaften:

EigenschaftWertaltKeytrue, wenn die Alt-Taste aktiviert ist (Windows oder Linux).bubblestruecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.commandKey(Nur AIR) true unter Mac OS, falls die Befehlstaste aktiviert ist; false, wenn sie deaktiviert ist. Unter Windows immer false controlKeytrue, wenn die Strg- oder Ctrl-Taste aktiv ist; false, wenn sie nicht aktiv ist.ctrlKeytrue unter Windows oder Linux, wenn die Strg-Taste aktiv ist. true unter Mac OS, falls die Strg-Taste oder die Befehlstaste aktiv ist. Andernfalls wird false zurückgegeben.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.phaseDie aktuelle Phase im Ereignisablauf. Für Zwei-Finger-Tipp-Ereignisse ist dieser Wert immer all entsprechend dem Wert GesturePhase.ALL, nachdem dieses Ereignis abgesetzt wurde.isRelatedObjectInaccessibletrue, wenn die relatedObject-Eigenschaft aufgrund von Sicherheitssandboxregeln den Wert null hat.localXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, in Relation zum umgebenden Sprite.localYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden Sprite-Objekt steht.shiftKeytrue, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist.targetDie InteractiveObject-Instanz unter dem Touchpen oder Finger. Das unter target angegebene Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet.
flash.display.InteractiveObject.gestureTwoFingerTapflash.events.GesturePhase
altKey Gibt an, ob die Alt-Taste aktiviert (true) oder deaktiviert (false) ist.Boolean Gibt an, ob die Alt-Taste aktiviert (true) oder deaktiviert (false) ist. Wird nur für Windows und Linux unterstützt. commandKey Gibt an, ob die Befehlstaste aktiviert ist (nur Mac).Boolean Gibt an, ob die Befehlstaste aktiviert ist (nur Mac).

Unter Mac OS ist der Wert der commandKey-Eigenschaft identisch mit dem Wert der ctrlKey-Eigenschaft. Diese Eigenschaft ist unter Windows oder Linux immer „false“.

controlKey Gibt an, ob unter Mac OS die Ctrl-Taste oder unter Windows oder Linux die Strg-Taste aktiviert ist.Boolean Gibt an, ob unter Mac OS die Ctrl-Taste oder unter Windows oder Linux die Strg-Taste aktiviert ist. ctrlKey Gibt unter Windows oder Linux an, ob die Strg-Taste aktiviert (true) oder deaktiviert (false) ist.Boolean Gibt unter Windows oder Linux an, ob die Strg-Taste aktiviert (true) oder deaktiviert (false) ist. Unter Mac wird damit angezeigt, ob die Ctrl-Taste oder die Befehlstaste aktiviert ist. localX Die horizontale Koordinate, an der das Ereignis aufgetreten ist, in Relation zum umgebenden Sprite.Number Die horizontale Koordinate, an der das Ereignis aufgetreten ist, in Relation zum umgebenden Sprite. localY Die vertikale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden Sprite-Objekt steht.Number Die vertikale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden Sprite-Objekt steht. phase Ein Wert aus der GesturePhase-Klasse, die den Fortschritt der Berührungsgeste angibt.String Ein Wert aus der GesturePhase-Klasse, die den Fortschritt der Berührungsgeste angibt. Bei den meisten Gesten ist der Wert begin, update oder end. Bei Swipe- und Zwei-Finger-Tipp-Ereignisse ist der Wert für die Phase immer all, nachdem das Ereignis abgesetzt wurde. Verwenden Sie diesen Wert, um festzustellen, wenn eine Ereignisprozedur auf eine komplexe Benutzerinteraktion reagiert oder unterschiedlich je nach der aktuellen Phase einer Multitouch-Geste reagiert (zum Beispiel beim Erweitern, Bewegen und Ablegen, wenn ein Benutzer ein visuelles Objekt berührt und über den Bildschirm zieht). flash.events.GesturePhaseshiftKey Gibt an, ob die Umschalttaste aktiviert (true) oder deaktiviert (false) ist.Boolean Gibt an, ob die Umschalttaste aktiviert (true) oder deaktiviert (false) ist. stageX Die horizontale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.Number Die horizontale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten. Diese Eigenschaft wird berechnet, wenn die Eigenschaft localX eingerichtet wird. stageY Die vertikale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.Number Die vertikale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten. Diese Eigenschaft wird berechnet, wenn die Eigenschaft localY eingerichtet wird.
FullScreenEvent Das Stage-Objekt löst immer dann ein FullScreenEvent-Objekt aus, wenn die Bühne in den Vollbildmodus versetzt wird oder diesen verlässt.Ereignisobjekte für FullScreenEvent-Ereignisse. flash.events:ActivityEvent Das Stage-Objekt löst immer dann ein FullScreenEvent-Objekt aus, wenn die Bühne in den Vollbildmodus versetzt wird oder diesen verlässt. Es gibt nur einen Typ eines fullScreen-Ereignisses: FullScreenEvent.FULL_SCREEN. flash.display.Stage.displayStatefullScreenflash.events:FullScreenEvent:FULL_SCREENflash.events:FullScreenEventflash.display.Stage.displayStateFullScreenEvent Erstellt ein Ereignisobjekt, das Informationen über fullScreen-Ereignisse enthält.typeString Der Ereignistyp. Ereignis-Listener können über die übernommene Eigenschaft type auf diese Informationen zugreifen. Es gibt nur einen Typ eines fullScreen-Ereignisses: FullScreenEvent.FULL_SCREEN. bubblesBooleanfalseLegt fest, ob das Ereignisobjekt an der Bubbling-Phase des Ereignisablaufs teilnimmt. Ereignis-Listener können über die übernommene Eigenschaft bubbles auf diese Informationen zugreifen. cancelableBooleanfalseBestimmt, ob das Ereignisobjekt abgebrochen werden kann. Ereignis-Listener können über die übernommene Eigenschaft cancelable auf diese Informationen zugreifen. fullScreenBooleanfalseGibt an, ob das Gerät aktiviert (true) oder deaktiviert (false) wird. Ereignis-Listener können über die Eigenschaft activating auf diese Informationen zugreifen. Konstruktor für FullScreenEvent-Objekte. Erstellt ein Ereignisobjekt, das Informationen über fullScreen-Ereignisse enthält. Ereignisobjekte werden Ereignis-Listenern als Parameter übergeben. FullScreenEvent.FULL_SCREENclone Erstellt eine Kopie des FullScreenEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.Ein neues FullScreenEvent-Objekt mit Eigenschaftswerten, die denen des Originals entsprechen. flash.events:Event Erstellt eine Kopie des FullScreenEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht. toString Gibt einen String zurück, der alle Eigenschaften des FullScreenEvent-Objekts enthält.Ein String, der alle Eigenschaften des FullScreenEvent-Objekts enthält. String Gibt einen String zurück, der alle Eigenschaften des FullScreenEvent-Objekts enthält. Das folgende Format wird verwendet:

[FullScreenEvent type=Wert bubbles=Wert cancelable=Wert activating=Wert]

FULL_SCREEN Die Konstante „FullScreenEvent.FULL_SCREEN“ definiert den Wert der Eigenschaft „type“ eines fullScreen-Ereignisobjekts.fullScreenString Die Konstante FullScreenEvent.FULL_SCREEN definiert den Wert der type-Eigenschaft eines fullScreen-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertfullScreentrue bei Vollbildanzeige und false bei normaler Anzeige.bubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.targetDas Stage-Objekt.
flash.display.Stage.displayState
fullScreen Gibt an, ob das Stage-Objekt im Vollbildmodus angezeigt wird (true) oder nicht (false).Boolean Gibt an, ob das Stage-Objekt im Vollbildmodus angezeigt wird (true) oder nicht (false).
StageVideoAvailabilityEvent Dieses Ereignis wird ausgelöst, wenn sich der Status der Stage.stageVideos-Eigenschaft ändert.Gibt die aktuelle Verfügbarkeit von Bühnenvideo an. flash.events:Event

Dieses Ereignis wird ausgelöst, wenn sich der Status der Stage.stageVideos-Eigenschaft ändert. Diese Eigenschaft kann sich ändern, wenn der Benutzer ein Video aus einem wmode, der StageVideo nicht unterstützt (zum Beispiel wmode=normal, wmode=opaque oder wmode=transparent), zur Vollbildanzeige ändert. Das Vergrößern zum Vollbild kann dazu führen, dass der Stage.stageVideos-Vektor gefüllt wird. Umgekehrt kann das Beenden des Vollbildmodus dazu führen, dass der Stage.stageVideos-Vektor geleert wird.

HINWEIS: Diese Benachrichtigung erfolgt nur, wenn sich der Zustand der Stage.stageVideos-Eigenschaft ändert. Das Verhalten kann je nach Plattform und Browser variieren. Unter Windows wird das stageVideoAvailability-Ereignis zum Beispiel nicht abgesetzt, wenn Sie in den Vollbildmodus wechseln, während wmode auf direct eingestellt ist. Auf anderen Plattformen kann dasselbe Verhalten dazu führen, dass Flash Player Ressourcen neu zuweist. In diesen Fällen ändert sich der Zustand der Stage.stageVideos-Eigenschaft und das Ereignis wird abgesetzt. Sie können Änderungen am Vollbildmodus erkennen, indem Sie einen Listener für das flash.events.FullScreenEvent-Ereignis verwenden. Dieses Ereignis wird vom Stage-Objekt abgesetzt.

flash.events.StageVideoEventflash.media.StageVideoAvailabilityflash.events.VideoEventflash.events.FullScreenEventflash.display.Stage.stageVideosflash.events.FullScreenEventflash.media.Videoflash.net.NetStreamArbeiten mit VideosStageVideoAvailabilityEvent Konstruktor. typeStringDer Ereignistyp. Mögliche Werte sind: StageVideoAvailabilityEvent.STAGE_VIDEO_AVAILABILITY. bubblesBooleanfalseGibt an, ob dieses Event-Objekt an der Bubbling-Phase des Ereignisflusses teilnimmt. cancelableBooleanfalseGibt an, ob Sie die Aktion, die dieses Ereignis auslöst, abbrechen können. availabilityStringnullDie aktuelle Verfügbarkeit von Bühnenvideo. Konstruktor.

Konstruktor.

STAGE_VIDEO_AVAILABILITY Definiert den Wert der type-Eigenschaft eines stageVideoAvailability-Ereignisobjekts.stageVideoAvailabilityStringDer Bezeichner für das stageVideoAvailability-Ereignis des Stage-Objekts. Definiert den Wert der type-Eigenschaft eines stageVideoAvailability-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertavailabilityDer vom Ereignis gemeldete Status.bubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, das das Ereignis aktiv verarbeitet.targetDas Stage-Objekt, das die Verfügbarkeit des Bühnenvideos angibt.
availability Gibt die aktuelle Verfügbarkeit des Bühnenvideos mithilfe einer Konstante der flash.media.StageVideoAvailability-Klasse an. StringGibt die aktuelle Verfügbarkeit von Bühnenvideo an.

Gibt die aktuelle Verfügbarkeit des Bühnenvideos mithilfe einer Konstante der flash.media.StageVideoAvailability-Klasse an.

DatagramSocketDataEvent Ein DatagramSocketDataEvent-Objekt wird abgesetzt, wenn ein Datagram-Socket Daten empfangen hat.flash.events:Event Ein DatagramSocketDataEvent-Objekt wird abgesetzt, wenn ein Datagram-Socket Daten empfangen hat. DatagramSocket-Klassedataflash.events:DatagramSocketDataEvent:DATAflash.events:DatagramSocketDataEventWird von einem DatagramSocket-Objekt abgesetzt, wenn ein UDP-Paket empfangen wird. flash.net.DatagramSocket.dataDatagramSocketDataEvent Erstellt ein Ereignisobjekt, das Informationen über Datagram-Ereignisse enthält.typeString Der Ereignistyp. Mögliche Werte sind:DatagramSocketDataEvent.DATA bubblesBooleanfalse Bestimmt, ob das Ereignisobjekt an der Bubbling-Phase des Ereignisablaufs teilnimmt. cancelableBooleanfalseBestimmt, ob das Ereignisobjekt abgebrochen werden kann. srcAddressStringDie IP-Adresse des Computers, der das Paket gesendet hat. srcPortint0Der Port des Computers, über den das Paket gesendet wurde. dstAddressStringDie IP-Adresse, an die das Paket adressiert ist. dstPortint0Der Port, an den das Paket adressiert ist. dataflash.utils:ByteArraynullDie Datagram-Paketdaten. Erstellt ein Ereignisobjekt, das Informationen über Datagram-Ereignisse enthält. Ereignisobjekte werden Ereignis-Listenern als Parameter übergeben. clone Erstellt eine Kopie des DatagramSocketDataEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.Ein neues DatagramSocketDataEvent-Objekt mit Eigenschaftswerten, die denen des Originals entsprechen. flash.events:Event Erstellt eine Kopie des DatagramSocketDataEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht. toString Gibt einen String zurück, der alle Eigenschaften des DatagramSocketDataEvent-Objekts enthält.Eine Zeichenfolge, die alle Eigenschaften des ProgressEvent-Objekts enthält. String Gibt einen String zurück, der alle Eigenschaften des DatagramSocketDataEvent-Objekts enthält. Der String liegt im folgenden Format vor:

[DatagramSocketDataEvent type=Wert bubbles=Wert cancelable=Wert srcAddress=Wert srcPort=Wert dstAddress=Wert dstPort=Wert data=Wert]

DATA Definiert den Wert der Eigenschaft type eines Datenereignisobjekts.dataStringWird von einem DatagramSocket-Objekt abgesetzt, wenn ein UDP-Paket empfangen wird. Definiert den Wert der Eigenschaft type eines data-Ereignisobjekts. flash.net.DatagramSocket.datadata Die Datagram-Paketdaten.flash.utils:ByteArray Die Datagram-Paketdaten. dstAddress Die IP-Adresse des DatagramSocket-Objekts, das dieses Ereignis abgesetzt hat.String Die IP-Adresse des DatagramSocket-Objekts, das dieses Ereignis abgesetzt hat.

Hinweis: Wenn der Socket an die spezielle Adresse: 0.0.0.0 gebunden ist, gibt diese Eigenschaft 0.0.0.0 zurück. Um die spezifische IP zu kennen, an die die Datagram-Meldung gesendet werden soll, müssen Sie den Socket an eine explizite IP-Adresse binden.

dstPort Der Port des DatagramSocket-Objekts, das dieses Ereignis abgesetzt hat.int Der Port des DatagramSocket-Objekts, das dieses Ereignis abgesetzt hat. srcAddress Die IP-Adresse des Computers, der das Paket gesendet hat.String Die IP-Adresse des Computers, der das Paket gesendet hat. srcPort Der Port des Computers, über den das Paket gesendet wurde.int Der Port des Computers, über den das Paket gesendet wurde.
DRMStatusEvent Ein NetStream-Objekt löst ein DRMStatusEvent-Objekt aus, wenn der mit DRM (Digital Rights Management) geschützte Inhalt erfolgreich abgespielt wird (wenn der Gutschein verifiziert wurde und der Benutzer authentifiziert wurde und berechtigt ist, den Inhalt anzuzeigen).Ereignisobjekte für DRM-fähige Objekte. flash.events:Event Ein NetStream-Objekt löst ein DRMStatusEvent-Objekt aus, wenn der mit DRM (Digital Rights Management) geschützte Inhalt erfolgreich abgespielt wird (wenn der Gutschein verifiziert wurde und der Benutzer authentifiziert wurde und berechtigt ist, den Inhalt anzuzeigen). Das DRMStatusEvent-Objekt enthält Informationen über den Gutschein, zum Beispiel. ob der Inhalt offline zur Verfügung gestellt werden kann oder wann der Gutschein abläuft und der Inhalt nicht mehr angezeigt werden kann. Die Anwendung kann diese Daten verwenden, um den Benutzer über den Status der Richtlinien und Berechtigungen zu informieren. flash.net.NetStreamDRMStatusEvent.DRM_STATUSflash.net.drm.DRMManagerflash.net.drm.DRMVoucherdrmStatusflash.events:DRMStatusEvent:DRM_STATUSflash.events:DRMStatusEventWird von einem NetStream-Objekt abgesetzt, wenn mit der Wiedergabe DRM-geschützten Inhalts begonnen wird. DRMStatusEvent Erstellt ein Ereignisobjekt, das bestimmte Informationen über DRM-Statusereignisse enthält.typeStringunknown Der Ereignistyp. Ereignis-Listener können über die übernommene Eigenschaft type auf diese Informationen zugreifen. Es gibt nur einen Typ von DRMAuthenticate-Ereignissen: DRMAuthenticateEvent.DRM_AUTHENTICATE. bubblesBooleanfalseBestimmt, ob das Ereignisobjekt an der Bubbling-Phase des Ereignisablaufs teilnimmt. Ereignis-Listener können über die übernommene Eigenschaft bubbles auf diese Informationen zugreifen. cancelableBooleanfalseBestimmt, ob das Ereignisobjekt abgebrochen werden kann. Ereignis-Listener können über die übernommene Eigenschaft cancelable auf diese Informationen zugreifen. inMetadataflash.net.drm:DRMContentDatanullDas benutzerdefinierte Objekt, das benutzerdefinierte DRM-Eigenschaften enthält. inVoucherflash.net.drm:DRMVouchernullDer Kontext des Ereignisses. inLocalBooleanfalseGibt an, ob der Inhalt offline betrachtet werden kann. Erstellt ein Ereignisobjekt, das bestimmte Informationen über DRM-Statusereignisse enthält. Ereignisobjekte werden Ereignis-Listenern als Parameter übergeben. clone Erstellt eine Kopie des DRMStatusEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.Ein neues DRMStatusEvent-Objekt mit Eigenschaftswerten, die denen des Originals entsprechen. flash.events:Event Erstellt eine Kopie des DRMStatusEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht. toString Gibt einen String zurück, der alle Eigenschaften des DRMStatusEvent-Objekts enthält.Ein String, der alle Eigenschaften des DRMStatusEvent-Objekts enthält. String Gibt einen String zurück, der alle Eigenschaften des DRMStatusEvent-Objekts enthält. DRM_STATUS Die DRMStatusEvent.DRM_STATUS-Konstante definiert den Wert der type-Eigenschaft eines drmStatus-Ereignisobjekts.drmStatusStringWird von einem NetStream-Objekt abgesetzt, wenn mit der Wiedergabe DRM-geschützten Inhalts begonnen wird. Die DRMStatusEvent.DRM_STATUS-Konstante definiert den Wert der type-Eigenschaft eines drmStatus-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.detailEin String, der den Kontext des Statusereignisses erläutert.isAnonymousGibt an, ob der mit DRM-Verschlüsselung geschützte Inhalt verfügbar ist, ohne dass der Benutzer Authentifizierungsdaten eingeben muss.isAvailableOfflineGibt an, ob der mit DRM-Verschlüsselung geschützte Inhalt offline verfügbar ist.offlineLeasePeriodDie verbleibende Anzahl der Tage, an denen der Inhalt offline angezeigt werden kann.RichtlinienEin benutzerdefiniertes Objekt des DRM-Statusereignisses.targetDas NetStream-Objekt.voucherEndDateDas absolute Datum, an dem der Gutschein abläuft und der Inhalt nicht mehr von Benutzern angezeigt werden kann.contentDataDie DRMContentData für den Inhalt.voucherDas DRMVoucher-Objekt für den Inhalt.isLocalGibt an, ob der Inhalt im lokalen Dateisystem gespeichert ist.
contentData Ein DRMContentData-Objekt, das die nötigen Informationen enthält, um einen Gutschein für das Anzeigen des DRM-geschützten Inhalts zu erhalten.flash.net.drm:DRMContentData Ein DRMContentData-Objekt, das die nötigen Informationen enthält, um einen Gutschein für das Anzeigen des DRM-geschützten Inhalts zu erhalten. detail Ein String, der den Kontext des Statusereignisses erläutert.String Ein String, der den Kontext des Statusereignisses erläutert. isAnonymous Gibt an, ob der durch Digital Rights Management (DRM)-Verschlüsselung geschützte Inhalt verfügbar ist, ohne dass ein Benutzer Authentifizierungsdaten eingeben muss.Boolean Gibt an, ob der durch Digital Rights Management (DRM)-Verschlüsselung geschützte Inhalt verfügbar ist, ohne dass ein Benutzer Authentifizierungsdaten eingeben muss. Ist dies der Fall, ist der Wert true. Andernfalls ist der Wert false und ein Benutzer muss ein Benutzernamen und ein Kennwort eingeben, die mit den vom Content Provider erwarteten übereinstimmen. isAvailableOffline Gibt an, ob der durch Digital Rights Management (DRM)-Verschlüsselung geschützte Inhalt offline verfügbar ist.Boolean Gibt an, ob der durch Digital Rights Management (DRM)-Verschlüsselung geschützte Inhalt offline verfügbar ist. Ist dies der Fall, ist der Wert true. Andernfalls ist der Wert false.

Damit der digital geschützte Inhalt offline zur Verfügung steht, muss der entsprechende Gutschein auf dem lokalen Computer des Benutzer zwischengespeichert sein. (Die Anwendung entscheidet, ob der Inhalt lokal gespeichert werden soll, damit er offline verfügbar ist.)

isLocal Gibt an, ob der Gutschein im lokalen Gutschein-Store zwischengespeichert ist.Boolean Gibt an, ob der Gutschein im lokalen Gutschein-Store zwischengespeichert ist. offlineLeasePeriod Die verbleibende Anzahl der Tage, an denen der Inhalt offline angezeigt werden kann.uint Die verbleibende Anzahl der Tage, an denen der Inhalt offline angezeigt werden kann. policies Ein benutzerdefiniertes Objekt des DRM-Statusereignisses.Object Ein benutzerdefiniertes Objekt des DRM-Statusereignisses. voucherEndDate Das absolute Datum, an dem der Gutschein abläuft und der Inhalt nicht mehr von Benutzern angezeigt werden kann.Date Das absolute Datum, an dem der Gutschein abläuft und der Inhalt nicht mehr von Benutzern angezeigt werden kann. voucher Ein DRMVoucher-Objekt für den Inhalt.flash.net.drm:DRMVoucher Ein DRMVoucher-Objekt für den Inhalt.
AsyncErrorEvent Ein Objekt löst ein AsyncErrorEvent-Ereignis aus, wenn eine Ausnahme vom nativen asynchronen Code ausgegeben wird, z. B. LocalConnection, NetConnection, SharedObject oder NetStream.Ereignisobjekte für AsyncErrorEvent-Ereignisse. flash.events:ErrorEvent Ein Objekt löst ein AsyncErrorEvent-Ereignis aus, wenn eine Ausnahme vom nativen asynchronen Code ausgegeben wird, z. B. LocalConnection, NetConnection, SharedObject oder NetStream. Es gibt nur einen Typ eines asynchronen Fehlerereignisses: AsyncErrorEvent.ASYNC_ERROR. ASYNC_ERRORasyncErrorflash.events:AsyncErrorEvent:ASYNC_ERRORflash.events:AsyncErrorEventAsyncErrorEvent Erstellt ein AsyncErrorEvent-Objekt, das Informationen über asyncError-Ereignisse enthält.typeString Der Ereignistyp. Ereignis-Listener können über die übernommene Eigenschaft type auf diese Informationen zugreifen. Es gibt nur einen Typ eines Fehlerereignisses: ErrorEvent.ERROR. bubblesBooleanfalseLegt fest, ob das Ereignisobjekt eine Bubbling-Phase durchführt. Ereignis-Listener können über die übernommene Eigenschaft bubbles auf diese Informationen zugreifen. cancelableBooleanfalseBestimmt, ob das Ereignisobjekt abgebrochen werden kann. Ereignis-Listener können über die übernommene Eigenschaft cancelable auf diese Informationen zugreifen. textStringDer als Fehlermeldung anzuzeigende Text. Ereignis-Listener können über die Eigenschaft text auf diese Informationen zugreifen. errorErrornullDie eingetretene Ausnahme. Wenn error nicht null ist, wird die errorId-Eigenschaft des Ereignisse von der errorId-Eigenschaft des Fehlers festgelegt. Konstruktor für AsyncErrorEvent-Objekte. Erstellt ein AsyncErrorEvent-Objekt, das Informationen über asyncError-Ereignisse enthält. MS">AsyncErrorEvent-Objekte werden Ereignis-Listenern als Parameter übergeben. clone Erstellt eine Kopie des AsyncErrorEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.Ein neues AsyncErrorEvent-Objekt mit Eigenschaftswerten, die denen des Originals entsprechen. flash.events:Event Erstellt eine Kopie des AsyncErrorEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht. toString Gibt eine Zeichenfolge zurück, die alle Eigenschaften des AsyncErrorEvent-Objekts enthält.Eine Zeichenfolge, die alle Eigenschaften des AsyncErrorEvent-Objekts enthält. String Gibt eine Zeichenfolge zurück, die alle Eigenschaften des AsyncErrorEvent-Objekts enthält. Der String liegt im folgenden Format vor:

[AsyncErrorEvent type=Wert bubbles=Wert cancelable=Wert ... error=Wert errorID=Wert] Die errorId-Eigenschaft ist nur in Adobe AIR verfügbar

ASYNC_ERROR Die Konstante AsyncErrorEvent.ASYNC_ERROR definiert den Wert der type-Eigenschaft eines asyncError-Ereignisobjekts.asyncErrorString Die Konstante AsyncErrorEvent.ASYNC_ERROR definiert den Wert der type-Eigenschaft eines asyncError-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann. currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. targetDas Objekt, das das Ereignis auslöst.errorDer Fehler, der das Ereignis ausgelöst hat.
error Der ausgegebene Ausnahmefehler.Error Der ausgegebene Ausnahmefehler.
StatusEvent Ein Objekt sendet ein StatusEvent-Objekt, wenn ein Gerät (z. B. eine Kamera oder ein Mikrofon) oder ein Objekt (z. B. ein LocalConnection-Objekt) den Status meldet.Ereignisobjekte für StatusEvent-Ereignisse. flash.events:Event Ein Objekt sendet ein StatusEvent-Objekt, wenn ein Gerät (z. B. eine Kamera oder ein Mikrofon) oder ein Objekt (z. B. ein LocalConnection-Objekt) den Status meldet. Es gibt nur einen Typ eines status-Ereignisses: StatusEvent.STATUS . flash.media.Cameraflash.media.Microphoneflash.net.LocalConnectionflash.sensors.Accelerometerflash.sensors.Geolocationair.net.ServiceMonitorstatusflash.events:StatusEvent:STATUSflash.events:StatusEventflash.media.Camera.statusflash.media.Microphone.statusflash.net.LocalConnection.statusflash.net.NetStream.statusflash.sensors.Geolocation.statusflash.sensors.Accelerometer.statusStatusEvent Erstellt ein Ereignisobjekt, das Informationen über Status-Ereignisse enthält.typeString Der Ereignistyp. Ereignis-Listener können über die übernommene Eigenschaft type auf diese Informationen zugreifen. Es gibt nur einen Typ eines status-Ereignisses: StatusEvent.STATUS . bubblesBooleanfalseBestimmt, ob das Ereignisobjekt an der Bubbling-Phase des Ereignisablaufs teilnimmt. Ereignis-Listener können über die übernommene Eigenschaft bubbles auf diese Informationen zugreifen. cancelableBooleanfalseBestimmt, ob das Ereignisobjekt abgebrochen werden kann. Ereignis-Listener können über die übernommene Eigenschaft cancelable auf diese Informationen zugreifen. codeStringEine Beschreibung des Objektstatus. Ereignis-Listener können über die Eigenschaft code auf diese Informationen zugreifen. levelStringDie Kategorie der Meldung, z. B. "status", "warning" oder "error". Ereignis-Listener können über die Eigenschaft level auf diese Informationen zugreifen. Konstruktor für StatusEvent-Objekte. Erstellt ein Ereignisobjekt, das Informationen über Status-Ereignisse enthält. Ereignisobjekte werden Ereignis-Listenern als Parameter übergeben. STATUSclone Erstellt eine Kopie des StatusEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.Ein neues StatusEvent-Objekt mit Eigenschaftswerten, die denen des Originals entsprechen. flash.events:Event Erstellt eine Kopie des StatusEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht. toString Gibt eine Zeichenfolge zurück, die alle Eigenschaften des StatusEvent-Objekts enthält.Eine Zeichenfolge, die alle Eigenschaften des StatusEvent-Objekts enthält. String Gibt eine Zeichenfolge zurück, die alle Eigenschaften des StatusEvent-Objekts enthält. Der String liegt im folgenden Format vor:

[StatusEvent type=Wert bubbles=Wert cancelable=Wert code=Wert level=Wert]

STATUS Definiert den Wert der Eigenschaft type eines status-Ereignisobjekts.statusString Definiert den Wert der Eigenschaft type eines status-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.codeEine Beschreibung des Objektstatus.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.EbeneDie Kategorie der Meldung, z. B. "status", "warning" oder "error".targetDas Objekt, dessen Status gemeldet wird.
flash.media.Camera.statusflash.media.Microphone.statusflash.net.LocalConnection.statusflash.net.NetStream.statusflash.sensors.Geolocation.statusflash.sensors.Accelerometer.status
code Eine Beschreibung des Objektstatus.String Eine Beschreibung des Objektstatus. flash.media.Cameraflash.media.Microphoneflash.net.LocalConnectionlevel Die Meldungskategorie wie „Status“, „Warnung“ oder „Fehler“.String Die Kategorie der Meldung, z. B. "status", "warning" oder "error". flash.media.Cameraflash.media.Microphoneflash.net.LocalConnection
DRMAuthenticationErrorEvent Der DRMManager löst ein DRMAuthenticationErrorEvent-Objekt aus, wenn ein Aufruf der authenticate()-Methode des DRMManager-Objekts fehlschlägt.flash.events:ErrorEvent Der DRMManager löst ein DRMAuthenticationErrorEvent-Objekt aus, wenn ein Aufruf der authenticate()-Methode des DRMManager-Objekts fehlschlägt. DRMAuthenticationErrorEvent Erstellt eine neue Instanz eines DRMAuthenticationErrorEvent-Objekts.typeStringder Ereignistypstring bubblesBooleanfalseob das Ereignis in der Anzeigeliste fortgesetzt wird cancelableBooleanfalseob das Ereignis abgebrochen werden kann inDetailStringDie Fehlerbeschreibung. inErrorIDint0die ID des allgemeinen Fehlertyps inSubErrorIDint0die ID, die den spezifischen Fehler innerhalb des Fehlertyps angibt inServerURLStringnulldie URL des angemeldeten Servers inDomainStringnulldie authentifizierte Domäne des angemeldeten Servers Erstellt eine neue Instanz eines DRMAuthenticationErrorEvent-Objekts. clone Erstellt eine Kopie des ErrorEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.Ein neues ErrorEvent-Objekt mit Eigenschaftswerten, die denen des Originals entsprechen. flash.events:Event Erstellt eine Kopie des ErrorEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht. AUTHENTICATION_ERROR Die im type-Parameter zu verwendende Stringkonstante für das Authentifizierungsfehlerereignis beim Hinzufügen und Entfernen von Ereignis-Listenern.authenticationErrorString Die im type-Parameter zu verwendende Stringkonstante für das Authentifizierungsfehlerereignis beim Hinzufügen und Entfernen von Ereignis-Listenern. domain Die Inhaltsdomäne des Medienrechteservers.String Die Inhaltsdomäne des Medienrechteservers. In diesem Fall ist „domain“ kein Netzwerk- oder Internetdomänenname. serverURL Die URL des Medienrechteservers, der den Authentifizierungsversuch abgelehnt hat.String Die URL des Medienrechteservers, der den Authentifizierungsversuch abgelehnt hat. subErrorID Ein ausführlicherer Fehlercode.int Ein ausführlicherer Fehlercode. HTMLUncaughtScriptExceptionEvent Ein HTMLLoader-Objekt löst ein HTMLUncaughtScriptExceptionEvent-Objekt aus, wenn eine JavaScript-Ausnahme ausgegeben wird und nicht mit einer catch-Anweisung verarbeitet wird.flash.events:Event Ein HTMLLoader-Objekt löst ein HTMLUncaughtScriptExceptionEvent-Objekt aus, wenn eine JavaScript-Ausnahme ausgegeben wird und nicht mit einer catch-Anweisung verarbeitet wird. HTMLLoaderuncaughtScriptExceptionflash.events:HTMLUncaughtScriptExceptionEvent:UNCAUGHT_SCRIPT_EXCEPTIONflash.events:HTMLUncaughtScriptExceptionEventHTMLUncaughtScriptExceptionEvent Erstellt ein HTMLUncaughtScriptExceptionEvent-Objekt, das als ein Parameter an Ereignis-Listener übergeben wird.exceptionValueWenn ein JavaScript-Prozess eine nicht erfasste Ausnahme ausgibt, ist exceptionValue das Ergebnis der Ausdrucksevaluierung in der throw-Anweisung, die zu der nicht erfassten Ausnahme geführt hat. Die exceptionValue-Eigenschaft kann ein Grundwert, ein Verweis auf ein JavaScript-Objekt oder ein Verweis auf ein ActionScript-Objekt sein. Erstellt ein HTMLUncaughtScriptExceptionEvent-Objekt, das als ein Parameter an Ereignis-Listener übergeben wird. clone Erstellt eine Kopie des HTMLUncaughtScriptExceptionEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.Die Kopie des HTMLUncaughtScriptExceptionEvent-Objekts. flash.events:Event Erstellt eine Kopie des HTMLUncaughtScriptExceptionEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht. UNCAUGHT_SCRIPT_EXCEPTION Die Konstante HTMLUncaughtScriptExceptionEvent.UNCAUGHT_SCRIPT_EXCEPTION definiert den Wert der type-Eigenschaft eines uncaughtScriptException-Ereignisobjekts.uncaughtScriptException Die Konstante HTMLUncaughtScriptExceptionEvent.UNCAUGHT_SCRIPT_EXCEPTION definiert den Wert der type-Eigenschaft eines uncaughtScriptException-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.exceptionValueDas Ergebnis der Evaluierung des Ausdrucks in der throw-Anweisung, der zu der nicht erfassten Ausnahme geführt hat.stackTraceEin Array von Objekten, die den Stack-Trace zu dem Zeitpunkt repräsentieren, an dem die throw-Anweisung, die zu der nicht erfassten Ausnahme führte, ausgeführt wurde.targetDas HTMLLoader-Objekt.
exceptionValue Das Ergebnis der Evaluierung des Ausdrucks in der throw-Anweisung, der zu der nicht erfassten Ausnahme geführt hat. Das Ergebnis der Evaluierung des Ausdrucks in der throw-Anweisung, der zu der nicht erfassten Ausnahme geführt hat. Die exceptionValue-Eigenschaft kann ein Grundwert, ein Verweis auf ein JavaScript-Objekt oder ein Verweis auf ein ActionScript-Objekt sein. stackTrace Ein Array von Objekten, die den Stack-Trace zu dem Zeitpunkt repräsentieren, an dem die throw-Anweisung, die zu der nicht erfassten Ausnahme führte, ausgeführt wurde.Array Ein Array von Objekten, die den Stack-Trace zu dem Zeitpunkt repräsentieren, an dem die throw-Anweisung, die zu der nicht erfassten Ausnahme führte, ausgeführt wurde. Jedes Objekt im Array weist drei Eigenschaften auf:
  • sourceURL (ein String): Die URL des Skripts des Call-Stack-Frames.
  • line (eine Zahl): Die Zeilennummer in der sourceURL-Ressource des Call-Stack-Frames.
  • functionName (ein String): Der Name der Funktion für den Call-Stack-Frame.
SoftKeyboardEvent Ein SoftKeyboardEvent-Objekt wird abgesetzt, wenn eine virtuelle Tastatur aktiviert oder deaktiviert wird.Ein SoftKeyboardEvent wird abgesetzt, wenn eine virtuelle Tastatur aktiviert oder deaktiviert wird. flash.events:Event Ein SoftKeyboardEvent-Objekt wird abgesetzt, wenn eine virtuelle Tastatur aktiviert oder deaktiviert wird.

SoftKeyboardEvents werden von TextFields und von InteractiveObjects abgesetzt, deren needsSoftKeyboard-Eigenschaft den Wert true hat.

flash.display.InteractiveObject.needsSoftKeyboardSoftKeyboardEvent Erstellt ein Ereignisobjekt, das Informationen zu Aktivierungs- und Deaktivierungsereignissen der virtuellen Tastatur enthält.typeString Der Ereignistyp als ein Konstantenwert (zum Beispiel SOFT_KEYBOARD_ACTIVATE). Ereignis-Listener können über die übernommene Eigenschaft type auf diese Informationen zugreifen. bubblesBooleanLegt fest, ob das Ereignisobjekt an der Bubbling-Phase des Ereignisablaufs teilnimmt. Ereignis-Listener können über die übernommene Eigenschaft bubbles auf diese Informationen zugreifen. cancelableBooleanBestimmt, ob das Ereignisobjekt abgebrochen werden kann. Ereignis-Listener können über die übernommene Eigenschaft cancelable auf diese Informationen zugreifen. relatedObjectValflash.display:InteractiveObjectEin Verweis auf ein Anzeigelistenobjekt, das in Relation zum Ereignis steht. triggerTypeValStringGibt an, ob das Tastaturereignis von einer Anwendung oder vom Benutzer ausgelöst wurde. Konstruktor für SoftKeyboardEvent-Objekte. Erstellt ein Ereignisobjekt, das Informationen zu Aktivierungs- und Deaktivierungsereignissen der virtuellen Tastatur enthält. Ereignisobjekte werden Ereignis-Listenern als Parameter übergeben. clone Erstellt eine Kopie des SoftKeyboardEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.Ein neues SoftKeyboardEvent-Objekt mit Eigenschaftswerten, die denen des Originals entsprechen. flash.events:EventErstellt eine Kopie eines SoftKeyboardEvent-Objekts. Erstellt eine Kopie des SoftKeyboardEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht. toString Gibt einen String zurück, der alle Eigenschaften des SoftKeyboardEvent-Objekts enthält.Eine Zeichenfolge, die alle Eigenschaften des SoftKeyboardEvent-Objekts enthält. String Gibt einen String zurück, der alle Eigenschaften des SoftKeyboardEvent-Objekts enthält. Das folgende Format wird verwendet:

[SoftKeyboardEvent type=Wert bubbles=Wert cancelable=Wert relatedObjectVal=Wert triggerTypeVal=Wert activating=Wert]

SOFT_KEYBOARD_ACTIVATE Die SoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATE-Konstante definiert den Wert der type-Eigenschaft des SoftKeyboardEvent-Objekts, das abgesetzt wird, wenn eine virtuelle Tastatur angezeigt wird.softKeyboardActivateStringKonstantenwert für ein Ereignis, das beim Einblenden der virtuellen Tastatur abgesetzt wird. Die SoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATE-Konstante definiert den Wert der type-Eigenschaft des SoftKeyboardEvent-Objekts, das abgesetzt wird, wenn eine virtuelle Tastatur angezeigt wird.

Das softKeyboardActivate-Ereignis wird nach dem softKeyboardActivating-Ereignis abgesetzt und kann nicht abgebrochen werden. Wenn die virtuelle Tastatur nicht eingeblendet werden soll, brechen Sie das softKeyboardActivating-Ereignis ab.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWerttypeSOFT_KEYBOARD_ACTIVATEbubblestruecancelablefalse; es ist zu spät zum Abbrechen.relatedObjectValEin Verweis auf ein Anzeigelistenobjekt, das in Relation zum Ereignis steht.triggerTypeValGibt an, ob das Tastaturereignis von einer Anwendung oder vom Benutzer ausgelöst wurde.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
SOFT_KEYBOARD_ACTIVATING Die SoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATING-Konstante definiert den Wert der type-Eigenschaft des SoftKeyboardEvent-Objekts, das direkt vor dem Anzeigen der virtuellen Tastatur abgesetzt wird.softKeyboardActivatingStringKonstantenwert für ein Ereignis, das direkt vor dem Einblenden der virtuellen Tastatur abgesetzt wird. Die SoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATING-Konstante definiert den Wert der type-Eigenschaft des SoftKeyboardEvent-Objekts, das direkt vor dem Anzeigen der virtuellen Tastatur abgesetzt wird. Wenn das Ereignis durch den Aufruf von preventDefault abgebrochen wird, wird die virtuelle Tastatur nicht geöffnet.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWerttypeSOFT_KEYBOARD_ACTIVATINGbubblestruecancelabletrue; das Abbrechen verhindert, dass die Tastatur eingeblendet wird.relatedObjectValEin Verweis auf ein Anzeigelistenobjekt, das in Relation zum Ereignis steht.triggerTypeValGibt an, ob das Tastaturereignis von einer Anwendung oder vom Benutzer ausgelöst wurde.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
SOFT_KEYBOARD_DEACTIVATE Die SoftKeyboardEvent.SOFT_KEYBOARD_DEACTIVATE-Konstante definiert den Wert der type-Eigenschaft des SoftKeyboardEvent-Objekts, das beim Ausblenden einer virtuellen Tastatur abgesetzt wird.softKeyboardDeactivateStringKonstantenwert für ein Ereignis, das nach dem Ausblenden oder Minimieren der virtuellen Tastatur abgesetzt wird. Die SoftKeyboardEvent.SOFT_KEYBOARD_DEACTIVATE-Konstante definiert den Wert der type-Eigenschaft des SoftKeyboardEvent-Objekts, das beim Ausblenden einer virtuellen Tastatur abgesetzt wird.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWerttypeSOFT_KEYBOARD_DEACTIVATEbubblestruecancelablefalse; das Abbrechen ist nicht zulässig.relatedObjectValEin Verweis auf ein Anzeigelistenobjekt, das in Relation zum Ereignis steht.triggerTypeValGibt an, ob das Tastaturereignis von einer Anwendung oder vom Benutzer ausgelöst wurde.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
relatedObject Ein Verweis auf ein Anzeigelistenobjekt, das in Relation zum Ereignis steht.flash.display:InteractiveObjectEin Verweis auf ein Anzeigelistenobjekt, das in Relation zum Ereignis steht. Ein Verweis auf ein Anzeigelistenobjekt, das in Relation zum Ereignis steht. triggerType Gibt an, ob die Änderung des Tastaturstatus durch eine Anwendung ausgelöst wurde (zum Beispiel die programmgesteuerte Verwendung von requestSoftKeyboard()) oder durch den Benutzer (zum Beispiel die Auswahl eines Textfeldes).StringDie Ursache der Änderung des Tastaturstatus. Gibt an, ob die Änderung des Tastaturstatus durch eine Anwendung ausgelöst wurde (zum Beispiel die programmgesteuerte Verwendung von requestSoftKeyboard()) oder durch den Benutzer (zum Beispiel die Auswahl eines Textfeldes). flash.events.SoftKeyboardTrigger
ProgressEvent Ein ProgressEvent-Objekt wird ausgelöst, wenn eine Ladevorgang gestartet wurde oder ein Socket Daten empfangen hat.Ereignisobjekte für ProgressEvent-Ereignisse. flash.events:Event Ein ProgressEvent-Objekt wird ausgelöst, wenn eine Ladevorgang gestartet wurde oder ein Socket Daten empfangen hat. Diese Ereignisse werden in der Regel erzeugt, wenn SWF-Dateien, Bilder oder Daten in eine Anwendung geladen werden. Es gibt zwei Arten von Fortschrittsereignissen: ProgressEvent.PROGRESS und ProgressEvent.SOCKET_DATA. Zusätzlich werden in AIR ProgressEvent-Objekte abgesetzt, wenn Daten unter Verwendung der NativeProcess-Klasse von oder zu einem untergeordneten Prozess gesendet werden. Im folgenden Beispiel wird anhand der Klasse ProgressEventExample gezeigt, wie verschiedene Ereignis-Listener beim Herunterladen einer Datei verwendet werden. In diesem Beispiel werden die folgenden Aufgaben ausgeführt:
  1. Die Eigenschaften downloadURL und fileName werden mit dem Speicherort und dem Namen der Download-Datei erstellt.
  2. Im Konstruktor ProgressEventExample wird ein neues FileReference-Objekt mit dem Namen file erstellt, das dann an die configureListeners()-Methode übergeben wird.
  3. Die Eigenschaften downloadURL und fileName werden an file.download() übergeben. Diese Methode ermittelt dann den Speicherort für den Download der Datei.
  4. Die configureListeners()-Methode fügt sieben Ereignis-Listener und die verknüpften Abonnentenmethoden hinzu:
    1. cancel/cancelHandler() wird ausgelöst, wenn das Herunterladen der Datei abgebrochen wird.
    2. complete/complereHandler() wird ausgelöst, wenn das Herunterladen der Dateien abgeschlossen ist.
    3. ioError/ioErrorHandler() wird ausgelöst, wenn die Download-Datei nicht verfügbar oder unzugänglich ist.
    4. open/openHandler()wird nach Beginn des Download-Vorgangs ausgelöst.
    5. progress/progressHandler() wird beim Beginn und beim Ende des Download-Vorgangs ausgelöst.
    6. securityError/securityErrorHandler wird ausgelöst, wenn die lokalen Sicherheitseinstellungen für die Wiedergabe nicht mit der Art des Datenzugriffs für die Download-Datei übereinstimmen (lokaler Zugriff bzw. Netzwerkzugriff). Siehe Hinweise unten.
    7. select/selectHandler() wird bei Auswahl des Download-Objekts ausgelöst.

Hinweise:

  • Für die Kompilierung der SWF-Datei müssen Sie die Option „Sicherheit bei lokaler Wiedergabe“ auf „Nur auf Netzwerk zugreifen“ einstellen.
  • Bei diesem Beispiel ist die Datei SomeFile.pdf erforderlich.
  • Obwohl in diesem Beispiel alle verfügbaren Ereignisse des FileReference-Objekts verwendet werden, ist in den meisten Situationen nur ein Teil davon erforderlich.

package { import flash.display.Sprite; import flash.events.*; import flash.net.FileReference; import flash.net.URLRequest; public class ProgressEventExample extends Sprite { private var downloadURL:String = "http://www.[yourDomain].com/SomeFile.pdf"; private var fileName:String = "SomeFile.pdf"; private var file:FileReference; public function ProgressEventExample() { var request:URLRequest = new URLRequest(downloadURL); file = new FileReference(); configureListeners(file); file.download(request, fileName); } private function configureListeners(dispatcher:IEventDispatcher):void { dispatcher.addEventListener(Event.CANCEL, cancelHandler); dispatcher.addEventListener(Event.COMPLETE, completeHandler); dispatcher.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler); dispatcher.addEventListener(Event.OPEN, openHandler); dispatcher.addEventListener(ProgressEvent.PROGRESS, progressHandler); dispatcher.addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler); dispatcher.addEventListener(Event.SELECT, selectHandler); } private function cancelHandler(event:Event):void { trace("cancelHandler: " + event); } private function completeHandler(event:Event):void { trace("completeHandler: " + event); } private function ioErrorHandler(event:IOErrorEvent):void { trace("ioErrorHandler: " + event); } private function openHandler(event:Event):void { trace("openHandler: " + event); } private function progressHandler(event:ProgressEvent):void { var file:FileReference = FileReference(event.target); trace("progressHandler: name=" + file.name + " bytesLoaded=" + event.bytesLoaded + " bytesTotal=" + event.bytesTotal); } private function securityErrorHandler(event:SecurityErrorEvent):void { trace("securityErrorHandler: " + event); } private function selectHandler(event:Event):void { var file:FileReference = FileReference(event.target); trace("selectHandler: name=" + file.name + " URL=" + downloadURL); } } }
FileStream-KlasseLoaderInfo-KlasseSocket-Klasseprogressflash.events:ProgressEvent:PROGRESSflash.events:ProgressEventflash.display.LoaderInfo.progressflash.media.Sound.progressflash.net.FileReference.progressflash.net.URLLoader.progressflash.net.URLStream.progresssocketDataflash.events:ProgressEvent:SOCKET_DATAflash.events:ProgressEventflash.net.Socket.socketDataerrorDataflash.events:ProgressEvent:STANDARD_ERROR_DATAflash.events:ProgressEventflash.desktop.NativeProcess.standardErrorDataerrorDataflash.events:ProgressEvent:STANDARD_INPUT_PROGRESSflash.events:ProgressEventflash.desktop.NativeProcess.standardInputProgressoutputDataflash.events:ProgressEvent:STANDARD_OUTPUT_DATAflash.events:ProgressEventflash.desktop.NativeProcess.standardOutputDataProgressEvent Erstellt ein Ereignisobjekt, das Informationen über progress-Ereignisse enthält.typeString Der Ereignistyp. Mögliche Werte sind:ProgressEvent.PROGRESS, ProgressEvent.SOCKET_DATA, ProgressEvent.STANDARD_ERROR_DATA, ProgressEvent.STANDARD_INPUT_PROGRESS und ProgressEvent.STANDARD_OUTPUT_DATA. bubblesBooleanfalse Bestimmt, ob das Ereignisobjekt an der Bubbling-Phase des Ereignisablaufs teilnimmt. cancelableBooleanfalseBestimmt, ob das Ereignisobjekt abgebrochen werden kann. bytesLoadedNumber0Die Anzahl der geladenen Elemente oder Byte zu dem Zeitpunkt, zu dem der Listener das Ereignis verarbeitet. bytesTotalNumber0Die Gesamtanzahl der Elemente oder Byte, die bei einem erfolgreichen Ladevorgang geladen werden. Konstruktor für ProgressEvent-Objekte. Erstellt ein Ereignisobjekt, das Informationen über progress-Ereignisse enthält. Ereignisobjekte werden Ereignis-Listenern als Parameter übergeben. clone Erstellt eine Kopie des ProgressEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.Ein neues ProgressEvent-Objekt mit Eigenschaftswerten, die denen des Originals entsprechen. flash.events:Event Erstellt eine Kopie des ProgressEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht. toString Gibt eine Zeichenfolge zurück, die alle Eigenschaften des ProgressEvent-Objekts enthält.Eine Zeichenfolge, die alle Eigenschaften des ProgressEvent-Objekts enthält. String Gibt eine Zeichenfolge zurück, die alle Eigenschaften des ProgressEvent-Objekts enthält. Der String liegt im folgenden Format vor:

[ProgressEvent type=Wert bubbles=Wert cancelable=Wert bytesLoaded=Wert bytesTotal=Wert]

PROGRESS Definiert den Wert der Eigenschaft „type“ eines progress-Ereignisobjekts.progressString Definiert den Wert der Eigenschaft type eines progress-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsebytesLoadedDie Anzahl der geladenen Elemente oder Byte zu dem Zeitpunkt, zu dem der Listener das Ereignis verarbeitet.bytesTotalDie Gesamtanzahl der Elemente oder Byte, die bei einem erfolgreichen Ladevorgang schließlich geladen werden.cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.targetDas Objekt, dessen Fortschritt protokolliert wird.
flash.display.LoaderInfo.progressflash.media.Sound.progressflash.net.FileReference.progressflash.net.URLLoader.progressflash.net.URLStream.progress
SOCKET_DATA Definiert den Wert der Eigenschaft „type“ eines socketData-Ereignisobjekts.socketDataString Definiert den Wert der Eigenschaft type eines socketData-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, das das Ereignis aktiv verarbeitet.bytesLoadedDie Anzahl der geladenen Elemente oder Byte zu dem Zeitpunkt, zu dem der Listener das Ereignis verarbeitet.bytesTotal0. Diese Eigenschaft wird von socketData-Ereignisobjekten nicht verwendet.targetDer Socket, dessen Fortschritt protokolliert wird.
flash.net.Socket.socketData
STANDARD_ERROR_DATA Definiert den Wert der type-Eigenschaft eines standardErrorData-Ereignisobjekts.standardErrorDataString Definiert den Wert der type-Eigenschaft eines standardErrorData-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, das das Ereignis aktiv verarbeitet.bytesLoadedDie Anzahl der Bytes der Fehlerdaten, die von NativeProcessObject.error aufgrund dieses Ereignisses gepuffert wurden.bytesTotal0; diese Eigenschaft wird von standardErrorData-Ereignisobjekten nicht verwendet.targetDas NativeProcess-Objekt, das die Fehlerdaten meldet.
flash.desktop.NativeProcess.standardErrorData
STANDARD_INPUT_PROGRESS Definiert den Wert der type-Eigenschaft eines standardInputProgress-Ereignisobjekts.standardInputProgressString Definiert den Wert der type-Eigenschaft eines standardInputProgress-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, das das Ereignis aktiv verarbeitet.bytesLoadedDie Anzahl der Bytes der Fehlerdaten, die von NativeProcessObject.error aufgrund dieses Ereignisses gepuffert wurden.bytesTotal0; diese Eigenschaft wird von standardInputProgress-Ereignisobjekten nicht verwendet.targetDas NativeProcess-Objekt, das die Fehlerdaten meldet.
flash.desktop.NativeProcess.standardInputProgress
STANDARD_OUTPUT_DATA Definiert den Wert der type-Eigenschaft eines standardOutputData-Ereignisobjekts.standardOutputDataString Definiert den Wert der type-Eigenschaft eines standardOutputData-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, das das Ereignis aktiv verarbeitet.bytesLoadedDie Anzahl der Bytes der Ausgabedaten, die von NativeProcessObject.output aufgrund dieses Ereignisses gepuffert wurden.bytesTotal0; diese Eigenschaft wird von standardOutputData-Ereignisobjekten nicht verwendet.targetDas NativeProcess-Objekt, das die Ausgabedaten meldet.
flash.desktop.NativeProcess.standardOutputData
bytesLoaded Die Anzahl der geladenen Elemente oder Bytes zu dem Zeitpunkt, zu dem der Listener das Ereignis verarbeitet.Number Die Anzahl der geladenen Elemente oder Bytes zu dem Zeitpunkt, zu dem der Listener das Ereignis verarbeitet. bytesTotal Die Gesamtanzahl der Elemente oder Byte, die bei einem erfolgreichen Ladevorgang geladen werden.Number Die Gesamtanzahl der Elemente oder Byte, die bei einem erfolgreichen Ladevorgang geladen werden. Wenn das Fortschrittsereignis ausgelöst oder einem Socket-Objekt hinzugefügt wird, ist der Wert von bytesTotal immer 0, falls nicht im bytesTotal-Parameter des Konstruktors ein Wert angegeben wird. Die tatsächliche Anzahl der Byte, die zurück order vorwärts gesendet werden, wird nicht festgelegt und ist Sache des Anwendungsentwicklers.
ShaderEvent Ein ShaderEvent wird ausgelöst, wenn ein von einem ShaderJob gestarteter Shadervorgang beendet wird.flash.events:Event Ein ShaderEvent wird ausgelöst, wenn ein von einem ShaderJob gestarteter Shadervorgang beendet wird. flash.display.ShaderJobcompleteflash.events:ShaderEvent:COMPLETEflash.events:ShaderEventflash.display.ShaderJob.completeShaderEvent Erstellt ein ShaderEvent-Objekt, das an Ereignis-Listener übergeben wird.typeStringDer Typ des Ereignisses, verfügbar in der type-Eigenschaft. bubblesBooleanfalseBestimmt, ob das Ereignisobjekt an der Bubbling-Phase des Ereignisablaufs teilnimmt. Der Standardwert ist false. cancelableBooleanfalseBestimmt, ob das Ereignisobjekt abgebrochen werden kann. Der Standardwert ist false. bitmapflash.display:BitmapDatanullDas BitmapData-Objekt, das das Ergebnis des beendeten Vorgangs enthält (oder null, wenn das Ziel kein BitmapData-Objekt war). arrayflash.utils:ByteArraynullDas ByteArray-Objekt, das das Ergebnis des beendeten Vorgangs enthält (oder null, wenn das Ziel kein ByteArray-Objekt war). vectornullDie Vector.<Number>-Instanz, die das Ergebnis des beendeten Vorgangs enthält (oder null, wenn das Ziel keine Vector.<Number>-Instanz) war. Erstellt ein ShaderEvent-Objekt, das an Ereignis-Listener übergeben wird. clone Erstellt eine Kopie des ShaderEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.Ein neues ShaderEvent-Objekt mit Eigenschaftswerten, die den Werten des Originals entsprechen. flash.events:Event Erstellt eine Kopie des ShaderEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht. toString Gibt einen String zurück, der alle Eigenschaften des ShaderEvent-Objekts enthält.Ein String, der alle Eigenschaften des ShaderEvent-Objekts enthält. String Gibt einen String zurück, der alle Eigenschaften des ShaderEvent-Objekts enthält. Der String liegt im folgenden Format vor:

[ShaderEvent type=Wert bubbles=Wert cancelable=Wert eventPhase=Wert bitmapData=Wert byteArray=Wert vector=Wert]

COMPLETE Definiert den Wert der Eigenschaft „type“ eines complete-Ereignisobjekts.completeString Definiert den Wert der Eigenschaft type eines complete-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsebitmapDataDas BitmapData-Objekt, das das Ergebnis des beendeten Vorgangs enthält (oder null, wenn das Ziel kein BitmapData-Objekt war).byteArrayDas ByteArray-Objekt, das das Ergebnis des beendeten Vorgangs enthält (oder null, wenn das Ziel kein ByteArray-Objekt war).cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.targetDas ShaderJob-Objekt, dessen Fertigstellung protokolliert wird.vectorDie Vector.<Number>-Instanz, die das Ergebnis des beendeten Vorgangs enthält (oder null, wenn das Ziel keine Vector.<Number>-Instanz) war.
flash.display.ShaderJob.complete
bitmapData Das BitmapData-Objekt, das an die ShaderJob.start()-Methode übergeben wurde.flash.display:BitmapData Das BitmapData-Objekt, das an die ShaderJob.start()-Methode übergeben wurde. Wenn ein ByteArray oder Vector.<Number> an die start()-Methode übergeben wurde, ist diese Eigenschaft null. flash.display.ShaderJob.start()byteArray Das ByteArray-Objekt, das an die ShaderJob.start()-Methode übergeben wurde.flash.utils:ByteArray Das ByteArray-Objekt, das an die ShaderJob.start()-Methode übergeben wurde. Wenn ein BitmapData- oder Vector.<Number>-Objekt an die start()-Methode übergeben wurde, ist diese Eigenschaft null. flash.display.ShaderJob.start()vector Das Vector.<Number>-Objekt, das an die ShaderJob.start()-Methode übergeben wurde. Das Vector.<Number>-Objekt, das an die ShaderJob.start()-Methode übergeben wurde. Wenn ein BitmapData- oder ByteArray-Objekt an die start()-Methode übergeben wurde, ist diese Eigenschaft null. flash.display.ShaderJob.start()
DRMAuthenticationCompleteEvent Der DRMManager löst ein DRMAuthenticationCompleteEvent-Objekt aus, wenn der Aufruf der authenticate()-Methode des DRMManager-Objekts erfolgreich ist.flash.events:Event Der DRMManager löst ein DRMAuthenticationCompleteEvent-Objekt aus, wenn der Aufruf der authenticate()-Methode des DRMManager-Objekts erfolgreich ist. DRMAuthenticationCompleteEvent Erstellt eine neue Instanz eines DRMAuthenticationCompleteEvent-Objekts.typeStringder Ereignistypstring bubblesBooleanfalseob das Ereignis in der Anzeigeliste fortgesetzt wird cancelableBooleanfalseob das Ereignis abgebrochen werden kann inServerURLStringnulldie URL des angemeldeten Servers inDomainStringnulldie authentifizierte Domäne des angemeldeten Servers inTokenflash.utils:ByteArraynulldas Authentifizierungstoken Erstellt eine neue Instanz eines DRMAuthenticationCompleteEvent-Objekts. clone Dupliziert eine Instanz einer Event-Unterklasse.Ein mit dem Original identisches neues Ereignisobjekt. flash.events:Event Dupliziert eine Instanz einer Event-Unterklasse.

Gibt ein neues Ereignisobjekt zurück, das eine Kopie der ursprünglichen Instanz des Ereignisobjekts ist. Normalerweise rufen Sie clone() nicht auf; es wird automatisch von der EventDispatcher-Klasse aufgerufen, wenn Sie ein Ereignis neu auslösen, das heißt, wenn Sie dispatchEvent(event) von einer Prozedur aus aufrufen, die event verarbeitet.

Das neue Ereignisobjekt übernimmt alle Eigenschaften des Originals.

Wenn Sie Ihre eigene benutzerdefinierte Event-Klasse erstellen, müssen Sie die übernommene Event.clone()-Methode außer Kraft setzen, um die Eigenschaften Ihrer benutzerdefinierten Klasse zu duplizieren. Wenn Sie nicht alle der Ereignis-Unterklasse hinzugefügten Eigenschaften eingestellt haben, weisen sie nicht die korrekten Werte auf, wenn Listener das neu ausgelöste Ereignis verarbeiten.

In dem folgenden Beispiel ist PingEvent eine Unterklasse von Event und implementiert aus diesem Grund eine eigene Version von clone().

class PingEvent extends Event { var URL:String; public override function clone():Event { return new PingEvent(type, bubbles, cancelable, URL); } }
AUTHENTICATION_COMPLETE Die Stringkonstante im Typparameter beim Hinzufügen und Entfernen von Ereignis-Listenern für das Ereignis bei abgeschlossener Authentifizierung.authenticationCompleteString Die Stringkonstante im Typparameter beim Hinzufügen und Entfernen von Ereignis-Listenern für das Ereignis bei abgeschlossener Authentifizierung. domain Die Inhaltsdomäne des Medienrechteservers.String Die Inhaltsdomäne des Medienrechteservers. In diesem Fall ist „domain“ kein Netzwerk- oder Internetdomänenname. serverURL Die URL des Medienrechteservers.String Die URL des Medienrechteservers. token Das Authentifizierungstoken.flash.utils:ByteArray Das Authentifizierungstoken.

Die Authentifizierung wird dem Sitzungscache von DRMManager automatisch hinzugefügt. Sie können das Token speichern und zur Authentifizierung des Benutzers in künftigen Sitzungen verwenden. Verwenden Sie ein Token mit der setAuthenticationToken()-Methode von DRMManager wieder. Die Gültigkeitsdauer des Tokens sowie andere Eigenschaften werden vom Server, der das Token generiert, bestimmt.

flash.net.drm.DRMManager.setAuthenticationToken()
AccelerometerEvent Die Accelerometer-Klasse setzt AccelerometerEvent-Objekte ab, wenn Beschleunigungsupdates vom Beschleunigungssensor empfangen werden, der in das Gerät eingebaut ist.flash.events:Event Die Accelerometer-Klasse setzt AccelerometerEvent-Objekte ab, wenn Beschleunigungsupdates vom Beschleunigungssensor empfangen werden, der in das Gerät eingebaut ist. flash.sensors.Accelerometerupdateflash.events:AccelerometerEvent:UPDATEflash.events:AccelerometerEventAccelerometerEvent Erstellt ein AccelerometerEvent-Objekt, das Informationen zur Beschleunigung entlang der drei Dimensionsachsen enthält.typeString Der Ereignistyp. Ereignis-Listener können über die übernommene Eigenschaft type auf diese Informationen zugreifen. Es gibt nur einen Typ eines Updateereignisses: AccelerometerEvent.UPDATE. bubblesBooleanfalseLegt fest, ob das Ereignisobjekt eine Bubbling-Phase durchführt. Ereignis-Listener können über die übernommene Eigenschaft bubbles auf diese Informationen zugreifen. cancelableBooleanfalseBestimmt, ob das Ereignisobjekt abgebrochen werden kann. Ereignis-Listener können über die übernommene Eigenschaft cancelable auf diese Informationen zugreifen. timestampNumber0Der Zeitstempel der Accelerometer-Aktualisierung. accelerationXNumber0Der Beschleunigungswert in G (9,8m/s/s) entlang der x-Achse. accelerationYNumber0Der Beschleunigungswert in G (9,8m/s/s) entlang der y-Achse. accelerationZNumber0Der Beschleunigungswert in G (9,8m/s/s) entlang der z-Achse. Konstruktor für AccelerometerEvent-Objekte. Erstellt ein AccelerometerEvent-Objekt, das Informationen zur Beschleunigung entlang der drei Dimensionsachsen enthält. Ereignisobjekte werden Ereignis-Listenern als Parameter übergeben. clone Erstellt eine Kopie des AccelerometerEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.Ein neues AccelerometerEvent-Objekt mit Eigenschaftswerten, die denen des Originals entsprechen. flash.events:Event Erstellt eine Kopie des AccelerometerEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht. toString Gibt einen String zurück, der alle Eigenschaften des AccelerometerEvent-Objekts enthält.Ein String, der alle Eigenschaften des AccelerometerEvent-Objekts enthält. String Gibt einen String zurück, der alle Eigenschaften des AccelerometerEvent-Objekts enthält. Das folgende Format wird verwendet:

[AccelerometerEvent type=Wert bubbles=Wert cancelable=Wert timestamp=Wert accelerationX=Wert accelerationY=Wert accelerationZ=Wert ]

UPDATE Definiert den Wert der type-Eigenschaft eines AccelerometerEvent-Ereignisobjekts.updateString Definiert den Wert der type-Eigenschaft eines AccelerometerEvent-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.timestampDer Zeitstempel der Accelerometer-Aktualisierung.accelerationXDer Beschleunigungswert in G (9,8m/s/s) entlang der x-Achse.accelerationYDer Beschleunigungswert in G (9,8m/s/s) entlang der y-Achse. accelerationZDer Beschleunigungswert in G (9,8m/s/s) entlang der z-Achse.
accelerationX Beschleunigung entlang der x-Achse, gemessen in G.Number Beschleunigung entlang der x-Achse, gemessen in G. (1 g entspricht ungefähr 9,8 m/s/s) Die x-Achse verläuft von der linken zur rechten Seite des Geräts, wenn es sich in der aufrechten Position befindet. Die Beschleunigung ist positiv, wenn das Geräts nach rechts bewegt wird. accelerationY Beschleunigung entlang der y-Achse, gemessen in G.Number Beschleunigung entlang der y-Achse, gemessen in G. (1 g entspricht ungefähr 9,8 m/s/s.) Die y-Achse verläuft von der unteren zur oberen Seite des Geräts, wenn es sich in der aufrechten Position befindet. Die Beschleunigung ist positiv, wenn sich das Gerät in Relation zu dieser Achse nach oben bewegt. accelerationZ Beschleunigung entlang der z-Achse, gemessen in G.Number Beschleunigung entlang der z-Achse, gemessen in G. (1 g entspricht ungefähr 9,8 m/s/s.) Die z-Achse verläuft senkrecht zur Oberfläche des Geräts. Die Beschleunigung ist positiv, wenn das Gerät so bewegt wird, dass seine Oberfläche sich nach oben bewegt. timestamp Die Anzahl der Millisekunden seit der Initialisierung der Laufzeitumgebung bis zum Auftreten des Ereignisses.Number Die Anzahl der Millisekunden seit der Initialisierung der Laufzeitumgebung bis zum Auftreten des Ereignisses. Wenn das Gerät zum Beispiel 4 Sekunden nach der Initialisierung der Anwendung Beschleunigungsdaten erfasst, wird die timestamp-Eigenschaft des Ereignisses auf 4000 gesetzt.
IMEEvent Ein IMEEvent-Objekt wird ausgelöst, wenn der Benutzer Text über einen Eingabemethoden-Editor (IME) eingibt.Ereignisobjekte für IMEEvent-Ereignisse. flash.events:TextEvent Ein IMEEvent-Objekt wird ausgelöst, wenn der Benutzer Text über einen Eingabemethoden-Editor (IME) eingibt. IMEs werden in der Regel zur Eingabe von Text für Sprachen mit Ideogrammen anstelle von Buchstaben verwendet, beispielsweise Japanisch, Chinesisch und Koreanisch. Es gibt zwei IME-Ereignisse: IMEEvent.IME_COMPOSITION und IMEEvent.IME_START_COMPOSITION. flash.system.IMEflash.events.IMEEvent.IME_COMPOSITIONflash.events.IMEEvent.IME_START_COMPOSITIONimeCompositionflash.events:IMEEvent:IME_COMPOSITIONflash.events:IMEEventflash.system.IME.imeCompositionimeCompositionflash.events:IMEEvent:IME_START_COMPOSITIONflash.events:IMEEventflash.system.IME.imeCompositionIMEEvent Erstellt ein Ereignisobjekt mit bestimmten Informationen, die für IME-Ereignisse wichtig sind.typeString Der Ereignistyp. Ereignis-Listener können über die übernommene Eigenschaft type auf diese Informationen zugreifen. Es gibt nur ein IME-Ereignis: IMEEvent.IME_COMPOSITION. bubblesBooleanfalseBestimmt, ob das Ereignisobjekt an der Bubbling-Phase des Ereignisablaufs teilnimmt. Ereignis-Listener können über die übernommene Eigenschaft bubbles auf diese Informationen zugreifen. cancelableBooleanfalseBestimmt, ob das Ereignisobjekt abgebrochen werden kann. Ereignis-Listener können über die übernommene Eigenschaft cancelable auf diese Informationen zugreifen. textStringDie vom IME gelesene Zeichenfolge. Dies ist die Originalzeichenfolge, so wie sie vom Benutzer eingegeben wurde, vor der Auswahl eines Kandidaten. Die endgültig zusammengesetzte Zeichenfolge wird in einem TextEvent.TEXT_INPUT-Ereignis an das Objekt mit dem Tastaturfokus gesendet. Ereignis-Listener können über die Eigenschaft text auf diese Informationen zugreifen. imeClientflash.text.ime:IIMEClientnullEin Satz von Rückrufen, die von der Text-Engine verwendet werden, um mit dem IME zu kommunizieren. Hilfreich, wenn Ihr Code über eine eigene Text-Engine verfügt und selbst Textzeilen darstellt, anstatt TextField-Objekte oder das TextLayoutFramework zu verwenden. Konstruktor für IMEEvent-Objekte. Erstellt ein Ereignisobjekt mit bestimmten Informationen, die für IME-Ereignisse wichtig sind. Ereignisobjekte werden Ereignis-Listenern als Parameter übergeben. flash.system.IMEflash.events.IMEEvent.IME_COMPOSITIONflash.events.IMEEvent.IME_START_COMPOSITIONclone Erstellt eine Kopie des IMEEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.Ein neues IMEEvent-Objekt mit Eigenschaftswerten, die denen des Originals entsprechen. flash.events:Event Erstellt eine Kopie des IMEEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht. toString Gibt eine Zeichenfolge zurück, die alle Eigenschaften des IMEEvent-Objekts enthält.Eine Zeichenfolge, die alle Eigenschaften des IMEEvent-Objekts enthält. String Gibt eine Zeichenfolge zurück, die alle Eigenschaften des IMEEvent-Objekts enthält. Der String liegt im folgenden Format vor:

[IMEEvent type=Wert bubbles=Wert cancelable=Wert text=Wert]

IME_COMPOSITION Definiert den Wert der Eigenschaft type eines imeComposition-Ereignisobjekts.imeCompositionString Definiert den Wert der type-Eigenschaft eines imeComposition-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.targetDas IME-Objekt.
flash.system.IME.imeComposition
IME_START_COMPOSITION Um IME-Texteingaben zu verarbeiten, muss der Empfänger das imeClient-Feld des Ereignisses auf ein Objekt einstellen, das die IIMEClient-Schnittstelle implementiert.imeStartCompositionString Um IME-Texteingaben zu verarbeiten, muss der Empfänger das imeClient-Feld des Ereignisses auf ein Objekt einstellen, das die IIMEClient-Schnittstelle implementiert. Wenn imeClient nicht eingestellt wird, verwendet die Laufzeitumgebung stattdessen den Out-of-Line-IME-Satz und sendet den endgültigen Satz als TEXT_INPUT-Ereignis.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.targetDas IME-Objekt.
flash.system.IME.imeComposition
imeClient Gibt ein Objekt an, das die IMEClient- Schnittstelle implementiert.flash.text.ime:IIMEClient Gibt ein Objekt an, das die IMEClient- Schnittstelle implementiert. Komponenten, die auf dem flash.text.engine-Paket basieren, müssen diese Schnittstelle implementieren, um die Bearbeitung von Text in der Zeile („inline“) mit einem IME zu unterstützen.
DataEvent Ein Objekt löst ein DataEvent-Objekt aus, wenn Grunddaten fertig geladen wurden.Ereignisobjekte für DataEvent-Ereignisse. flash.events:TextEvent Ein Objekt löst ein DataEvent-Objekt aus, wenn Grunddaten fertig geladen wurden. Es gibt zwei Arten von Datenereignissen:
  • DataEvent.DATA: wird bei gesendeten oder empfangenen Daten ausgelöst.
  • DataEvent.UPLOAD_COMPLETE_DATA: wird bei gesendeten Daten oder bei Antwort des Servers ausgelöst.
Im folgenden Beispiel wird ein XMLSocket erstellt und eine Verbindung mit einem Socket-Server an Port 8080 von yourDomain hergestellt. Dem XMLSocket-Objekt wird ein Ereignis-Listener zugewiesen, der auf data-Ereignisse wartet. Diese Ereignisse werden beim Empfang von unformatierten Daten ausgelöst.

Hinweise:

  • Um in diesem Beispiel ein securityError-Ereignis zu generieren, müssen Sie „Sicherheit bei lokaler Wiedergabe“ auf „Nur auf Netzwerk zugreifen“ setzen, um die SWF-Datei zu kompilieren.
  • Sie benötigen einen Server, der auf [ yourDomain ] ausgeführt wird und über Port 8080 angeschlossen ist.

package { import flash.display.Sprite; import flash.events.DataEvent; import flash.net.XMLSocket; public class DataEventExample extends Sprite { private var hostName:String = "[yourDomain]"; private var port:uint = 8080; private var socket:XMLSocket; public function DataEventExample() { socket = new XMLSocket(); socket.addEventListener(DataEvent.DATA, dataHandler); socket.connect(hostName, port); } private function dataHandler(event:DataEvent):void { trace("dataHandler: " + event.data); } } }
flash.net.FileReferenceflash.net.XMLSocketdataflash.events:DataEvent:DATAflash.events:DataEventflash.net.XMLSocket.datauploadCompleteDataflash.events:DataEvent:UPLOAD_COMPLETE_DATAflash.events:DataEventflash.net.FileReference.uploadCompleteDataDataEvent Erstellt ein Ereignisobjekt, das Informationen über Datenereignisse enthält.typeString Der Ereignistyp. Ereignis-Listener können über die übernommene Eigenschaft type auf diese Informationen zugreifen. Es gibt nur einen Typ eines Datenereignisses: DataEvent.DATA. bubblesBooleanfalseLegt fest, ob das Ereignisobjekt an der Bubbling-Phase des Ereignisablaufs teilnimmt. Ereignis-Listener können über die übernommene Eigenschaft bubbles auf diese Informationen zugreifen. cancelableBooleanfalseBestimmt, ob das Ereignisobjekt abgebrochen werden kann. Ereignis-Listener können über die übernommene Eigenschaft cancelable auf diese Informationen zugreifen. dataStringDie in Flash Player oder Adobe AIR geladenen Grunddaten. Ereignis-Listener können über die Eigenschaft data auf diese Informationen zugreifen. Konstruktor für DataEvent-Objekte. Erstellt ein Ereignisobjekt, das Informationen über Datenereignisse enthält. Ereignisobjekte werden Ereignis-Listenern als Parameter übergeben. flash.net.XMLSocketDataEvent.DATAclone Erstellt eine Kopie des DataEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.Ein neues DataEvent-Objekt mit Eigenschaftswerten, die denen des Originals entsprechen. flash.events:Event Erstellt eine Kopie des DataEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht. toString Gibt eine Zeichenfolge zurück, die alle Eigenschaften des DataEvent-Objekts enthält.Eine Zeichenfolge, die alle Eigenschaften des DataEvent-Objekts enthält. String Gibt eine Zeichenfolge zurück, die alle Eigenschaften des DataEvent-Objekts enthält. Der String liegt im folgenden Format vor:

[DataEvent type=Wert bubbles=Wert cancelable=Wert data=Wert]

DATA Definiert den Wert der Eigenschaft type eines Datenereignisobjekts.dataString Definiert den Wert der Eigenschaft type eines data-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.dataDie in Flash Player oder Adobe AIR geladenen Grunddaten. targetDas XMLSocket-Objekt, das Daten empfängt.
flash.net.XMLSocket.data
UPLOAD_COMPLETE_DATA Definiert den Wert der Eigenschaft type eines uploadCompleteData-Ereignisobjekts.uploadCompleteDataString Definiert den Wert der Eigenschaft type eines uploadCompleteData-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.dataDie unformatierten Daten, die nach einem erfolgreichen Datei-Upload vom Server zurückgegeben werden.targetDas FileReference-Objekt, das nach einem erfolgreichen Upload Daten empfängt.
flash.net.FileReference.uploadCompleteData
data Die in Flash Player oder Adobe AIR geladenen Grunddaten. String Die in Flash Player oder Adobe AIR geladenen Grunddaten.
SecurityErrorEvent Ein Objekt löst ein SecurityErrorEvent-Objekt aus, um das Auftreten eines Sicherheitsfehlers zu melden.Ereignisobjekte für SecurityErrorEvent-Ereignisse. flash.events:ErrorEvent Ein Objekt löst ein SecurityErrorEvent-Objekt aus, um das Auftreten eines Sicherheitsfehlers zu melden. Sicherheitsfehler, die über diese Klasse gemeldet werden, werden im Allgemeinen von asynchronen Vorgängen erzeugt, z. B. dem Laden von Daten, in denen Sicherheitsverletzungen nicht sofort festgestellt werden können. Ihr Ereignis-Listener kann auf die Eigenschaft text eines Objekts zugreifen, um festzustellen, welche Operation versucht wurde und welche URLs involviert waren. Gibt es keine Ereignis-Listener, zeigt die Debugger-Version von Flash Player oder die AIR Debug Launcher (ADL)-Anwendung automatisch eine Fehlermeldung mit dem Inhalt der text-Eigenschaft an. Es gibt nur einen Typ eines Sicherheitsfehler-Ereignisses: SecurityErrorEvent.SECURITY_ERROR.

Sicherheitsfehler-Ereignisse sind finale Ereignisse, die von einem beliebigen Zielobjekt gesendet werden können. Dies bedeutet, dass andere Ereignisse, einschließlich generischer Fehlerereignisse, nicht für ein Zielobjekt gesendet werden, bei dem ein Sicherheitsfehler auftritt.

Im folgenden Beispiel wird anhand der Klasse SecurityErrorEventExample erläutert, wie die Listener-Methode securityErrorHandler() instanziiert und für auszulösende securityError-Ereignisse konfiguriert werden kann. Dieses Ereignis tritt ein, wenn sich ein URLRequest-Speicherort nicht in genau der gleichen Domäne wie die aufrufende SWF-Datei befindet und in der angeforderten Domäne kein domänenübergreifender Zugriff über eine entsprechende Richtliniendatei eingerichtet ist.

Ersetzen Sie zur Erstellung eines SecurityErrorEvent die Adresse http://www.[yourdomain].com durch einen Pfad, für den kein domänenübergreifender Zugriff eingerichtet wurde.

package { import flash.display.Sprite; import flash.net.URLLoader; import flash.net.URLRequest; import flash.events.SecurityErrorEvent; public class SecurityErrorEventExample extends Sprite { public function SecurityErrorEventExample() { var loader:URLLoader = new URLLoader(); loader.addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler); var request:URLRequest = new URLRequest("http://www.[yourDomain].com"); loader.load(request); } private function securityErrorHandler(event:SecurityErrorEvent):void { trace("securityErrorHandler: " + event); } } }
Security-KlasseSECURITY_ERRORsecurityErrorflash.events:SecurityErrorEvent:SECURITY_ERRORflash.events:SecurityErrorEventflash.net.FileReference.securityErrorflash.net.LocalConnection.securityErrorflash.net.NetConnection.securityErrorflash.net.Socket.securityErrorflash.net.URLLoader.securityErrorflash.net.URLStream.securityErrorflash.net.XMLSocket.securityErrorSecurityErrorEvent Erstellt ein Event-Objekt, das Informationen über Sicherheitsfehler-Ereignisse enthält.typeStringDer Ereignistyp. Ereignis-Listener können über die übernommene Eigenschaft type auf diese Informationen zugreifen. Es gibt nur einen Typ eines Fehlerereignisses: SecurityErrorEvent.SECURITY_ERROR. bubblesBooleanfalseBestimmt, ob das Ereignisobjekt an der Bubbling-Phase des Ereignisablaufs teilnimmt. Ereignis-Listener können über die übernommene Eigenschaft bubbles auf diese Informationen zugreifen. cancelableBooleanfalseBestimmt, ob das Ereignisobjekt abgebrochen werden kann. Ereignis-Listener können über die übernommene Eigenschaft cancelable auf diese Informationen zugreifen. textStringDer als Fehlermeldung anzuzeigende Text. Ereignis-Listener können über die Eigenschaft text auf diese Informationen zugreifen. idint0Eine Verweisnummer, die dem spezifischen Fehler zugeordnet ist. Konstruktor für SecurityErrorEvent-Objekte. Erstellt ein Event-Objekt, das Informationen über Sicherheitsfehler-Ereignisse enthält. Ereignisobjekte werden Ereignis-Listenern als Parameter übergeben. SECURITY_ERRORclone Erstellt eine Kopie des SecurityErrorEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.Ein neues securityErrorEvent-Objekt mit Eigenschaftswerten, die denen des Originals entsprechen. flash.events:Event Erstellt eine Kopie des SecurityErrorEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht. toString Gibt eine Zeichenfolge zurück, die alle Eigenschaften des SecurityErrorEvent-Objekts enthält.Eine Zeichenfolge, die alle Eigenschaften des SecurityErrorEvent-Objekts enthält. String Gibt eine Zeichenfolge zurück, die alle Eigenschaften des SecurityErrorEvent-Objekts enthält. Der String liegt im folgenden Format vor:

[securityErrorEvent type=Wert bubbles=Wert cancelable=Wert text=Wert errorID=Wert] Die errorId-Eigenschaft ist nur in Adobe AIR verfügbar

SECURITY_ERROR Die Konstante SecurityErrorEvent.SECURITY_ERROR definiert den Wert der type-Eigenschaft eines securityError-Ereignisobjekts.securityErrorString Die Konstante SecurityErrorEvent.SECURITY_ERROR definiert den Wert der type-Eigenschaft eines securityError-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.targetDas Netzwerkobjekt, das den Sicherheitsfehler ausgibt.textDer als Fehlermeldung anzuzeigende Text.
flash.net.FileReference.securityErrorflash.net.LocalConnection.securityErrorflash.net.NetConnection.securityErrorflash.net.Socket.securityErrorflash.net.URLLoader.securityErrorflash.net.URLStream.securityErrorflash.net.XMLSocket.securityError
UncaughtErrorEvent Ein UncaughtErrorEvent-Objekt wird von einer Instanz der UncaughtErrorEvents-Klasse abgesetzt, wenn ein nicht erfasster Fehler auftritt.flash.events:ErrorEvent Ein UncaughtErrorEvent-Objekt wird von einer Instanz der UncaughtErrorEvents-Klasse abgesetzt, wenn ein nicht erfasster Fehler auftritt. Fehler werden nicht erfasst, wenn sie außerhalb von try..catch-Blöcken ausgegeben werden, oder wenn ein ErrorEvent-Objekt ausgelöst wird, aber keine registrierten Listener vorhanden sind. Die Funktionalität für nicht erfasste Fehlerereignisse wird häufig als „globale Fehlerprozedur“ bezeichnet.

Das UncaughtErrorEvents-Objekt, welches das Ereignis absetzt, ist entweder mit einem LoaderInfo-Objekt oder mit einem Loader-Objekt verknüpft. Mit den folgenden Eigenschaften können Sie auf eine UncaughtErrorEvents-Instanz zugreifen:

  • LoaderInfo.uncaughtErrorEvents: zum Erkennen nicht erfasster Fehler im Code, der in derselben SWF-Datei definiert ist.
  • Loader.uncaughtErrorEvents: zum Erkennen nicht erfasster Fehler im Code, der in der SWF-Datei definiert ist, die von einem Loader-Objekt geladen wird.

Wenn ein uncaughtError-Ereignis auftritt, wird die Ausführung in dem Aufruf-Stack, der den Fehler verursacht hat, nicht fortgesetzt, selbst wenn das Ereignis verarbeitet wird. Falls es sich bei dem Fehler um einen synchronen Fehler handelt, wird Code, der in der Funktion verbleibt, in der der Fehler aufgetreten ist, nicht ausgeführt. Infolgedessen ist es wahrscheinlich, dass sich Ihre Anwendung in einem instabilen Zustand befindet, wenn ein nicht erfasster Fehler auftritt. Da ein nicht erfasster Fehler viele Ursachen haben kann, ist es unmöglich vorherzusagen, welche Funktionen verfügbar sind. Ihre Anwendung kann zum Beispiel in der Lage sein, Netzwerkoperationen oder Dateioperationen auszuführen. Diese Operationen stehen jedoch nicht unbedingt zur Verfügung.

Wenn eine SWF-Datei eine andere lädt, steigen uncaughtError-Ereignisse durch die LoaderInfo-Hierarchie nach unten und wieder nach oben. Angenommen, A.sfw lädt B.swf mithilfe einer Loader-Instanz. Wenn ein nicht erfasster Fehler in B.swf auftritt, wird ein uncaughtError-Ereignis in der folgenden Reihenfolge an LoaderInfo- und Loader-Objekte abgesetzt:

  1. (Erfassungsphase) LoaderInfo von A.swf
  2. (Erfassungsphase) Loader in A.swf
  3. (Zielphase) LoaderInfo von B.swf
  4. (Bubbling-Phase) Loader in A.swf
  5. (Bubbling-Phase) LoaderInfo von A.swf

Die uncaughtErrorEvents-Eigenschaft eines Loader-Objekts setzt nie ein uncaughtErrorEvent-Ereignis in der Zielphase ab. Sie setzt das Ereignis nur in den Erfassungs- und Bubblingphasen ab.

Wie bei anderen Ereignis-Bubblings beendet der Aufruf von stopPropagation() oder stopImmediatePropagation() das Absetzen des Ereignisses an andere Listener, allerdings mit einem wichtigen Unterschied. Das UncaughtErrorEvents-Objekt eines Loader-Objekts wird zum Zweck der Ereignispropagierung als ein Paar mit dem LoaderInfo.uncaughtErrorEvents-Objekt der geladenen SWF-Datei behandelt. Wenn ein mit einem dieser Objekte registrierter Listener die stopPropagation()-Methode aufruft, werden Ereignisse immer noch an andere Listener abgesetzt, die mit diesem UncaughtErrorEvents-Objekt registriert sind, und an Listener, die mit seinem UncaughtErrorEvents-Partnerobjekt registriert sind, bevor die Ereignispropagierung endet. Die stopImmediatePropagation()-Methode verhindert weiterhin, dass Ereignisse an alle zusätzlichen Listener abgesetzt werden.

Wenn Inhalt in einer Debugger-Version der Laufzeitumgebung ausgeführt wird, zum Beispiel in der Debugger-Version von Flash Player oder im AIR Debug Launcher (ADL), wird ein Dialogfeld angezeigt, wenn ein nicht erfasster Fehler auftritt. Für diese Laufzeitumgebungsversionen wird das Fehlerdialogfeld auch dann angezeigt, wenn ein Listener für das uncaughtError-Ereignis registriert ist. Um zu verhindern, dass das Dialogfeld in einer solchen Situation angezeigt wird, rufen Sie die preventDefault()-Methode des UncaughtErrorEvent-Objekts auf.

Wenn es sich bei dem von einem Loader-Objekt geladenen Inhalt um eine AVM1 (ActionScript 2)-SWF-Datei handelt, führen nicht erfasste Fehler in der AVM1-SWF-Datei nicht zu einem uncaughtError-Ereignis. Außerdem führen JavaScript-Fehler in HTML-Inhalten, die in ein HTMLLoader-Objekt (einschließlich eines Flex-HTML-Steuerungselements) geladen werden, nicht zu einem uncaughtError-Ereignis.

Das folgende Beispiel veranschaulicht die Verwendung einer Ereignisprozedur für nicht erfasste Fehler, um nicht erfasste Fehler in einem ActionScript-Projekt zu erkennen. Im Beispiel wird eine uncaughtError-Ereignisprozedur definiert, um nicht erfasste Fehler zu erkennen. Es stellt auch eine Schaltfläche bereit, die einen Fehler ausgibt, wenn auf sie geklickt wird. Dieser Fehler wird von der Ereignisprozedur für nicht erfasste Fehler erkannt.

Im Konstruktor registriert der Code einen Listener für das uncaughtError-Ereignis, das von der uncaughtErrorEvents-Eigenschaft des LoaderInfo-Objekts abgesetzt wird.

In der uncaughtErrorHandler()-Methode überprüft der Code den Datentyp der error-Eigenschaft und reagiert entsprechend.

package { import flash.display.Sprite; import flash.events.ErrorEvent; import flash.events.MouseEvent; import flash.events.UncaughtErrorEvent; public class UncaughtErrorEventExample extends Sprite { public function UncaughtErrorEventExample() { loaderInfo.uncaughtErrorEvents.addEventListener(UncaughtErrorEvent.UNCAUGHT_ERROR, uncaughtErrorHandler); drawUI(); } private function uncaughtErrorHandler(event:UncaughtErrorEvent):void { if (event.error is Error) { var error:Error = event.error as Error; // do something with the error } else if (event.error is ErrorEvent) { var errorEvent:ErrorEvent = event.error as ErrorEvent; // do something with the error } else { // a non-Error, non-ErrorEvent type was thrown and uncaught } } private function drawUI():void { var btn:Sprite = new Sprite(); btn.graphics.clear(); btn.graphics.beginFill(0xFFCC00); btn.graphics.drawRect(0, 0, 100, 50); btn.graphics.endFill(); addChild(btn); btn.addEventListener(MouseEvent.CLICK, clickHandler); } private function clickHandler(event:MouseEvent):void { throw new Error("Gak!"); } } }
Das folgende Beispiel ist die Flex-Entsprechung des vorstehenden Beispiels, wobei ein MXML-Dokument anstelle einer ActionScript-Klasse als Stamminhalt verwendet wird. <?xml version="1.0" encoding="utf-8"?> <s:WindowedApplication xmlns:fx="http://ns.adobe.com/mxml/2009" xmlns:s="library://ns.adobe.com/flex/spark" xmlns:mx="library://ns.adobe.com/flex/halo" applicationComplete="applicationCompleteHandler();"> <fx:Script> <![CDATA[ import flash.events.ErrorEvent; import flash.events.MouseEvent; import flash.events.UncaughtErrorEvent; private function applicationCompleteHandler():void { loaderInfo.uncaughtErrorEvents.addEventListener(UncaughtErrorEvent.UNCAUGHT_ERROR, uncaughtErrorHandler); } private function uncaughtErrorHandler(event:UncaughtErrorEvent):void { if (event.error is Error) { var error:Error = event.error as Error; // do something with the error } else if (event.error is ErrorEvent) { var errorEvent:ErrorEvent = event.error as ErrorEvent; // do something with the error } else { // a non-Error, non-ErrorEvent type was thrown and uncaught } } private function clickHandler(event:MouseEvent):void { throw new Error("Gak!"); } ]]> </fx:Script> <s:Button label="Cause Error" click="clickHandler(event);"/> </s:WindowedApplication> Das folgende Beispiel veranschaulicht die Verwendung einer Ereignisprozedur für nicht erfasste Fehler, um nicht erfasste Fehler in einer geladenen SWF-Datei zu erkennen. Im Beispiel wird eine uncaughtError-Ereignisprozedur definiert, um nicht erfasste Fehler zu erkennen.

Im Konstruktor erstellt der Code ein Loader-Objekt und registriert einen Listener für das uncaughtError-Ereignis, das von der uncaughtErrorEvents-Eigenschaft des Loader-Objekts abgesetzt wird.

In der uncaughtErrorHandler()-Methode überprüft der Code den Datentyp der error-Eigenschaft und reagiert entsprechend.

package { import flash.display.Loader; import flash.display.Sprite; import flash.events.ErrorEvent; import flash.events.UncaughtErrorEvent; import flash.net.URLRequest; public class LoaderUncaughtErrorEventExample extends Sprite { private var ldr:Loader; public function LoaderUncaughtErrorEventExample() { ldr = new Loader(); ldr.load(new URLRequest("child.swf")); ldr.uncaughtErrorEvents.addEventListener(UncaughtErrorEvent.UNCAUGHT_ERROR, uncaughtErrorHandler); } private function uncaughtErrorHandler(event:UncaughtErrorEvent):void { if (event.error is Error) { var error:Error = event.error as Error; // do something with the error } else if (event.error is ErrorEvent) { var errorEvent:ErrorEvent = event.error as ErrorEvent; // do something with the error } else { // a non-Error, non-ErrorEvent type was thrown and uncaught } } } }
LoaderInfo.uncaughtErrorEventsLoader.uncaughtErrorEventsUncaughtErrorEventsuncaughtErrorflash.events:UncaughtErrorEvent:UNCAUGHT_ERRORflash.events:UncaughtErrorEventUncaughtErrorEvent Erstellt ein UncaughtErrorEvent-Objekt, das Informationen über ein uncaughtError-Ereignisse enthält.typeStringunknownDer Ereignistyp. bubblesBooleantrueBestimmt, ob das Ereignisobjekt an der Bubbling-Phase des Ereignisablaufs teilnimmt. Ereignis-Listener können über die übernommene Eigenschaft bubbles auf diese Informationen zugreifen. cancelableBooleantrueBestimmt, ob das Ereignisobjekt abgebrochen werden kann. Ereignis-Listener können über die übernommene Eigenschaft cancelable auf diese Informationen zugreifen. error_innullDas Objekt, das mit dem Fehler verknüpft ist, der nicht erfasst oder verarbeitet wurde (unter normalen Umständen ein Error- oder ErrorEvent-Objekt). Konstruktor für UncaughtErrorEvent-Objekte. Erstellt ein UncaughtErrorEvent-Objekt, das Informationen über ein uncaughtError-Ereignise enthält. clone Erstellt eine Kopie des UncaughtErrorEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.Ein neues UncaughtErrorEvent-Objekt mit Eigenschaftswerten, die denen des Originals entsprechen. flash.events:Event Erstellt eine Kopie des UncaughtErrorEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht. toString Gibt einen String zurück, der alle Eigenschaften des UncaughtErrorEvent-Objekts enthält.Ein String, der alle Eigenschaften des UncaughtErrorEvent-Objekts enthält. String Gibt einen String zurück, der alle Eigenschaften des UncaughtErrorEvent-Objekts enthält. UNCAUGHT_ERROR Definiert den Wert der type-Eigenschaft eines uncaughtError-Ereignisobjekts.uncaughtErrorString Definiert den Wert der type-Eigenschaft eines uncaughtError-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblestruecancelabletrue; das Abbrechen des Ereignisses verhindert, dass das Dialogfeld für nicht erfasste Fehler in Debugger-Versionen der Laufzeitumgebung angezeigt wirdcurrentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.errorDer nicht erfasste Fehler.targetDas LoaderInfo-Objekt, das mit der SWF-Datei verknüpft ist, in der der Fehler aufgetreten ist.textTextfehlermeldung.
error Das Fehlerobjekt, das mit dem nicht erfassten Fehler verknüpft ist. Das Fehlerobjekt, das mit dem nicht erfassten Fehler verknüpft ist. Normalerweise weist das Objekt einen der folgenden Datentypen auf:
  • Eine Error-Instanz (oder eine ihrer Unterklassen), wenn der nicht erfasste Fehler ein synchroner Fehler ist, der von einer throw-Anweisung erstellt wird, zum Beispiel ein Fehler, der mit einem try..catch-Block hätte erfasst werden können.
  • Eine Error-Instanz (oder eine ihrer Unterklassen), wenn der nicht erfasste Fehler ein asynchroner Fehler ist, der ein Fehlerereignis absetzt, wenn der Fehler auftritt

Die error-Eigenschaft kann jedoch ein Objekt jedes Datentyps sein. ActionScript erfordert keine throw-Anweisung, die nur mit Error-Objekten verwendet wird. Der folgende Code ist zum Beispiel sowohl zur Kompilierungszeit als auch zur Laufzeit zulässig:

throw new Sprite()

Wenn diese throw-Anweisung nicht durch einen try..catch-Block erfasst wird, löst die throw-Anweisung ein uncaughtError-Ereignis aus. In diesem Fall ist die error-Eigenschaft des UncaughtErrorEvent-Objekts, das abgesetzt wird, das Sprite-Objekt, das in der throw-Anweisung konstruiert wird.

Demzufolge sollten Sie in Ihrem uncaughtError-Listener den Datentyp der error-Eigenschaft überprüfen. Diese Überprüfung wird im folgenden Beispiel veranschaulicht:

function uncaughtErrorHandler(event:UncaughtErrorEvent):void { var message:String; if (event.error is Error) { message = Error(event.error).message; } else if (event.error is ErrorEvent) { message = ErrorEvent(event.error).text; } else { message = event.error.toString(); } }

Wenn die error-Eigenschaft eine Error-Instanz (oder Error-Unterklasse) enthält, variieren die verfügbaren Fehlerinformationen abhängig von der Version der Laufzeitumgebung, in der der Inhalt ausgeführt wird. Die folgende Funktionalität ist nur verfügbar, wenn Inhalt in einer Debugger-Version der Laufzeitumgebung ausgeführt wird, zum Beispiel in der Debug-Version von Flash Player oder im AIR Debug Launcher (ADL):

  • Error.getStackTrace(), um den Aufruf-Stack abzurufen, der zu dem Fehler geführt hat. In Nicht-Debugger-Versionen der Laufzeitumgebung gibt diese Methode null zurück. Beachten Sie, dass Aufruf-Stack-Informationen nie verfügbar sind, wenn die error-Eigenschaft eine ErrorEvent-Instanz ist.
  • Vollständiger Error.message-Text. In Nicht-Debugger-Versionen der Laufzeitumgebung enthält diese Eigenschaft eine Kurzversion der Fehlermeldung, häufig eine Kombination aus den Error.errorID- und Error.name-Eigenschaften.

Alle anderen Eigenschaften und Methoden der Error-Klasse sind in allen Versionen der Laufzeitumgebung verfügbar.

InvokeEvent Das NativeApplication-Objekt einer AIR-Anwendung löst ein invoke-Ereignis aus, wenn die Anwendung aufgerufen wird.Wird vom NativeApplication-Objekt abgesetzt, wenn eine AIR-Anwendung über das Betriebssystem aufgerufen wird. flash.events:Event Das NativeApplication-Objekt einer AIR-Anwendung löst ein invoke-Ereignis aus, wenn die Anwendung aufgerufen wird.

Das NativeApplication-Objekt löst ein invoke-Ereignis immer dann aus, wenn eine Anwendung gestartet wird. Das Ereignis kann aber auch zu anderen Zeitpunkten ausgelöst werden. Eine laufende Anwendung löst zum Beispiel ein zusätzliches InvokeEvent-Ereignis aus, wenn ein Benutzer eine mit der Anwendung verknüpfte Datei aktiviert.

Es kann jeweils nur eine Instanz einer bestimmten Anwendung gestartet werden. Bei nachfolgenden Versuchen, die Anwendung zu starten, löst das NativeApplication-Objekt der laufenden Instanz ein neues invoke-Ereignis aus. Die Anwendung ist dafür zuständig, dieses Ereignis zu verarbeiten und die entsprechende Aktion auszuführen, zum Beispiel ein neues Anwendungsfenster zum Anzeigen der Daten in der Datei zu öffnen.

InvokeEvent-Objekte werden vom NativeApplication-Objekt (NativeApplication.nativeApplication) ausgelöst. Um invoke-Ereignisse zu erhalten, rufen Sie die addEventListener()-Methode des NativeApplication-Objekts auf. Wenn ein Ereignis-Listener für ein invoke-Ereignis registriert wird, empfängt er auch alle invoke-Ereignisse, die vor der Registrierung aufgetreten sind. Diese früheren Ereignisse werden nach der Rückgabe des Aufrufs von addEventListener() ausgelöst, jedoch nicht unbedingt vor einem neuen invoke-Ereignis, das möglicherweise nach der Registrierung ausgelöst wird. Sie sollten sich also nicht auf eine bestimmte Auslösereihenfolge verlassen.

flash.events.BrowserInvokeEventflash.desktop.NativeApplicationinvokeflash.events:InvokeEvent:INVOKEflash.events:InvokeEventDie type-Konstante für flash.events.InvokeEvent-Ereignisse. flash.desktop.NativeApplicationflash.desktop.InvokeEventReasonInvokeEvent Die Konstruktorfunktion für die InvokeEvent-Klasse.typeStringDer Typ des Ereignisses, auf den als Event.type zugegriffen werden kann. bubblesBooleanfalseAuf false eingestellt für ein InvokeEvent-Objekt. cancelableBooleanfalseAuf false eingestellt für ein InvokeEvent-Objekt. dirflash.filesystem:FilenullDer Ordner, der verwendet werden sollte, um relative Pfade im arguments-Array aufzulösen. argvArraynullEin Array von Argumenten (Strings), die an die Anwendung zu übergeben sind. reasonStringstandarddie Ursache des Ereignisses; entweder InvokeEventReason.LOGIN oder InvokeEventReason.STANDARD. (Dieser Parameter ist ab AIR 1.5.1 verfügbar.) Die Konstruktorfunktion für die InvokeEvent-Klasse. flash.desktop.InvokeEventReasonclone Erstellt eine neue Kopie dieses Ereignisses.Die Kopie des Ereignisses. flash.events:Event Erstellt eine neue Kopie dieses Ereignisses. INVOKE Die InvokeEvent.INVOKE-Konstante definiert den Wert der type-Eigenschaft eines InvokeEvent-Objekts.invokeStringDie type-Konstante für flash.events.InvokeEvent-Ereignisse. Die InvokeEvent.INVOKE-Konstante definiert den Wert der type-Eigenschaft eines InvokeEvent-Objekts.

Das InvokeEvent-Ereignisobjekt hat folgende Eigenschaften:

EigenschaftenWerteArgumentsDas Array von Stringargumenten, die während dieses Aufrufs übergeben werden.currentDirectoryein File-Objekt, das den Ordner darstellt, der für die Auflösung relativer Pfade im Argumentarray verwendet wird.reasonein Code, der angibt, ob das invoke-Ereignis ausgelöst wurde, weil die Anwendung beim Anmelden automatisch gestartet wurde (InvokeEventReason.LOGIN), oder aus einem anderen Grund (InvokeEventReason.STANDARD). Verfügbar ab AIR 1.5.1.bubblesfalse.cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetGibt das Objekt an, welches das InvokeEvent -Objekt aktiv mit einem Ereignis-Listener verarbeitet.targetImmer das NativeApplication-Objekt.
flash.desktop.NativeApplicationflash.desktop.InvokeEventReason
arguments Das Array von Stringargumenten, die während dieses Aufrufs übergeben werden.Array Das Array von Stringargumenten, die während dieses Aufrufs übergeben werden. Wenn es sich um einen Befehlszeilenaufruf handelt, enthält das Array die Befehlszeilenargumente (ohne den Prozessnamen).

Hinweis: Wenn unter Mac® OS X mehrere Dateien ausgewählt und geöffnet wurden, löst AIR ein einzelnes invoke-Ereignis aus, das im arguments-Array die Namen aller ausgewählten Dateien enthält. Unter Windows® und Linux löst AIR hingegen ein separates invoke-Ereignis für jede ausgewählte Datei aus, das nur den jeweiligen Dateinamen im arguments-Array enthält.

currentDirectory Der Ordner, der verwendet werden sollte, um relative Pfade im Argument-Array aufzulösen.flash.filesystem:File Der Ordner, der verwendet werden sollte, um relative Pfade im arguments-Array aufzulösen.

Wenn eine Anwendung von der Befehlszeile aus gestartet wird, ist die Eigenschaft normalerweise auf das aktuelle Arbeitsverzeichnis der Befehlszeilen-Shell eingestellt, von der aus die Anwendung gestartet wurde. Wenn eine Anwendung von der GUI-Shell aus gestartet wird, wird für diese Eigenschaft normalerweise das erste Systemstammverzeichnis verwendet.

reason Die Ursache für dieses InvokeEvent.String Die Ursache für dieses InvokeEvent. Diese Eigenschaft gibt an, ob die Anwendung vom Benutzer manuell oder beim Anmelden automatisch gestartet wurde. Mögliche Werte werden als Konstanten in der InvokeEventReason-Klasse aufgelistet. InvokeEventReason-KonstanteBedeutungLOGINWurde bei der Anmeldung automatisch gestartet.STANDARDWurde aufgrund anderer Ursachen gestartet. flash.desktop.InvokeEventReason
ScreenMouseEvent Das SystemTrayIcon-Objekt löst als Reaktion auf eine Interaktion mit der Maus Ereignisse vom Typ ScreenMouseEvent aus.Ereignisobjekt für ScreenMouseEvent-Ereignisse. flash.events:MouseEvent Das SystemTrayIcon-Objekt löst als Reaktion auf eine Interaktion mit der Maus Ereignisse vom Typ ScreenMouseEvent aus.

Das ScreenMouseEvent-Objekt erweitert die MouseEvent-Klasse, sodass zwei weitere Eigenschaften bereitgestellt werden, screenX und screenY, die die Mauskoordinaten in Relation zum primären Desktopbildschirm anstatt zu einem Anwendungsfenster oder der Bühne protokollieren.

flash.desktop.SystemTrayIconflash.display.Screenclickflash.events:ScreenMouseEvent:CLICKflash.events:ScreenMouseEventWird von einem SystemTrayIcon-Objekt abgesetzt, wenn auf das Symbol geklickt wird. mouseDownflash.events:ScreenMouseEvent:MOUSE_DOWNflash.events:ScreenMouseEventmouseUpflash.events:ScreenMouseEvent:MOUSE_UPflash.events:ScreenMouseEventrightClickflash.events:ScreenMouseEvent:RIGHT_CLICKflash.events:ScreenMouseEventrightMouseDownflash.events:ScreenMouseEvent:RIGHT_MOUSE_DOWNflash.events:ScreenMouseEventrightMouseUpflash.events:ScreenMouseEvent:RIGHT_MOUSE_UPflash.events:ScreenMouseEventScreenMouseEvent Erstellt ein ScreenMouseEvent-Objekt, das die Mausposition in Bildschirmkoordinaten enthält.typeString Der Ereignistyp. Ereignis-Listener können über die übernommene Eigenschaft type auf diese Informationen zugreifen. bubblesBooleanfalseDie X-Position des Klicks in Bildschirmkoordinaten. cancelableBooleanfalseDie Y-Position des Klicks in Bildschirmkoordinaten. screenXNumberunknownAuf false eingestellt, da Bildschirmmausereignisse nie fortgesetzt werden. screenYNumberunknownAuf false eingestellt, da es kein Standardverhalten gibt, das abgebrochen werden kann. ctrlKeyBooleanfalseUnter Windows und Linux wird damit angezeigt, ob die Strg-Taste beim Auslösen dieses Ereignisses gedrückt war. Unter Mac OS wird damit angezeigt, ob die Ctrl-Taste oder die Befehlstaste gedrückt war. altKeyBooleanfalseMit der Einstellung true wird angegeben, dass die Alt-Taste gedrückt war, als dieses Ereignis auftrat. shiftKeyBooleanfalseMit der Einstellung true wird angegeben, dass die Umschalttaste gedrückt war, als dieses Ereignis auftrat. buttonDownBooleanfalseMit der Einstellung true wird angegeben, dass eine Maustaste gedrückt war, als dieses Ereignis auftrat. commandKeyBooleanfalseGibt an, ob die Befehlstaste gedrückt war (nur Mac). controlKeyBooleanfalseGibt an, ob die Strg- oder Ctrl-Taste gedrückt war. Konstruktor für ScreenMouseEvent-Objekte. Erstellt ein ScreenMouseEvent-Objekt, das die Mausposition in Bildschirmkoordinaten enthält. flash.events.MouseEventflash.display.Screenclone Erstellt eine Kopie des ScreenMouseEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.Ein neues ScreenMouseEvent-Objekt mit Eigenschaftswerten, die denen des Originals entsprechen. flash.events:Event Erstellt eine Kopie des ScreenMouseEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht. toString Gibt einen String zurück, der alle Eigenschaften des ScreenMouseEvent-Objekts enthält.Ein String, der alle Eigenschaften des ScreenMouseEvent-Objekts enthält. String Gibt einen String zurück, der alle Eigenschaften des ScreenMouseEvent-Objekts enthält. Der String liegt im folgenden Format vor:

[ScreenMouseEvent type=Wert bubbles=Wert cancelable=Wert status=Wert]

CLICK Die ScreenMouseEvent.CLICK-Konstante definiert den Wert der type-Eigenschaft eines click-Ereignisobjekts.clickStringWird von einem SystemTrayIcon-Objekt abgesetzt, wenn auf das Symbol geklickt wird. Die ScreenMouseEvent.CLICK-Konstante definiert den Wert der type-Eigenschaft eines click-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden relevanten Eigenschaften:

EigenschaftWertbuttonDowntrue, wenn die primäre Maustaste gedrückt wird; andernfalls false.ctrlKeytrue unter Windows oder Linux, wenn die Strg-Taste aktiv ist. true unter Mac OS, falls die Strg-Taste oder die Befehlstaste aktiv ist. Andernfalls wird false zurückgegeben.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.shiftKeytrue, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist.commandKeytrue unter Mac OS, falls die Befehlstaste aktiviert ist; false, wenn sie deaktiviert ist. Unter Windows immer false controlKeytrue, wenn die Strg- oder Ctrl-Taste aktiv ist; false, wenn sie nicht aktiv ist.screenXDie horizontale Koordinate, bei der das Ereignis aufgetreten ist, in Bildschirmkoordinaten.screenYDie vertikale Koordinate, bei der das Ereignis aufgetreten ist, in Bildschirmkoordinaten.targetDas SystemTrayIcon-Objekt unter dem Zeigegerät.
MOUSE_DOWN Die ScreenMouseEvent.MOUSE_DOWN-Konstante definiert den Wert der type-Eigenschaft eines mouseDown-Ereignisobjekts.mouseDownString Die ScreenMouseEvent.MOUSE_DOWN-Konstante definiert den Wert der type-Eigenschaft eines mouseDown -Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden relevanten Eigenschaften:

EigenschaftWertbuttonDowntrue, wenn die primäre Maustaste gedrückt wird; andernfalls false.ctrlKeytrue unter Windows oder Linux, wenn die Strg-Taste aktiv ist. true unter Mac OS, falls die Strg-Taste oder die Befehlstaste aktiv ist. Andernfalls wird false zurückgegeben.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.shiftKeytrue, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist.commandKeytrue unter Mac OS, falls die Befehlstaste aktiviert ist; false, wenn sie deaktiviert ist. Unter Windows immer false controlKeytrue, wenn die Strg- oder Ctrl-Taste aktiv ist; false, wenn sie nicht aktiv ist.screenXDie horizontale Koordinate, bei der das Ereignis aufgetreten ist, in Bildschirmkoordinaten.screenYDie vertikale Koordinate, bei der das Ereignis aufgetreten ist, in Bildschirmkoordinaten.targetDas SystemTrayIcon-Objekt unter dem Zeigegerät.
MOUSE_UP Die ScreenMouseEvent.MOUSE_UP-Konstante definiert den Wert der type-Eigenschaft eines mouseUp-Ereignisobjekts.mouseUpString Die ScreenMouseEvent.MOUSE_UP-Konstante definiert den Wert der type-Eigenschaft eines mouseUp-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden relevanten Eigenschaften:

EigenschaftWertbuttonDowntrue, wenn die primäre Maustaste gedrückt wird; andernfalls false.ctrlKeytrue unter Windows oder Linux, wenn die Strg-Taste aktiv ist. true unter Mac OS, falls die Strg-Taste oder die Befehlstaste aktiv ist. Andernfalls wird false zurückgegeben.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.shiftKeytrue, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist.commandKeytrue unter Mac OS, falls die Befehlstaste aktiviert ist; false, wenn sie deaktiviert ist. Unter Windows immer false controlKeytrue, wenn die Strg- oder Ctrl-Taste aktiv ist; false, wenn sie nicht aktiv ist.screenXDie horizontale Koordinate, bei der das Ereignis aufgetreten ist, in Bildschirmkoordinaten.screenYDie vertikale Koordinate, bei der das Ereignis aufgetreten ist, in Bildschirmkoordinaten.targetDas SystemTrayIcon-Objekt unter dem Zeigegerät.
RIGHT_CLICK Die ScreenMouseEvent.RIGHT_CLICK-Konstante definiert den Wert der type-Eigenschaft eines rightClick-Ereignisobjekts.rightClickString Die ScreenMouseEvent.RIGHT_CLICK-Konstante definiert den Wert der type-Eigenschaft eines rightClick-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden relevanten Eigenschaften:

EigenschaftWertbuttonDowntrue, wenn die primäre Maustaste gedrückt wird; andernfalls false.ctrlKeytrue unter Windows oder Linux, wenn die Strg-Taste aktiv ist. true unter Mac OS, falls die Strg-Taste oder die Befehlstaste aktiv ist. Andernfalls wird false zurückgegeben.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.shiftKeytrue, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist.commandKeytrue unter Mac OS, falls die Befehlstaste aktiviert ist; false, wenn sie deaktiviert ist. Unter Windows immer false controlKeytrue, wenn die Strg- oder Ctrl-Taste aktiv ist; false, wenn sie nicht aktiv ist.screenXDie horizontale Koordinate, bei der das Ereignis aufgetreten ist, in Bildschirmkoordinaten.screenYDie vertikale Koordinate, bei der das Ereignis aufgetreten ist, in Bildschirmkoordinaten.targetDas SystemTrayIcon-Objekt unter dem Zeigegerät.
RIGHT_MOUSE_DOWN Die ScreenMouseEvent.RIGHT_MOUSE_DOWN-Konstante definiert den Wert der type-Eigenschaft eines rightMouseDown-Ereignisobjekts.rightMouseDownString Die ScreenMouseEvent.RIGHT_MOUSE_DOWN-Konstante definiert den Wert der type-Eigenschaft eines rightMouseDown-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden relevanten Eigenschaften:

EigenschaftWertbuttonDowntrue, wenn die primäre Maustaste gedrückt wird; andernfalls false.ctrlKeytrue unter Windows oder Linux, wenn die Strg-Taste aktiv ist. true unter Mac OS, falls die Strg-Taste oder die Befehlstaste aktiv ist. Andernfalls wird false zurückgegeben.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.shiftKeytrue, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist.commandKeytrue unter Mac OS, falls die Befehlstaste aktiviert ist; false, wenn sie deaktiviert ist. Unter Windows immer false controlKeytrue, wenn die Strg- oder Ctrl-Taste aktiv ist; false, wenn sie nicht aktiv ist.screenXDie horizontale Koordinate, bei der das Ereignis aufgetreten ist, in Bildschirmkoordinaten.screenYDie vertikale Koordinate, bei der das Ereignis aufgetreten ist, in Bildschirmkoordinaten.targetDas SystemTrayIcon-Objekt unter dem Zeigegerät.
RIGHT_MOUSE_UP Die ScreenMouseEvent.RIGHT_MOUSE_UP-Konstante definiert den Wert der type-Eigenschaft eines rightMouseUp-Ereignisobjekts.rightMouseUpString Die ScreenMouseEvent.RIGHT_MOUSE_UP-Konstante definiert den Wert der type-Eigenschaft eines rightMouseUp-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden relevanten Eigenschaften:

EigenschaftWertbuttonDowntrue, wenn die primäre Maustaste gedrückt wird; andernfalls false.ctrlKeytrue unter Windows oder Linux, wenn die Strg-Taste aktiv ist. true unter Mac OS, falls die Strg-Taste oder die Befehlstaste aktiv ist. Andernfalls wird false zurückgegeben.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.shiftKeytrue, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist.commandKeytrue unter Mac OS, falls die Befehlstaste aktiviert ist; false, wenn sie deaktiviert ist. Unter Windows immer false controlKeytrue, wenn die Strg- oder Ctrl-Taste aktiv ist; false, wenn sie nicht aktiv ist.screenXDie horizontale Koordinate, bei der das Ereignis aufgetreten ist, in Bildschirmkoordinaten.screenYDie vertikale Koordinate, bei der das Ereignis aufgetreten ist, in Bildschirmkoordinaten.targetDas SystemTrayIcon-Objekt unter dem Zeigegerät.
screenX Die X-Position des Klicks in Bildschirmkoordinaten. Number Die X-Position des Klicks in Bildschirmkoordinaten. screenY Die Y-Position des Klicks in Bildschirmkoordinaten. Number Die Y-Position des Klicks in Bildschirmkoordinaten.
ContextMenuEvent Ein InteractiveObject löst ein ContextMenuEvent-Objekt aus, wenn der Benutzer das Kontextmenü öffnet oder damit interagiert.Ereignisobjekte für ContextMenuEvent-Ereignisse. flash.events:Event Ein InteractiveObject löst ein ContextMenuEvent-Objekt aus, wenn der Benutzer das Kontextmenü öffnet oder damit interagiert. Es gibt zwei Arten von ContextMenuEvent-Objekten:
  • ContextMenuEvent.MENU_ITEM_SELECT
  • ContextMenuEvent.MENU_SELECT
Im folgenden Beispiel wird die Klasse ContextMenuEventExample zur Entfernung des Standard-Kontextmenüs von der Bühne und zum Hinzufügen eines neuen Menüpunkts, mit dem die Farbe eines Quadrats auf der Bühne geändert wird, verwendet. In diesem Beispiel werden die folgenden Aufgaben ausgeführt:
  1. Die Eigenschaft myContextMenu wird deklariert, und anschließend wird ein neues ContextMenu-Objekt mit der Eigenschaft redRectangle (vom Typ "Sprite") deklariert.
  2. Die Methode removeDefaultItems() wird aufgerufen. Bei dieser Methode werden alle integrierten Kontextmenüelemente mit Ausnahme der Option zum Drucken entfernt.
  3. Die Methode addCustomMenuItems() wird aufgerufen. Bei dieser Methode wird das defaultItems-Array um eine Option ReverseColours zur Farbumkehr erweitert. Hierfür wird die push()-Methode "Array" eingesetzt. Ein menuItemSelect-Ereignis-Listener wird dem ContextMenuItem-Objekt hinzugefügt. Die verknüpfte Methode ist menuItemSelectHandler(). Bei dieser Methode werden einige trace()-Anweisungen gedruckt, wenn der Benutzer die Option zur Farbumkehr im Kontextmenü wählt. Außerdem wird das rote Quadrat schwarz und der schwarze Text rot.
  4. Im Konstruktor wird ein menuSelect-Ereignis-Listener zusammen mit der verknüpften Methode menuSelectHandler() hinzugefügt. Hiermit werden drei trace()-Anweisungen gedruckt, wenn ein Element im Kontextmenü ausgewählt wird.
  5. Der Konstruktor ruft die Methode addChildren() auf, mit der ein rotes Quadrat gezeichnet und der Anzeigeliste hinzugefügt wird. Das Quadrat wird sofort angezeigt.
  6. Zum Schluss wird myContextMenu dem Kontextmenü der Eigenschaft redRectangle zugewiesen, sodass das benutzerdefinierte Kontextmenü nur angezeigt wird, wenn sich der Mauszeiger über dem Quadrat befindet.
package { import flash.ui.ContextMenu; import flash.ui.ContextMenuItem; import flash.ui.ContextMenuBuiltInItems; import flash.events.ContextMenuEvent; import flash.display.Sprite; import flash.display.Shape; import flash.text.TextField; public class ContextMenuEventExample extends Sprite { private var myContextMenu:ContextMenu; private var menuLabel:String = "Reverse Colors"; private var textLabel:String = "Right Click"; private var redRectangle:Sprite; private var label:TextField; private var size:uint = 100; private var black:uint = 0x000000; private var red:uint = 0xFF0000; public function ContextMenuEventExample() { myContextMenu = new ContextMenu(); removeDefaultItems(); addCustomMenuItems(); myContextMenu.addEventListener(ContextMenuEvent.MENU_SELECT, menuSelectHandler); addChildren(); redRectangle.contextMenu = myContextMenu; } private function addChildren():void { redRectangle = new Sprite(); redRectangle.graphics.beginFill(red); redRectangle.graphics.drawRect(0, 0, size, size); addChild(redRectangle); redRectangle.x = size; redRectangle.y = size; label = createLabel(); redRectangle.addChild(label); } private function removeDefaultItems():void { myContextMenu.hideBuiltInItems(); var defaultItems:ContextMenuBuiltInItems = myContextMenu.builtInItems; defaultItems.print = true; } private function addCustomMenuItems():void { var item:ContextMenuItem = new ContextMenuItem(menuLabel); myContextMenu.customItems.push(item); item.addEventListener(ContextMenuEvent.MENU_ITEM_SELECT, menuItemSelectHandler); } private function menuSelectHandler(event:ContextMenuEvent):void { trace("menuSelectHandler: " + event); } private function menuItemSelectHandler(event:ContextMenuEvent):void { trace("menuItemSelectHandler: " + event); var textColor:uint = (label.textColor == black) ? red : black; var bgColor:uint = (label.textColor == black) ? black : red; redRectangle.graphics.clear(); redRectangle.graphics.beginFill(bgColor); redRectangle.graphics.drawRect(0, 0, size, size); label.textColor = textColor; } private function createLabel():TextField { var txtField:TextField = new TextField(); txtField.text = textLabel; return txtField; } } }
ContextMenu-KlasseContextMenuItem-KlassemenuItemSelectflash.events:ContextMenuEvent:MENU_ITEM_SELECTflash.events:ContextMenuEventflash.ui.ContextMenuItem.menuItemSelectmenuSelectflash.events:ContextMenuEvent:MENU_SELECTflash.events:ContextMenuEventflash.ui.ContextMenu.menuSelectContextMenuEvent Erstellt ein Ereignisobjekt, das bestimmte Informationen über Menüereignisse enthält.typeString Der Ereignistyp. Folgende Werte sind möglich:
  • ContextMenuEvent.MENU_ITEM_SELECT
  • ContextMenuEvent.MENU_SELECT
bubblesBooleanfalse Bestimmt, ob das Ereignisobjekt an der Bubbling-Phase des Ereignisablaufs teilnimmt. Ereignis-Listener können über die übernommene Eigenschaft bubbles auf diese Informationen zugreifen. cancelableBooleanfalseBestimmt, ob das Ereignisobjekt abgebrochen werden kann. Ereignis-Listener können über die übernommene Eigenschaft cancelable auf diese Informationen zugreifen. mouseTargetflash.display:InteractiveObjectnullDas Anzeigelistenobjekt, auf das der Benutzer mit rechts geklickt hat, um das Kontextmenü anzuzeigen. Hierbei kann es sich um contextMenuOwner oder um eines seiner untergeordneten Elemente in der Anzeigeliste handeln. contextMenuOwnerflash.display:InteractiveObjectnullDas Anzeigelistenobjekt, dem das Menü zugeordnet ist. Hierbei kann es sich um mouseTarget oder um einen seiner Vorgänger in der Anzeigeliste handeln. Konstruktor für ContextMenuEvent-Objekte.
Erstellt ein Ereignisobjekt, das bestimmte Informationen über Menüereignisse enthält. Ereignisobjekte werden Ereignis-Listenern als Parameter übergeben.
ContextMenuEvent.MENU_ITEM_SELECTContextMenuEvent.MENU_SELECT
clone Erstellt eine Kopie des ContextMenuEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.Ein neues ContextMenuEvent-Objekt mit Eigenschaftswerten, die denen des Originals entsprechen. flash.events:Event Erstellt eine Kopie des ContextMenuEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht. toString Gibt eine Zeichenfolge zurück, die alle Eigenschaften des ContextMenuEvent-Objekts enthält.Eine Zeichenfolge, die alle Eigenschaften des ContextMenuEvent-Objekts enthält. String Gibt eine Zeichenfolge zurück, die alle Eigenschaften des ContextMenuEvent-Objekts enthält. Der String liegt im folgenden Format vor:

[ContextMenuEvent type= value bubbles= value cancelable= value ... contextMenuOwner= value ]

MENU_ITEM_SELECT Definiert den Wert der Eigenschaft "type" eines menuItemSelect-Ereignisobjekts.menuItemSelectString Definiert den Wert der Eigenschaft type eines menuItemSelect-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.contextMenuOwnerDas Anzeigelistenobjekt, dem das Menü zugeordnet ist.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.mouseTargetDas Anzeigelistenobjekt, auf das der Benutzer mit rechts geklickt hat, um das Kontextmenü anzuzeigen.targetDas ausgewählte ContextMenuItem-Objekt. Das Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet.
flash.ui.ContextMenuItem.menuItemSelect
MENU_SELECT Definiert den Wert der Eigenschaft "type" eines menuSelect-Ereignisobjekts.menuSelectString Definiert den Wert der Eigenschaft type eines menuSelect-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.contextMenuOwnerDas Anzeigelistenobjekt, dem das Menü zugeordnet ist.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.mouseTargetDas Anzeigelistenobjekt, auf das der Benutzer mit rechts geklickt hat, um das Kontextmenü anzuzeigen.targetDas ContextMenu-Objekt, das angezeigt werden soll. Das Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet.
flash.ui.ContextMenu.menuSelect
contextMenuOwner Das Anzeigelistenobjekt, dem das Menü zugeordnet ist.flash.display:InteractiveObject Das Anzeigelistenobjekt, dem das Menü zugeordnet ist. Hierbei kann es sich um ein Mausziel (mouseTarget) oder um einen seiner Vorgänger in der Anzeigeliste handeln. isMouseTargetInaccessible Gibt an, ob die mouseTarget-Eigenschaft aus Sicherheitsgründen auf null gesetzt wurde.Boolean Gibt an, ob die mouseTarget-Eigenschaft aus Sicherheitsgründen auf null gesetzt wurde. Ist der Nominalwert von menuTarget ein Verweis auf ein DisplayObject in einer anderen Sicherheitssandbox, wird menuTarget auf null gesetzt, es sei denn, die Berechtigung gilt über die Sandboxgrenzen hinweg für beide Richtungen. Die Berechtigung wird durch das Aufrufen von Security.allowDomain() aus einer SWF-Datei hergestellt, oder indem vom Server der Bilddatei eine Richtliniendatei bereitgestellt und das LoaderContext.checkPolicyFile-Flag beim Laden des Bilds gesetzt wird. ContextMenuEvent.mouseTargetSecurity.allowDomain()LoaderContext.checkPolicyFilemouseTarget Das Anzeigelistenobjekt, auf das der Benutzer mit rechts geklickt hat, um das Kontextmenü anzuzeigen.flash.display:InteractiveObject Das Anzeigelistenobjekt, auf das der Benutzer mit rechts geklickt hat, um das Kontextmenü anzuzeigen. Hierbei kann es sich um das Anzeigelistenobjekt handeln, mit dem das Menü verknüpft ist (contextMenuOwner), oder um eines seiner untergeordneten Elemente in der Anzeigeliste.

Der Wert dieser Eigenschaft kann in zwei Fällen null sein: Wenn kein Mausziel vorhanden ist (beispielsweise, wenn Sie die Maus über den Hintergrund bewegen) oder wenn eines vorhanden ist, dieses aber eine Sicherheitssandbox ist, auf die Sie keinen Zugriff haben. Verwenden Sie die isMouseTargetInaccessible()-Eigenschaft, um festzustellen, welcher dieser Gründe zutrifft.

ContextMenuEvent.isMouseTargetInaccessible
DRMAuthenticateEvent Ein NetStream-Objekt löst ein DRMAuthenticateEvent-Objekt aus, wenn versucht wird, DRM (digitales Rechtemanagement)-verschlüsselte Inhalte abzuspielen, die bei der Authentifizierung Benutzerdaten erfordern.Ereignisobjekte für DRM-fähige Objekte. flash.events:Event Ein NetStream-Objekt löst ein DRMAuthenticateEvent-Objekt aus, wenn versucht wird, DRM (digitales Rechtemanagement)-verschlüsselte Inhalte abzuspielen, die bei der Authentifizierung Benutzerdaten erfordern.

Die DRMAuthenticateEvent-Prozedur ist zuständig für das Sammeln der erforderlichen Benutzerdaten (zum Beispiel Benutzernamen, Kennwort und Typ) und die Übergabe der Werte an die NetStream.setDRMAuthenticationCredentials()-Methode zur Authentifizierung. Jede AIR-Anwendung muss einen Mechanismus zur Verfügung stellen, mit dem die Benutzerdaten erhalten werden. Die Anwendung könnte dem Benutzer zum Beispiel eine einfache Benutzeroberfläche zur Eingabe des Benutzernamens und des Kennworts, optional auch des Typs, anzeigen.

Wenn die Benutzerauthentifizierung fehlschlägt, startet die Anwendung einen neuen Versuch und löst ein neues DRMAuthenticateEvent-Ereignis für das NetStream-Objekts aus.

package { import flash.display.Sprite; import flash.events.AsyncErrorEvent; import flash.events.NetStatusEvent; import flash.events.DRMAuthenticateEvent; import flash.media.Video; import flash.net.NetConnection; import flash.net.NetStream; public class DRMAuthenticateEventExample extends Sprite { var videoURL:String = "Video.flv"; var videoConnection:NetConnection; var videoStream:NetStream; var video:Video = new Video(); public function DRMAuthenticateEventExample() { videoConnection = new NetConnection(); videoConnection.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler); videoConnection.connect(null); } private function connectStream():void { videoStream = new NetStream(videoConnection); videoStream.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler); videoStream.addEventListener(AsyncErrorEvent.ASYNC_ERROR, asyncErrorHandler); videoStream.addEventListener(DRMAuthenticateEvent.DRM_AUTHENTICATE, drmAuthenticateEventHandler); video.attachNetStream(videoStream); videoStream.play(videoURL); addChild(video); } private function netStatusHandler(event:NetStatusEvent):void { switch (event.info.code) { case "NetConnection.Connect.Success": connectStream(); break; case "NetStream.Play.StreamNotFound": trace("Unable to locate video: " + videoURL); break; } } private function asyncErrorHandler(event:AsyncErrorEvent):void { // ignore AsyncErrorEvent events. } private function drmAuthenticateEventHandler(event:DRMAuthenticateEvent):void { videoStream.setDRMAuthenticationCredentials("User", "password", "drm"); } } }
DRMAuthenticateEvent.DRM_AUTHENTICATEflash.net.drm.DRMManagerdrmAuthenticateflash.events:DRMAuthenticateEvent:AUTHENTICATION_TYPE_DRMflash.events:DRMAuthenticateEventflash.net.NetStream.drmAuthenticateDRMAuthenticateEvent.authenticationTypedrmAuthenticateflash.events:DRMAuthenticateEvent:AUTHENTICATION_TYPE_PROXYflash.events:DRMAuthenticateEventflash.net.NetStream.drmAuthenticateDRMAuthenticateEvent.authenticationTypedrmAuthenticateflash.events:DRMAuthenticateEvent:DRM_AUTHENTICATEflash.events:DRMAuthenticateEventflash.net.NetStream.drmAuthenticateDRMAuthenticateEvent Erstellt ein Event-Objekt, das bestimmte Informationen über DRM-Authentifizierungsereignisse enthält.typeString Der Ereignistyp. Ereignis-Listener können über die übernommene Eigenschaft type auf diese Informationen zugreifen. Es gibt nur einen Typ von DRMAuthenticate-Ereignissen: DRMAuthenticateEvent.DRM_AUTHENTICATE. bubblesBooleanfalseBestimmt, ob das Ereignisobjekt an der Bubbling-Phase des Ereignisablaufs teilnimmt. Ereignis-Listener können über die übernommene Eigenschaft bubbles auf diese Informationen zugreifen. cancelableBooleanfalseBestimmt, ob das Ereignisobjekt abgebrochen werden kann. Ereignis-Listener können über die übernommene Eigenschaft cancelable auf diese Informationen zugreifen. headerStringDer verschlüsselte Inhaltsdateiheader, der vom Server bereitgestellt wird. userPromptString Eine vom Server bereitgestellte Eingabeaufforderung für den Benutzernamen. passPromptStringEine vom Server bereitgestellte Eingabeaufforderung für das Kennwort. urlPromptStringEine vom Server bereitgestellte Eingabeaufforderung für eine anzuzeigende URL. authenticationTypeStringZeigt an, ob die angegebenen Benutzerdaten für die Authentifizierung für den Flash Media Rights Management Server (FMRMS) oder eine Proxyserver bestimmt sind. netstreamflash.net:NetStreamnullDas NetStream-Objekt, das dieses Ereignis eingeleitet hat. Erstellt ein Event-Objekt, das bestimmte Informationen über DRM-Authentifizierungsereignisse enthält. Ereignisobjekte werden Ereignis-Listenern als Parameter übergeben. clone Erstellt eine Kopie des DRMAuthenticateEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.Ein neues DRMAuthenticateEvent-Objekt mit Eigenschaftswerten, die denen des Originals entsprechen. flash.events:Event Erstellt eine Kopie des DRMAuthenticateEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht. toString Gibt einen String zurück, der alle Eigenschaften des DRMAuthenticateEvent-Objekts enthält.Ein String, der alle Eigenschaften des DRMAuthenticateEvent-Objekts enthält. String Gibt einen String zurück, der alle Eigenschaften des DRMAuthenticateEvent-Objekts enthält. Der String liegt im folgenden Format vor:

[DRMAuthenticateEvent type=Wert bubbles=Wert cancelable=Wert eventPhase=Wert header=Wert usernamePrompt=Wert passwordPrompt=Wert urlPrompt=Wert] authenticationType=Wert

AUTHENTICATION_TYPE_DRM Die DRMAuthenticateEvent.AUTHENTICATION_TYPE_DRM-Konstante definiert den Wert der authenticationType-Eigenschaft eines DRMAuthenticateEvent-Objekts.drmString Die DRMAuthenticateEvent.AUTHENTICATION_TYPE_DRM-Konstante definiert den Wert der authenticationType-Eigenschaft eines DRMAuthenticateEvent-Objekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertauthenticationTypeZeigt an, ob die angegebenen Benutzerdaten für die Authentifizierung für den Flash Media Rights Management Server (FMRMS) oder eine Proxyserver bestimmt sind.bubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.headerDer verschlüsselte Inhaltsdateiheader, der vom Server bereitgestellt wird.netstreamDas NetStream-Objekt, das dieses Ereignis eingeleitet hat.passwordPromptEine vom Server bereitgestellte Eingabeaufforderung für das Kennwort.targetDas NetStream-Objekt.urlPromptEine vom Server bereitgestellte Eingabeaufforderung für eine anzuzeigende URL.usernamePromptEine vom Server bereitgestellte Eingabeaufforderung für den Benutzernamen.
flash.net.NetStream.drmAuthenticateDRMAuthenticateEvent.authenticationType
AUTHENTICATION_TYPE_PROXY Die DRMAuthenticateEvent.AUTHENTICATION_TYPE_PROXY-Konstante definiert den Wert der authenticationType-Eigenschaft eines DRMAuthenticateEvent-Objekts.proxyString Die DRMAuthenticateEvent.AUTHENTICATION_TYPE_PROXY-Konstante definiert den Wert der authenticationType-Eigenschaft eines DRMAuthenticateEvent-Objekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertauthenticationTypeZeigt an, ob die angegebenen Benutzerdaten für die Authentifizierung für den Flash Media Rights Management Server (FMRMS) oder eine Proxyserver bestimmt sind.bubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.headerDer verschlüsselte Inhaltsdateiheader, der vom Server bereitgestellt wird.netstreamDas NetStream-Objekt, das dieses Ereignis eingeleitet hat.passwordPromptEine vom Server bereitgestellte Eingabeaufforderung für das Kennwort.targetDas NetStream-Objekt.urlPromptEine vom Server bereitgestellte Eingabeaufforderung für eine anzuzeigende URL.usernamePromptEine vom Server bereitgestellte Eingabeaufforderung für den Benutzernamen.
flash.net.NetStream.drmAuthenticateDRMAuthenticateEvent.authenticationType
DRM_AUTHENTICATE Die DRMAuthenticateEvent.DRM_AUTHENTICATE-Konstante definiert den Wert der type-Eigenschaft eines DRMAuthenticateEvent-Objekts.drmAuthenticateString Die DRMAuthenticateEvent.DRM_AUTHENTICATE-Konstante definiert den Wert der type-Eigenschaft eines DRMAuthenticateEvent-Objekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertauthenticationTypeZeigt an, ob die angegebenen Benutzerdaten für die Authentifizierung für den Flash Media Rights Management Server (FMRMS) oder eine Proxyserver bestimmt sind.bubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.headerDer verschlüsselte Inhaltsdateiheader, der vom Server bereitgestellt wird.netstreamDas NetStream-Objekt, das dieses Ereignis eingeleitet hat.passwordPromptEine vom Server bereitgestellte Eingabeaufforderung für das Kennwort.targetDas NetStream-Objekt.urlPromptEine vom Server bereitgestellte Eingabeaufforderung für eine anzuzeigende URL.usernamePromptEine vom Server bereitgestellte Eingabeaufforderung für den Benutzernamen.
flash.net.NetStream.drmAuthenticate
authenticationType Zeigt an, ob die angegebenen Benutzerdaten für die Authentifizierung für Flash Media Rights Management Server (FMRMS) oder eine Proxyserver bestimmt sind.String Zeigt an, ob die angegebenen Benutzerdaten für die Authentifizierung für Flash Media Rights Management Server (FMRMS) oder eine Proxyserver bestimmt sind. Die "proxy"-Option ermöglicht der Anwendung zum Beispiel die Authentifizierung für einen Proxyserver, wenn ein Unternehmen diesen Schritt verlangt, bevor der Benutzer Zugriff auf das Internet hat. Sofern keine anonyme Authentifizierung verwendet wird, muss sich der Benutzer nach der Proxyauthentifizierung immer noch für den FMRMS authentifizieren, um den Gutschein zu erhalten und den Inhalt abzuspielen. Sie können setDRMAuthenticationcredentials() ein zweites Mal verwenden, diesmal mit der "drm"-Option, um die Authentifizierung für den FMRMS auszuführen. header Der verschlüsselte Inhaltsdateiheader, der vom Server bereitgestellt wird.String Der verschlüsselte Inhaltsdateiheader, der vom Server bereitgestellt wird. Er enthält Informationen über den Kontext des verschlüsselten Inhalts. netstream Das NetStream-Objekt, das dieses Ereignis eingeleitet hat.flash.net:NetStream Das NetStream-Objekt, das dieses Ereignis eingeleitet hat. passwordPrompt Eine vom Server bereitgestellte Eingabeaufforderung für das Kennwort.String Eine vom Server bereitgestellte Eingabeaufforderung für das Kennwort. Der String kann Anweisungen enthalten, die den erforderlichen Typ des Kennworts betreffen. urlPrompt Eine vom Server bereitgestellte Eingabeaufforderung für eine URL.String Eine vom Server bereitgestellte Eingabeaufforderung für eine URL. Der String kann angeben, wohin Benutzername und Kennwort gesendet werden. usernamePrompt Eine vom Server bereitgestellte Eingabeaufforderung für den Benutzernamen.String Eine vom Server bereitgestellte Eingabeaufforderung für den Benutzernamen. Der String kann Anweisungen enthalten, die den erforderlichen Typ des Benutzernamens betreffen. Ein Content-Provider könnte zum Beispiel eine E-Mail-Adresse als Benutzernamen verlangen.
StorageVolumeChangeEvent Das StorageVolumeInfo.storageVolumeInfo-Objekt setzt ein StorageVolumeChangeEvent-Ereignisobjekt ab, wenn ein Speichervolume bereitgestellt oder seine Bereitstellung aufgehoben wird.flash.events:Event Das StorageVolumeInfo.storageVolumeInfo-Objekt setzt ein StorageVolumeChangeEvent-Ereignisobjekt ab, wenn ein Speichervolume bereitgestellt oder seine Bereitstellung aufgehoben wird. Es gibt zwei Typen von StorageVolumeChangeEvent: storageVolumeMount und storageVolumeUnmount.

Unter Linux setzt das StorageVolumeInfo-Objekt nur storageVolumeMount- und storageVolumeUnmount-Ereignisse für reale Geräte ab. Es setzt keine Ereignisse ab, wenn der Benutzer Volumes über ein Netzwerk bereitstellt bzw. deren Bereitstellung aufhebt.

Einige Geräte, zum Beispiel bestimmte Digitalkameras und Handys, tauchen im StorageVolumeInfo.getStorageVolumes()-Array auf, sie setzen jedoch keine StorageVolumeChangeEvent-Objekte ab, wenn sie bereitgestellt werden oder ihre Bereitstellung aufgehoben wird.

flash.filesystem.StorageVolumeInfostorageVolumeMountflash.events:StorageVolumeChangeEvent:STORAGE_VOLUME_MOUNTflash.events:StorageVolumeChangeEventflash.filesystem.StorageVolumeInfostorageVolumeUnountflash.events:StorageVolumeChangeEvent:STORAGE_VOLUME_UNMOUNTflash.events:StorageVolumeChangeEventflash.filesystem.StorageVolumeInfoStorageVolumeChangeEvent Erstellt ein StorageVolumeChangeEvent-Objekt, das als Argument an Ereignis-Listener übergeben wird.typeString Der Typ des Ereignisses, aufrufbar über die type-Eigenschaft. Die StorageVolumeChangeEvent-Klasse definiert zwei Ereignistypen: das storageVolumeMount-Ereignis, das von der StorageVolumeChangeEvent.STORAGE_VOLUME_MOUNT-Konstante repräsentiert wird, und das storageVolumeUnmount-Ereignis, das von der StorageVolumeChangeEvent.STORAGE_VOLUME_UNMOUNT-Konstante repräsentiert wird. bubblesBooleanfalse Legt fest, ob das Ereignisobjekt an der Bubbling-Phase des Ereignisablaufs teilnimmt. Der Standardwert ist false. cancelableBooleanfalseBestimmt, ob das Ereignisobjekt abgebrochen werden kann. Der Standardwert ist false. pathflash.filesystem:FilenullDer Name des Speichervolumes. volumeflash.filesystem:StorageVolumenullDas File-Objekt, das das Speichervolume repräsentiert. Dient zum Erstellen eines neuen StorageVolumeChangeEvent-Objekts. Erstellt ein StorageVolumeChangeEvent-Objekt, das als Argument an Ereignis-Listener übergeben wird. flash.errors.SQLErrorflash.events.ErrorEvent.ERRORclone Dupliziert eine Instanz einer Event-Unterklasse.Ein mit dem Original identisches neues Ereignisobjekt. flash.events:Event Dupliziert eine Instanz einer Event-Unterklasse.

Gibt ein neues Ereignisobjekt zurück, das eine Kopie der ursprünglichen Instanz des Ereignisobjekts ist. Normalerweise rufen Sie clone() nicht auf; es wird automatisch von der EventDispatcher-Klasse aufgerufen, wenn Sie ein Ereignis neu auslösen, das heißt, wenn Sie dispatchEvent(event) von einer Prozedur aus aufrufen, die event verarbeitet.

Das neue Ereignisobjekt übernimmt alle Eigenschaften des Originals.

Wenn Sie Ihre eigene benutzerdefinierte Event-Klasse erstellen, müssen Sie die übernommene Event.clone()-Methode außer Kraft setzen, um die Eigenschaften Ihrer benutzerdefinierten Klasse zu duplizieren. Wenn Sie nicht alle der Ereignis-Unterklasse hinzugefügten Eigenschaften eingestellt haben, weisen sie nicht die korrekten Werte auf, wenn Listener das neu ausgelöste Ereignis verarbeiten.

In dem folgenden Beispiel ist PingEvent eine Unterklasse von Event und implementiert aus diesem Grund eine eigene Version von clone().

class PingEvent extends Event { var URL:String; public override function clone():Event { return new PingEvent(type, bubbles, cancelable, URL); } }
toString Gibt eine Zeichenfolge zurück, die alle Eigenschaften des Ereignisobjekts enthält.Eine Zeichenfolge, die alle Eigenschaften des Ereignisobjekts enthält. String Gibt eine Zeichenfolge zurück, die alle Eigenschaften des Ereignisobjekts enthält. Der String liegt im folgenden Format vor:

[Event type=Wert bubbles=Wert cancelable=Wert]

STORAGE_VOLUME_MOUNT Die StorageVolumeChangeEvent.VOLUME_MOUNT-Konstante definiert den Wert der type-Eigenschaft eines StorageVolumeChangeEvent, wenn ein Volume gemountet wird.storageVolumeMountString Die StorageVolumeChangeEvent.VOLUME_MOUNT-Konstante definiert den Wert der type-Eigenschaft eines StorageVolumeChangeEvent, wenn ein Volume gemountet wird.

Das Ereignis hat folgende Eigenschaften:

EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas StorageVolumeChangeEvent-Objekt.fileEin File-Objekt, das das Speichervolume repräsentiert.nameDer Name des Speichervolumes.targetDas StorageVolumeChangeEvent-Objekt.type"storageVolumeMount"
flash.filesystem.StorageVolumeInfo
STORAGE_VOLUME_UNMOUNT Die StorageVolumeChangeEvent.VOLUME_MOUNT-Konstante definiert den Wert der type-Eigenschaft eines StorageVolumeChangeEvent, wenn die Bereitstellung eines Volumes aufgehoben wird.storageVolumeUnmountString Die StorageVolumeChangeEvent.VOLUME_MOUNT-Konstante definiert den Wert der type-Eigenschaft eines StorageVolumeChangeEvent, wenn die Bereitstellung eines Volumes aufgehoben wird.

Das Ereignis hat folgende Eigenschaften:

EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas StorageVolumeChangeEvent-Objekt.fileEin File-Objekt, das das Speichervolume repräsentiert.nameDer Name des Speichervolumes.targetDas StorageVolumeChangeEvent-Objekt.type"storageVolumeUnmount"
flash.filesystem.StorageVolumeInfo
rootDirectory Ein File-Objekt, das dem Stammverzeichnis des bereitgestellten Volumes entspricht.flash.filesystem:File Ein File-Objekt, das dem Stammverzeichnis des bereitgestellten Volumes entspricht. Wenn die Bereitstellung des Volumes aufgehoben wurde (wenn der Ereignistyp storageVolumeUnmount ist), wird diese Eigenschaft auf null gesetzt. flash.filesystem.FilestorageVolume Ein StorageVolume-Objekt, das Informationen über ein bereitgestelltes Volume enthält.flash.filesystem:StorageVolume Ein StorageVolume-Objekt, das Informationen über ein bereitgestelltes Volume enthält. Diese Eigenschaft ist null für ein Volume, dessen Bereitstellung aufgehoben wurde (für ein storageVolumeUnmount-Eigenschaft). flash.filesystem.StorageVolume
SQLEvent Adobe AIR löst SQLEvent-Objekte aus, wenn einer der Vorgänge, die von einer SQLConnection-Instanz oder einer SQLStatement-Instanz ausgeführt werden, erfolgreich abgeschlossen wird.flash.events:Event Adobe AIR löst SQLEvent-Objekte aus, wenn einer der Vorgänge, die von einer SQLConnection-Instanz oder einer SQLStatement-Instanz ausgeführt werden, erfolgreich abgeschlossen wird. flash.data.SQLConnectionflash.data.SQLStatementanalyzeflash.events:SQLEvent:ANALYZEflash.events:SQLEventflash.data.SQLConnection.analyze()attachflash.events:SQLEvent:ATTACHflash.events:SQLEventflash.data.SQLConnection.attach()beginflash.events:SQLEvent:BEGINflash.events:SQLEventflash.data.SQLConnection.begin()cancelflash.events:SQLEvent:CANCELflash.events:SQLEventflash.data.SQLConnection.cancel()closeflash.events:SQLEvent:CLOSEflash.events:SQLEventflash.data.SQLConnection.close()commitflash.events:SQLEvent:COMMITflash.events:SQLEventflash.data.SQLConnection.commit()compactflash.events:SQLEvent:COMPACTflash.events:SQLEventflash.data.SQLConnection.compact()deanalyzeflash.events:SQLEvent:DEANALYZEflash.events:SQLEventflash.data.SQLConnection.deanalyze()detachflash.events:SQLEvent:DETACHflash.events:SQLEventflash.data.SQLConnection.detach()openflash.events:SQLEvent:OPENflash.events:SQLEventflash.data.SQLConnection.open()flash.data.SQLConnection.openAsync()reencryptflash.events:SQLEvent:REENCRYPTflash.events:SQLEventflash.data.SQLConnection.reencrypt()releaseSavepointflash.events:SQLEvent:RELEASE_SAVEPOINTflash.events:SQLEventflash.data.SQLConnection.releaseSavepoint()resultflash.events:SQLEvent:RESULTflash.events:SQLEventflash.data.SQLStatement.execute()flash.data.SQLStatement.next()flash.data.SQLStatement.getResult()rollbackToSavepointflash.events:SQLEvent:ROLLBACK_TO_SAVEPOINTflash.events:SQLEventflash.data.SQLConnection.rollbackToSavepoint()rollbackflash.events:SQLEvent:ROLLBACKflash.events:SQLEventflash.data.SQLConnection.rollback()schemaflash.events:SQLEvent:SCHEMAflash.events:SQLEventflash.data.SQLConnection.loadSchema()setSavepointflash.events:SQLEvent:SET_SAVEPOINTflash.events:SQLEventflash.data.SQLConnection.setSavepoint()SQLEvent Erstellt ein SQLEvent-Objekt, das als ein Parameter an Ereignis-Listener übergeben wird.typeString Der Typ des Ereignisses, verfügbar in der type-Eigenschaft. bubblesBooleanfalse Bestimmt, ob das Ereignisobjekt an der Bubbling-Phase des Ereignisablaufs teilnimmt. Der Standardwert ist false. cancelableBooleanfalseBestimmt, ob das Ereignisobjekt abgebrochen werden kann. Der Standardwert ist false. Dient zum Erstellen eines neuen SQLEvent-Objekts. Erstellt ein SQLEvent-Objekt, das als ein Parameter an Ereignis-Listener übergeben wird. clone Erstellt eine Kopie des SQLEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.Ein neues SQLEvent-Objekt mit Eigenschaftswerten, die denen des Originals entsprechen. flash.events:Event Erstellt eine Kopie des SQLEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht. ANALYZE Die SQLEvent.ANALYZE-Konstante definiert den Wert der type-Eigenschaft eines analyze-Ereignisobjekts.analyzeString Die SQLEvent.ANALYZE-Konstante definiert den Wert der type-Eigenschaft eines analyze-Ereignisobjekts. Der Ereignistyp wird ausgelöst, wenn ein Aufruf der SQLConnection.analyze()-Methode erfolgreich abgeschlossen wird. Das analyze-Ereignis hat folgende Eigenschaften: EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.targetDas SQLConnection-Objekt, das den Vorgang ausgeführt hat. flash.data.SQLConnection.analyze()ATTACH Die SQLEvent.ATTACH-Konstante definiert den Wert der type-Eigenschaft eines attach-Ereignisobjekts.attachString Die SQLEvent.ATTACH-Konstante definiert den Wert der type-Eigenschaft eines attach-Ereignisobjekts. Der Ereignistyp wird ausgelöst, wenn ein Aufruf der SQLConnection.attach()-Methode erfolgreich abgeschlossen wird. Das attach-Ereignis hat folgende Eigenschaften: EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.targetDas SQLConnection-Objekt, das den Vorgang ausgeführt hat. flash.data.SQLConnection.attach()BEGIN Die SQLEvent.BEGIN-Konstante definiert den Wert der type-Eigenschaft eines begin-Ereignisobjekts.beginString Die SQLEvent.BEGIN-Konstante definiert den Wert der type-Eigenschaft eines begin-Ereignisobjekts. Der Ereignistyp wird ausgelöst, wenn ein Aufruf der SQLConnection.begin()-Methode erfolgreich abgeschlossen wird. Das begin-Ereignis hat folgende Eigenschaften: EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.targetDas SQLConnection-Objekt, das den Vorgang ausgeführt hat. flash.data.SQLConnection.begin()CANCEL Die SQLEvent.CANCEL-Konstante definiert den Wert der type-Eigenschaft eines cancel-Ereignisobjekts.cancelString Die SQLEvent.CANCEL-Konstante definiert den Wert der type-Eigenschaft eines cancel-Ereignisobjekts. Der Ereignistyp wird ausgelöst, wenn ein Aufruf der SQLConnection.cancel()-Methode erfolgreich abgeschlossen wird. Das cancel-Ereignis hat folgende Eigenschaften: EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.targetDas SQLConnection- oder SQLStatement-Objekt, das den Vorgang ausgeführt hat. flash.data.SQLConnection.cancel()CLOSE Die SQLEvent.CLOSE-Konstante definiert den Wert der type-Eigenschaft eines close-Ereignisobjekts.closeString Die SQLEvent.CLOSE-Konstante definiert den Wert der type-Eigenschaft eines close-Ereignisobjekts. Der Ereignistyp wird ausgelöst, wenn ein Aufruf der SQLConnection.close()-Methode erfolgreich abgeschlossen wird. Das close-Ereignis hat folgende Eigenschaften: EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.targetDas SQLConnection-Objekt, das den Vorgang ausgeführt hat. flash.data.SQLConnection.close()COMMIT Die SQLEvent.COMMIT-Konstante definiert den Wert der type-Eigenschaft eines commit-Ereignisobjekts.commitString Die SQLEvent.COMMIT-Konstante definiert den Wert der type-Eigenschaft eines commit-Ereignisobjekts. Der Ereignistyp wird ausgelöst, wenn ein Aufruf der SQLConnection.commit()-Methode erfolgreich abgeschlossen wird. Das commit-Ereignis hat folgende Eigenschaften: EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.targetDas SQLConnection-Objekt, das den Vorgang ausgeführt hat. flash.data.SQLConnection.commit()COMPACT Die SQLEvent.COMPACT-Konstante definiert den Wert der type-Eigenschaft eines compact-Ereignisobjekts.compactString Die SQLEvent.COMPACT-Konstante definiert den Wert der type-Eigenschaft eines compact-Ereignisobjekts. Der Ereignistyp wird ausgelöst, wenn ein Aufruf der SQLConnection.compact()-Methode erfolgreich abgeschlossen wird. Das compact-Ereignis hat folgende Eigenschaften: EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.targetDas SQLConnection-Objekt, das den Vorgang ausgeführt hat. flash.data.SQLConnection.compact()DEANALYZE Die SQLEvent.DEANALYZE-Konstante definiert den Wert der type-Eigenschaft eines deanalyze-Ereignisobjekts.deanalyzeString Die SQLEvent.DEANALYZE-Konstante definiert den Wert der type-Eigenschaft eines deanalyze-Ereignisobjekts. Der Ereignistyp wird ausgelöst, wenn ein Aufruf der SQLConnection.deanalyze()-Methode erfolgreich abgeschlossen wird. Das deanalyze-Ereignis hat folgende Eigenschaften: EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.targetDas SQLConnection-Objekt, das den Vorgang ausgeführt hat. flash.data.SQLConnection.deanalyze()DETACH Die SQLEvent.DETACH-Konstante definiert den Wert der type-Eigenschaft eines detach-Ereignisobjekts.detachString Die SQLEvent.DETACH-Konstante definiert den Wert der type-Eigenschaft eines detach-Ereignisobjekts. Der Ereignistyp wird ausgelöst, wenn ein Aufruf der SQLConnection.detach()-Methode erfolgreich abgeschlossen wird. EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.targetDas SQLConnection-Objekt, das den Vorgang ausgeführt hat. flash.data.SQLConnection.detach()OPEN Die SQLEvent.OPEN-Konstante definiert den Wert der type-Eigenschaft eines open-Ereignisobjekts.openString Die SQLEvent.OPEN-Konstante definiert den Wert der type-Eigenschaft eines open-Ereignisobjekts. Der Ereignistyp wird ausgelöst, wenn ein Aufruf der SQLConnection.detach()- oder SQLConnection.openAsync()Methode erfolgreich abgeschlossen wird. Das open-Ereignis hat folgende Eigenschaften: EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.targetDas SQLConnection-Objekt, das den Vorgang ausgeführt hat. flash.data.SQLConnection.open()flash.data.SQLConnection.openAsync()REENCRYPT Die SQLEvent.REENCRYPT-Konstante definiert den Wert der type-Eigenschaft eines reencrypt-Ereignisobjekts.reencryptString Die SQLEvent.REENCRYPT-Konstante definiert den Wert der type-Eigenschaft eines reencrypt-Ereignisobjekts. Dieser Ereignistyp wird ausgelöst, wenn ein Aufruf der SQLConnection.reencrypt()-Methode erfolgreich abgeschlossen wird. Das reencrypt-Ereignis hat folgende Eigenschaften: EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.targetDas SQLConnection-Objekt, das den Vorgang ausgeführt hat. flash.data.SQLConnection.reencrypt()RELEASE_SAVEPOINT Die SQLEvent.RELEASE_SAVEPOINT-Konstante definiert den Wert der type-Eigenschaft eines releaseSavepoint-Ereignisobjekts.releaseSavepointString Die SQLEvent.RELEASE_SAVEPOINT-Konstante definiert den Wert der type-Eigenschaft eines releaseSavepoint-Ereignisobjekts. Dieser Ereignistyp wird ausgelöst, wenn ein Aufruf der SQLConnection.releaseSavepoint()-Methode erfolgreich abgeschlossen wird. Das releaseSavepoint-Ereignis hat folgende Eigenschaften: EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.targetDas SQLConnection-Objekt, das den Vorgang ausgeführt hat. flash.data.SQLConnection.releaseSavepoint()RESULT Die SQLEvent.RESULT-Konstante definiert den Wert der type-Eigenschaft eines result-Ereignisobjekts.resultString Die SQLEvent.RESULT-Konstante definiert den Wert der type-Eigenschaft eines result-Ereignisobjekts. Wird ausgelöst, wenn die SQLStatement.execute()- oder SQLStatement.next()-Methode erfolgreich abgeschlossen wird. Nachdem das SQLEvent.RESULT-Ereignis ausgelöst wurde, kann die SQLStatement.getResult()-Methode aufgerufen werden, um auf die Ergebnisdaten zuzugreifen. Das result-Ereignis hat folgende Eigenschaften: EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.targetDas SQLStatement-Objekt, das den Vorgang ausgeführt hat. flash.data.SQLStatement.execute()flash.data.SQLStatement.next()flash.data.SQLStatement.getResult()ROLLBACK_TO_SAVEPOINT Die SQLEvent.ROLLBACK_TO_SAVEPOINT-Konstante definiert den Wert der type-Eigenschaft eines rollbackToSavepoint-Ereignisobjekts.rollbackToSavepointString Die SQLEvent.ROLLBACK_TO_SAVEPOINT-Konstante definiert den Wert der type-Eigenschaft eines rollbackToSavepoint-Ereignisobjekts. Dieser Ereignistyp wird ausgelöst, wenn ein Aufruf der SQLConnection.rollbackToSavepoint()-Methode erfolgreich abgeschlossen wird. Das rollbackToSavepoint-Ereignis hat folgende Eigenschaften: EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.targetDas SQLConnection-Objekt, das den Vorgang ausgeführt hat. flash.data.SQLConnection.rollbackToSavepoint()ROLLBACK Die SQLEvent.ROLLBACK-Konstante definiert den Wert der type-Eigenschaft eines rollback-Ereignisobjekts.rollbackString Die SQLEvent.ROLLBACK-Konstante definiert den Wert der type-Eigenschaft eines rollback-Ereignisobjekts. Der Ereignistyp wird ausgelöst, wenn ein Aufruf der SQLConnection.rollback()-Methode erfolgreich abgeschlossen wird. Das rollback-Ereignis hat folgende Eigenschaften: EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.targetDas SQLConnection-Objekt, das den Vorgang ausgeführt hat. flash.data.SQLConnection.rollback()SCHEMA Die SQLEvent.SCHEMA-Konstante definiert den Wert der type-Eigenschaft eines schema-Ereignisobjekts.schemaString Die SQLEvent.SCHEMA-Konstante definiert den Wert der type-Eigenschaft eines schema-Ereignisobjekts. Wird ausgelöst, wenn die SQLConnection.loadSchema()-Methode erfolgreich abgeschlossen wurde. Nachdem das SQLEvent.SCHEMA-Ereignis ausgelöst wurde, können mit der SQLConnection.getSchemaResult()-Methode die Schemainformationen abgerufen werden. Das schema-Ereignis hat folgende Eigenschaften: EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.targetDas SQLConnection-Objekt, das den Vorgang ausgeführt hat. flash.data.SQLConnection.loadSchema()SET_SAVEPOINT Die SQLEvent.SET_SAVEPOINT-Konstante definiert den Wert der type-Eigenschaft eines setSavepoint-Ereignisobjekts.setSavepointString Die SQLEvent.SET_SAVEPOINT-Konstante definiert den Wert der type-Eigenschaft eines setSavepoint-Ereignisobjekts. Dieser Ereignistyp wird ausgelöst, wenn ein Aufruf der SQLConnection.setSavepoint()-Methode erfolgreich abgeschlossen wird. Das setSavepoint-Ereignis hat folgende Eigenschaften: EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.targetDas SQLConnection-Objekt, das den Vorgang ausgeführt hat. flash.data.SQLConnection.setSavepoint()DRMErrorEvent Die DRMErrorEvent-Klasse stellt Informationen zu Fehlern bereit, die beim Abspielen von DRM-verschlüsselten Dateien auftreten (DRM = Digital Rights Management).Ereignisobjekte für DRM-fähige Objekte. flash.events:ErrorEvent Die DRMErrorEvent-Klasse stellt Informationen zu Fehlern bereit, die beim Abspielen von DRM-verschlüsselten Dateien auftreten (DRM = Digital Rights Management).

Die Laufzeitumgebung löst ein DRMErrorEvent-Objekt aus, wenn ein NetStream-Objekt versucht, eine mit DRM (Digital Rights Management) verschlüsselte Datei abzuspielen und dabei ein DRM-Fehler auftritt. Ein DRMErrorEvent-Objekt wird zum Beispiel ausgelöst, wenn der Content-Provider die Anzeigeanwendung nicht unterstützt oder wenn die Autorisierung des Benutzers fehlschlägt, weil der Benutzer den Inhalt möglicherweise nicht gekauft hat.

Bei ungültigen Benutzerdaten verarbeitet das DRMAuthenticateEvent-Objekt den Fehler, indem die Auslösung wiederholt erfolgt, bis der Benützer gültige Daten eingibt oder bis die Anwendung weitere Versuche verhindert. Die Anwendung sollte alle anderen DRM-Fehlerereignisse überwachen, um die DRM-bezogenen Fehler zu erkennen, zu identifizieren und zu verarbeiten.

Diese Klasse stellt Eigenschaften bereit, die das Objekt enthalten, das den Fehler ausgegeben hat, sowie den Fehlercode und, falls zutreffend, einen untergeordneten Fehlercode und eine Textnachricht, die Informationen zum Fehler enthält. Eine Beschreibung von Fehlercodes im Zusammenhang mit DRM finden Sie unter Laufzeitfehlercodes. Die DRM-bezogenen Fehlercodes beginnen bei Fehler 3300.

package { import flash.display.Sprite; import flash.events.AsyncErrorEvent; import flash.events.NetStatusEvent; import flash.events.DRMErrorEvent; import flash.media.Video; import flash.net.NetConnection; import flash.net.NetStream; public class DRMVideoExample extends Sprite { var videoURL:String = "Video.flv"; var videoConnection:NetConnection; var videoStream:NetStream; var video:Video = new Video(); public function DRMVideoExample() { videoConnection = new NetConnection(); videoConnection.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler); videoConnection.connect(null); } private function connectStream():void { videoStream = new NetStream(videoConnection); videoStream.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler); videoStream.addEventListener(AsyncErrorEvent.ASYNC_ERROR, asyncErrorHandler); videoStream.addEventListener(DRMErrorEvent.DRM_ERROR, drmErrorEventHandler); video.attachNetStream(videoStream); videoStream.play(videoURL); addChild(video); } private function netStatusHandler(event:NetStatusEvent):void { switch (event.info.code) { case "NetConnection.Connect.Success": connectStream(); break; case "NetStream.Play.StreamNotFound": trace("Unable to locate video: " + videoURL); break; } } private function asyncErrorHandler(event:AsyncErrorEvent):void { // ignore AsyncErrorEvent events. } private function drmErrorEventHandler(event:DRMErrorEvent):void { trace(event.toString()); } } }
flash.net.NetStreamDRMErrorEvent.DRM_ERRORLaufzeitfehlercodesdrmErrorflash.events:DRMErrorEvent:DRM_ERRORflash.events:DRMErrorEventflash.net.NetStream.drmErrorDRMErrorEvent Erstellt ein Event-Objekt, das bestimmte Informationen über DRM-Fehlerereignisse enthält.typeStringunknown Der Ereignistyp. Ereignis-Listener können über die übernommene Eigenschaft type auf diese Informationen zugreifen. Es gibt nur einen Typ von DRMAuthenticate-Ereignissen: DRMAuthenticateEvent.DRM_AUTHENTICATE. bubblesBooleanfalseBestimmt, ob das Ereignisobjekt an der Bubbling-Phase des Ereignisablaufs teilnimmt. Ereignis-Listener können über die übernommene Eigenschaft bubbles auf diese Informationen zugreifen. cancelableBooleanfalseBestimmt, ob das Ereignisobjekt abgebrochen werden kann. Ereignis-Listener können über die übernommene Eigenschaft cancelable auf diese Informationen zugreifen. inErrorDetailStringDie spezifischen syntaktischen Details zum Fehler (falls zutreffend). inErrorCodeint0Der Hauptfehlercode. insubErrorIDint0Die sekundäre Fehler-ID. inMetadataflash.net.drm:DRMContentDatanullinSystemUpdateNeededBooleanfalseinDrmUpdateNeededBooleanfalse Erstellt ein Event-Objekt, das bestimmte Informationen über DRM-Fehlerereignisse enthält. Ereignisobjekte werden Ereignis-Listenern als Parameter übergeben. clone Erstellt eine Kopie des DRMErrorEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.Ein neues DRMErrorEvent-Objekt mit Eigenschaftswerten, die denen des Originals entsprechen. flash.events:Event Erstellt eine Kopie des DRMErrorEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht. toString Gibt einen String zurück, der alle Eigenschaften des DRMErrorEvent-Objekts enthält.Ein String, der alle Eigenschaften des DRMErrorEvent-Objekts enthält. String Gibt einen String zurück, der alle Eigenschaften des DRMErrorEvent-Objekts enthält. Der String liegt im folgenden Format vor:

[DRMErrorEvent type=Wert bubbles=Wert cancelable=Wert eventPhase=Wert errroID=Wert subErrorID=Wert text=Wert

DRM_ERROR Die Konstante DRMErrorEvent.DRM_ERROR definiert den Wert der type-Eigenschaft eines drmError-Ereignisobjekts.drmErrorString Die Konstante DRMErrorEvent.DRM_ERROR definiert den Wert der type-Eigenschaft eines drmError-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.errorIDEin dem Problem zugewiesener Fehlercode im Zahlenformat.subErrorIDEin Fehlercode, der ausführlichere Informationen zum zugrundeliegenden Problem angibt.targetDas NetStream-Objekt.
flash.net.NetStream.drmError
contentData Die DRMContentData für die Mediendatei.flash.net.drm:DRMContentData Die DRMContentData für die Mediendatei.

Sie können das Objekt, auf das mit der contentData-Eigenschaft verwiesen wird, verwenden, um den zugehörigen DRM-Gutschein aus dem Gutscheincache von DRMManager abzurufen. Die Gutscheineigenschaften beschreiben die dem Benutzer zugängliche Lizenz und erklären ggf., weshalb der DRM-geschützte Inhalt nicht angezeigt werden kann.

drmUpdateNeeded Gibt an, ob ein DRM-Update erforderlich ist, um die DRM-geschützten Inhalte abzuspielen.Boolean Gibt an, ob ein DRM-Update erforderlich ist, um die DRM-geschützten Inhalte abzuspielen. subErrorID Eine Fehler-ID, die ausführlichere Informationen zu dem zugrundeliegenden Problem bereitstellt.int Eine Fehler-ID, die ausführlichere Informationen zu dem zugrundeliegenden Problem bereitstellt. systemUpdateNeeded Gibt an, ob ein Systemupdate erforderlich ist, um die DRM-geschützten Inhalte abzuspielen.Boolean Gibt an, ob ein Systemupdate erforderlich ist, um die DRM-geschützten Inhalte abzuspielen.
EventPhase Die EventPhase-Klasse stellt Werte für die eventPhase-Eigenschaft der Event-Klasse bereit.Object Die EventPhase-Klasse stellt Werte für die eventPhase-Eigenschaft der Event-Klasse bereit. Event-KlasseEventDispatcher-KlasseAT_TARGET Die Zielphase, die zweite Phase im Ereignisablauf.2uint Die Zielphase, die zweite Phase im Ereignisablauf. BUBBLING_PHASE Die Bubbling-Phase, die dritte Phase im Ereignisablauf.3uint Die Bubbling-Phase, die dritte Phase im Ereignisablauf. CAPTURING_PHASE Die Aufnahmephase, die erste Phase im Ereignisablauf.1uint Die Aufnahmephase, die erste Phase im Ereignisablauf. FocusEvent Ein Objekt löst ein FocusEvent-Objekt aus, wenn der Benutzer den Fokus von einem Objekt in der Anzeigeliste zum Nächsten bewegt.Ereignisobjekte für Focus-Ereignisse. flash.events:Event Ein Objekt löst ein FocusEvent-Objekt aus, wenn der Benutzer den Fokus von einem Objekt in der Anzeigeliste zum Nächsten bewegt. Es gibt vier Arten von focus-Ereignissen:
  • FocusEvent.FOCUS_IN
  • FocusEvent.FOCUS_OUT
  • FocusEvent.KEY_FOCUS_CHANGE
  • FocusEvent.MOUSE_FOCUS_CHANGE
Im folgenden Beispiel wird anhand der Klassen FocusEventExample und CustomSprite gezeigt, wie Focus-Ereignisse im Zusammenhang mit Stage-Elementen zur Erfassung von Ereignis- und Druckinformationen verwendet werden können. In diesem Beispiel werden die folgenden Aufgaben ausgeführt:
  1. Die Eigenschaften child (vom Typ "Sprite") und childCount (vom Typ "uint") werden deklariert.
  2. Mit einer for-Schleife werden am Punkt (0,0) fünf hellblaue Quadrate gezeichnet. Zuerst wird einer neuen CustomSprite-Instanz die Eigenschaft child zugewiesen. Jedes Mal, wenn ein CustomSprite-Objekt erstellt wird, passiert Folgendes:
    • Die Eigenschaft size vom Typ "uint" wird auf 50 Pixel gesetzt, und bgColor wird auf hellblau gesetzt.
    • Die Eigenschaften buttonMode und useHandCursor der Klasse "Sprite" werden innerhalb des Konstruktors auf true gesetzt.
    • Es wird ein Ereignis-Listener vom Typ click zusammen mit dem verknüpften Abonnenten clickHandler() instanziiert. Die Abonnentenmethode erstellt eine lokale target-Variable vom Typ „Sprite“ und weist sie dem Feld zu, auf das geklickt wurde. Anschließend wird der Fokus der Bühne der Variablen target zugewiesen.
    • Die Methode draw() wird aufgerufen. Hierdurch wird ein 50 x 50 Pixel großes Quadrat mit den Methoden beginFill(), drawRect() und endFill() der Graphics-Klasse und der Instanzeigenschaften erstellt.
  3. In der „for“-Schleife wird die Methode configureListeners() aufgerufen, die drei Ereignis-Listener/-Abonnenten instanziiert:
    • focusIn/focusInHandler() wird ausgelöst, nachdem auf ein beliebiges Anzeigelistenobjekt (Feld) geklickt worden ist (click-Ereignis).
    • focusOut/focusOutHandler() wird ausgelöst, wenn auf ein anderes Feld geklickt wird oder die Bühne nicht mehr den Fokus besitzt (z. B., weil jemand außerhalb von Flash Player geklickt hat).
    • keyFocusChange/keyFocusChangeHandler() wird ausgelöst, wenn Sie mit der Tabulatortaste oder den Nach-links- und Nach-rechts-Pfeiltasten ein Anzeigelistenobjekt auswählen. Mit der keyFocusChangeHandler()-Methode werden die Aktionen der Nach-links- und Nach-rechts-Pfeiltasten überwacht. Außerdem wird die Methode preventDefault() zur Deaktivierung aufgerufen.
  4. In der for-Schleife wird jedes Quadrat der Anzeigeliste hinzugefügt und angezeigt (im gleichen Bereich). Hierfür kommt die Methode addChild() zum Einsatz.
  5. Der Konstruktor ruft anschließend die Methode refreshLayout() auf, mit der die orangefarbenen Quadrate mit jeweils 5 Pixel Abstand oben in der Anzeige (y = 0) verteilt werden.
package { import flash.display.Sprite; import flash.display.DisplayObject; import flash.events.FocusEvent; import flash.events.IEventDispatcher; public class FocusEventExample extends Sprite { private var gutter:uint = 5; private var childCount:uint = 5; public function FocusEventExample() { var child:Sprite; for(var i:uint; i < childCount; i++) { child = new CustomSprite(); configureListeners(child); addChild(child); } refreshLayout(); } private function configureListeners(dispatcher:IEventDispatcher):void { dispatcher.addEventListener(FocusEvent.FOCUS_IN, focusInHandler); dispatcher.addEventListener(FocusEvent.FOCUS_OUT, focusOutHandler); dispatcher.addEventListener(FocusEvent.KEY_FOCUS_CHANGE, keyFocusChangeHandler); dispatcher.addEventListener(FocusEvent.MOUSE_FOCUS_CHANGE, mouseFocusChangeHandler); } private function refreshLayout():void { var ln:uint = numChildren; var child:DisplayObject = getChildAt(0); var lastChild:DisplayObject = child; for(var i:uint = 1; i < ln; i++) { child = getChildAt(i); child.x = lastChild.x + lastChild.width + gutter; lastChild = child; } } private function focusInHandler(event:FocusEvent):void { var target:CustomSprite = CustomSprite(event.target); trace("focusInHandler: " + target.name); } private function focusOutHandler(event:FocusEvent):void { var target:CustomSprite = CustomSprite(event.target); trace("focusOutHandler: " + target.name); } private function keyFocusChangeHandler(event:FocusEvent):void { if(event.keyCode == 39 || event.keyCode == 37){ event.preventDefault() } var target:CustomSprite = CustomSprite(event.target); trace("keyFocusChangeHandler: " + target.name); } private function mouseFocusChangeHandler(event:FocusEvent):void { var target:CustomSprite = CustomSprite(event.target); trace("mouseFocusChangeHandler: " + target.name); } } } import flash.display.Sprite; import flash.events.MouseEvent; class CustomSprite extends Sprite { private var size:uint = 50; private var bgColor:uint = 0x00CCFF; public function CustomSprite() { buttonMode = true; useHandCursor = true; addEventListener(MouseEvent.CLICK, clickHandler); draw(size, size); } private function draw(w:uint, h:uint):void { graphics.beginFill(bgColor); graphics.drawRect(0, 0, w, h); graphics.endFill(); } private function clickHandler(event:MouseEvent):void { var target:Sprite = Sprite(event.target); trace("clickHandler: " + target.name); stage.focus = target; } }
focusInflash.events:FocusEvent:FOCUS_INflash.events:FocusEventflash.display.InteractiveObject.focusInfocusOutflash.events:FocusEvent:FOCUS_OUTflash.events:FocusEventflash.display.InteractiveObject.focusOutkeyFocusChangeflash.events:FocusEvent:KEY_FOCUS_CHANGEflash.events:FocusEventflash.display.InteractiveObject.keyFocusChangemouseFocusChangeflash.events:FocusEvent:MOUSE_FOCUS_CHANGEflash.events:FocusEventflash.display.InteractiveObject.mouseFocusChangeFocusEvent Erstellt ein Ereignisobjekt mit bestimmten Informationen, die für Fokus-Ereignisse wichtig sind.typeString Der Ereignistyp. Mögliche Werte sind: FocusEvent.FOCUS_IN, FocusEvent.FOCUS_OUT, FocusEvent.KEY_FOCUS_CHANGE und FocusEvent.MOUSE_FOCUS_CHANGE. bubblesBooleantrue Bestimmt, ob das Ereignisobjekt an der Bubbling-Phase des Ereignisablaufs teilnimmt. cancelableBooleanfalseBestimmt, ob das Ereignisobjekt abgebrochen werden kann. relatedObjectflash.display:InteractiveObjectnullGibt die andere InteractiveObject-Instanz an, die von dem Fokuswechsel betroffen ist. Wenn beispielsweise ein focusIn-Ereignis auftritt, stellt relatedObject das InteractiveObject dar, das den Fokus verloren hat. shiftKeyBooleanfalseGibt an, ob die Umschalttaste als Zusatztaste aktiviert ist. keyCodeuint0Gibt den Tastencodewert der Taste an, die zum Auslösen eines keyFocusChange-Ereignisses gedrückt wird. directionStringnoneGibt an, aus welcher Richtung das interaktive Zielobjekt aktiviert wurde. Hat den Wert FocusDirection.NONE (der Standardwert) für alle Ereignisse außer focusIn. Konstruktor für FocusEvent-Objekte. Erstellt ein Ereignisobjekt mit bestimmten Informationen, die für Fokus-Ereignisse wichtig sind. Ereignisobjekte werden Ereignis-Listenern als Parameter übergeben. FOCUS_INFOCUS_OUTKEY_FOCUS_CHANGEMOUSE_FOCUS_CHANGEflash.display.FocusDirectionclone Erstellt eine Kopie des FocusEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.Ein neues FocusEvent-Objekt mit Eigenschaftswerten, die denen des Originals entsprechen. flash.events:Event Erstellt eine Kopie des FocusEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht. toString Gibt eine Zeichenfolge zurück, die alle Eigenschaften des FocusEvent-Objekts enthält.Eine Zeichenfolge, die alle Eigenschaften des FocusEvent-Objekts enthält. String Gibt eine Zeichenfolge zurück, die alle Eigenschaften des FocusEvent-Objekts enthält. Der String liegt im folgenden Format vor:

[FocusEvent type=Wert bubbles=Wert cancelable=Wert relatedObject=Wert shiftKey=Wert] keyCode=Wert]

FOCUS_IN Definiert den Wert der Eigenschaft „type“ eines focusIn-Ereignisobjekts.focusInString Definiert den Wert der Eigenschaft type eines focusIn-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblestruecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.keyCode0; gilt nur für keyFocusChange-Ereignisse.relatedObjectDie andere InteractiveObject-Instanz, die von dem Fokuswechsel betroffen ist.shiftKeyfalse; gilt nur für keyFocusChange-Ereignisse.targetDie InteractiveObject-Instanz, die gerade den Fokus erhalten hat. Das unter target angegebene Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet. directionDie Richtung, aus der der Fokus zugewiesen wurde. Diese Eigenschaft meldet den Wert des direction-Parameters der assignFocus()-Methode auf der Bühne. Wird der Fokus durch andere Mittel geändert, ist der Wert immer FocusDirection.NONE. Gilt nur für focusIn-Ereignisse. Für alle anderen focus-Ereignisse ist der Wert FocusDirection.NONE.
flash.display.InteractiveObject.focusIn
FOCUS_OUT Definiert den Wert der Eigenschaft „type“ eines focusOut-Ereignisobjekts.focusOutString Definiert den Wert der Eigenschaft type eines focusOut-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblestruecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.keyCode0; gilt nur für keyFocusChange-Ereignisse.relatedObjectDie andere InteractiveObject-Instanz, die von dem Fokuswechsel betroffen ist.shiftKeyfalse; gilt nur für keyFocusChange-Ereignisse.targetDie InteractiveObject-Instanz, die gerade den Fokus verloren hat. Das unter target angegebene Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet.
flash.display.InteractiveObject.focusOut
KEY_FOCUS_CHANGE Definiert den Wert der Eigenschaft „type“ eines keyFocusChange-Ereignisobjekts.keyFocusChangeString Definiert den Wert der Eigenschaft type eines keyFocusChange-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblestruecancelabletrue; rufen Sie die Methode preventDefault() auf, um das Standardverhalten abzubrechen.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.keyCodeDer Tastencodewert der Taste, die zum Auslösen eines keyFocusChange-Ereignisses gedrückt wird.relatedObjectDie andere InteractiveObject-Instanz, die von dem Fokuswechsel betroffen ist.shiftKeytrue, wenn die Umschalttaste als Zusatztaste aktiviert ist, andernfalls false.targetDie InteractiveObject-Instanz, die gerade den Fokus besitzt. Das unter target angegebene Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet.
flash.display.InteractiveObject.keyFocusChange
MOUSE_FOCUS_CHANGE Definiert den Wert der Eigenschaft „type“ eines mouseFocusChange-Ereignisobjekts.mouseFocusChangeString Definiert den Wert der Eigenschaft type eines mouseFocusChange-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblestruecancelabletrue; rufen Sie die Methode preventDefault() auf, um das Standardverhalten abzubrechen.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.keyCode0; gilt nur für keyFocusChange-Ereignisse.relatedObjectDie andere InteractiveObject-Instanz, die von dem Fokuswechsel betroffen ist.shiftKeyfalse; gilt nur für keyFocusChange-Ereignisse.targetDie InteractiveObject-Instanz, die gerade den Fokus besitzt. Das unter target angegebene Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet.
flash.display.InteractiveObject.mouseFocusChange
direction Gibt die Richtung des Fokus für ein focusIn-Ereignis an.String Gibt die Richtung des Fokus für ein focusIn-Ereignis an. flash.display.FocusDirectionflash.display.Stage.assignFocus()isRelatedObjectInaccessible Falls „true“, ist die relatedObject-Eigenschaft aus Gründen, die mit der Sicherheitssandbox zusammenhängen, auf null gesetzt.Boolean Wenn true, ist die relatedObject-Eigenschaft aus Gründen, die mit der Sicherheitssandbox zusammenhängen, auf null gesetzt. Ist der Nominalwert von relatedObject ein Verweis auf ein DisplayObject in einer anderen Sandbox, wird relatedObject auf null gesetzt, es sei denn, die Berechtigung gilt über die Sandboxgrenzen hinweg für beide Richtungen. Die Berechtigung wird eingerichtet, indem aus einer SWF-Datei Security.allowDomain() aufgerufen wird oder eine Richtliniendatei vom Server einer Bilddatei bereitgestellt und die LoaderContext.checkPolicyFile-Eigenschaft beim Laden des Bilds gesetzt wird. FocusEvent.relatedObjectSecurity.allowDomain()LoaderContext.checkPolicyFilekeyCode Der Tastencodewert der Taste, die zum Auslösen eines „keyFocusChange“-Ereignisses gedrückt wird.uint Der Tastencodewert der Taste, die zum Auslösen eines keyFocusChange-Ereignisses gedrückt wird. relatedObject Ein Verweis auf die andere InteractiveObject-Instanz, die von dem Fokuswechsel betroffen ist.flash.display:InteractiveObject Ein Verweis auf die andere InteractiveObject-Instanz, die von dem Fokuswechsel betroffen ist. Wenn beispielsweise ein focusOut-Ereignis auftritt, stellt relatedObject die InteractiveObject-Instanz dar, die den Fokus erhalten hat.

Der Wert dieser Eigenschaft kann in zwei Fällen null sein: Wenn es kein verwandtes Objekt gibt oder wenn es eines gibt, dieses aber eine Sicherheitssandbox ist, auf die Sie keinen Zugriff haben. Verwenden Sie die isRelatedObjectInaccessible()-Eigenschaft, um festzustellen, welcher dieser Gründe zutrifft.

FocusEvent.isRelatedObjectInaccessible
shiftKey Gibt an, ob die Umschalttaste als Zusatztaste aktiviert ist. In diesem Fall lautet der Wert „true“.Boolean Gibt an, ob die Umschalttaste als Zusatztaste aktiviert ist. In diesem Fall lautet der Wert true. Andernfalls ist der Wert false. Diese Eigenschaft wird nur dann verwendet, wenn „FocusEvent“ den Typ keyFocusChange hat.
GesturePhase Die GesturePhase-Klasse ist eine Aufzählungsklasse von Konstantenwerten zur Verwendung mit der GestureEvent-, PressAndTapGestureEvent- und TransformGestureEvent-Klasse.Object Die GesturePhase-Klasse ist eine Aufzählungsklasse von Konstantenwerten zur Verwendung mit der GestureEvent-, PressAndTapGestureEvent- und TransformGestureEvent-Klasse. Verwenden Sie diese Werte, um den Anfang, den Fortschritt und das Ende einer Berührungsgeste (zum Beispiel das Bewegen von mehreren Fingern über einen Touchscreen), damit Ihre Anwendung auf die einzelnen Phasen der Benutzerberührung reagieren kann. Einige Gesten (Swipe- und Zwei-Finger-Tipp-Gesten) haben nur eine Phase und setzen die phase-Eigenschaft des Ereignisobjekts auf all. Die folgenden Beispiele zeigen die Ereignisverarbeitung für GESTURE_ROTATE-Ereignisse. Während der Benutzer eine Drehgeste auf dem berührungsempfindlichen Gerät ausführt, dreht sich mySprite und in myTextField wird die aktuelle Phase angezeigt. Multitouch.inputMode = MultitouchInputMode.GESTURE; var mySprite = new Sprite(); mySprite.addEventListener(TransformGestureEvent.GESTURE_ROTATE , onRotate ); mySprite.graphics.beginFill(0x336699); mySprite.graphics.drawRect(0, 0, 100, 80); var myTextField = new TextField(); myTextField.y = 200; addChild(mySprite); addChild(myTextField); function onRotate(evt:TransformGestureEvent):void { evt.target.rotation -= 45; if (evt.phase==GesturePhase.BEGIN) { myTextField.text = "Begin"; } if (evt.phase==GesturePhase.UPDATE) { myTextField.text = "Update"; } if (evt.phase==GesturePhase.END) { myTextField.text = "End"; } } flash.events.GestureEventflash.events.TransformGestureEventflash.events.PressAndTapGestureEventALL Ein einzelner Wert, der alle Phasen einfacher Gesten wie Zwei-Finger-Tipp- oder Swipe-Gesten umfasst.allString Ein einzelner Wert, der alle Phasen einfacher Gesten wie Zwei-Finger-Tipp- oder Swipe-Gesten umfasst. Bei Gesten, die die phase-Eigenschaft des Ereignisobjekts auf all setzen (Swipe- und Zwei-Finger-Tipp-Gesten), ist der phase-Wert immer all, nachdem das Ereignis abgesetzt wurde. flash.events.GestureEventflash.events.TransformGestureEventflash.events.PressAndTapGestureEventBEGIN Der Anfang einer neuen Geste (zum Beispiel das Aufsetzen eines Fingers auf einen Touchscreen).beginString Der Anfang einer neuen Geste (zum Beispiel das Aufsetzen eines Fingers auf einen Touchscreen). flash.events.GestureEventflash.events.TransformGestureEventflash.events.PressAndTapGestureEventEND Der Abschluss einer Geste (zum Beispiel das Heben eines Fingers von einem Touchscreen).endString Der Abschluss einer Geste (zum Beispiel das Heben eines Fingers von einem Touchscreen). flash.events.GestureEventflash.events.TransformGestureEventflash.events.PressAndTapGestureEventUPDATE Der Fortschritt einer Geste (zum Beispiel das Bewegen eines Fingers über einen Touchscreen).updateString Der Fortschritt einer Geste (zum Beispiel das Bewegen eines Fingers über einen Touchscreen). flash.events.GestureEventflash.events.TransformGestureEventflash.events.PressAndTapGestureEventBrowserInvokeEvent Das NativeApplication-Objekt einer AIR-Anwendung löst ein browserInvoke-Ereignis aus, wenn die Anwendung durch eine SWF-Datei im Browser mit der Browseraufruffunktion aufgerufen wurde.Wird vom NativeApplication-Objekt abgesetzt, wenn eine AIR-Anwendung über einen Webbrowser aufgerufen wird. flash.events:Event Das NativeApplication-Objekt einer AIR-Anwendung löst ein browserInvoke-Ereignis aus, wenn die Anwendung durch eine SWF-Datei im Browser mit der Browseraufruffunktion aufgerufen wurde. Das NativeApplication-Objekt löst ein browserInvoke-Ereignis auch dann aus, wenn ein Benutzer die nahtlose Installationsfunktion im Browser instanziiert und die SWF-Datei im Browser ein Array an den arguments-Parameter der launchApplication()-Methode der „air.swf“-Datei übergibt. (Weitere Informationen finden Sie unter „Verteilen, Installieren und Ausführen von AIR-Anwendungen“ im AIR-Entwicklerhandbuch.)

Der Aufruf durch den Browser ist nur dann zulässig, wenn in der Anwendungsdeskriptordatei einer Anwendung Folgendes angegeben ist:

<allowBrowserInvocation>true</allowBrowserInvocation>

Wenn die Anwendung nicht ausgeführt wird, löst das NativeApplication-Objekt ein InvokeEvent-Ereignis und ein browserInvoke-Ereignis aus, wenn der Aufruf über den Browser erfolgt. Andernfalls, wenn die Anwendung bereits ausgeführt wird, löst das NativeApplication-Objekt nur ein browserInvoke-Ereignis aus, wenn der Aufruf über den Browser erfolgt.

Wenn die Anwendung als Ergebnis einer nahtlosen Installation vom Browser aufgerufen wird (wenn der Benutzer sich für den sofortigen Start nach der Installation entschieden hat), löst das NativeApplication-Objekt ein BrowserInvoke-Ereignis nur dann aus, wenn Argumente übergeben werden (über die SWF-Datei im Browser, die ein Array an den arguments-Parameter der installApplication()-Methode der „air.swf“-Datei übergibt). Weitere Informationen finden Sie unter „Verteilen, Installieren und Ausführen von AIR-Anwendungen“ im AIR-Entwicklerhandbuch.

Wie auch das invokeEvent-Ereignis werden browserInvokeEvent-Ereignisse vom NativeApplication-Objekt (NativeApplication.nativeApplication) ausgelöst. Um browserInvoke-Ereignisse zu erhalten, rufen Sie die addEventListener()-Methode des NativeApplication-Objekts auf. Wenn ein Ereignis-Listener für ein browserInvoke-Ereignis registriert wird, empfängt er auch alle browserInvoke-Ereignisse, die vor der Registrierung aufgetreten sind. Diese werden nach der Rückgabe des Aufrufs von addEventListener() ausgelöst, jedoch nicht unbedingt vor anderen browserInvoke-Ereignissen, die möglicherweise nach der Registrierung empfangen wurden. Auf diese Weise können Sie browserInvoke-Ereignisse verarbeiten, die aufgetreten sind, bevor Ihr Initialisierungscode ausgeführt wurde (zum Beispiel wenn die Anwendung ursprünglich über den Browser aufgerufen wurde). Denken Sie daran, dass beim Hinzufügen eines Ereignis-Listeners zu einem späteren Zeitpunkt während der Ausführung (nach der Initialisierung der Anwendung) dieser alle browserInvoke-Ereignisse empfängt, die seit dem Starten der Anwendung aufgetreten sind.

flash.events.InvokeEventflash.desktop.NativeApplicationinvokeflash.events:BrowserInvokeEvent:BROWSER_INVOKEflash.events:BrowserInvokeEventflash.desktop.NativeApplicationBrowserInvokeEvent Die Konstruktorfunktion für die BrowserInvokeEvent-Klasse.typeStringDer Typ des Ereignisses, auf den als Event.type zugegriffen werden kann. bubblesBooleanEinstellung false für ein BrowserInvokeEvent-Objekt. cancelableBooleanEinstellung false für ein BrowserInvokeEvent-Objekt. argumentsArrayEin Array von Argumenten (Strings), die an die Anwendung zu übergeben sind. sandboxTypeStringDer Sandbox-Typ für den Browserinhalt. securityDomainStringDie Sicherheitsdomäne für den Browserinhalt. isHTTPSBooleanOb der Browserinhalt das HTTPS-URL-Schema verwendet. isUserEventBooleanOb der Browseraufruf das Ergebnis eines Benutzerereignisses war. Die Konstruktorfunktion für die BrowserInvokeEvent-Klasse. Im Allgemeinen rufen Entwickler den BrowserInvokeEvent()-Konstruktor nicht direkt auf. Nur die Laufzeitumgebung sollte ein BrowserInvokeEvent-Objekt erstellen. clone Erstellt eine neue Kopie dieses Ereignisses.Die Kopie des Ereignisses. flash.events:Event Erstellt eine neue Kopie dieses Ereignisses. BROWSER_INVOKE Die BrowserInvokeEvent.BROWSER_INVOKE-Konstante definiert den Wert der type-Eigenschaft eines BrowserInvokeEvent-Objekts.browserInvokeString Die BrowserInvokeEvent.BROWSER_INVOKE-Konstante definiert den Wert der type-Eigenschaft eines BrowserInvokeEvent-Objekts.

Das BrowserInvokeEvent-Ereignisobjekt hat folgende Eigenschaften:

EigenschaftenWerteArgumentsDas Array von Stringargumenten, die während dieses Aufrufs übergeben werden.sandBoxTypeEin String, der den Sandboxtyp für den Browserinhalt angibt (Security.APPLICATION, Security.LOCAL_TRUSTED, Security.LOCAL_WITH_FILE, Security.LOCAL_LOCAL_WITH_NETWORK oder Security.REMOTE).securityDomainEin String, der die Sicherheitsdomäne des Browsers angibt (zum Beispiel "www.example.com").isHTTPSOb der Browserinhalt das HTTPS-URL-Schema verwendet (true) oder nicht (false)isUserEventOb der Browseraufruf aus einem Benutzerereignis resultiert (in AIR 1.0 immer true).bubblesNein.cancelablefalse; es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetGibt das Objekt an, welches das InvokeEvent -Objekt aktiv mit einem Ereignis-Listener verarbeitet.targetImmer das NativeApplication-Objekt.
flash.desktop.NativeApplication
arguments Ein Array von Argumenten (Strings), die an die Anwendung zu übergeben sind.Array Ein Array von Argumenten (Strings), die an die Anwendung zu übergeben sind. isHTTPS Ob der Browserinhalt das HTTPS-URL-Schema verwendet (true) oder nicht (false).Boolean Ob der Browserinhalt das HTTPS-URL-Schema verwendet (true) oder nicht (false). isUserEvent Ob der Browseraufruf in einem Benutzerereignis resultiert (z. B. Mausklick).Boolean Ob der Browseraufruf in einem Benutzerereignis resultiert (z. B. Mausklick). In AIR 1.0 ist dies immer auf true gesetzt; AIR benötigt ein Benutzerereignis für die Initiierung des Aufrufs der Browseraufruffunktion. sandboxType Der Sandbox-Typ für den Browserinhalt.String Der Sandbox-Typ für den Browserinhalt. Dieser Parameter kann auf einen der folgenden Werte eingestellt sein:
  • Security.APPLICATION – Der Inhalt befindet sich in der Sicherheits-Sandbox der Anwendung.
  • Security.LOCAL_TRUSTED: Der Inhalt befindet sich in der lokalen vertrauenswürdigen Sicherheitssandbox.
  • Security.LOCAL_WITH_FILE – Der Inhalt befindet sich in der local-with-filesystem-Sicherheits-Sandbox.
  • Security.LOCAL_WITH_NETWORK – Der Inhalt befindet sich in der local-with-networking-Sicherheits-Sandbox.
  • Security.REMOTE – Der Inhalt befindet sich in einer Remote(-Netzwerk)-Domäne.
flash.system.Security.sandboxType
securityDomain Die Sicherheitsdomäne für den Browserinhalt, zum Beispiel „www.adobe.com“ oder „www.example.org“.String Die Sicherheitsdomäne für den Browserinhalt, zum Beispiel www.adobe.com oder www.example.org. Diese Eigenschaft wird nur für Inhalte in der Remote-Sicherheitssandbox (für Inhalte in einer Netzwerkdomäne) eingestellt, nicht für Inhalte in einer lokalen Sicherheitssandbox oder in der Sicherheitssandbox der Anwendung.
OutputProgressEvent Ein FileStream-Objekt löst OutputProgressEvent-Objekte aus, wenn ausstehende asynchrone Dateischreibvorgänge ausgeführt werden.Ereignisobjekte für Ausgabefortschrittereignisse (für asynchrone Dateischreibvorgänge). flash.events:Event Ein FileStream-Objekt löst OutputProgressEvent-Objekte aus, wenn ausstehende asynchrone Dateischreibvorgänge ausgeführt werden. Es gibt nur einen Typ Ausgabefortschrittereignis: OutputProgressEvent.OUTPUT_PROGRESS. flash.filesystem.FileStreamoutputProgressflash.events:OutputProgressEvent:OUTPUT_PROGRESSflash.events:OutputProgressEventflash.filesystem.FileStreamOutputProgressEvent Erstellt ein Ereignisobjekt, das Informationen über Ausgabefortschrittereignisse enthält.typeString Der Ereignistyp. Es gibt nur einen Fehlerereignistyp: OutputProgressEvent.OUTPUT_PROGRESS. bubblesBooleanfalse Bestimmt, ob das Ereignisobjekt an der Bubbling-Phase des Ereignisablaufs teilnimmt. cancelableBooleanfalseBestimmt, ob das Ereignisobjekt abgebrochen werden kann. bytesPendingNumber0Die Anzahl der noch nicht geschriebenen Byte. bytesTotalNumber0Die Gesamtzahl der Byte, die geschrieben wurden oder deren Schreiben noch ausstehend ist. Konstruktor für OutputProgressEvent-Objekte. Erstellt ein Ereignisobjekt, das Informationen über Ausgabefortschrittereignisse enthält. Ereignisobjekte werden Ereignis-Listenern als Parameter übergeben. clone Erstellt eine Kopie des OutputProgressEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.Ein neues OutputProgressEvent-Objekt mit Eigenschaftswerten, die denen des Originals entsprechen. flash.events:Event Erstellt eine Kopie des OutputProgressEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht. toString Gibt einen String zurück, der alle Eigenschaften des OutputProgressEvent-Objekts enthält. Ein String, der alle Eigenschaften des OutputProgressEvent-Objekts enthält. String Gibt einen String zurück, der alle Eigenschaften des OutputProgressEvent-Objekts enthält. Der String liegt im folgenden Format vor:

[OutputProgressEvent type=Wert bubbles=Wert cancelable=Wert eventPhase=Wert bytesPending=Wert bytesTotal=Wert]

OUTPUT_PROGRESS Definiert den Wert der type-Eigenschaft eines outputProgress-Ereignisobjekts.outputProgressString Definiert den Wert der type-Eigenschaft eines outputProgress-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertbubblesfalsebytesPendingDie Anzahl der verbleibenden Byte, die noch geschrieben werden müssen, zum Zeitpunkt der Verarbeitung des Ereignisses durch den Listener.bytesTotalDie Gesamtanzahl der Byte, die bei einem erfolgreichen Schreibvorgang schließlich geschrieben werden.cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.targetDer Protokollierungsstatus des FileStream-Objekts.
flash.filesystem.FileStream
bytesPending Die Anzahl der Byte, die noch nicht geschrieben sind, während der Listener das Ereignis verarbeitet.Number Die Anzahl der Byte, die noch nicht geschrieben sind, während der Listener das Ereignis verarbeitet. bytesTotal Die Gesamtzahl der bisher geschriebenen Byte plus die Anzahl der noch zu schreibenden Byte.Number Die Gesamtzahl der bisher geschriebenen Byte plus die Anzahl der noch zu schreibenden Byte.
StageOrientationEvent Ein Stage-Objekt setzt ein StageOrientationEvent-Objekt ab, wenn die Ausrichtung der Bühne geändert wird.flash.events:Event Ein Stage-Objekt setzt ein StageOrientationEvent-Objekt ab, wenn die Ausrichtung der Bühne geändert wird. Dazu kann es kommen, wenn das Gerät gedreht wird, wenn der Benutzer eine herausschiebbare Tastatur öffnet, oder wenn die setAspectRatio()-Methode des Stage-Objekts aufgerufen wird.

Es gibt zwei Typen des StageOrientationEvent-Ereignisses: orientationChanging (StageOrientationEvent.ORIENTATION_CHANGING) wird abgesetzt, bevor sich der Bildschirm zu einer neuen Ausrichtung wechselt. Das Aufrufen der preventDefault()-Methode des Ereignisobjekts, das für orientationChanging abgesetzt wird, verhindert, dass die Bühne ihre Ausrichtung ändert. orientationChange (StageOrientationEvent.ORIENTATION_CHANGE) wird abgesetzt, nachdem der Bildschirm zu einer neuen Ausrichtung gewechselt ist.

Hinweis: Wenn die autoOrients-Eigenschaft den Wert false hat, ändert sich die Bühnenausrichtung beim Drehen des Geräts nicht. StageOrientationEvents für die Gerätedrehung wird also nur dann abgesetzt, wenn autoOrients den Wert true hat.

Stage.deviceOrientationStage.autoOrientsorientationChangeflash.events:StageOrientationEvent:ORIENTATION_CHANGEflash.events:StageOrientationEventflash.display.StagedeviceOrientationStageOrientationEvent Erstellt ein StageOrientationEvent-Objekt mit spezifischen Informationen, die für Bühnenausrichtungs-Ereignisse relevant sind.typeString Der Ereignistyp: StageOrientationEvent.ORIENTATION_CHANGE bubblesBooleanfalse Gibt an, ob das Ereignisobjekt an der Bubbling-Phase des Ereignisablaufs beteiligt ist. cancelableBooleanfalseGibt an, ob das Ereignisobjekt abgebrochen werden kann. beforeOrientationStringnullGibt die Ausrichtung vor der Änderung an. afterOrientationStringnullGibt die Ausrichtung nach der Änderung an. Erstellt ein StageOrientationEvent-Objekt mit spezifischen Informationen, die für Bühnenausrichtungs-Ereignisse relevant sind. Ereignisobjekte werden Ereignis-Listenern als Parameter übergeben. Im Allgemeinen brauchen Sie dieses Ereignis nicht mit der Konstruktorfunktion zu erstellen. Stattdessen fügen Sie einen Ereignis-Listener für das Stage-Objekt hinzu, um diese Ereignisse zu erkennen, wenn sie auftreten. clone Erstellt eine Kopie des StageOrientationEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.Ein neues StageOrientationEvent-Objekt mit Eigenschaftswerten, die denen des Originals entsprechen. flash.events:Event Erstellt eine Kopie des StageOrientationEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht. toString Gibt einen String zurück, der alle Eigenschaften des StageOrientationEvent-Objekts enthält.Ein String, der alle Eigenschaften des StageOrientationEvent-Objekts enthält. String Gibt einen String zurück, der alle Eigenschaften des StageOrientationEvent-Objekts enthält. Der String hat das folgende Format:

[StageOrientationEvent type=Wert bubbles=Wert cancelable=Wert beforeDisplayState=Wert afterDisplayState=Wert]

ORIENTATION_CHANGE Die ORIENTATION_CHANGE-Konstante definiert den Wert der type-Eigenschaft eines orientationChange-Ereignisobjekts.orientationChangeString Die ORIENTATION_CHANGE-Konstante definiert den Wert der type-Eigenschaft eines orientationChange-Ereignisobjekts. Dieses Ereignis verfügt über die folgenden Eigenschaften: EigenschaftenWerteafterOrientationDie neue Ausrichtung der Bühne.beforeOrientationDie alte Ausrichtung der Bühne.targetDas Stage-Objekt, das die Ausrichtungsänderung abgesetzt hat. bubblestruecurrentTargetGibt das Objekt an, das das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.cancelablefalse; es ist zu spät, um die Änderung abzubrechen. flash.display.StagedeviceOrientationORIENTATION_CHANGING Die ORIENTATION_CHANGING-Konstante definiert den Wert der type-Eigenschaft eines orientationChanging-Ereignisobjekts.orientationChangingString Die ORIENTATION_CHANGING-Konstante definiert den Wert der type-Eigenschaft eines orientationChanging-Ereignisobjekts.

Wichtig: ORIENTATION_CHANGING-Ereignisse werden bei Android-Geräten nicht abgesetzt.

Dieses Ereignis verfügt über die folgenden Eigenschaften: EigenschaftenWerteafterOrientationDie neue Ausrichtung der Bühne.beforeOrientationDie alte Ausrichtung der Bühne.targetDas Stage-Objekt, das die Ausrichtungsänderung abgesetzt hat. bubblestruecurrentTargetGibt das Objekt an, das das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.cancelabletrue.
afterOrientation Die Ausrichtung der Bühne nach der Änderung.String Die Ausrichtung der Bühne nach der Änderung. beforeOrientation Die Ausrichtung der Bühne vor der Änderung.String Die Ausrichtung der Bühne vor der Änderung.
ActivityEvent Eine Kamera oder ein Mikrofon sendet ein ActivityEvent-Objekt, wenn eine Kamera oder ein Mikrofon meldet, dass sie bzw. es aktiviert oder deaktiviert wurde.Ereignisobjekte für ActivityEvent-Ereignisse. flash.events:Event Eine Kamera oder ein Mikrofon sendet ein ActivityEvent-Objekt, wenn eine Kamera oder ein Mikrofon meldet, dass sie bzw. es aktiviert oder deaktiviert wurde. Es gibt nur einen Typ eines activity-Ereignisses: ActivityEvent.ACTIVITY. Im folgenden Beispiel wird die Verwendung der ActivityEvent-Klasse demonstriert. Dem Mikrofon wird die Ereignis-Listener-Methode activityHandler() zugewiesen, und es wird immer Text generiert, wenn das Mikrofon ein activity-Ereignis auslöst. package { import flash.display.Sprite; import flash.events.ActivityEvent; import flash.media.Microphone; public class ActivityEventExample extends Sprite { public function ActivityEventExample() { var mic:Microphone = Microphone.getMicrophone(); mic.addEventListener(ActivityEvent.ACTIVITY, activityHandler); } private function activityHandler(event:ActivityEvent):void { trace("event: " + event); trace("event.activating: " + event.activating); } } } ActivityEvent.ACTIVITYactivityflash.events:ActivityEvent:ACTIVITYflash.events:ActivityEventflash.media.Camera.activityflash.media.Microphone.activityActivityEvent Erstellt ein Ereignisobjekt, das Informationen über Aktivitätsereignisse enthält.typeString Der Ereignistyp. Ereignis-Listener können über die übernommene Eigenschaft type auf diese Informationen zugreifen. Es gibt nur einen Typ eines activity-Ereignisses: ActivityEvent.ACTIVITY. bubblesBooleanfalseLegt fest, ob das Ereignisobjekt an der Bubbling-Phase des Ereignisablaufs teilnimmt. Ereignis-Listener können über die übernommene Eigenschaft bubbles auf diese Informationen zugreifen. cancelableBooleanfalseBestimmt, ob das Ereignisobjekt abgebrochen werden kann. Ereignis-Listener können über die übernommene Eigenschaft cancelable auf diese Informationen zugreifen. activatingBooleanfalseGibt an, ob das Gerät aktiviert (true) oder deaktiviert (false) wird. Ereignis-Listener können über die Eigenschaft activating auf diese Informationen zugreifen. Konstruktor für ActivityEvent-Objekte. Erstellt ein Ereignisobjekt, das Informationen über Aktivitätsereignisse enthält. Ereignisobjekte werden Ereignis-Listenern als Parameter übergeben. ActivityEvent.ACTIVITYclone Erstellt eine Kopie des ActivityEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.Ein neues ActivityEvent-Objekt mit Eigenschaftswerten, die denen des Originals entsprechen. flash.events:Event Erstellt eine Kopie des ActivityEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht. toString Gibt eine Zeichenfolge zurück, die alle Eigenschaften des ActivityEvent-Objekts enthält.Eine Zeichenfolge, die alle Eigenschaften des ActivityEvent-Objekts enthält. String Gibt eine Zeichenfolge zurück, die alle Eigenschaften des ActivityEvent-Objekts enthält. Das folgende Format wird verwendet:

[ActivityEvent type=Wert bubbles=Wert cancelable=Wert activating=Wert]

ACTIVITY Die Konstante ActivityEvent.ACTIVITY definiert den Wert der type-Eigenschaft eines Aktivitätsereignisobjekts.activityString Die Konstante ActivityEvent.ACTIVITY definiert den Wert der type-Eigenschaft eines activity-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWertactivatingtrue, wenn das Gerät aktiviert wird, oder false, wenn es deaktiviert wird.bubblesfalsecancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.targetDas Objekt, mit dem eine Sitzung gestartet oder beendet wird, z. B. ein Camera- oder Microphone-Objekt.
flash.media.Camera.activityflash.media.Microphone.activity
activating Gibt an, ob das Gerät aktiviert (true) oder deaktiviert (false) wird.Boolean Gibt an, ob das Gerät aktiviert (true) oder deaktiviert (false) wird.