Paket | flash.events |
Klasse | public class ErrorEvent |
Vererbung | ErrorEvent TextEvent Event Object |
Unterklassen | AsyncErrorEvent, AugmentedErrorEvent, DownloadErrorEvent, DRMAuthenticationErrorEvent, DRMDeviceGroupErrorEvent, DRMErrorEvent, DRMReturnVoucherErrorEvent, IOErrorEvent, RSLErrorEvent, SecurityErrorEvent, SkinErrorEvent, SQLErrorEvent, StatusFileUpdateErrorEvent, StatusUpdateErrorEvent, UncaughtErrorEvent |
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 9, AIR 1.0, Flash Lite 4 |
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.
Verwandte API-Elemente
Eigenschaft | Definiert von | ||
---|---|---|---|
bubbles : Boolean [schreibgeschützt]
Gibt an, ob es sich bei dem Ereignis um ein Bubbling-Ereignis handelt. | Event | ||
cancelable : Boolean [schreibgeschützt]
Gibt an, ob das mit dem Ereignis verknüpfte Verhalten verhindert werden kann. | Event | ||
constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | ||
currentTarget : Object [schreibgeschützt]
Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. | Event | ||
errorID : int [schreibgeschützt]
Enthält die Verweisnummer, die dem spezifischen Fehler zugeordnet ist. | ErrorEvent | ||
eventPhase : uint [schreibgeschützt]
Die aktuelle Phase im Ereignisablauf. | Event | ||
target : Object [schreibgeschützt]
Das Ereignis-Ziel. | Event | ||
text : String
Bei einem textInput-Ereignis das bzw. die vom Benutzer eingegebene(n) Zeichen. | TextEvent | ||
type : String [schreibgeschützt]
Der Ereignistyp. | Event |
Methode | Definiert von | ||
---|---|---|---|
ErrorEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, text:String = "", id:int = 0)
Erstellt ein Ereignisobjekt, das Informationen über Fehlerereignisse enthält. | ErrorEvent | ||
[override]
Erstellt eine Kopie des ErrorEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht. | ErrorEvent | ||
Eine Dienstprogrammfunktion zur Implementierung der toString()-Methode in benutzerdefinierten ActionScript 3.0 Event-Klassen. | Event | ||
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | ||
Überprüft, ob die preventDefault()-Methode bei dem Ereignis aufgerufen wurde. | Event | ||
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | ||
Bricht das Standardverhalten eines Ereignisses ab, wenn dieses Verhalten abgebrochen werden kann. | Event | ||
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | ||
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | ||
Verhindert die Verarbeitung von Ereignis-Listenern im aktuellen Knoten und in Knoten, die dem aktuellen Knoten im Ereignisablauf nachfolgen. | Event | ||
Verhindert die Verarbeitung von Ereignis-Listenern in Knoten, die dem aktuellen Knoten im Ereignisablauf nachfolgen. | Event | ||
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | ||
[override]
Gibt eine Zeichenfolge zurück, die alle Eigenschaften des ErrorEvent-Objekts enthält. | ErrorEvent | ||
Gibt den Grundwert des angegebenen Objekts zurück. | Object |
Konstante | Definiert von | ||
---|---|---|---|
ERROR : String = "error" [statisch]
Definiert den Wert der Eigenschaft „type“ eines error-Ereignisobjekts. | ErrorEvent |
errorID | Eigenschaft |
errorID:int
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 10.1 |
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.
Implementierung
public function get errorID():int
ErrorEvent | () | Konstruktor |
public function ErrorEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, text:String = "", id:int = 0)
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Erstellt ein Ereignisobjekt, das Informationen über Fehlerereignisse enthält. Ereignisobjekte werden Ereignis-Listenern als Parameter übergeben.
Parametertype:String — Der Ereignistyp. Ereignis-Listener können über die übernommene Eigenschaft type auf diese Informationen zugreifen. Es gibt nur einen Typ eines Fehlerereignisses: ErrorEvent.ERROR .
| |
bubbles:Boolean (default = false ) — Legt fest, ob das Ereignisobjekt eine Bubbling-Phase durchführt. Ereignis-Listener können über die übernommene Eigenschaft bubbles auf diese Informationen zugreifen.
| |
cancelable:Boolean (default = false ) — Bestimmt, ob das Ereignisobjekt abgebrochen werden kann. Ereignis-Listener können über die übernommene Eigenschaft cancelable auf diese Informationen zugreifen.
| |
text:String (default = " ") — Der als Fehlermeldung anzuzeigende Text. Ereignis-Listener können über die Eigenschaft text auf diese Informationen zugreifen.
| |
id:int (default = 0 ) — Eine mit dem spezifischen Fehler verknüpfte Referenznummer (wird nur in Adobe AIR unterstützt).
|
clone | () | Methode |
override public function clone():Event
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Erstellt eine Kopie des ErrorEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.
RückgabewerteEvent — Ein neues ErrorEvent-Objekt mit Eigenschaftswerten, die denen des Originals entsprechen.
|
toString | () | Methode |
override public function toString():String
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 9, AIR 1.0, Flash Lite 4 |
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.
String — Eine Zeichenfolge, die alle Eigenschaften des ErrorEvent-Objekts enthält.
|
ERROR | Konstante |
public static const ERROR:String = "error"
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Definiert den Wert der Eigenschaft type
eines error
-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
Eigenschaft | Wert |
---|---|
bubbles | false |
cancelable | false . Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
target | Das Objekt, bei dem der Netzwerkvorgang fehlschlägt. |
text | Der als Fehlermeldung anzuzeigende Text. |
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(); } } } }
Tue Jun 12 2018, 10:04 AM Z