Пакет | flash.events |
Класс | public class IOErrorEvent |
Наследование | IOErrorEvent ErrorEvent TextEvent Event Object |
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Проверять события ошибки, для которых нет прослушивателей, можно с помощью отладочной версии Flash Player или приложения AIR Debug Launcher (ADL). Отображается строка, заданная параметром text
конструктора IOErrorEvent.
Связанные элементы API
Метод | Определено | ||
---|---|---|---|
IOErrorEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, text:String = "", id:int = 0)
Создает объект Event, содержащий данные о событиях ioError. | IOErrorEvent | ||
[переопределить]
Создает копию объекта IOErrorEvent и задает значение каждого свойства, совпадающее с оригиналом. | IOErrorEvent | ||
Служебная функция для реализации метода toString() в пользовательских классах ActionScript 3.0 Event. | Event | ||
Показывает, определено ли заданное свойство для объекта. | Object | ||
Проверяет, выполнялся ли для события вызова метода preventDefault(). | Event | ||
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | ||
Отменяет поведение по умолчанию для события, если такое поведение можно отменить. | Event | ||
Показывает наличие заданного свойства и его перечисляемость. | Object | ||
Задает доступность динамического свойства для операций цикла. | Object | ||
Отменяет обработку прослушивателей событий в текущем узле, а также во всех узлах, которые следуют в потоке событий за текущим узлом. | Event | ||
Отменяет обработку прослушивателей событий в узлах, которые следуют в потоке событий за текущим узлом. | Event | ||
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | ||
[переопределить]
Возвращает строку, содержащую все свойства объекта IOErrorEvent. | IOErrorEvent | ||
Возвращает элементарное значение заданного объекта. | Object |
Константа | Определено | ||
---|---|---|---|
IO_ERROR : String = "ioError" [статические]
Задает значение свойства type для объекта события ioError. | IOErrorEvent | ||
STANDARD_ERROR_IO_ERROR : String = "standardErrorIoError" [статические]
Событие standardErrorIoError отправляется, когда возникает ошибка при чтении данных из потока standardError объекта NativeProcess. | IOErrorEvent | ||
STANDARD_INPUT_IO_ERROR : String = "standardInputIoError" [статические]
Событие standardInputIoError отправляется, когда возникает ошибка при чтении данных из потока standardInput объекта NativeProcess. | IOErrorEvent | ||
STANDARD_OUTPUT_IO_ERROR : String = "standardOutputIoError" [статические]
Событие standardOutputIoError отправляется, когда возникает ошибка при чтении данных из потока standardOutput объекта NativeProcess. | IOErrorEvent |
IOErrorEvent | () | Конструктор |
public function IOErrorEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, text:String = "", id:int = 0)
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Создает объект Event, содержащий данные о событиях ioError
. Объекты Event передаются прослушивателям событий в качестве параметров.
type:String — Тип события. Прослушиватели событий могут получать эту информацию через унаследованное свойство type . Существует только один тип события ошибки ввода/вывода: IOErrorEvent.IO_ERROR .
| |
bubbles:Boolean (default = false ) — Определяет, участвует ли объект Event в фазе восходящей цепочки потока событий. Прослушиватели событий могут получать эту информацию через унаследованное свойство bubbles .
| |
cancelable:Boolean (default = false ) — Определяет, можно ли отменить объект Event. Прослушиватели событий могут получать эту информацию через унаследованное свойство cancelable .
| |
text:String (default = " ") — Текст, отображаемый в качестве сообщения об ошибке. Прослушиватели событий могут получать эту информацию через свойство text .
| |
id:int (default = 0 ) — Ссылочный номер, связываемый с конкретной ошибкой (поддерживается только в Adobe AIR).
|
Связанные элементы API
clone | () | метод |
override public function clone():Event
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Создает копию объекта IOErrorEvent и задает значение каждого свойства, совпадающее с оригиналом.
ВозвращаетEvent — Новый объект IOErrorEvent, значения свойств которого соответствуют значениям оригинала.
|
toString | () | метод |
override public function toString():String
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Возвращает строку, содержащую все свойства объекта IOErrorEvent. Строка имеет следующий формат:
[IOErrorEvent type=value bubbles=value cancelable=value text=value errorID=value]
Свойство errorId
доступно только в Adobe AIR.
String — Строка, содержащая все свойства объекта IOErrorEvent.
|
IO_ERROR | Константа |
public static const IO_ERROR:String = "ioError"
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Задает значение свойства type
для объекта события ioError
.
Это событие имеет следующие свойства:
Свойство | Значение |
---|---|
bubbles | false |
cancelable | false ; поведение по умолчанию, подлежащее отмене, не определено. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
errorID | Ссылочный номер, связываемый с конкретной ошибкой (только AIR). |
target | Сетевой объект, с которым произошла ошибка ввода/вывода. |
text | Текст, отображаемый в качестве сообщения об ошибке. |
Связанные элементы API
STANDARD_ERROR_IO_ERROR | Константа |
public static const STANDARD_ERROR_IO_ERROR:String = "standardErrorIoError"
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 2, Flash Lite 4 |
Событие standardErrorIoError
отправляется, когда возникает ошибка при чтении данных из потока standardError объекта NativeProcess.
Это событие имеет следующие свойства:
Свойство | Значение |
---|---|
bubbles | Нет. |
cancelable | Нет. Нет поведения по умолчанию для отмены. |
errorID | Содержит ссылочный номер, связанный с конкретной ошибкой. |
target | Объект, с которым связана ошибка. |
text | Текст, отображаемый в качестве сообщения об ошибке. |
STANDARD_INPUT_IO_ERROR | Константа |
public static const STANDARD_INPUT_IO_ERROR:String = "standardInputIoError"
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 2, Flash Lite 4 |
Событие standardInputIoError
отправляется, когда возникает ошибка при чтении данных из потока standardInput объекта NativeProcess.
Это событие имеет следующие свойства:
Свойство | Значение |
---|---|
bubbles | Нет. |
cancelable | Нет. Нет поведения по умолчанию для отмены. |
errorID | Содержит ссылочный номер, связанный с конкретной ошибкой. |
target | Объект, с которым связана ошибка. |
text | Текст, отображаемый в качестве сообщения об ошибке. |
STANDARD_OUTPUT_IO_ERROR | Константа |
public static const STANDARD_OUTPUT_IO_ERROR:String = "standardOutputIoError"
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 2, Flash Lite 4 |
Событие standardOutputIoError
отправляется, когда возникает ошибка при чтении данных из потока standardOutput объекта NativeProcess.
Это событие имеет следующие свойства:
Свойство | Значение |
---|---|
bubbles | Нет. |
cancelable | Нет. Нет поведения по умолчанию для отмены. |
errorID | Содержит ссылочный номер, связанный с конкретной ошибкой. |
target | Объект, с которым связана ошибка. |
text | Текст, отображаемый в качестве сообщения об ошибке. |
IOErrorEventExample
, чтобы продемонстрировать отправку события ошибки при попытке загрузить несуществующий файл. Для этого выполняются следующие задачи:
- Конструктор класса создает новый экземпляр объекта URLLoader и назначает его переменной
loader
. - Экземпляр URLLoader создает прослушиватель событий типа
ioError
со связанным методом подписчикаioErrorHandler()
, который просто печатает сведения о событии с использованием методаtrace()
. - Затем конструктор создает новый экземпляр объекта URLRequest,
request
, передающийMissingFile.xml
, чтобы сообщить имя и местоположение отсутствующего файла. - Затем переменная
request
передается методуloader.load()
, который пытается загрузить отсутствующий файл. Так как файл не существует, обработчик событий отправляет событиеioError
.
Примечания.
- SWF-файл требуется откомпилировать с установленным для параметра «Безопасность локального воспроизведения» режимом «Доступ только к локальным файлам».
- Проверьте, чтобы не было файла с именем «MissingFile.xml» на одном уровне с SWF-файлом.
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, 11:34 AM Z