| 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():intErrorEvent | () | 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
Ukryj dziedziczone właściwości publiczne
Pokaż dziedziczone właściwości publiczne