Pakiet | flash.events |
Klasa | public class ErrorEvent |
Dziedziczenie | ErrorEvent TextEvent Event Object |
Podklasy | AsyncErrorEvent, AugmentedErrorEvent, DownloadErrorEvent, DRMAuthenticationErrorEvent, DRMDeviceGroupErrorEvent, DRMErrorEvent, DRMReturnVoucherErrorEvent, IOErrorEvent, RSLErrorEvent, SecurityErrorEvent, SkinErrorEvent, SQLErrorEvent, StatusFileUpdateErrorEvent, StatusUpdateErrorEvent, UncaughtErrorEvent |
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Klasa ErrorEvent definiuje tylko jeden typ zdarzenia error
: ErrorEvent.ERROR
. Klasa ErrorEvent jest również klasą bazową dla kilku innych klas zdarzeń błędów, w tym dla klas: AsyncErrorEvent, IOErrorEvent, SecurityErrorEvent, SQLErrorEvent i UncaughtErrorEvent.
Aby wykrywać zdarzenia error
, dla których nie zarejestrowano żadnych detektorów, można zarejestrować detektor zdarzenia uncaughtError
(UncaughtErrorEvent.UNCAUGHT_ERROR).
Nieprzechwycony błąd powoduje także wyświetlenie okna dialogowego z informacją o zdarzeniu błędu, gdy treść działa w wersji programu Flash Player z debugerem lub w aplikacji AIR Debug Launcher (ADL).
Powiązane elementy interfejsu API
Właściwość | Zdefiniowane przez | ||
---|---|---|---|
bubbles : Boolean [tylko do odczytu]
Określa, czy zdarzenie może przechodzić fazę propagacji. | Event | ||
cancelable : Boolean [tylko do odczytu]
Wskazuje, czy można uniemożliwić operacje skojarzone ze zdarzeniem. | Event | ||
constructor : Object
Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu. | Object | ||
currentTarget : Object [tylko do odczytu]
Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń. | Event | ||
errorID : int [tylko do odczytu]
Zawiera numer referencyjny skojarzony z konkretnym błędem. | ErrorEvent | ||
eventPhase : uint [tylko do odczytu]
Bieżąca faza przepływu zdarzeń. | Event | ||
target : Object [tylko do odczytu]
Miejsce docelowe zdarzenia. | Event | ||
text : String
W przypadku zdarzenia textInput jest to znak lub sekwencja znaków wprowadzonych przez użytkownika. | TextEvent | ||
type : String [tylko do odczytu]
Typ zdarzenia. | Event |
Metoda | Zdefiniowane przez | ||
---|---|---|---|
ErrorEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, text:String = "", id:int = 0)
Tworzy obiekt Event, który zawiera informacje o zdarzeniach błędów. | ErrorEvent | ||
[przesłanianie]
Tworzy kopię obiektu ErrorEvent i ustawia wartości poszczególnych właściwości zgodnie z właściwościami oryginału. | ErrorEvent | ||
Funkcja narzędziowa umożliwiająca implementację metody toString() w niestandardowych klasach Event w języku ActionScript 3.0. | Event | ||
Wskazuje, czy dla obiektu zdefiniowano określoną właściwość. | Object | ||
Sprawdza, czy w odniesieniu do tego zdarzenia wywołano metodę preventDefault(). | Event | ||
Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr. | Object | ||
Anuluje domyślne ustawienia zdarzenia, o ile zachowanie to może być anulowane. | Event | ||
Wskazuje, czy określona właściwość istnieje i jest przeliczalna. | Object | ||
Ustawia dostępność właściwości dynamicznej używanej w pętlach. | Object | ||
Zapobiega przetwarzaniu wszelkich detektorów zdarzeń w węźle bieżącym i węzłach następujących po nim. | Event | ||
Zapobiega przetwarzaniu wszelkich detektorów zdarzeń w węzłach następujących po węźle bieżącym w przepływie zdarzeń. | Event | ||
Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych. | Object | ||
[przesłanianie]
Zwraca ciąg znaków, który zawiera wszystkie właściwości obiektu ErrorEvent. | ErrorEvent | ||
Zwraca pierwotną wartość dla określonego obiektu. | Object |
Stała | Zdefiniowane przez | ||
---|---|---|---|
ERROR : String = "error" [statyczny]
Definiuje wartość właściwości type obiektu zdarzenia error. | ErrorEvent |
errorID | właściwość |
errorID:int
[tylko do odczytu] Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 10.1 |
Zawiera numer referencyjny skojarzony z konkretnym błędem. W przypadku niestandardowego obiektu ErrorEvent ta liczba jest wartością parametru id
przekazanego w konstruktorze.
Implementacja
public function get errorID():int
ErrorEvent | () | Konstruktor |
public function ErrorEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, text:String = "", id:int = 0)
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Tworzy obiekt Event, który zawiera informacje o zdarzeniach błędów. Obiekty Event są przekazywane jako parametry do detektorów zdarzeń.
Parametrytype:String — Typ zdarzenia. Detektory zdarzeń mogą uzyskiwać dostęp do tej informacji za pośrednictwem dziedziczonej właściwości type . Istnieje tylko jeden typ zdarzenia błędu: ErrorEvent.ERROR .
| |
bubbles:Boolean (default = false ) — Określa, czy obiekt Event jest w fazie propagacji. Detektory zdarzeń mogą uzyskiwać dostęp do tej informacji za pośrednictwem dziedziczonej właściwości bubbles .
| |
cancelable:Boolean (default = false ) — Określa, czy obiekt Event może zostać anulowany. Detektory zdarzeń mogą uzyskiwać dostęp do tej informacji za pośrednictwem dziedziczonej właściwości cancelable .
| |
text:String (default = " ") — Tekst, który ma być wyświetlany w charakterze komunikatu o błędzie. Detektory zdarzeń mogą uzyskiwać dostęp do tej informacji za pośrednictwem właściwości text .
| |
id:int (default = 0 ) — Numer referencyjny skojarzony z konkretnym błędem (obsługiwany tylko w środowisku Adobe AIR).
|
clone | () | metoda |
override public function clone():Event
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Tworzy kopię obiektu ErrorEvent i ustawia wartości poszczególnych właściwości zgodnie z właściwościami oryginału.
ZwracaEvent — Nowy obiekt ErrorEvent z wartościami właściwości zgodnymi z oryginałem.
|
toString | () | metoda |
override public function toString():String
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Zwraca ciąg znaków, który zawiera wszystkie właściwości obiektu ErrorEvent. Format ciągu znaków jest następujący:
[ErrorEvent type=wartość bubbles=wartość cancelable=wartość text=wartość errorID=wartość]
Uwaga: Wartość errorId
zwrócona przez metodę toString()
jest dostępna jedynie w środowisku Adobe AIR. Chociaż program Flash Player 10.1 obsługuje właściwość errorID
, wywołanie metody toString()
dla obiektu ErrorEvent nie spowoduje zwrócenia wartości errorId
w programie Flash Player.
String — Ciąg znaków, który zawiera wszystkie właściwości obiektu ErrorEvent.
|
ERROR | Stała |
public static const ERROR:String = "error"
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Definiuje wartość właściwości type
obiektu zdarzenia error
.
To zdarzenie ma następujące właściwości:
Właściwość | Wartość |
---|---|
bubbles | false |
cancelable | false ; nie ma domyślnego zachowania, które można byłoby anulować. |
currentTarget | Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń. |
target | Obiekt, w którym wystąpiło niepowodzenie operacji sieciowej. |
text | Tekst, który ma być wyświetlany w charakterze komunikatu o błędzie. |
errorHandler()
), która przechwytuje wiele typów błędów. Jeśli wystąpi zdarzenie ioError
, procedura próbuje załadować plik z sieci, co z kolei powoduje wygenerowanie zdarzenia securityError
.
Uwaga: Przykład nie będzie działał, jeśli w tym samym katalogu, co plik SWF, istnieje plik o nazwie MissingFile.xml.
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, 12:06 PM Z