Pakiet | flash.events |
Klasa | public class IOErrorEvent |
Dziedziczenie | IOErrorEvent ErrorEvent TextEvent Event Object |
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Aby sprawdzić, czy nie pojawiają się zdarzenia error, dla których nie zadeklarowano detektorów, można użyć wersji programu Flash Player z debuggerem lub aplikacji AIR Debug Launcher (ADL). Wyświetlany jest ciąg znaków zdefiniowany w parametrze text
konstruktora IOErrorEvent.
Powiązane elementy interfejsu API
Metoda | Zdefiniowane przez | ||
---|---|---|---|
IOErrorEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, text:String = "", id:int = 0)
Tworzy obiekt Event, który zawiera określone informacje o zdarzeniach ioError. | IOErrorEvent | ||
[przesłanianie]
Tworzy kopię obiektu IOErrorEvent i ustawia wartości poszczególnych właściwości zgodnie z właściwościami oryginału. | IOErrorEvent | ||
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 IOErrorEvent. | IOErrorEvent | ||
Zwraca pierwotną wartość dla określonego obiektu. | Object |
Stała | Zdefiniowane przez | ||
---|---|---|---|
IO_ERROR : String = "ioError" [statyczny]
Definiuje wartość właściwości type obiektu zdarzenia ioError. | IOErrorEvent | ||
STANDARD_ERROR_IO_ERROR : String = "standardErrorIoError" [statyczny]
Zdarzenie standardErrorIoError jest wywoływane w przypadku wystąpienia błędu podczas odczytu danych ze strumienia standardError obiektu NativeProcess. | IOErrorEvent | ||
STANDARD_INPUT_IO_ERROR : String = "standardInputIoError" [statyczny]
Zdarzenie standardInputIoError jest wywoływane w przypadku wystąpienia błędu podczas zapisu danych do strumienia standardInput obiektu NativeProcess. | IOErrorEvent | ||
STANDARD_OUTPUT_IO_ERROR : String = "standardOutputIoError" [statyczny]
Zdarzenie standardOutputIoError jest wywoływane w przypadku wystąpienia błędu podczas odczytu danych ze strumienia standardOutput obiektu NativeProcess. | IOErrorEvent |
IOErrorEvent | () | Konstruktor |
public function IOErrorEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, text:String = "", id:int = 0)
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Tworzy obiekt Event, który zawiera określone informacje o zdarzeniach ioError
. Obiekty Event są przekazywane jako parametry do detektorów zdarzeń.
type: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 wejścia/wyjścia: IOErrorEvent.IO_ERROR .
| |
bubbles:Boolean (default = false ) — Określa, czy obiekt Event uczestniczy w etapie propagacji przepływu zdarzeń. 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).
|
Powiązane elementy interfejsu API
clone | () | metoda |
override public function clone():Event
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Tworzy kopię obiektu IOErrorEvent i ustawia wartości poszczególnych właściwości zgodnie z właściwościami oryginału.
ZwracaEvent — Nowy obiekt IOErrorEvent 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: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Zwraca ciąg znaków, który zawiera wszystkie właściwości obiektu IOErrorEvent. Format ciągu znaków jest następujący:
[IOErrorEvent type=wartość bubbles=wartość cancelable=wartość text=wartość errorID=wartość]
Wartość errorId
jest dostępna jedynie w środowisku Adobe AIR.
String — Ciąg znaków, który zawiera wszystkie właściwości obiektu IOErrorEvent.
|
IO_ERROR | Stała |
public static const IO_ERROR:String = "ioError"
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Definiuje wartość właściwości type
obiektu zdarzenia ioError
.
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ń. |
errorID | Numer referencyjny skojarzony z konkretnym błędem (tylko w środowisku AIR). |
target | Obiekt sieciowy, w którym wystąpił błąd wejścia/wyjścia. |
text | Tekst, który ma być wyświetlany w charakterze komunikatu o błędzie. |
Powiązane elementy interfejsu API
STANDARD_ERROR_IO_ERROR | Stała |
public static const STANDARD_ERROR_IO_ERROR:String = "standardErrorIoError"
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 2, Flash Lite 4 |
Zdarzenie standardErrorIoError
jest wywoływane w przypadku wystąpienia błędu podczas odczytu danych ze strumienia standardError obiektu NativeProcess.
To zdarzenie ma następujące właściwości:
Właściwość | Wartość |
---|---|
bubbles | Nie. |
cancelable | Nie. Nie ma domyślnego zachowania, które można byłoby anulować. |
errorID | Numer referencyjny skojarzony z konkretnym błędem. |
target | Obiekt, w którym wystąpił błąd. |
text | Tekst, który ma być wyświetlany w charakterze komunikatu o błędzie. |
STANDARD_INPUT_IO_ERROR | Stała |
public static const STANDARD_INPUT_IO_ERROR:String = "standardInputIoError"
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 2, Flash Lite 4 |
Zdarzenie standardInputIoError
jest wywoływane w przypadku wystąpienia błędu podczas zapisu danych do strumienia standardInput obiektu NativeProcess.
To zdarzenie ma następujące właściwości:
Właściwość | Wartość |
---|---|
bubbles | Nie. |
cancelable | Nie. Nie ma domyślnego zachowania, które można byłoby anulować. |
errorID | Numer referencyjny skojarzony z konkretnym błędem. |
target | Obiekt, w którym wystąpił błąd. |
text | Tekst, który ma być wyświetlany w charakterze komunikatu o błędzie. |
STANDARD_OUTPUT_IO_ERROR | Stała |
public static const STANDARD_OUTPUT_IO_ERROR:String = "standardOutputIoError"
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 2, Flash Lite 4 |
Zdarzenie standardOutputIoError
jest wywoływane w przypadku wystąpienia błędu podczas odczytu danych ze strumienia standardOutput obiektu NativeProcess.
To zdarzenie ma następujące właściwości:
Właściwość | Wartość |
---|---|
bubbles | Nie. |
cancelable | Nie. Nie ma domyślnego zachowania, które można byłoby anulować. |
errorID | Numer referencyjny skojarzony z konkretnym błędem. |
target | Obiekt, w którym wystąpił błąd. |
text | Tekst, który ma być wyświetlany w charakterze komunikatu o błędzie. |
IOErrorEventExample
do zademonstrowania sposobu wywołania obiektu zdarzenia przy próbie wczytania nieistniejącego pliku. Przykładowy kod realizuje następujące zadania:
- Konstruktor klasy tworzy nową instancję obiektu URLLoader i przypisuje ją zmiennej
loader
. - Instancja klasy URLLoader tworzy instancję detektora zdarzeń typu
ioError
, z którym skojarzona jest metoda (subskrybent)ioErrorHandler()
. Metoda ta drukuje informacje o zdarzeniu za pomocą instrukcjitrace()
. - Następnie konstruktor tworzy nową instancję obiektu URLRequest o nazwie
request
, przekazując nazwęMissingFile.xml
, przez co znana jest nazwa i lokalizacja brakujące to pliku. - Teraz zmienna
request
jest przekazywana do metodyloader.load()
, która próbuje załadować nieistniejący plik. Ponieważ plik nie istnieje, procedura obsługi zdarzeń generuje zdarzenieioError
.
Uwagi:
- Plik SWF powinien być skompilowany z opcją „Zabezpieczenie odtwarzania lokalnego” ustawioną na wartość „Tylko pliki dostępne lokalnie”.
- Na tym samym poziomie struktury katalogów, na której znajduje się plik SWF, nie może istnieć plik o nazwie „MissingFile.xml”.
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); } } }
Tue Jun 12 2018, 12:06 PM Z