Пакет | 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():int
ErrorEvent | () | Конструктор |
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