| Пакет | flash.events |
| Класс | public class ErrorEvent |
| Наследование | ErrorEvent TextEvent Event Object |
| Подклассы | AsyncErrorEvent, AugmentedErrorEvent, DownloadErrorEvent, DRMAuthenticationErrorEvent, DRMDeviceGroupErrorEvent, DRMErrorEvent, DRMReturnVoucherErrorEvent, IOErrorEvent, RSLErrorEvent, SecurityErrorEvent, SkinErrorEvent, SQLErrorEvent, StatusFileUpdateErrorEvent, StatusUpdateErrorEvent, UncaughtErrorEvent |
| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Класс ErrorEvent определяет только один тип события error: ErrorEvent.ERROR. Класс ErrorEvent также служит базовым классом для нескольких других классов событий ошибки, включая AsyncErrorEvent, IOErrorEvent, SecurityErrorEvent, SQLErrorEvent и UncaughtErrorEvent.
Чтобы проверить наличие событий error, для которых нет прослушивателей, нужно зарегистрировать прослушиватель для события uncaughtError (UncaughtErrorEvent.UNCAUGHT_ERROR).
Неперехваченная ошибка также приводит к отображению диалогового окна ошибки, когда содержимое выполняется в отладочной версии Flash Player или в отладочном приложении AIR Debug Launcher (ADL).
Связанные элементы API
| Свойство | Определено | ||
|---|---|---|---|
![]() | bubbles : Boolean [только для чтения]
Определяет, является ли событие событием восходящей цепочки. | Event | |
![]() | cancelable : Boolean [только для чтения]
Указывает, можно ли предотвратить поведение, связанное с событием. | Event | |
![]() | constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | |
![]() | currentTarget : Object [только для чтения]
Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. | Event | |
| errorID : int [только для чтения]
Содержит ссылочный номер, связанный с конкретной ошибкой. | ErrorEvent | ||
![]() | eventPhase : uint [только для чтения]
Текущая фаза в потоке событий. | Event | |
![]() | target : Object [только для чтения]
Целевой объект события. | Event | |
![]() | text : String
Для события textInput — введенный пользователем знак или последовательность знаков. | TextEvent | |
![]() | type : String [только для чтения]
Тип события. | Event | |
| Метод | Определено | ||
|---|---|---|---|
ErrorEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, text:String = "", id:int = 0)
Создает объект Event, содержащий данные о событиях ошибок. | ErrorEvent | ||
[переопределить]
Создает копию объекта ErrorEvent и задает значение каждого свойства, совпадающее с оригиналом. | ErrorEvent | ||
![]() |
Служебная функция для реализации метода toString() в пользовательских классах ActionScript 3.0 Event. | Event | |
![]() |
Показывает, определено ли заданное свойство для объекта. | Object | |
![]() |
Проверяет, выполнялся ли для события вызова метода preventDefault(). | Event | |
![]() |
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | |
![]() |
Отменяет поведение по умолчанию для события, если такое поведение можно отменить. | Event | |
![]() |
Показывает наличие заданного свойства и его перечисляемость. | Object | |
![]() |
Задает доступность динамического свойства для операций цикла. | Object | |
![]() |
Отменяет обработку прослушивателей событий в текущем узле, а также во всех узлах, которые следуют в потоке событий за текущим узлом. | Event | |
![]() |
Отменяет обработку прослушивателей событий в узлах, которые следуют в потоке событий за текущим узлом. | Event | |
![]() |
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | |
[переопределить]
Возвращает строку, содержащую все свойства объекта ErrorEvent. | ErrorEvent | ||
![]() |
Возвращает элементарное значение заданного объекта. | Object | |
| Константа | Определено | ||
|---|---|---|---|
| ERROR : String = "error" [статические]
Определяет значение свойства type объекта события error. | ErrorEvent | ||
errorID | свойство |
errorID:int [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0, Flash Player 10.1 |
Содержит ссылочный номер, связанный с конкретной ошибкой. Для пользовательского объекта ErrorEvent это число является значением параметра id, представленного в конструкторе.
Реализация
public function get errorID():intErrorEvent | () | Конструктор |
public function ErrorEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, text:String = "", id:int = 0)| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Создает объект Event, содержащий данные о событиях ошибок. Объекты Event передаются прослушивателям событий в качестве параметров.
Параметрыtype:String — Тип события. Прослушиватели событий могут получать эту информацию через унаследованное свойство type. Существует только один тип события ошибки: ErrorEvent.ERROR.
| |
bubbles:Boolean (default = false) — Определяет, находится ли объект Event в фазе восходящей цепочки. Прослушиватели событий могут получать эту информацию через унаследованное свойство bubbles.
| |
cancelable:Boolean (default = false) — Определяет, можно ли отменить объект Event. Прослушиватели событий могут получать эту информацию через унаследованное свойство cancelable.
| |
text:String (default = "") — Текст, отображаемый в качестве сообщения об ошибке. Прослушиватели событий могут получать эту информацию через свойство text.
| |
id:int (default = 0) — Ссылочный номер, связываемый с конкретной ошибкой (поддерживается только в Adobe AIR).
|
clone | () | метод |
override public function clone():Event| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Создает копию объекта ErrorEvent и задает значение каждого свойства, совпадающее с оригиналом.
ВозвращаетEvent — Новый объект ErrorEvent, значения свойств которого соответствуют значениям оригинала.
|
toString | () | метод |
override public function toString():String| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Возвращает строку, содержащую все свойства объекта ErrorEvent. Строка имеет следующий формат:
[ErrorEvent type= value bubbles= value cancelable= value text= value errorID= value ]
Примечание. Значение errorId, возвращаемое методом toString(), доступно только для Adobe AIR. Хотя Flash Player 10.1 поддерживает свойство errorID, вызов метода toString() для объекта ErrorEvent не передает значение errorId во Flash Player.
String — Строка, содержащая все свойства объекта ErrorEvent.
|
ERROR | Константа |
public static const ERROR:String = "error"| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Определяет значение свойства type объекта события error.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
bubbles | false |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
target | Объект, испытывающий сбой сетевой операции. |
text | Текст, отображаемый в качестве сообщения об ошибке. |
errorHandler()), захватывающего несколько типов событий ошибки. Если получено событие ioError, обработчик выполнить загрузку из сети, в результате чего выдается securityError.
Примечание. Этот пример не распространяется на случаи, когда файл с именем MissingFile.xml находится в том же каталоге, что и SWF-файл.
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, 11:34 AM Z
Скрыть унаследованные общедоступные свойства
Показать унаследованные общедоступные свойства