flash.eventsNetMonitorEvent Объект NetMonitorEvent отправляет объекты NetMonitor при создании объекта NetStream.flash.events:Event Объект NetMonitorEvent отправляет объекты NetMonitor при создании объекта NetStream. netStreamCreateflash.events:NetMonitorEvent:NET_STREAM_CREATEflash.events:NetMonitorEventNetMonitorEvent Создает объект события, содержащий сведения о событиях netStreamCreate.typeStringТип события. Прослушиватели событий могут получать эту информацию через унаследованное свойство type. Существует только один тип события: NetMonitorEvent. NET_STREAM_CREATE. bubblesBooleanfalseОпределяет, участвует ли объект Event в фазе восходящей цепочки потока событий. Прослушиватели событий могут получать эту информацию через унаследованное свойство bubbles. cancelableBooleanfalseОпределяет, можно ли отменить объект Event. Прослушиватели событий могут получать эту информацию через унаследованное свойство cancelable. netStreamflash.net:NetStreamnullНовый объект NetStream, который был создан. Прослушиватели событий могут получать эти данные через свойство netStream. Конструктор для объектов NetMonitorEvent. Создает объект события, содержащий сведения о событиях netStreamCreate. Объекты Event передаются прослушивателям событий в качестве параметров. NetMonitorEvent. NET_STREAM_CREATEclone Создает копию объекта NetMonitorEvent и задает значение каждого свойства, совпадающее с оригиналом.Новый объект NetMonitorEvent, значения свойств которого соответствуют значениям оригинала. flash.events:Event Создает копию объекта NetMonitorEvent и задает значение каждого свойства, совпадающее с оригиналом. toString Возвращает строку, содержащую все свойства объекта NetMonitorEvent.Строка, содержащая все свойства объекта NetMonitorEvent. String Возвращает строку, содержащую все свойства объекта NetMonitorEvent. Используется следующий формат:

[NetMonitorEvent type=значение bubbles=значение cancelable=значение netStream=значение]

NET_STREAM_CREATE Константа NetMonitorEvent.NET_STREAM_CREATE определяет значение свойства «type» объекта события netStreamCreate.netStreamCreateString Константа NetMonitorEvent.NET_STREAM_CREATE определяет значение свойства type объекта события netStreamCreate.

Объект события netStreamCreate имеет следующие свойства.

СвойствоЗначениеnetStreamОбъект NetStream, который был создан.bubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.targetНачало объекта или окончание сессии.
netStream Новый объект NetStream.flash.net:NetStream Новый объект NetStream.
TimerEvent Объект Timer отправляет объекты TimerEvent каждый раз, когда объект Timer достигает интервала, указанного в свойстве Timer.delay.Объекты событий Timer. flash.events:Event Объект Timer отправляет объекты TimerEvent каждый раз, когда объект Timer достигает интервала, указанного в свойстве Timer.delay. В следующем примере используется класс TimerExample, чтобы продемонстрировать создание метода прослушивателя timerHandler() и его использование для прослушивания нового события TimerEvent, которое отправляется при вызове метода start() объекта Timer. package { import flash.utils.Timer; import flash.events.TimerEvent; import flash.display.Sprite; public class TimerEventExample extends Sprite { public function TimerEventExample() { var myTimer:Timer = new Timer(1000, 2); myTimer.addEventListener(TimerEvent.TIMER, timerHandler); myTimer.start(); } public function timerHandler(event:TimerEvent):void { trace("timerHandler: " + event); } } } flash.utils.TimertimerCompleteflash.events:TimerEvent:TIMER_COMPLETEflash.events:TimerEventflash.utils.Timer.timerCompletetimerflash.events:TimerEvent:TIMERflash.events:TimerEventflash.utils.Timer.timerTimerEvent Создает объект Event со специфической информацией, имеющей отношение к событиям timer.typeString Тип события. Прослушиватели событий могут получать эту информацию через унаследованное свойство type. bubblesBooleanfalseОпределяет, находится ли объект Event в фазе восходящей цепочки. Прослушиватели событий могут получать эту информацию через унаследованное свойство bubbles. cancelableBooleanfalseОпределяет, можно ли отменить объект Event. Прослушиватели событий могут получать эту информацию через унаследованное свойство cancelable. Конструктор для объектов TimerEvent. Создает объект Event со специфической информацией, имеющей отношение к событиям timer. Объекты Event передаются прослушивателям событий в качестве параметров. clone Создает копию объекта TimerEvent и задает значение каждого свойства, совпадающее с оригиналом.Новый объект TimerEvent, значения свойств которого соответствуют значениям оригинала. flash.events:Event Создает копию объекта TimerEvent и задает значение каждого свойства, совпадающее с оригиналом. toString Возвращает строку, содержащую все свойства объекта TimerEvent.Строка, содержащая все свойства объекта TimerEvent. String Возвращает строку, содержащую все свойства объекта TimerEvent. Строка имеет следующий формат:

[TimerEvent type=value bubbles=value cancelable=value]

updateAfterEvent Предписывает проигрывателю Flash Player или среде выполнения AIR выполнить визуализацию после обработки данного события, если список отображения был изменен. Предписывает проигрывателю Flash Player или среде выполнения AIR выполнить визуализацию после обработки данного события, если список отображения был изменен. Ниже приведен пример метода TimerEvent.updateAfterEvent(). function onTimer(event:TimerEvent):void { if (40 < my_mc.x && my_mc.x < 375) { my_mc.x-= 50; } else { my_mc.x=374; } event.updateAfterEvent(); } var moveTimer:Timer=new Timer(50,250); moveTimer.addEventListener(TimerEvent.TIMER,onTimer); moveTimer.start(); TIMER_COMPLETE Задает значение свойства type для объекта события timerComplete.timerCompleteString Задает значение свойства type для объекта события timerComplete.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.targetОбъект Timer, выполнивший запросы.
flash.utils.Timer.timerComplete
TIMER Задает значение свойства type для объекта события timer.timerString Задает значение свойства type для объекта события timer.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.targetОбъект Timer, достигший заданного интервала.
flash.utils.Timer.timer
IOErrorEvent Объект IOErrorEvent отправляется, когда операция ввода или вывода завершается с ошибкой.Объекты событий IOErrorEvent. flash.events:ErrorEvent Объект IOErrorEvent отправляется, когда операция ввода или вывода завершается с ошибкой.

Проверять события ошибки, для которых нет прослушивателей, можно с помощью отладочной версии Flash Player или приложения AIR Debug Launcher (ADL). Отображается строка, заданная параметром text конструктора IOErrorEvent.

В следующем примере используется класс IOErrorEventExample, чтобы продемонстрировать отправку события ошибки при попытке загрузить несуществующий файл. Для этого выполняются следующие задачи:
  1. Конструктор класса создает новый экземпляр объекта URLLoader и назначает его переменной loader.
  2. Экземпляр URLLoader создает прослушиватель событий типа ioError со связанным методом подписчика ioErrorHandler(), который просто печатает сведения о событии с использованием метода trace().
  3. Затем конструктор создает новый экземпляр объекта URLRequest, request, передающий MissingFile.xml, чтобы сообщить имя и местоположение отсутствующего файла.
  4. Затем переменная 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); } } }
IO_ERRORioErrorflash.events:IOErrorEvent:IO_ERRORflash.events:IOErrorEventflash.display.LoaderInfo.ioErrorflash.media.Sound.ioErrorflash.net.SecureSocket.ioErrorflash.net.Socket.ioErrorflash.net.FileReference.ioErrorflash.net.NetConnection.ioErrorflash.net.NetStream.ioErrorflash.net.URLLoader.ioErrorflash.net.URLStream.ioErrorflash.net.XMLSocket.ioErrorIOErrorEventflash.events:IOErrorEvent:STANDARD_ERROR_IO_ERRORflash.events:IOErrorEventIOErrorEventflash.events:IOErrorEvent:STANDARD_INPUT_IO_ERRORflash.events:IOErrorEventIOErrorEventflash.events:IOErrorEvent:STANDARD_OUTPUT_IO_ERRORflash.events:IOErrorEventIOErrorEvent Создает объект Event, содержащий данные о событиях ioError.typeString Тип события. Прослушиватели событий могут получать эту информацию через унаследованное свойство type. Существует только один тип события ошибки ввода/вывода: IOErrorEvent.IO_ERROR. bubblesBooleanfalseОпределяет, участвует ли объект Event в фазе восходящей цепочки потока событий. Прослушиватели событий могут получать эту информацию через унаследованное свойство bubbles. cancelableBooleanfalseОпределяет, можно ли отменить объект Event. Прослушиватели событий могут получать эту информацию через унаследованное свойство cancelable. textStringТекст, отображаемый в качестве сообщения об ошибке. Прослушиватели событий могут получать эту информацию через свойство text. idint0Ссылочный номер, связываемый с конкретной ошибкой (поддерживается только в Adobe AIR). Конструктор для объектов IOErrorEvent. Создает объект Event, содержащий данные о событиях ioError. Объекты Event передаются прослушивателям событий в качестве параметров. IO_ERRORclone Создает копию объекта IOErrorEvent и задает значение каждого свойства, совпадающее с оригиналом.Новый объект IOErrorEvent, значения свойств которого соответствуют значениям оригинала. flash.events:Event Создает копию объекта IOErrorEvent и задает значение каждого свойства, совпадающее с оригиналом. toString Возвращает строку, содержащую все свойства объекта IOErrorEvent.Строка, содержащая все свойства объекта IOErrorEvent. String Возвращает строку, содержащую все свойства объекта IOErrorEvent. Строка имеет следующий формат:

[IOErrorEvent type=value bubbles=value cancelable=value text=value errorID=value] Свойство errorId доступно только в Adobe AIR.

IO_ERROR Задает значение свойства type для объекта события ioError.ioErrorString Задает значение свойства type для объекта события ioError.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.errorIDСсылочный номер, связываемый с конкретной ошибкой (только AIR).targetСетевой объект, с которым произошла ошибка ввода/вывода.textТекст, отображаемый в качестве сообщения об ошибке.
flash.display.LoaderInfo.ioErrorflash.media.Sound.ioErrorflash.net.SecureSocket.ioErrorflash.net.Socket.ioErrorflash.net.FileReference.ioErrorflash.net.NetConnection.ioErrorflash.net.NetStream.ioErrorflash.net.URLLoader.ioErrorflash.net.URLStream.ioErrorflash.net.XMLSocket.ioError
STANDARD_ERROR_IO_ERROR Событие standardErrorIoError отправляется, когда возникает ошибка при чтении данных из потока standardError объекта NativeProcess.standardErrorIoErrorString Событие standardErrorIoError отправляется, когда возникает ошибка при чтении данных из потока standardError объекта NativeProcess.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesНет.cancelableНет. Нет поведения по умолчанию для отмены.errorIDСодержит ссылочный номер, связанный с конкретной ошибкой.targetОбъект, с которым связана ошибка.textТекст, отображаемый в качестве сообщения об ошибке.
STANDARD_INPUT_IO_ERROR Событие standardInputIoError отправляется, когда возникает ошибка при чтении данных из потока standardInput объекта NativeProcess.standardInputIoErrorString Событие standardInputIoError отправляется, когда возникает ошибка при чтении данных из потока standardInput объекта NativeProcess.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesНет.cancelableНет. Нет поведения по умолчанию для отмены.errorIDСодержит ссылочный номер, связанный с конкретной ошибкой.targetОбъект, с которым связана ошибка.textТекст, отображаемый в качестве сообщения об ошибке.
STANDARD_OUTPUT_IO_ERROR Событие standardOutputIoError отправляется, когда возникает ошибка при чтении данных из потока standardOutput объекта NativeProcess.standardOutputIoErrorString Событие standardOutputIoError отправляется, когда возникает ошибка при чтении данных из потока standardOutput объекта NativeProcess.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesНет.cancelableНет. Нет поведения по умолчанию для отмены.errorIDСодержит ссылочный номер, связанный с конкретной ошибкой.targetОбъект, с которым связана ошибка.textТекст, отображаемый в качестве сообщения об ошибке.
NetStatusEvent Объект NetConnection, NetStream или SharedObject отправляет объекты NetStatusEvent, когда сообщает о своем состоянии.Объекты событий NetStatusEvent. flash.events:Event Объект NetConnection, NetStream или SharedObject отправляет объекты NetStatusEvent, когда сообщает о своем состоянии. Существует только один тип события состояния: NetStatusEvent.NET_STATUS. В следующем примере объект Video с классами NetConnection и NetStream используется для загрузки и воспроизведения FLV-файла.

Здесь метод netStatusHandler регистрируется в качестве прослушивателя события NetStatusEvent — NetConnection.netStatus. Когда определяется состояние (успешно или неуспешно) попытки выполнить NetConnection.connect(), событие netStatus запускает этот метод. Если попытка подключиться к объекту NetConnection успешная (другими словами, если свойство info объекта NetStatusEvent, отправленного событием netStatus, имеет свойство code с указанием успешного выполнения), код создает объекты Video и NetStream и вызывает методы Video.attachNetStream() и NetStream.play().

Примечание. Чтобы запустить данный пример, вам потребуется FLV-файл, имя и место расположения которого совпадают с переменной, переданной videoURL. В данном случае, FLV-файл Video.flv находится в том же каталоге, где размещается SWF-файл.

package { import flash.display.Sprite; import flash.events.*; import flash.media.Video; import flash.net.NetConnection; import flash.net.NetStream; public class NetStatusEventExample extends Sprite { private var videoURL:String = "Video.flv"; private var connection:NetConnection; private var stream:NetStream; public function NetStatusEventExample() { connection = new NetConnection(); connection.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler); connection.addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler); connection.connect(null); } private function netStatusHandler(event:NetStatusEvent):void { switch (event.info.code) { case "NetConnection.Connect.Success": connectStream(); break; case "NetStream.Play.StreamNotFound": trace("Unable to locate video: " + videoURL); break; } } private function connectStream():void { var stream:NetStream = new NetStream(connection); stream.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler); stream.addEventListener(AsyncErrorEvent.ASYNC_ERROR, asyncErrorHandler); var video:Video = new Video(); video.attachNetStream(stream); stream.play(videoURL); addChild(video); } private function securityErrorHandler(event:SecurityErrorEvent):void { trace("securityErrorHandler: " + event); } private function asyncErrorHandler(event:AsyncErrorEvent):void { // ignore AsyncErrorEvent events. } } }
flash.net.NetConnectionflash.net.NetStreamflash.net.SharedObjectNetStatusEvent.NET_STATUSnetStatusflash.events:NetStatusEvent:NET_STATUSflash.events:NetStatusEventflash.events.NetStatusEvent.infoflash.net.NetConnection.netStatusflash.net.NetStream.netStatusflash.net.SharedObject.netStatusNetStatusEvent Создает объект Event, содержащий сведения о событиях netStatus.typeString Тип события. Прослушиватели событий могут получать эту информацию через унаследованное свойство type. Существует только один тип события состояния: NetStatusEvent.NET_STATUS. bubblesBooleanfalseОпределяет, участвует ли объект Event в фазе восходящей цепочки потока событий. Прослушиватели событий могут получать эту информацию через унаследованное свойство bubbles. cancelableBooleanfalseОпределяет, можно ли отменить объект Event. Прослушиватели событий могут получать эту информацию через унаследованное свойство cancelable. infoObjectnullОбъект, содержащий свойства, описывающие состояние объекта. Прослушиватели событий могут получать этот объект через свойство info. Конструктор для объектов NetStatusEvent. Создает объект Event, содержащий сведения о событиях netStatus. Объекты Event передаются прослушивателям событий в качестве параметров. flash.events.NetStatusEvent.NET_STATUSclone Создает копию объекта NetStatusEvent и задает значение каждого свойства, совпадающее с оригиналом.Новый объект NetStatusEvent, значения свойств которого соответствуют значениям оригинала. flash.events:Event Создает копию объекта NetStatusEvent и задает значение каждого свойства, совпадающее с оригиналом. toString Возвращает строку, содержащую все свойства объекта NetStatusEvent.Строка, содержащая все свойства объекта NetStatusEvent. String Возвращает строку, содержащую все свойства объекта NetStatusEvent. Строка имеет следующий формат:

[NetStatusEvent type=value bubbles=value cancelable=value info=value]

NET_STATUS Задает значение свойства type для объекта события netStatus.netStatusString Задает значение свойства type для объекта события netStatus.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.infoОбъект со свойствами, описывающими состояние объекта или условие ошибки.targetОбъект NetConnection или NetStream, сообщающий свое состояние.
flash.events.NetStatusEvent.infoflash.net.NetConnection.netStatusflash.net.NetStream.netStatusflash.net.SharedObject.netStatus
info Объект со свойствами, описывающими состояние объекта или условие ошибки.Object Объект со свойствами, описывающими состояние объекта или условие ошибки.

Информационный объект может иметь свойство code, содержащее строку, представляющую конкретное событие, или свойство level, содержащее строку, являющуюсяstatus или error.

Информационный объект может быть и другим. Свойства code и level могут не поддерживаться для некоторых реализаций, также некоторые серверы могут отправлять другие объекты.

Подключения P2P отправляют сообщения для NetConnection с параметром stream в информационном объекте, который указывает, к какому объекту NetStream относится сообщение.

Например, система Flex Data Services отправляет объекты Message, которые являются причиной ошибок поведения типа данных, при попытке доступа к свойству code или level.

В следующей таблице описываются возможные строковые значения свойств code и level.

Свойство codeСвойство levelЗначение"NetConnection.Call.BadVersion""error"Пакет закодирован в неопределенном формате."NetConnection.Call.Failed""error"Методу NetConnection.call() не удалось вызвать метод или команду на сервере."NetConnection.Call.Prohibited""error"Выполнение операции Action Message Format (AMF) предотвращено по соображениям безопасности. Либо URL-адрес AMF не принадлежит тому же домену, что и файл, содержащий код, который вызывает метод NetConnection.call(), либо на сервере AMF отсутствует файл политики, устанавливающий отношения доверия с доменом файла, содержащего код, который вызывает метод NetConnection.call(). "NetConnection.Connect.AppShutdown""error"Завершается работа серверного приложения."NetConnection.Connect.Closed"statusПодключение успешно разорвано."NetConnection.Connect.Failed""error"Попытка подключения не удалась."NetConnection.Connect.IdleTimeout"statusСервер Flash Media Server отключил клиента, поскольку время бездействия клиента превысило значение, настроенное для параметра <MaxIdleTime>. На сервере Flash Media Server параметр <AutoCloseIdleClients> отключен по умолчанию. При включении время ожидания по умолчанию равно 3600 секундам (1 час). Для получения дополнительной информации см. веб-страницу «Закрытие ожидающих подключений». "NetConnection.Connect.InvalidApp""error"Имя приложения, указанное в вызове метода NetConnection.connect(), является недействительным."NetConnection.Connect.NetworkChange"status

Flash Player обнаружил изменение в сети, например, разорвано беспроводное подключение, успешно установлено беспроводное подключение, или отключен сетевой кабель.

Используйте это событие для проверки изменений в сетевом интерфейсе. Не используйте это событие для внедрения логики повторного подключения NetConnection. Используйте "NetConnection.Connect.Closed" для реализации логики повторного подключения NetConnection.

"NetConnection.Connect.Rejected""error"При попытке подключения отсутствовали права на доступ к приложению."NetConnection.Connect.Success"statusПопытка подключения удалась."NetGroup.Connect.Failed""error"Попытка подключения NetGroup не удалась. Свойство info.group указывает, какой объект NetGroup не удалось создать."NetGroup.Connect.Rejected""error"Объект NetGroup не авторизован. Свойство info.group указывает, какому объекту NetGroup не предоставлена авторизация."NetGroup.Connect.Succcess"statusОбъект NetGroup успешно создан и авторизован. Свойство info.group указывает, какой объект NetGroup спешно создан."NetGroup.LocalCoverage.Notify"statusОтправляется, когда меняется часть пространства групповых адресов, за которые отвечает данный узел."NetGroup.MulticastStream.PublishNotify"statusОтправляется, когда в группе NetGroup обнаруживается новый именованный поток. Свойство info.name:String содержит имя обнаруженного потока."NetGroup.MulticastStream.UnpublishNotify"statusОтправляется, когда именованный поток перестает быть доступным в группе. Свойство info.name:String содержит имя пропавшего потока."NetGroup.Neighbor.Connect"statusОтправляется, когда к этому узлу подключается соседний. Свойство info.neighbor:String содержит групповой адрес соседнего узла. Свойство info.peerID:String содержит идентификатор соседнего однорангового узла."NetGroup.Neighbor.Disconnect"statusОтправляется, когда от этого узла отключается соседний. Свойство info.neighbor:String содержит групповой адрес соседнего узла. Свойство info.peerID:String содержит идентификатор соседнего однорангового узла."NetGroup.Posting.Notify"statusОтправляется при получении новой групповой публикации. Свойство info.message:Object представляет собой сообщение. Свойство info.messageID:String содержит идентификатор этого сообщения (messageID)."NetGroup.Replication.Fetch.Failed"statusОтправляется, когда не удается отправить запрос на получение (объявленный с помощью NetGroup.Replication.Fetch.SendNotify) или когда он отклоняется. Если запрашиваемый объект по-прежнему нужен, будут предприниматься новые попытки. Свойство info.index:Number содержит индекс запрашиваемого объекта."NetGroup.Replication.Fetch.Result"statusОтправляется, когда соседний узел удовлетворяет запрос на получение. Свойство info.index:Number содержит индекс результирующего объекта. Свойство info.object:Object содержит значение этого объекта. Этот индекс автоматически удаляется из набора запрашиваемых объектов (Want). Если объект недействителен, этот индекс можно добавить в набор запрашиваемых объектов (Want) с помощью метода NetGroup.addWantObjects()."NetGroup.Replication.Fetch.SendNotify"statusОтправляется, когда система репликации объектов готовится отправить соседнему узлу запрос на объект. Свойство info.index:Number содержит индекс запрашиваемого объекта."NetGroup.Replication.Request"statusОтправляется после того, как соседний узел запросил объект, объявленный этим узлом с помощью метода NetGroup.addHaveObjects(). В качестве ответа на этот запрос должен быть вызван метод NetGroup.writeRequestedObject() или NetGroup.denyRequestedObject(). Обратите внимание, что ответ может быть асинхронным. Свойство info.index:Number содержит индекс запрашиваемого объекта. Свойство info.requestID:int содержит идентификатор этого запроса, который должен быть использован при вызове метода NetGroup.writeRequestedObject() или NetGroup.denyRequestedObject()."NetGroup.SendTo.Notify"statusОтправляется при получении сообщения, отправленного этому узлу. Свойство info.message:Object представляет собой сообщение. Свойство info.from:String является объектом groupAddress, с которого отправлено полученное сообщение. Свойство info.fromLocal:Boolean имеет значение TRUE, если сообщение отправлено этим узлом (с учетом того, что локальный узел является ближайшим к групповому адресу назначения), или значение FALSE, если сообщение получено с другого узла. Чтобы обеспечить рекурсивную маршрутизацию, сообщение необходимо повторно отправить с помощью метода NetGroup.sendToNearest(), если свойство info.fromLocal имеет значение FALSE."NetStream.Buffer.Empty"statusFlash Player не получает данные достаточно быстро для заполнения буфера. Поток данных прерывается до повторного заполнения буфера, после чего отправляется сообщение NetStream.Buffer.Full, и возобновляется потоковое воспроизведение."NetStream.Buffer.Flush"statusПотоковое воспроизведение данных прекратилось, оставшийся буфер очищается."NetStream.Buffer.Full"statusБуфер заполнен, начинается потоковое воспроизведение."NetStream.Connect.Closed"statusПодключение Р2Р успешно разорвано. Свойство info.stream указывает на то, что поток закрыт."NetStream.Connect.Failed""error"Попытка подключения Р2Р не удалась. Свойство info.stream указывает на то, что поток не открыт."NetStream.Connect.Rejected""error"При попытке подключения Р2Р отсутствовали права на доступ к другому одноранговому приложению. Свойство info.stream указывает на то, что поток отклонен."NetStream.Connect.Success"statusПопытка подключения Р2Р удалась. Свойство info.stream указывает на то, что поток открыт."NetStream.DRM.UpdateNeeded"statusОбъект NetStream пытается воспроизвести защищенное содержимое, но необходимый модуль Flash Access отсутствует, запрещен текущей политикой для содержимого или несовместим с текущим экземпляром проигрывателя. Чтобы обновить модуль или проигрыватель, используйте метод update() класса flash.system.SystemUpdater. "NetStream.Failed""error"(Flash Media Server) Произошла ошибка по причине, не указанной среди других кодов событий. "NetStream.MulticastStream.Reset"statusГрупповая подписка изменила фокус на другой поток, опубликованный с тем же именем в той же группе. Локальные переопределения параметров потока многоадресной рассылки потеряны. Повторно примените локальные переопределения, в противном случае будут использованы параметры по умолчанию нового потока."NetStream.Pause.Notify"statusПоток приостановлен."NetStream.Play.Failed""error"Произошла ошибка при воспроизведении по причине, не указанной в таблице, например, у подписчика нет доступа для чтения."NetStream.Play.FileStructureInvalid""error"(AIR и Flash Player 9.0.115.0) Приложение обнаруживает недопустимую структуру файла и не будет пытаться воспроизвести данный тип файла. "NetStream.Play.InsufficientBW""warning"(Flash Media Server) Пропускной способности клиента недостаточно для воспроизведения данных с нормальной скоростью. "NetStream.Play.NoSupportedTrackFound""error"(AIR и Flash Player 9.0.115.0) Приложение не обнаруживает поддерживаемых каналов (видео, аудио или данных) и не будет пытаться воспроизвести файл."NetStream.Play.PublishNotify"statusИсходная публикация потока отправляется всем подписчикам."NetStream.Play.Reset"statusВызвано сбросом списка воспроизведения."NetStream.Play.Start"statusНачалось воспроизведение."NetStream.Play.Stop"statusВоспроизведение остановлено."NetStream.Play.StreamNotFound""error"FLV-файл, переданный методу NetStream.play(), не найден."NetStream.Play.Transition"status(Flash Media Server 3.5) Сервер получает команду перехода к другому потоку в результате переключения потока битовой передачи данных. Данный код означает состояние успешного выполнения вызова NetStream.play2() для инициации переключения потоков. Если переключение не выполнено, сервер отправляет событие NetStream.Play.Failed. При переключении потока выполняется отправка события onPlayStatus с кодом NetStream.Play.TransitionComplete. Для проигрывателя Flash Player версии 10 и более поздних версий."NetStream.Play.UnpublishNotify"statusОтмена публикации потока отправляется всем подписчикам."NetStream.Publish.BadName""error"Попытка опубликовать поток, уже публикуемый другим пользователем."NetStream.Publish.Idle"statusСервер публикации потока свободен и не передает данных."NetStream.Publish.Start"statusПубликация выполнена успешно."NetStream.Record.AlreadyExists"statusЗаписываемый поток соответствует файлу, в который уже выполняется запись другим потоком. Такая ситуация может возникнуть при неправильной настройке виртуальных каталогов.NetStream.Record.Failed"error"Попытка записи потока не удалась."NetStream.Record.NoAccess""error"Попытка записать поток, который все еще воспроизводится или к которому у клиента нет права доступа."NetStream.Record.Start"statusНачалась запись."NetStream.Record.Stop"statusЗапись остановлена."NetStream.Seek.Failed""error"Невозможно выполнить поиск, если поток не поддерживает поиск."NetStream.Seek.InvalidTime""error"В ходе последовательной загрузки видео в пользователь попытался найти или воспроизвести еще не загруженные на данный момент видеоданные или данные, находящиеся за пределами полностью загруженного файла. Свойство info.details объекта события содержит временной код, указывающий последнюю действительную позицию, доступную для поиска."NetStream.Seek.Notify"status

Операция поиска выполнена.

Отправляется, когда метод NetStream.seek() вызывается для потока в режиме создания данных AS3 NetStream. Объект info расширяется и включает свойство info.seekPoint, которое содержит то же значение, которое передается методу NetStream.seek().

"NetStream.Step.Notify"statusОперация шага выполнена."NetStream.Unpause.Notify"statusПоток возобновлен."NetStream.Unpublish.Success"statusОперация отмены публикации выполнена успешно."SharedObject.BadPersistence""error"Запрос на создание общего объекта с флагами постоянства отправлен, но не удовлетворен, так как объект уже создан с другими флагами."SharedObject.Flush.Failed""error"Состояние ожидания pending разрешено, но вызов SharedObject.flush() не удался."SharedObject.Flush.Success"statusСостояние ожидания pending разрешено, и вызов SharedObject.flush() выполнен успешно."SharedObject.UriMismatch""error"Предпринята попытка подключения к объекту NetConnection, URI (URL) которого не совпадает с общим объектом.

Если постоянно появляются ошибки, связанные с буфером, попробуйте изменить его с помощью свойства NetStream.bufferTime.

Следующий пример демонстрирует функцию обработчика событий, которая проверяет наличие ошибки NetStream.Seek.InvalidTime. Ошибка NetStream.Seek.InvalidTime происходит, когда пользователь пытается выполнить поиск точки воспроизведения, которая находится за пределами загруженного потока. В этом примере проверяется значение свойства info.code объекта события. Если возникает ошибка, свойству eventObj.info.details назначается переменная, которая должна использоваться в качестве параметра для метода seek() потока. Свойство eventObj.info.details содержит последнее имеющееся допустимое положение для обработки ошибки. Таким образом, пользователь переходит к допустимому месту в конце загруженного потока. function videoStatus(eventObj:NetStatusEvent):Void { switch(eventObj.info.code) { case "NetStream.Seek.InvalidTime": { var validSeekTime:Number = eventObj.info.details; nStream.seek(validSeekTime); break; } } }
Класс NetConnectionКласс NetStreamКласс NetGroup
UncaughtErrorEvents Класс UncaughtErrorEvents обеспечивает способ получения событий о неперехваченных ошибках.flash.events:EventDispatcher Класс UncaughtErrorEvents обеспечивает способ получения событий о неперехваченных ошибках. Экземпляр этого класса отправляет событие uncaughtError, когда во время выполнения возникает ошибка, которая не обнаруживается и не обрабатывается кодом приложения.

Используйте следующие свойства, чтобы получить доступ к экземпляру UncaughtErrorEvents.

  • LoaderInfo.uncaughtErrorEvents позволяет обнаружить неперехваченные ошибки в коде, определенном в том же SWF-файле.
  • Loader.uncaughtErrorEvents позволяет обнаружить неперехваченные ошибки в коде, определенном в SWF-файле, который загружен в объекте Loader.

Чтобы сразу перехватить ошибку и предотвратить отправку события неперехваченной ошибки, выполните следующие действия.

  • Используйте блок try..catch, чтобы изолировать код, который потенциально может выдавать синхронную ошибку.
  • Когда выполняется операция, которая отправляет событие при возникновении ошибок, зарегистрируйте прослушиватель для этого события ошибки.

Если содержимое, загруженное объектом Loader, является SWF-файлом версии AVM1 (ActionScript 2), неперехваченные ошибки в этом файле не приводят к отправке события uncaughtError. Кроме того, ошибки JavaScript в HTML-содержимом, загруженном в объекте HTMLLoader (включая элемент управления HTML во Flex), не приводят к отправке события uncaughtError.

LoaderInfo.uncaughtErrorEventsLoader.uncaughtErrorEventsUncaughtErrorEventuncaughtError Отправляется, когда возникает ошибка, которую не обнаруживает и не обрабатывает код разработчика.flash.events.UncaughtErrorEvent.UNCAUGHT_ERRORflash.events.UncaughtErrorEvent Отправляется, когда возникает ошибка, которую не обнаруживает и не обрабатывает код разработчика. UncaughtErrorEvents Создает экземпляр UncaughtErrorEvents. Создает экземпляр UncaughtErrorEvents. Код разработчика не должен создать экземпляры UncaughtErrorEvents непосредственно. Чтобы получить доступ к объекту UncaughtErrorEvents, используйте одно из следующих свойств.
  • LoaderInfo.uncaughtErrorEvents позволяет обнаружить неперехваченные ошибки в коде, определенном в том же SWF-файле.
  • Loader.uncaughtErrorEvents позволяет обнаружить неперехваченные ошибки в коде, определенном в SWF-файле, который загружен в объекте Loader.
LoaderInfo.uncaughtErrorEventsLoader.uncaughtErrorEvents
MouseEvent Объект MouseEvent отправляется в поток событий при каждом событии мыши.Объекты событий мыши. flash.events:Event Объект MouseEvent отправляется в поток событий при каждом событии мыши. Как правило, событие мыши генерируется устройством ввода пользователя, например мышью или шаровым манипулятором, в котором используется указатель.

Когда в процессе принимают участие вложенные узлы, события мыши нацелены на самый глубокий вложенный узел, видимый в списке отображения. Этот узел называется целевым. Чтобы предок целевого узла получал оповещение о событии мыши, используйте метод EventDispatcher.addEventListener() для предка, указав в качестве параметра type конкретное событие мыши, которое нужно отслеживать.

В следующем примере используются классы MouseEventExample и ChildSprite, чтобы показать, как отправляются события мыши для простого изображения. Этот код выполняет следующие задачи.
  1. Заявляются свойства для размера (100 x 100 пикселей) и фонового цвета (оранжевый) для последующего использования при рисовании квадрата.
  2. Конструктор создает новый объект ChildSprite с именем child. Его конструктор сначала рисует оранжевый квадрат 100 x 100 пикселей в точке с координатами (0,0) путем вызова метода draw(), а затем добавляет семь прослушивателей событий с подписчиками.
    • click/clickHandler(): отправляется, когда пользователь один раз щелкает квадрат левой кнопкой мыши.
    • doubleClick/doubleClickHandler(): отправляется, когда пользователь дважды щелкает квадрат левой кнопкой мыши.
    • mouseDown/mouseDownHandler(): когда нажимают объект ChildSprite (оранжевый квадрат), на экране печатается сообщение trace(), а затем вызывается метод ChildSprite.draw(), рисующий темно-желтый квадрат вместо голубого, нарисованного методом mouseOverHandler(). Метод mouseDownHandler() также добавляет прослушиватель событий mouseMove и подписчик mouseMoveHandler() (как описано ниже), обрабатывающий перемещение мыши. Затем вызывается метод startDrag(), позволяющий перетаскивать объект Sprite.
    • mouseOut/mouseOutHandler(): отправляется, когда указатель покидает область квадрата. Вызывается метод draw(), чтобы вернуть квадрату обычный размер и цвет.
    • mouseOver/mouseOverHandler(): отправляется, когда указатель мыши находится над квадратом. Этот метод перерисовывает квадрат так, что он становится больше, а фон становится темно-желтым.
    • mouseUp/mouseUpHandler(): когда пользователь отпускает кнопку мыши, прослушиватель события mouseMove удаляется и вызывается метод stopDrag фиксирующий местоположение квадрата.
    • mouseMove/mouseMoveHandler(): вызывается в рамках функции mouseDownHandler() и отправляется, когда пользователь удерживает левую кнопку мыши и перетаскивает квадрат.
    • mouseWheel/mouseWheelHandler(): отправляется при прокручивании пользователем колесика мыши над квадратом.
  3. Затем экземпляр ChildSprite с именем child добавляется в список отображения с помощью метода addChild(), который быстро рисует оранжевый квадрат.

Примечания.

  • Класс MouseEventExample должен быть в корне документа.
  • Некоторые из перечисленных выше методов событий объявляют локальную переменную sprite, которой присваивается значение event.target типа Sprite.
package { import flash.display.Sprite; public class MouseEventExample extends Sprite { private var size:uint = 100; private var bgColor:uint = 0xFFCC00; public function MouseEventExample() { var child:ChildSprite = new ChildSprite(); addChild(child); } } } import flash.display.Sprite; import flash.events.MouseEvent; class ChildSprite extends Sprite { private var size:uint = 50; private var overSize:uint = 60; private var backgroundColor:uint = 0xFFCC00; private var overColor:uint = 0xCCFF00; private var downColor:uint = 0x00CCFF; public function ChildSprite() { draw(size, size, backgroundColor); doubleClickEnabled = true; addEventListener(MouseEvent.CLICK, clickHandler); addEventListener(MouseEvent.DOUBLE_CLICK, doubleClickHandler); addEventListener(MouseEvent.MOUSE_DOWN, mouseDownHandler); addEventListener(MouseEvent.MOUSE_OUT, mouseOutHandler); addEventListener(MouseEvent.MOUSE_OVER, mouseOverHandler); addEventListener(MouseEvent.MOUSE_UP, mouseUpHandler); addEventListener(MouseEvent.MOUSE_WHEEL, mouseWheelHandler); } private function draw(w:uint, h:uint, bgColor:uint):void { graphics.clear(); graphics.beginFill(bgColor); graphics.drawRect(0, 0, w, h); graphics.endFill(); } private function clickHandler(event:MouseEvent):void { trace("clickHandler"); } private function doubleClickHandler(event:MouseEvent):void { trace("doubleClickHandler"); } private function mouseDownHandler(event:MouseEvent):void { trace("mouseDownHandler"); draw(overSize, overSize, downColor); var sprite:Sprite = Sprite(event.target); sprite.addEventListener(MouseEvent.MOUSE_MOVE, mouseMoveHandler); sprite.startDrag(); } private function mouseMoveHandler(event:MouseEvent):void { trace("mouseMoveHandler"); event.updateAfterEvent(); } private function mouseOutHandler(event:MouseEvent):void { trace("mouseOutHandler"); draw(size, size, backgroundColor); } private function mouseOverHandler(event:MouseEvent):void { trace("mouseOverHandler"); draw(overSize, overSize, overColor); } private function mouseWheelHandler(event:MouseEvent):void { trace("mouseWheelHandler delta: " + event.delta); } private function mouseUpHandler(event:MouseEvent):void { trace("mouseUpHandler"); var sprite:Sprite = Sprite(event.target); sprite.removeEventListener(MouseEvent.MOUSE_MOVE, mouseMoveHandler); sprite.stopDrag(); draw(overSize, overSize, overColor); } }
clickflash.events:MouseEvent:CLICKflash.events:MouseEventflash.display.InteractiveObject.clickcontextMenuflash.events:MouseEvent:CONTEXT_MENUflash.events:MouseEventdoubleClickflash.events:MouseEvent:DOUBLE_CLICKflash.events:MouseEventflash.display.InteractiveObject.doubleClickmiddleClickflash.events:MouseEvent:MIDDLE_CLICKflash.events:MouseEventflash.display.InteractiveObject.middleClickmiddleMouseDownflash.events:MouseEvent:MIDDLE_MOUSE_DOWNflash.events:MouseEventflash.display.InteractiveObject.middleMouseDownmiddleMouseUpflash.events:MouseEvent:MIDDLE_MOUSE_UPflash.events:MouseEventflash.display.InteractiveObject.middleMouseUpmouseDownflash.events:MouseEvent:MOUSE_DOWNflash.events:MouseEventflash.display.InteractiveObject.mouseDownmouseMoveflash.events:MouseEvent:MOUSE_MOVEflash.events:MouseEvent В следующем примере рассматривается простая программа для рисования. Пользователь может рисовать на основном объекте Sprite или на прямоугольном объекте Sprite меньшего размера.

В конструкторе создается прямоугольный объект Sprite с именем innerRect и задается зеленый цвет для стиля линии. Стилю линий для рисования контейнера Sprite MouseEvent_MOUSE_MOVEExample задается красный цвет. Добавляются отдельный прослушиватели событий MouseEvent.MOUSE_UP и MouseEvent.MOUSE_DOWN для основного объекта Sprite и объекта Sprite с именем innerRect приложения. В обоих случаях методы прослушивателя событий для нажатого положения мыши перемещают текущее положение точки рисования в местоположение указателя мыши и добавляют прослушиватель для события MouseEvent.MOUSE_MOVE. При перемещении указателя мыши вызванный метод прослушивателя событий следует за указателем и рисует линию с помощью метода graphics.LineTo(). (Примечание. Объект Sprite с именем innerRect скрывает красные линии основного объекта Sprite, нарисованного за прямоугольником.) Когда происходит событие MouseEvent.MOUSE_UP, прослушиватель события MOUSE_MOVE удаляется и рисование прекращается.

package { import flash.display.Sprite; import flash.display.Graphics; import flash.events.MouseEvent; public class MouseEvent_MOUSE_MOVEExample extends Sprite { private var innerRect:Sprite = new Sprite(); public function MouseEvent_MOUSE_MOVEExample() { graphics.lineStyle(3, 0xFF0000, 1); stage.addEventListener(MouseEvent.MOUSE_DOWN, mouseDownHandler); stage.addEventListener(MouseEvent.MOUSE_UP, mouseUpHandler); innerRect.graphics.lineStyle(1, 0x00FF00, 1); innerRect.graphics.beginFill(0xFFFFFF); innerRect.graphics.drawRect(10, 10, 200, 200); innerRect.graphics.endFill(); innerRect.addEventListener(MouseEvent.MOUSE_DOWN, innerRectMouseDownHandler); innerRect.addEventListener(MouseEvent.MOUSE_UP, innerRectMouseUpHandler); addChild(innerRect); } private function mouseDownHandler(event:MouseEvent):void { graphics.moveTo(event.stageX, event.stageY); stage.addEventListener(MouseEvent.MOUSE_MOVE, mouseMoveHandler); } private function mouseMoveHandler(event:MouseEvent):void { graphics.lineTo(event.stageX, event.stageY); } private function mouseUpHandler(event:MouseEvent):void { stage.removeEventListener(MouseEvent.MOUSE_MOVE, mouseMoveHandler); } private function innerRectMouseDownHandler(event:MouseEvent):void { innerRect.graphics.moveTo(event.localX, event.localY); innerRect.addEventListener(MouseEvent.MOUSE_MOVE, innerRectMouseMoveHandler); } private function innerRectMouseMoveHandler(event:MouseEvent):void { innerRect.graphics.lineTo(event.localX, event.localY); } private function innerRectMouseUpHandler(event:MouseEvent):void { innerRect.removeEventListener(MouseEvent.MOUSE_MOVE, innerRectMouseMoveHandler); } } }
flash.display.InteractiveObject.mouseMove
mouseOutflash.events:MouseEvent:MOUSE_OUTflash.events:MouseEventflash.display.InteractiveObject.mouseOutmouseOverflash.events:MouseEvent:MOUSE_OVERflash.events:MouseEventflash.display.InteractiveObject.mouseOvermouseUpflash.events:MouseEvent:MOUSE_UPflash.events:MouseEventflash.display.InteractiveObject.mouseUpmouseWheelflash.events:MouseEvent:MOUSE_WHEELflash.events:MouseEventflash.display.InteractiveObject.mouseWheelrightClickflash.events:MouseEvent:RIGHT_CLICKflash.events:MouseEventflash.display.InteractiveObject.rightClickRightMouseDownflash.events:MouseEvent:RIGHT_MOUSE_DOWNflash.events:MouseEventflash.display.InteractiveObject.rightMouseDownrightMouseUpflash.events:MouseEvent:RIGHT_MOUSE_UPflash.events:MouseEventflash.display.InteractiveObject.rightMouseUprollOutflash.events:MouseEvent:ROLL_OUTflash.events:MouseEventflash.display.InteractiveObject.rollOutrollOverflash.events:MouseEvent:ROLL_OVERflash.events:MouseEventflash.display.InteractiveObject.rollOverMouseEvent Создает объект Event, содержащий данные о событиях мыши.typeString Тип события. Возможные значения: MouseEvent.CLICK, MouseEvent.DOUBLE_CLICK, MouseEvent.MOUSE_DOWN, MouseEvent.MOUSE_MOVE, MouseEvent.MOUSE_OUT, MouseEvent.MOUSE_OVER, MouseEvent.MOUSE_UP, MouseEvent.MIDDLE_CLICK, MouseEvent.MIDDLE_MOUSE_DOWN, MouseEvent.MIDDLE_MOUSE_UP, MouseEvent.RIGHT_CLICK, MouseEvent.RIGHT_MOUSE_DOWN, MouseEvent.RIGHT_MOUSE_UP, MouseEvent.MOUSE_WHEEL, MouseEvent.ROLL_OUT и MouseEvent.ROLL_OVER. bubblesBooleantrue Определяет, участвует ли объект Event в фазе восходящей цепочки потока событий. cancelableBooleanfalseОпределяет, можно ли отменить объект Event. localXNumberunknownГоризонтальная координата события относительно спрайта-контейнера. localYNumberunknownВертикальная координата события относительно спрайта-контейнера. relatedObjectflash.display:InteractiveObjectnullДополняющий экземпляр InteractiveObject, на который влияет событие. Например, когда происходит событие mouseOut, relatedObject представляет объект списка отображения, на который теперь показывает указатель. ctrlKeyBooleanfalseВ Windows или Linux указывает на то, активирована ли клавиша Ctrl. В Mac указывает на то, активирована ли клавиша Ctrl или Command. altKeyBooleanfalseУказывает на то, активирована ли клавиша Alt (только для Windows или Linux). shiftKeyBooleanfalseУказывает, активирована ли клавиша Shift. buttonDownBooleanfalseУказывает, нажата ли основная кнопка мыши. deltaint0Указывает количество строк, подлежащих прокрутке в каждом случае вращения пользователем колесика мыши. Положительное значение delta показывает прокручивание вверх, отрицательное значение показывает прокрутку вниз. Как правило, используются значения в пределах 1-3, но при более быстром прокручивании это число увеличивается. Этот параметр используется только для события MouseEvent.mouseWheel. commandKeyBooleanfalse(Только для AIR) Указывает, активирована ли клавиша Command (только для Mac). Этот параметр используется только для событий MouseEvent.click, MouseEvent.mouseDown, MouseEvent.mouseUp, MouseEvent.middleClick, MouseEvent.middleMouseDown, MouseEvent.middleMouseUp, MouseEvent.rightClick, MouseEvent.rightMouseDown, MouseEvent.rightMouseUp и MouseEvent.doubleClick. Этот параметр только для Adobe AIR; не устанавливать его для содержимого Flash Player. controlKeyBooleanfalse(Только для AIR)Указывает активирована ли клавиша Control или Ctrl. Этот параметр используется только для событий MouseEvent.click, MouseEvent.mouseDown, MouseEvent.mouseUp, MouseEvent.middleClick, MouseEvent.middleMouseDown, MouseEvent.middleMouseUp, MouseEvent.rightClick, MouseEvent.rightMouseDown, MouseEvent.rightMouseUp и MouseEvent.doubleClick. Этот параметр только для Adobe AIR; не устанавливать его для содержимого Flash Player. clickCountint0(Только для AIR) Указывает на то, является ли событие мыши частью последовательности нажатий мышью. Этот параметр будет нулевым для всех событий мыши, кроме MouseEvent.mouseDown, MouseEvent.mouseUp, MouseEvent.middleMouseDown, MouseEvent.middleMouseUp, MouseEvent.rightMouseDown и MouseEvent.rightMouseUp. С помощью параметра clickCount можно прослушивать единичные, двойные и множественные нажатия мышью. Этот параметр только для Adobe AIR; не устанавливать его для содержимого Flash Player. Конструктор для объектов MouseEvent. Создает объект Event, содержащий данные о событиях мыши. Объекты Event передаются прослушивателям событий в качестве параметров. clone Создает копию объекта MouseEvent и задает значение каждого свойства, совпадающее с оригиналом.Новый объект MouseEvent, значения свойств которого соответствуют значениям оригинала. flash.events:Event Создает копию объекта MouseEvent и задает значение каждого свойства, совпадающее с оригиналом. toString Возвращает строку, содержащую все свойства объекта MouseEvent.Строка, содержащая все свойства объекта MouseEvent. String Возвращает строку, содержащую все свойства объекта MouseEvent. Строка имеет следующий формат:

[MouseEvent type=value bubbles=value cancelable=value ... delta=value]

updateAfterEvent Предписывает проигрывателю Flash Player или Adobe AIR выполнить визуализацию после обработки данного события, если список отображения был изменен. Предписывает проигрывателю Flash Player или Adobe AIR выполнить визуализацию после обработки данного события, если список отображения был изменен. CLICK Задает значение свойства type для объекта события click.clickString Задает значение свойства type для объекта события click.

Это событие имеет следующие свойства:

СвойствоЗначениеaltKeytrue, если клавиша Alt активна (Windows).bubblestruebuttonDownДля событий щелчка всегда используется значение false.cancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.commandKeytrue в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows.controlKeytrue, если клавиша Ctrl или Control активна; false, если неактивна.ctrlKeytrue в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.localXГоризонтальная координата события относительно спрайта-контейнера.localYВертикальная координата события относительно спрайта-контейнера.shiftKeytrue, если клавиша Shift активна; иначе — false.stageXГоризонтальная координата события в глобальных координатах рабочей области.stageYВертикальная координата события в глобальных координатах рабочей области.targetОбъект InteractiveObject под указателем. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент.
flash.display.InteractiveObject.click
CONTEXT_MENU Константа MouseEvent.CONTEXT_MENU определяет значение свойства type объекта события contextMenu.contextMenuString Константа MouseEvent.CONTEXT_MENU определяет значение свойства type объекта события contextMenu.

Это событие имеет следующие свойства:

СвойствоЗначениеaltKeytrue, если клавиша Alt активна (Windows).bubblestruebuttonDowntrue, если правая кнопка мыши нажата; иначе —false.cancelablefalse; поведение по умолчанию отменить невозможно.commandKeytrue в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows.controlKeytrue, если клавиша Ctrl или Control активна; false, если неактивна.ctrlKeytrue в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.localXГоризонтальная координата события относительно спрайта-контейнера.localYВертикальная координата события относительно спрайта-контейнера.shiftKeytrue, если клавиша Shift активна; иначе — false.clickCountЧисло нажатий мышью, указывающее на то, является ли событие частью последовательности множественных нажатий мышью.stageXГоризонтальная координата события в глобальных координатах рабочей области.stageYВертикальная координата события в глобальных координатах рабочей области.targetОбъект InteractiveObject под указателем. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент.
DOUBLE_CLICK Задает значение свойства type для объекта события doubleClick.doubleClickString Задает значение свойства type для объекта события doubleClick. Свойство doubleClickEnabled должно иметь значение true, чтобы объект мог генерировать событие doubleClick.

Это событие имеет следующие свойства:

СвойствоЗначениеaltKeytrue, если клавиша Alt активна (Windows).bubblestruebuttonDownДля событий двойного щелчка всегда используется значение false.cancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.commandKeytrue в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows.controlKeytrue, если клавиша Ctrl или Control активна; false, если неактивна.ctrlKeytrue в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.localXГоризонтальная координата события относительно спрайта-контейнера.localYВертикальная координата события относительно спрайта-контейнера.shiftKeytrue, если клавиша Shift активна; иначе — false.stageXГоризонтальная координата события в глобальных координатах рабочей области.stageYВертикальная координата события в глобальных координатах рабочей области.targetОбъект InteractiveObject под указателем. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент.
flash.display.InteractiveObject.doubleClick
MIDDLE_CLICK Определяет значение свойства type объекта события middleClick.middleClickString Определяет значение свойства type объекта события middleClick.

Это событие имеет следующие свойства:

СвойствоЗначениеaltKeytrue, если клавиша Alt активна (Windows).bubblestruebuttonDownДля событий промежуточного щелчка всегда используется значение false.cancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.commandKeytrue в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows.controlKeytrue, если клавиша Ctrl или Control активна; false, если неактивна.ctrlKeytrue в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.localXГоризонтальная координата события относительно спрайта-контейнера.localYВертикальная координата события относительно спрайта-контейнера.shiftKeytrue, если клавиша Shift активна; иначе — false.stageXГоризонтальная координата события в глобальных координатах рабочей области.stageYВертикальная координата события в глобальных координатах рабочей области.targetОбъект InteractiveObject под указателем. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент.
flash.display.InteractiveObject.middleClick
MIDDLE_MOUSE_DOWN Определяет значение свойства type объекта события middleMouseDown.middleMouseDownString Определяет значение свойства type объекта события middleMouseDown.

Это событие имеет следующие свойства:

СвойствоЗначениеaltKeytrue, если клавиша Alt активна (Windows).bubblestruebuttonDowntrue, если нажата средняя кнопка мыши; иначе — false.cancelablefalse; поведение по умолчанию отменить невозможно.commandKeytrue в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows.controlKeytrue, если клавиша Ctrl или Control активна; false, если неактивна.ctrlKeytrue в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.localXГоризонтальная координата события относительно спрайта-контейнера.localYВертикальная координата события относительно спрайта-контейнера.shiftKeytrue, если клавиша Shift активна; иначе — false.clickCountЧисло нажатий мышью, указывающее на то, является ли событие частью последовательности множественных нажатий мышью.stageXГоризонтальная координата события в глобальных координатах рабочей области.stageYВертикальная координата события в глобальных координатах рабочей области.targetОбъект InteractiveObject под указателем. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент.
flash.display.InteractiveObject.middleMouseDown
MIDDLE_MOUSE_UP Определяет значение свойства type объекта события middleMouseUp.middleMouseUpString Определяет значение свойства type объекта события middleMouseUp.

Это событие имеет следующие свойства:

СвойствоЗначениеaltKeytrue, если клавиша Alt активна (Windows).bubblestruebuttonDowntrue, если нажата средняя кнопка мыши; иначе — false.cancelablefalse; поведение по умолчанию отменить невозможно.commandKeytrue в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows.controlKeytrue, если клавиша Ctrl или Control активна; false, если неактивна.ctrlKeytrue в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.localXГоризонтальная координата события относительно спрайта-контейнера.localYВертикальная координата события относительно спрайта-контейнера.shiftKeytrue, если клавиша Shift активна; иначе — false.clickCountЧисло нажатий мышью, указывающее на то, является ли событие частью последовательности множественных нажатий мышью.stageXГоризонтальная координата события в глобальных координатах рабочей области.stageYВертикальная координата события в глобальных координатах рабочей области.targetОбъект InteractiveObject под указателем. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент.
flash.display.InteractiveObject.middleMouseUp
MOUSE_DOWN Задает значение свойства type для объекта события mouseDown.mouseDownString Задает значение свойства type для объекта события mouseDown.

Это событие имеет следующие свойства:

СвойствоЗначениеaltKeytrue, если клавиша Alt активна (Windows).bubblestruebuttonDowntrue, если нажата основная кнопка мыши; иначе — false.cancelablefalse; поведение по умолчанию отменить невозможно.commandKeytrue в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows.controlKeytrue, если клавиша Ctrl или Control активна; false, если неактивна.ctrlKeytrue в Windows и Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.localXГоризонтальная координата события относительно спрайта-контейнера.localYВертикальная координата события относительно спрайта-контейнера.shiftKeytrue, если клавиша Shift активна; иначе — false.clickCountЧисло нажатий мышью, указывающее на то, является ли событие частью последовательности множественных нажатий мышью.stageXГоризонтальная координата события в глобальных координатах рабочей области.stageYВертикальная координата события в глобальных координатах рабочей области.targetОбъект InteractiveObject под указателем. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент.
Пример использования этой константы см. в примере константы MOUSE_MOVE.
flash.display.InteractiveObject.mouseDown
MOUSE_MOVE Задает значение свойства type для объекта события mouseMove.mouseMoveString Задает значение свойства type для объекта события mouseMove.

Это событие имеет следующие свойства:

СвойствоЗначениеaltKeytrue, если клавиша Alt активна (Windows).bubblestruebuttonDowntrue, если нажата основная кнопка мыши; иначе — false.cancelablefalse; поведение по умолчанию отменить невозможно.commandKeytrue в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows.controlKeytrue, если клавиша Ctrl или Control активна; false, если неактивна.ctrlKeytrue в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.localXГоризонтальная координата события относительно спрайта-контейнера.localYВертикальная координата события относительно спрайта-контейнера.shiftKeytrue, если клавиша Shift активна; иначе — false.stageXГоризонтальная координата события в глобальных координатах рабочей области.stageYВертикальная координата события в глобальных координатах рабочей области.targetОбъект InteractiveObject под указателем. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент.
В следующем примере рассматривается простая программа для рисования. Пользователь может рисовать на основном объекте Sprite или на прямоугольном объекте Sprite меньшего размера.

В конструкторе создается прямоугольный объект Sprite с именем innerRect и задается зеленый цвет для стиля линии. Стилю линий для рисования контейнера Sprite MouseEvent_MOUSE_MOVEExample задается красный цвет. Добавляются отдельный прослушиватели событий MouseEvent.MOUSE_UP и MouseEvent.MOUSE_DOWN для основного объекта Sprite и объекта Sprite с именем innerRect приложения. В обоих случаях методы прослушивателя событий для нажатого положения мыши перемещают текущее положение точки рисования в местоположение указателя мыши и добавляют прослушиватель для события MouseEvent.MOUSE_MOVE. При перемещении указателя мыши вызванный метод прослушивателя событий следует за указателем и рисует линию с помощью метода graphics.LineTo(). (Примечание. Объект Sprite с именем innerRect скрывает красные линии основного объекта Sprite, нарисованного за прямоугольником.) Когда происходит событие MouseEvent.MOUSE_UP, прослушиватель события MOUSE_MOVE удаляется и рисование прекращается.

package { import flash.display.Sprite; import flash.display.Graphics; import flash.events.MouseEvent; public class MouseEvent_MOUSE_MOVEExample extends Sprite { private var innerRect:Sprite = new Sprite(); public function MouseEvent_MOUSE_MOVEExample() { graphics.lineStyle(3, 0xFF0000, 1); stage.addEventListener(MouseEvent.MOUSE_DOWN, mouseDownHandler); stage.addEventListener(MouseEvent.MOUSE_UP, mouseUpHandler); innerRect.graphics.lineStyle(1, 0x00FF00, 1); innerRect.graphics.beginFill(0xFFFFFF); innerRect.graphics.drawRect(10, 10, 200, 200); innerRect.graphics.endFill(); innerRect.addEventListener(MouseEvent.MOUSE_DOWN, innerRectMouseDownHandler); innerRect.addEventListener(MouseEvent.MOUSE_UP, innerRectMouseUpHandler); addChild(innerRect); } private function mouseDownHandler(event:MouseEvent):void { graphics.moveTo(event.stageX, event.stageY); stage.addEventListener(MouseEvent.MOUSE_MOVE, mouseMoveHandler); } private function mouseMoveHandler(event:MouseEvent):void { graphics.lineTo(event.stageX, event.stageY); } private function mouseUpHandler(event:MouseEvent):void { stage.removeEventListener(MouseEvent.MOUSE_MOVE, mouseMoveHandler); } private function innerRectMouseDownHandler(event:MouseEvent):void { innerRect.graphics.moveTo(event.localX, event.localY); innerRect.addEventListener(MouseEvent.MOUSE_MOVE, innerRectMouseMoveHandler); } private function innerRectMouseMoveHandler(event:MouseEvent):void { innerRect.graphics.lineTo(event.localX, event.localY); } private function innerRectMouseUpHandler(event:MouseEvent):void { innerRect.removeEventListener(MouseEvent.MOUSE_MOVE, innerRectMouseMoveHandler); } } }
flash.display.InteractiveObject.mouseMove
MOUSE_OUT Задает значение свойства type для объекта события mouseOut.mouseOutString Задает значение свойства type для объекта события mouseOut.

Это событие имеет следующие свойства:

СвойствоЗначениеaltKeytrue, если клавиша Alt активна (Windows).bubblestruebuttonDowntrue, если нажата основная кнопка мыши; иначе — false.cancelablefalse; поведение по умолчанию отменить невозможно.commandKeytrue в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows.controlKeytrue, если клавиша Ctrl или Control активна; false, если неактивна.ctrlKeytrue в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.relatedObjectОбъект списка отображения, на который сейчас указывает мышь.localXГоризонтальная координата события относительно спрайта-контейнера.localYВертикальная координата события относительно спрайта-контейнера.shiftKeytrue, если клавиша Shift активна; иначе — false.stageXГоризонтальная координата события в глобальных координатах рабочей области.stageYВертикальная координата события в глобальных координатах рабочей области.targetОбъект InteractiveObject под указателем. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент.
flash.display.InteractiveObject.mouseOut
MOUSE_OVER Задает значение свойства type для объекта события mouseOver.mouseOverString Задает значение свойства type для объекта события mouseOver.

Это событие имеет следующие свойства:

СвойствоЗначениеaltKeytrue, если клавиша Alt активна (Windows).bubblestruebuttonDowntrue, если нажата основная кнопка мыши; иначе — false.cancelablefalse; поведение по умолчанию отменить невозможно.commandKeytrue в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows.controlKeytrue, если клавиша Ctrl или Control активна; false, если неактивна.ctrlKeytrue в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.relatedObjectОбъект списка отображения, на который указывала мышь.localXГоризонтальная координата события относительно спрайта-контейнера.localYВертикальная координата события относительно спрайта-контейнера.shiftKeytrue, если клавиша Shift активна; иначе — false.stageXГоризонтальная координата события в глобальных координатах рабочей области.stageYВертикальная координата события в глобальных координатах рабочей области.targetОбъект InteractiveObject под указателем. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент.
flash.display.InteractiveObject.mouseOver
MOUSE_UP Задает значение свойства type объекта события mouseUp.mouseUpString Задает значение свойства type объекта события mouseUp.

Это событие имеет следующие свойства:

СвойствоЗначениеaltKeytrue, если клавиша Alt активна (Windows).bubblestruebuttonDowntrue, если нажата основная кнопка мыши; иначе — false.cancelablefalse; поведение по умолчанию отменить невозможно.commandKeytrue в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows.controlKeytrue, если клавиша Ctrl или Control активна; false, если неактивна.ctrlKeytrue в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.localXГоризонтальная координата события относительно спрайта-контейнера.localYВертикальная координата события относительно спрайта-контейнера.shiftKeytrue, если клавиша Shift активна; иначе — false.clickCountЧисло нажатий мышью, указывающее на то, является ли событие частью последовательности множественных нажатий мышью.stageXГоризонтальная координата события в глобальных координатах рабочей области.stageYВертикальная координата события в глобальных координатах рабочей области.targetОбъект InteractiveObject под указателем. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент.
Пример использования этой константы см. в примере константы MOUSE_MOVE.
flash.display.InteractiveObject.mouseUp
MOUSE_WHEEL Задает значение свойства type для объекта события mouseWheel.mouseWheelString Задает значение свойства type для объекта события mouseWheel.

Это событие имеет следующие свойства:

СвойствоЗначениеaltKeytrue, если клавиша Alt активна (Windows).bubblestruebuttonDowntrue, если нажата основная кнопка мыши; иначе — false.cancelablefalse; поведение по умолчанию отменить невозможно.commandKeytrue в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows.controlKeytrue, если клавиша Ctrl или Control активна; false, если неактивна.ctrlKeytrue в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.deltaЧисло строк за каждую прокрутку колесика мышки.localXГоризонтальная координата события относительно спрайта-контейнера.localYВертикальная координата события относительно спрайта-контейнера.shiftKeytrue, если клавиша Shift активна; иначе — false.stageXГоризонтальная координата события в глобальных координатах рабочей области.stageYВертикальная координата события в глобальных координатах рабочей области.targetОбъект InteractiveObject под указателем. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент.
flash.display.InteractiveObject.mouseWheel
RIGHT_CLICK Определяет значение свойства type объекта события rightClick.rightClickString Определяет значение свойства type объекта события rightClick.

Это событие имеет следующие свойства:

СвойствоЗначениеaltKeytrue, если клавиша Alt активна (Windows).bubblestruebuttonDownДля событий щелчка правой кнопкой мыши всегда используется значение false.cancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.commandKeytrue в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows.controlKeytrue, если клавиша Ctrl или Control активна; false, если неактивна.ctrlKeytrue в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.localXГоризонтальная координата события относительно спрайта-контейнера.localYВертикальная координата события относительно спрайта-контейнера.shiftKeytrue, если клавиша Shift активна; иначе — false.stageXГоризонтальная координата события в глобальных координатах рабочей области.stageYВертикальная координата события в глобальных координатах рабочей области.targetОбъект InteractiveObject под указателем. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент.
flash.display.InteractiveObject.rightClick
RIGHT_MOUSE_DOWN Определяет значение свойства type объекта события rightMouseDown.rightMouseDownString Определяет значение свойства type объекта события rightMouseDown.

Это событие имеет следующие свойства:

СвойствоЗначениеaltKeytrue, если клавиша Alt активна (Windows).bubblestruebuttonDownДля событий щелчка правой кнопкой мыши всегда используется значение true.cancelablefalse; поведение по умолчанию отменить невозможно.commandKeytrue в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows.controlKeytrue, если клавиша Ctrl или Control активна; false, если неактивна.ctrlKeytrue в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.localXГоризонтальная координата события относительно спрайта-контейнера.localYВертикальная координата события относительно спрайта-контейнера.shiftKeytrue, если клавиша Shift активна; иначе — false.clickCountЧисло нажатий мышью, указывающее на то, является ли событие частью последовательности множественных нажатий мышью.stageXГоризонтальная координата события в глобальных координатах рабочей области.stageYВертикальная координата события в глобальных координатах рабочей области.targetОбъект InteractiveObject под указателем. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент.
flash.display.InteractiveObject.rightMouseDown
RIGHT_MOUSE_UP Определяет значение свойства type объекта события rightMouseUp.rightMouseUpString Определяет значение свойства type объекта события rightMouseUp.

Это событие имеет следующие свойства:

СвойствоЗначениеaltKeytrue, если клавиша Alt активна (Windows).bubblestruebuttonDowntrue, если правая кнопка мыши нажата; иначе —false.cancelablefalse; поведение по умолчанию отменить невозможно.commandKeytrue в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows.controlKeytrue, если клавиша Ctrl или Control активна; false, если неактивна.ctrlKeytrue в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.localXГоризонтальная координата события относительно спрайта-контейнера.localYВертикальная координата события относительно спрайта-контейнера.shiftKeytrue, если клавиша Shift активна; иначе — false.clickCountЧисло нажатий мышью, указывающее на то, является ли событие частью последовательности множественных нажатий мышью.stageXГоризонтальная координата события в глобальных координатах рабочей области.stageYВертикальная координата события в глобальных координатах рабочей области.targetОбъект InteractiveObject под указателем. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент.
flash.display.InteractiveObject.rightMouseUp
ROLL_OUT Задает значение свойства type для объекта события rollOut.rollOutString Задает значение свойства type для объекта события rollOut.

Это событие имеет следующие свойства:

СвойствоЗначениеaltKeytrue, если клавиша Alt активна (Windows).bubblesfalsebuttonDowntrue, если нажата основная кнопка мыши; иначе — false.cancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.commandKeytrue в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows.controlKeytrue, если клавиша Ctrl или Control активна; false, если неактивна.ctrlKeytrue в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.relatedObjectОбъект списка отображения, на который сейчас указывает мышь.localXГоризонтальная координата события относительно спрайта-контейнера.localYВертикальная координата события относительно спрайта-контейнера.shiftKeytrue, если клавиша Shift активна; иначе — false.stageXГоризонтальная координата события в глобальных координатах рабочей области.stageYВертикальная координата события в глобальных координатах рабочей области.targetОбъект InteractiveObject под указателем. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент.
flash.display.InteractiveObject.rollOut
ROLL_OVER Задает значение свойства type для объекта события rollOver.rollOverString Задает значение свойства type для объекта события rollOver.

Это событие имеет следующие свойства:

СвойствоЗначениеaltKeytrue, если клавиша Alt активна (Windows).bubblesfalsebuttonDowntrue, если нажата основная кнопка мыши; иначе — false.cancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.commandKeytrue в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows.controlKeytrue, если клавиша Ctrl или Control активна; false, если неактивна.ctrlKeytrue в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.relatedObjectОбъект списка отображения, на который указывала мышь.localXГоризонтальная координата события относительно спрайта-контейнера.localYВертикальная координата события относительно спрайта-контейнера.shiftKeytrue, если клавиша Shift активна; иначе — false.stageXГоризонтальная координата события в глобальных координатах рабочей области.stageYВертикальная координата события в глобальных координатах рабочей области.targetОбъект InteractiveObject под указателем. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент.
flash.display.InteractiveObject.rollOver
altKey Показывает активность клавиши Alt: true — активна, false — неактивна.Boolean Показывает активность клавиши Alt: true — активна, false — неактивна. Поддерживается только для ОС Windows. В других операционных системах это свойство всегда имеет значение false. buttonDown Указывает состояние левой кнопки мыши: нажата (true) или не нажата (false).Boolean Показывает, нажата ли основная кнопка мыши: true — да, false — нет. clickCount Указывает на то, является ли событие для нажатого положения мыши частью последовательности нажатий мышью.int Указывает на то, является ли событие для нажатого положения мыши частью последовательности нажатий мышью. Этот параметр будет нулевым для всех событий мыши, кроме MouseEvent.mouseDown, MouseEvent.mouseUp, MouseEvent.middleMouseDown, MouseEvent.middleMouseUp, MouseEvent.rightMouseDown и MouseEvent.rightMouseUp. С помощью параметра clickCount можно прослушивать единичные, двойные и множественные нажатия мышью. Например, для первоначального события MouseEvent.mouseDown и MouseEvent.mouseUp свойство clickCount будет иметь значение 1, а для второго события MouseEvent.mouseDown и MouseEvent.mouseUp в последовательности двойного нажатия свойство clickCount будет иметь значение 2. При значительном движении мыши или если последовательность множественных нажатий мышью прервана по каким-либо причинам, следующее событие MouseEvent.mouseDown будет иметь значение свойства clickCount равное 1. Событие doubleClick будет отправляться, как обычно. commandKey Указывает, активирована ли клавиша Command (только для Mac). Свойство commandKey будет иметь то же значение, что и свойство ctrlKey в Mac.Boolean Указывает, активирована ли клавиша Command (только для Mac).

Свойство commandKey будет иметь то же значение, что и свойство ctrlKey в Mac. Всегда значение false в Windows или Linux.

controlKey Указывает, активирована ли клавиша Control в Mac или клавиша Ctrl в Windows или Linux.Boolean Указывает, активирована ли клавиша Control в Mac или клавиша Ctrl в Windows или Linux. ctrlKey В Windows или Linux указывает на то, активирована ли клавиша Ctrl (true) или нет (false).Boolean В Windows или Linux указывает на то, активирована ли клавиша Ctrl (true) или нет (false). В Macintosh указывает на то, активирована ли клавиша Control или Command. delta Указывает количество строк, подлежащих прокрутке в каждом случае вращения пользователем колесика мыши.int Указывает количество строк, подлежащих прокрутке в каждом случае вращения пользователем колесика мыши. Положительное значение delta показывает прокручивание вверх, отрицательное значение показывает прокрутку вниз. Как правило, используются значения в пределах 1-3, но при более быстром прокручивании это число увеличивается. Этот параметр зависит от устройства и операционной системы, как правило, его может настраивать пользователь. Это свойство применяется только к событию MouseEvent.mouseWheel. isRelatedObjectInaccessible Если принимает значение true, свойство relatedObject принимает значение null по причинам, связанным с изолированными средами безопасности.Boolean Если принимает значение true, свойство relatedObject принимает значение null по причинам, связанным с изолированными средами безопасности. Если номинальным значением свойства relatedObject является ссылка на объект DisplayObject в другой изолированной среде, свойство relatedObject принимает значение null, пока не будут заданы двусторонние права в границах данной изолированной среды. Права задаются путем вызова метода Security.allowDomain() из SWF-файла или указания файла политик на сервере файла изображений и задания свойства LoaderContext.checkPolicyFile при загрузке изображения. MouseEvent.relatedObjectSecurity.allowDomain()LoaderContext.checkPolicyFilelocalX Горизонтальная координата события относительно спрайта-контейнера.Number Горизонтальная координата события относительно спрайта-контейнера. Пример использования этого свойства см. в примере для константы MOUSE_MOVE. localY Вертикальная координата события относительно спрайта-контейнера.Number Вертикальная координата события относительно спрайта-контейнера. Пример использования этого свойства см. в примере для константы MOUSE_MOVE. relatedObject Ссылка на объект списка отображения, связанный с событием.flash.display:InteractiveObject Ссылка на объект списка отображения, связанный с событием. Например, когда происходит событие mouseOut, relatedObject представляет объект списка отображения, на который теперь показывает указатель. Это свойство применяется к событиям mouseOut, mouseOver, rollOut и rollOver.

Это свойство может принимать значение null по двум причинам: связанный объект отсутствует или связанный объект существует, но находится в изолированной программной среде безопасности, доступ к которой запрещен. Используйте свойство isRelatedObjectInaccessible() для определения причины.

MouseEvent.isRelatedObjectInaccessible
shiftKey Показывает активность клавиши Shift: true — активна, false — неактивна.Boolean Показывает активность клавиши Shift: true — активна, false — неактивна. stageX Горизонтальная координата события в глобальных координатах рабочей области.Number Горизонтальная координата события в глобальных координатах рабочей области. Это свойство вычисляется, когда задано свойство localX. Пример использования этого свойства см. в примере для константы MOUSE_MOVE. stageY Вертикальная координата события в глобальных координатах рабочей области.Number Вертикальная координата события в глобальных координатах рабочей области. Это свойство вычисляется, когда задано свойство localY. Пример использования этого свойства см. в примере для константы MOUSE_MOVE.
IEventDispatcher Интерфейс IEventDispatcher определяет методы добавления и удаления прослушивателей событий, проверяет, зарегистрированы ли определенные типы прослушивателей событий и отправляет события. Интерфейс IEventDispatcher определяет методы добавления и удаления прослушивателей событий, проверяет, зарегистрированы ли определенные типы прослушивателей событий и отправляет события.

Цели событий являются важным компонентом модели событий во Flash® Player и Adobe AIR. Цель события является основным фактором, определяющим прохождение потока событий по иерархии списка отображения. Когда происходит такое событие, как щелчок мыши или нажатие клавиши, объект Event отправляется в поток событий из корня списка отображения. Объект Event проходит путь к цели события и обратно, разделенный на три фазы: фаза захвата от корня к последнему узлу перед целевым узлом события; фаза цели включает только целевой узел события; а фаза восходящей цепочки включает все последующие узлы на пути обратно к корневому узлу списка отображения.

Как правило, чтобы дать определенному пользователем классу возможность отправлять события, проще всего расширить класс EventDispatcher. Если это невозможно (например, если класс уже расширяет другой класс), можно внедрить интерфейс IEventDispatcher, создайте элемент EventDispatcher и создайте простые процедуры для направления вызовов в собранный EventDispatcher.

В следующем примере используются классы IEventDispatcherExample и DecoratedDispatcher, чтобы продемонстрировать реализацию и использование класса IEventDispatcher. Для этого каждый метод DecoratedDispatcher реализуется так же, как и в EventDispatcher. В конструкторе IEventDispatcherExample создается новый экземпляр класса DecoratedDispatcher (с именем decorDispatcher), затем с помощью переменной decorDispatcher вызывается метод addEventListener() с пользовательским событием doSomething, которое затем обрабатывается методом didSomething(), распечатывающим строку текста с помощью trace(). package { import flash.events.Event; import flash.display.Sprite; public class IEventDispatcherExample extends Sprite { public function IEventDispatcherExample() { var decorDispatcher:DecoratedDispatcher = new DecoratedDispatcher(); decorDispatcher.addEventListener("doSomething", didSomething); decorDispatcher.dispatchEvent(new Event("doSomething")); } public function didSomething(evt:Event):void { trace(">> didSomething"); } } } import flash.events.IEventDispatcher; import flash.events.EventDispatcher; import flash.events.Event; class DecoratedDispatcher implements IEventDispatcher { private var dispatcher:EventDispatcher; public function DecoratedDispatcher() { dispatcher = new EventDispatcher(this); } public function addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void{ dispatcher.addEventListener(type, listener, useCapture, priority); } public function dispatchEvent(evt:Event):Boolean{ return dispatcher.dispatchEvent(evt); } public function hasEventListener(type:String):Boolean{ return dispatcher.hasEventListener(type); } public function removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void{ dispatcher.removeEventListener(type, listener, useCapture); } public function willTrigger(type:String):Boolean { return dispatcher.willTrigger(type); } }
addEventListener Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии.typeStringТип события. listenerFunctionФункция прослушивателя, обрабатывающая событие. Эта функция принимает объект события как единственный параметр и ничего не возвращает, например:

function(evt:Event):void

Эта функция может иметь любое имя.
useCaptureBooleanfalseОпределяет, работает ли прослушиватель в фазе захвата или в целевой фазе и в фазе восходящей цепочки. Если значение useCapture равно true, прослушиватель обрабатывает событие только во время фазы захвата, но не во время целевой фазы или фазы восходящей цепочки. Если значение useCapture равно false, то прослушиватель обрабатывает событие только в целевой фазе или фазе восходящей цепочки. Для прослушивания события во всех трех фазах следует дважды вызвать addEventListener(), первый раз с useCapture, равным true, а второй раз с useCapture, равным false. priorityint0Уровень приоритета прослушивателя событий. Приоритеты обозначены 32-разрядным целым числом. Чем больше число, тем выше приоритет. Все прослушиватели с приоритетом n обрабатываются перед обработкой прослушивателей с приоритетом n-1. Прослушиватели с одинаковым приоритетом обрабатываются в порядке их добавления. Значение приоритета по умолчанию равно 0. useWeakReferenceBooleanfalseОпределяет, является ли ссылка на listener «сильной» или «слабой». «Сильная» ссылка (по умолчанию) предотвращает удаление listener сборщиком мусора. «Слабая» ссылка не выполняет эту функцию.

Функции элементов уровня класса не подлежат удалению в качестве мусора, вследствие чего можно установить useWeakReference равным true для функций элементов уровня класса, не подвергая их возможности подобного удаления. Если значение useWeakReference равно true для прослушивателя, являющегося вложенной внутренней функцией, такая функция может быть удалена в качестве мусора и перестанет быть устойчивой. При создании ссылок на внутреннюю функцию (возможно сохранение в другой переменной) она не будет собираться в качестве мусора и останется устойчивой.

Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии. Можно регистрировать прослушиватели событий в любом узле из списка отображения для каждого типа события, фазы и приоритета.

После успешной регистрации прослушивателя событий невозможно изменить его приоритет путем дополнительных вызовов addEventListener(). Для изменения приоритета прослушивателя следует вначале вызвать removeEventListener(). Затем можно снова зарегистрировать прослушиватель с новым приоритетом.

После регистрации прослушивателя последующие вызовы addEventListener() со значениями, отличающимися от type и useCapture приводят к его отдельной регистрации. Например, прослушиватель, изначально зарегистрированный со значением useCapture, равным true, прослушивает только во время фазы захвата. После повторного вызова addEventListener() с помощью аналогичного объекта прослушивания, но со значением useCapture, равным false, активными становятся два отдельных прослушивателя: один прослушивает во время фазы захвата, второй – во время целевой фазы и фазы восходящей цепочки.

Невозможно зарегистрировать прослушиватель события только для целевой фазы или для фазы восходящей цепочки. Эти фазы соединены при регистрации, поскольку восходящая цепочка применяется только к предшественникам целевого узла.

При отсутствии необходимости в прослушивателе события он может быть удален с помощью вызова EventDispatcher.removeEventListener(); в противном случае могут возникнуть проблемы с памятью. Объекты с зарегистрированными прослушивателями события автоматически не удаляются из памяти, поскольку сборщик мусора не удаляет объекты, на которые имеются ссылки.

Копирование экземпляра EventDispatcher не приводит к копированию прослушивателей событий, присоединенных к нему. (Если для вновь создаваемого узла требуется прослушиватель событий, его необходимо присоединить после создания узла.) При этом при перемещении экземпляра EventDispatcher присоединенные к нему прослушиватели событий перемещаются вместе с ним.

Прослушиватель событий, регистрируемый на узле, на котором в это время обрабатывается событие, не запускается в ходе текущей фазы, но может быть запущен в потоке событий более поздней фазы, например фазы восходящей цепочки.

Прослушиватель событий, удаленный из узла во время обработки события на этом узле, будет запускаться текущими операциями. После удаления прослушиватель событий никогда не вызывается повторно (если только он не был повторно зарегистрирован для будущей обработки).

dispatchEvent Посылает событие в поток событий.Значение равно true до тех пор, пока preventDefault() не будет вызван для события; в этом случае возвращается значение false. Booleaneventflash.events:EventОбъект события, переданный в поток событий. Посылает событие в поток событий. Адресатом события является объект EventDispatcher, в котором вызывается dispatchEvent(). hasEventListener Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события.Значение true, если прослушиватель указанного типа зарегистрирован; в противном случае – false. BooleantypeStringТип события. Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события. Это позволяет определить, где объект EventDispatcher изменил обработку типа события в иерархии потока событий. Для определения, действительно ли определенный тип события запускает прослушиватель события, следует использовать IEventDispatcher.willTrigger().

Различие между hasEventListener() и willTrigger() заключается в том, что hasEventListener() анализирует только объект, к которому он принадлежит, тогда как willTrigger() — весь поток событий для события, указанного параметром type.

willTrigger()
removeEventListener Удаляет прослушиватель из объекта EventDispatcher.typeStringТип события. listenerFunctionУдаляемый объект прослушивателя. useCaptureBooleanfalseУказывает, был ли слушатель зарегистрирован для фазы захвата или целевой фазы и фазы восходящей цепочки. Если прослушиватель был зарегистрирован для фазы захвата, целевой фазы и фазы восходящей цепочки, необходимо удалить оба вызова removeEventListener(): один вызов с useCapture, равным true, и второй вызов с useCapture, равным false. Удаляет прослушиватель из объекта EventDispatcher. При отсутствии прослушивателя, зарегистрированного с объектом EventDispatcher, вызов этого метода не оказывает эффекта. willTrigger Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником.Значение равно true при запуске прослушивателя указанного типа; в противном случае значение равно false. BooleantypeStringТип события. Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником. Этот метод возвращает значение true, если прослушиватель события запускается в течение любой фазы потока событий, когда событие указанного типа передается объекту EventDispatcher или любому из его нижестоящих элементов.

Различие между hasEventListener() и willTrigger() заключается в том, что hasEventListener() анализирует только объект, к которому он принадлежит, тогда как willTrigger() — весь поток событий для события, указанного параметром type.

SQLErrorEvent Экземпляр SQLErrorEvent отправляется экземпляром SQLConnection или SQLStatement при ошибке во время выполнения операции базы данных в асинхронном режиме.flash.events:ErrorEvent Экземпляр SQLErrorEvent отправляется экземпляром SQLConnection или SQLStatement при ошибке во время выполнения операции базы данных в асинхронном режиме. Экземпляр SQLErrorEvent, передаваемый в качестве объекта события прослушивателям, предоставляет доступ к сведениям о причине ошибки и предпринятой операции.

Конкретные сведения о сбое можно найти в объекте SQLError свойства error экземпляра SQLErrorEvent.

flash.errors.SQLErrorflash.data.SQLConnectionflash.data.SQLStatementerrorflash.events:SQLErrorEvent:ERRORflash.events:SQLErrorEventflash.data.SQLConnectionflash.data.SQLStatementflash.errors.SQLErrorSQLErrorEvent Создает объект SQLErrorEvent для передачи в качестве аргумента прослушивателям событий.typeString Тип события, доступный в свойстве type. SQLErrorEvent определяет один тип событий, error, представленный константой SQLErrorEvent.ERROR. bubblesBooleanfalse Определяет, участвует ли объект Event в фазе восходящей цепочки потока событий. Значение по умолчанию false. cancelableBooleanfalseОпределяет, может ли объект Event быть отменен. Значение по умолчанию false. errorflash.errors:SQLErrornullОбъект SQLError, содержащий сведения об ошибке. Используется для создания нового объекта SQLErrorEvent. Создает объект SQLErrorEvent для передачи в качестве аргумента прослушивателям событий. flash.errors.SQLError;ERRORclone Создает копию объекта SQLErrorEvent и задает значение каждого свойства, совпадающее с оригиналом.Новый объект SQLErrorEvent, значения свойств которого соответствуют значениям оригинала. flash.events:Event Создает копию объекта SQLErrorEvent и задает значение каждого свойства, совпадающее с оригиналом. toString Возвращает строку, содержащую все свойства объекта SQLErrorEvent.Строка, содержащая все свойства объекта SQLErrorEvent. String Возвращает строку, содержащую все свойства объекта SQLErrorEvent. Строка имеет следующий формат:

[SQLErrorEvent type=value bubbles=value cancelable=value error=value]

Значение свойства error имеет следующий формат: SQLError : message value code=value operation=value

ERROR Константа SQLErrorEvent.ERROR определяет значение свойства type события ошибки, отправляемого, когда вызов метода экземпляра SQLConnection или SQLStatement завершается ошибкой.errorString Константа SQLErrorEvent.ERROR определяет значение свойства type события ошибки, отправляемого, когда вызов метода экземпляра SQLConnection или SQLStatement завершается ошибкой. Объект события error имеет следующие свойства. СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.errorОбъект SQLError, содержащий информацию о типе возникшей ошибки и о вызвавшей ее операции.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.targetОбъект SQLConnection или SQLStatement, сообщающий об ошибке. flash.data.SQLConnectionflash.data.SQLStatementflash.errors.SQLErrorerror Объект SQLError, содержащий подробные сведения о причине ошибки.flash.errors:SQLError Объект SQLError, содержащий подробные сведения о причине ошибки.
ErrorEvent Объект отправляет объект ErrorEvent, когда асинхронная операция завершается с ошибкой.Объекты событий ErrorEvent. flash.events:TextEvent Объект отправляет объект ErrorEvent, когда асинхронная операция завершается с ошибкой.

Класс ErrorEvent определяет только один тип события error: ErrorEvent.ERROR. Класс ErrorEvent также служит базовым классом для нескольких других классов событий ошибки, включая AsyncErrorEvent, IOErrorEvent, SecurityErrorEvent, SQLErrorEvent и UncaughtErrorEvent.

Чтобы проверить наличие событий error, для которых нет прослушивателей, нужно зарегистрировать прослушиватель для события uncaughtError (UncaughtErrorEvent.UNCAUGHT_ERROR).

Неперехваченная ошибка также приводит к отображению диалогового окна ошибки, когда содержимое выполняется в отладочной версии Flash Player или в отладочном приложении AIR Debug Launcher (ADL).

Следующий пример демонстрирует использование одного обработчика событий (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(); } } } }
UncaughtErrorEventerrorflash.events:ErrorEvent:ERRORflash.events:ErrorEventErrorEvent Создает объект Event, содержащий данные о событиях ошибок.typeString Тип события. Прослушиватели событий могут получать эту информацию через унаследованное свойство type. Существует только один тип события ошибки: ErrorEvent.ERROR. bubblesBooleanfalseОпределяет, находится ли объект Event в фазе восходящей цепочки. Прослушиватели событий могут получать эту информацию через унаследованное свойство bubbles. cancelableBooleanfalseОпределяет, можно ли отменить объект Event. Прослушиватели событий могут получать эту информацию через унаследованное свойство cancelable. textStringТекст, отображаемый в качестве сообщения об ошибке. Прослушиватели событий могут получать эту информацию через свойство text. idint0Ссылочный номер, связываемый с конкретной ошибкой (поддерживается только в Adobe AIR). Конструктор для объектов ErrorEvent. Создает объект Event, содержащий данные о событиях ошибок. Объекты Event передаются прослушивателям событий в качестве параметров. clone Создает копию объекта ErrorEvent и задает значение каждого свойства, совпадающее с оригиналом.Новый объект ErrorEvent, значения свойств которого соответствуют значениям оригинала. flash.events:Event Создает копию объекта ErrorEvent и задает значение каждого свойства, совпадающее с оригиналом. toString Возвращает строку, содержащую все свойства объекта ErrorEvent.Строка, содержащая все свойства объекта ErrorEvent. String Возвращает строку, содержащую все свойства объекта 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.

ERROR Определяет значение свойства type объекта события error.errorString Определяет значение свойства type объекта события error.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.targetОбъект, испытывающий сбой сетевой операции.textТекст, отображаемый в качестве сообщения об ошибке.
errorID Содержит ссылочный номер, связанный с конкретной ошибкой.int Содержит ссылочный номер, связанный с конкретной ошибкой. Для пользовательского объекта ErrorEvent это число является значением параметра id, представленного в конструкторе.
SoftKeyboardTrigger Класс SoftKeyboardTrigger определяет значения счётчика для свойства triggerType класса SoftKeyboardEvent.Определяет значения счётчика для свойства triggerType класса SoftKeyboardEvent. Object Класс SoftKeyboardTrigger определяет значения счётчика для свойства triggerType класса SoftKeyboardEvent. Эти значения обозначают, какая операция вызвала событие активизации SoftKeyboard. CONTENT_TRIGGERED Вызов функции вызвал событие.contentTriggeredStringОзначает, что вызов функции вызвал событие. Вызов функции вызвал событие. USER_TRIGGERED Операция пользователя вызвала событие.userTriggeredStringОзначает, что операция пользователя вызвала событие. Операция пользователя вызвала событие. Типичные операции пользователя, которые могут вызвать это событие, включают явно закрытие клавиатуры, или нажим Обратной клавиши. TransformGestureEvent Класс TransformGestureEvent позволяет обрабатывать события ввода с помощью сложных движений (таких как перемещение пальцев по сенсорному экрану), которые интерпретируются устройством или операционной системой как жест.обеспечивает возможность обработки событий для взаимодействия с сенсорным экраном. flash.events:GestureEvent Класс TransformGestureEvent позволяет обрабатывать события ввода с помощью сложных движений (таких как перемещение пальцев по сенсорному экрану), которые интерпретируются устройством или операционной системой как жест. Жест может иметь одну или несколько точек касания. При взаимодействии с таким устройством, как мобильный телефон или планшетный компьютер с сенсорным экраном, пользователь, как правило, касается экрана и проводит по нему пальцами или указывающим устройством. Можно разработать программы, которые реагируют на такое пользовательское взаимодействие пользователя с помощью классов GestureEvent, PressAndTapGestureEvent и TransformGestureEvent. Создайте прослушиватели для событий, которые определены здесь или в связанных классах GestureEvent и TouchEvent. И с помощью свойств и методов этих классов создайте обработчики событий, которые реагируют на жесты пользователя.

Устройство или операционная система интерпретируют ввод с помощью жеста. Так, у разных устройств или операционных систем есть свои требования к отдельным типам жестов. Для выделения содержимого на разных устройствах могут потребоваться различные движения ввода. Сведения о том, как устройство или операционная система интерпретирует прикосновение в качестве того или иного жеста, см. в документации производителя.

Класс Multitouch служит для определения поддержки сенсорного взаимодействия в текущей среде и для управления этой поддержкой, если она имеется.

Примечание. Когда объекты вложены в список отображения, события сенсорного экрана нацеливаются на самый глубокий из видимых вложенных объектов. Этот объект называется целевым узлом. Чтобы родительский элемент целевого узла (объект, содержащий целевой узел в списке отображения) получил уведомление о событии сенсорного экрана, вызовите метод EventDispatcher.addEventListener() для родительского элемента, задав в качестве параметра type конкретное событие, которое требуется отслеживать.

В процессе взаимодействия пользователя с сенсорным экраном свойства scale, rotation и offset объекта TransformGestureEvent рассматриваются как инкрементные значения с точки зрения предшествующего события жеста. Например, когда жест увеличивает размер экранного объекта, значения масштабирования могут изменяться в последовательности 1.03, 1.01, 1.01, 1.02, то есть к окончанию жеста экранный объект будет увеличен в 1.0717 раз по отношению к исходному размеру.

Для объектов TransformGestureEvent свойства, не измененные текущим жестом, сохраняют те же значения. Например, при жесте панорамирования не происходит поворота или преобразования масштаба, поэтому свойство rotation события имеет значение 0, а свойства scaleX и scaleY — значение 1.

Следующий пример демонстрирует обработку событий GESTURE_ROTATE. Когда пользователь выполняет жест поворота на устройстве с сенсорным экраном, объект mySprite поворачивается, и в текстовом поле myTextField отображается текущая фаза. Multitouch.inputMode = MultitouchInputMode.GESTURE; var mySprite = new Sprite(); mySprite.addEventListener(TransformGestureEvent.GESTURE_ROTATE , onRotate ); mySprite.graphics.beginFill(0x336699); mySprite.graphics.drawRect(0, 0, 100, 80); var myTextField = new TextField(); myTextField.y = 200; addChild(mySprite); addChild(myTextField); function onRotate(evt:TransformGestureEvent):void { evt.target.rotation -= 45; if (evt.phase==GesturePhase.BEGIN) { myTextField.text = "Begin"; } if (evt.phase==GesturePhase.UPDATE) { myTextField.text = "Update"; } if (evt.phase==GesturePhase.END) { myTextField.text = "End"; } } Следующий пример демонстрирует обработку событий жестов преобразования. Предполагается, в локальной системе есть изображение с именем african_elephant.jpg, которое находится в том же каталоге, что и класс TransformGestureExample2. Этот пример предоставлен Кристианом Кантреллом (Christian Cantrell), более подробное объявление приводится в его руководстве по быстрому началу работы: Multi-touch and gesture support on the Flash Platform (Поддержка технологии Multi-Touch и жестов на платформе Flash Platform). package { import flash.display.Bitmap; import flash.display.Sprite; import flash.events.TransformGestureEvent; import flash.text.TextField; import flash.text.TextFormat; import flash.ui.Multitouch; import flash.ui.MultitouchInputMode; [SWF(width=320, height=460, frameRate=24, backgroundColor=0x000000)] public class TransformGestureExample2 extends Sprite { [Embed(source="african_elephant.jpg")] public var ElephantImage:Class; public var scaleDebug:TextField; public var rotateDebug:TextField; public function TransformGestureExample2() { // Debug var tf:TextFormat = new TextFormat(); tf.color = 0xffffff; tf.font = "Helvetica"; tf.size = 11; this.scaleDebug = new TextField(); this.scaleDebug.width = 310; this.scaleDebug.defaultTextFormat = tf; this.scaleDebug.x = 2; this.scaleDebug.y = 2; this.stage.addChild(this.scaleDebug); this.rotateDebug = new TextField(); this.rotateDebug.width = 310; this.rotateDebug.defaultTextFormat = tf; this.rotateDebug.x = 2; this.rotateDebug.y = 15; this.stage.addChild(this.rotateDebug); var elephantBitmap:Bitmap = new ElephantImage(); var elephant:Sprite = new Sprite(); elephant.addChild(elephantBitmap); elephant.x = 160; elephant.y = 230; elephantBitmap.x = (300 - (elephantBitmap.bitmapData.width / 2)) * -1; elephantBitmap.y = (400 - (elephantBitmap.bitmapData.height / 2)) *-1; this.addChild(elephant); Multitouch.inputMode = MultitouchInputMode.GESTURE; elephant.addEventListener(TransformGestureEvent.GESTURE_ZOOM, onZoom); elephant.addEventListener(TransformGestureEvent.GESTURE_ROTATE, onRotate); } private function onZoom(e:TransformGestureEvent):void { this.scaleDebug.text = (e.scaleX + ", " + e.scaleY); var elephant:Sprite = e.target as Sprite; elephant.scaleX *= e.scaleX; elephant.scaleY *= e.scaleY; } private function onRotate(e:TransformGestureEvent):void { var elephant:Sprite = e.target as Sprite; this.rotateDebug.text = String(e.rotation); elephant.rotation += e.rotation; } } }
flash.ui.Multitouchflash.events.TouchEventflash.events.GestureEventflash.events.PressAndTapGestureEventflash.events.MouseEventflash.events.EventDispatcher.addEventListener()gesturePanflash.events:TransformGestureEvent:GESTURE_PANflash.events:TransformGestureEvent Следующий пример демонстрирует обработку событий GESTURE_PAN. Когда пользователь выполняет жест панорамирования на устройстве с сенсорным экраном, в текстовом поле myTextField отображается текущая фаза. Multitouch.inputMode = MultitouchInputMode.GESTURE; var mySprite = new Sprite(); mySprite.addEventListener(TransformGestureEvent.GESTURE_PAN , onPan); mySprite.graphics.beginFill(0x336699); mySprite.graphics.drawRect(0, 0, 100, 80); var myTextField = new TextField(); myTextField.y = 200; addChild(mySprite); addChild(myTextField); function onPan(evt:TransformGestureEvent):void { evt.target.localX++; if (evt.phase==GesturePhase.BEGIN) { myTextField.text = "Begin"; } if (evt.phase==GesturePhase.UPDATE) { myTextField.text = "Update"; } if (evt.phase==GesturePhase.END) { myTextField.text = "End"; } } flash.display.InteractiveObject.gesturePanflash.events.GesturePhasegestureRotateflash.events:TransformGestureEvent:GESTURE_ROTATEflash.events:TransformGestureEvent Следующий пример демонстрирует обработку событий GESTURE_ROTATE. Когда пользователь выполняет жест поворота на устройстве с сенсорным экраном, объект mySprite поворачивается, и в текстовом поле myTextField отображается текущая фаза. Multitouch.inputMode = MultitouchInputMode.GESTURE; var mySprite = new Sprite(); mySprite.addEventListener(TransformGestureEvent.GESTURE_ROTATE , onRotate ); mySprite.graphics.beginFill(0x336699); mySprite.graphics.drawRect(0, 0, 100, 80); var myTextField = new TextField(); myTextField.y = 200; addChild(mySprite); addChild(myTextField); function onRotate(evt:TransformGestureEvent):void { evt.target.rotation -= 45; if (evt.phase==GesturePhase.BEGIN) { myTextField.text = "Begin"; } if (evt.phase==GesturePhase.UPDATE) { myTextField.text = "Update"; } if (evt.phase==GesturePhase.END) { myTextField.text = "End"; } } flash.display.InteractiveObject.gestureRotateflash.events.GesturePhasegestureSwipeflash.events:TransformGestureEvent:GESTURE_SWIPEflash.events:TransformGestureEvent Следующий пример демонстрирует обработку событий GESTURE_SWIPE. Когда пользователь выполняет жест выделения на устройстве с сенсорным экраном, в текстовом поле myTextField отображается текущая фаза all, которая является единственной применимой для событий выделения пальцами. Multitouch.inputMode = MultitouchInputMode.GESTURE; var mySprite = new Sprite(); mySprite.addEventListener(TransformGestureEvent.GESTURE_SWIPE , onSwipe); mySprite.graphics.beginFill(0x336699); mySprite.graphics.drawRect(0, 0, 100, 80); var myTextField = new TextField(); myTextField.y = 200; addChild(mySprite); addChild(myTextField); function onSwipe(evt:TransformGestureEvent):void { if (evt.offsetX == 1 ) { myTextField.text = "right"; } if (evt.offsetY == -1) { myTextField.text = "up"; } myTextField.text = evt.phase; } flash.display.InteractiveObject.gestureSwipeflash.events.GesturePhasegestureZoomflash.events:TransformGestureEvent:GESTURE_ZOOMflash.events:TransformGestureEvent Следующий пример демонстрирует обработку событий GESTURE_ZOOM. Когда пользователь выполняет жест изменения масштаба на устройстве с сенсорным экраном, в текстовом поле myTextField отображается текущая фаза. Multitouch.inputMode = MultitouchInputMode.GESTURE; var mySprite = new Sprite(); mySprite.addEventListener(TransformGestureEvent.GESTURE_ZOOM , onZoom); mySprite.graphics.beginFill(0x336699); mySprite.graphics.drawRect(0, 0, 100, 80); var myTextField = new TextField(); myTextField.y = 200; addChild(mySprite); addChild(myTextField); function onZoom(evt:TransformGestureEvent):void { evt.target.scaleX++; if (evt.phase==GesturePhase.BEGIN) { myTextField.text = "Begin"; } if (evt.phase==GesturePhase.UPDATE) { myTextField.text = "Update"; } if (evt.phase==GesturePhase.END) { myTextField.text = "End"; } } flash.display.InteractiveObject.gestureZoomflash.events.GesturePhaseTransformGestureEvent Создает объект Event, который содержит информацию о сложных мультисенсорных событиях, например, когда пользователь проводит пальцем по экрану.typeString Тип события. Возможные значения: TransformGestureEvent.GESTURE_PAN, TransformGestureEvent.GESTURE_ROTATE, TransformGestureEvent.GESTURE_SWIPE и TransformGestureEvent.GESTURE_ZOOM. bubblesBooleantrue Определяет, участвует ли объект Event в фазе восходящей цепочки потока событий. cancelableBooleanfalseОпределяет, можно ли отменить объект Event. phaseStringnullЭти значения отслеживает начало, ход выполнения, и конец жеста. Возможные значения: GesturePhase.BEGIN, GesturePhase.END и GesturePhase.UPDATE. localXNumber0Горизонтальная координата события относительно экранного объекта-контейнера. localYNumber0Вертикальная координата события относительно экранного объекта-контейнера. scaleXNumber1.0Масштабирование экранного объекта по горизонтали. scaleYNumber1.0Масштабирование экранного объекта по вертикали. rotationNumber0Текущий угол поворота экранного объекта относительно оси z (в градусах). offsetXNumber0Перемещение экранного объекта по горизонтали относительно исходной позиции. offsetYNumber0Перемещение экранного объекта по вертикали относительно исходной позиции. ctrlKeyBooleanfalseВ Windows или Linux указывает на то, активирована ли клавиша Ctrl. В Mac указывает на то, активирована ли клавиша Ctrl или Command. altKeyBooleanfalseУказывает на то, активирована ли клавиша Alt (только для Windows или Linux). shiftKeyBooleanfalseУказывает, активирована ли клавиша Shift. commandKeyBooleanfalse(Только для AIR) Указывает, активирована ли клавиша Command (только для Mac). Этот параметр только для Adobe AIR; не устанавливать его для содержимого Flash Player. controlKeyBooleanfalse(Только для AIR)Указывает активирована ли клавиша Control или Ctrl. Этот параметр только для Adobe AIR; не устанавливать его для содержимого Flash Player. Конструктор для объектов TransformGestureEvent. Создает объект Event, который содержит информацию о сложных мультисенсорных событиях, например, когда пользователь проводит пальцем по экрану. Объекты Event передаются прослушивателям событий в качестве параметров. flash.ui.Multitouchflash.events.TouchEventflash.events.GestureEventflash.events.PressAndTapGestureEventflash.events.GesturePhaseflash.events.MouseEventflash.events.EventDispatcher.addEventListener()clone Создает копию объекта TransformGestureEvent и задает значение каждого свойства, совпадающее с оригиналом.Новый объект TransformGestureEvent, значения свойств которого соответствуют значениям оригинала. flash.events:Event Создает копию объекта TransformGestureEvent и задает значение каждого свойства, совпадающее с оригиналом. toString Возвращает строку, содержащую все свойства объекта TransformGestureEvent.Строка, содержащая все свойства объекта TransformGestureEvent. String Возвращает строку, содержащую все свойства объекта TransformGestureEvent. Строка имеет следующий формат:

[TransformGestureEvent type=value bubbles=value cancelable=value ... ]

GESTURE_PAN Определяет значение свойства type объекта события сенсорного экрана GESTURE_PAN.gesturePanString Определяет значение свойства type объекта события сенсорного экрана GESTURE_PAN.

Объект TransformGestureEvent имеет следующие свойства.

СвойствоЗначениеaltKeytrue, если клавиша Alt активна (Windows или Linux).bubblestruecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.commandKeytrue в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows.controlKeytrue, если клавиша Ctrl или Control активна; false, если неактивна.ctrlKeytrue в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.phaseТекущая фаза в потоке событий, значение представляет собой экземпляр класса GesturePhase.localXГоризонтальная координата события относительно экранного объекта-контейнера.localYВертикальная координата события относительно экранного объекта-контейнера.scaleXМасштабирование экранного объекта по горизонтали с момента предыдущего события жеста. Для жестов панорамирования задается значение 1.scaleYМасштабирование экранного объекта по вертикали с момента предыдущего события жеста. Для жестов панорамирования задается значение 1.rotationТекущий угол поворота экранного объекта относительно оси z с момента предыдущего события жеста. Для жестов панорамирования задается значение 0.offsetXПеремещение экранного объекта по горизонтали относительно предыдущего события жеста.offsetYПеремещение экранного объекта по вертикали относительно предыдущего события жеста.shiftKeytrue, если клавиша Shift активна; иначе — false.targetЭкземпляр InteractiveObject под указывающим устройством. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент.
Следующий пример демонстрирует обработку событий GESTURE_PAN. Когда пользователь выполняет жест панорамирования на устройстве с сенсорным экраном, в текстовом поле myTextField отображается текущая фаза. Multitouch.inputMode = MultitouchInputMode.GESTURE; var mySprite = new Sprite(); mySprite.addEventListener(TransformGestureEvent.GESTURE_PAN , onPan); mySprite.graphics.beginFill(0x336699); mySprite.graphics.drawRect(0, 0, 100, 80); var myTextField = new TextField(); myTextField.y = 200; addChild(mySprite); addChild(myTextField); function onPan(evt:TransformGestureEvent):void { evt.target.localX++; if (evt.phase==GesturePhase.BEGIN) { myTextField.text = "Begin"; } if (evt.phase==GesturePhase.UPDATE) { myTextField.text = "Update"; } if (evt.phase==GesturePhase.END) { myTextField.text = "End"; } }
flash.display.InteractiveObject.gesturePanflash.events.GesturePhase
GESTURE_ROTATE Определяет значение свойства type объекта события сенсорного экрана GESTURE_ROTATE.gestureRotateString Определяет значение свойства type объекта события сенсорного экрана GESTURE_ROTATE.

Объект TransformGestureEvent имеет следующие свойства.

СвойствоЗначениеaltKeytrue, если клавиша Alt активна (Windows или Linux).bubblestruecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.commandKeytrue в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows.controlKeytrue, если клавиша Ctrl или Control активна; false, если неактивна.ctrlKeytrue в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.phaseТекущая фаза в потоке событий, значение представляет собой экземпляр класса GesturePhase.localXГоризонтальная координата события относительно экранного объекта-контейнера.localYВертикальная координата события относительно экранного объекта-контейнера.scaleXМасштабирование экранного объекта по горизонтали с момента предыдущего события жеста.scaleYМасштабирование экранного объекта по вертикали с момента предыдущего события жеста.rotationТекущий угол поворота экранного объекта относительно оси z с момента предыдущего события жеста.offsetXПеремещение экранного объекта по горизонтали относительно предыдущего события жеста.offsetYПеремещение экранного объекта по вертикали относительно предыдущего события жеста.shiftKeytrue, если клавиша Shift активна; иначе — false.targetЭкземпляр InteractiveObject под указывающим устройством. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент.
Следующий пример демонстрирует обработку событий GESTURE_ROTATE. Когда пользователь выполняет жест поворота на устройстве с сенсорным экраном, объект mySprite поворачивается, и в текстовом поле myTextField отображается текущая фаза. Multitouch.inputMode = MultitouchInputMode.GESTURE; var mySprite = new Sprite(); mySprite.addEventListener(TransformGestureEvent.GESTURE_ROTATE , onRotate ); mySprite.graphics.beginFill(0x336699); mySprite.graphics.drawRect(0, 0, 100, 80); var myTextField = new TextField(); myTextField.y = 200; addChild(mySprite); addChild(myTextField); function onRotate(evt:TransformGestureEvent):void { evt.target.rotation -= 45; if (evt.phase==GesturePhase.BEGIN) { myTextField.text = "Begin"; } if (evt.phase==GesturePhase.UPDATE) { myTextField.text = "Update"; } if (evt.phase==GesturePhase.END) { myTextField.text = "End"; } }
flash.display.InteractiveObject.gestureRotateflash.events.GesturePhase
GESTURE_SWIPE Определяет значение свойства type объекта события сенсорного экрана GESTURE_SWIPE.gestureSwipeString Определяет значение свойства type объекта события сенсорного экрана GESTURE_SWIPE.

Объект TransformGestureEvent имеет следующие свойства.

СвойствоЗначениеaltKeytrue, если клавиша Alt активна (Windows или Linux).bubblestruecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.commandKeytrue в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows.controlKeytrue, если клавиша Ctrl или Control активна; false, если неактивна.ctrlKeytrue в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.phaseТекущая фаза в потоке событий. При отправке событий выделения всегда используется значение all, что соответствует значению GesturePhase.ALL.localXГоризонтальная координата события относительно спрайта-контейнера.localYВертикальная координата события относительно спрайта-контейнера.scaleXМасштабирование экранного объекта по горизонтали. Для жестов выделения задается значение 1scaleYМасштабирование экранного объекта по вертикали. Для жестов выделения задается значение 1rotationТекущий угол поворота экранного объекта относительно оси z (в градусах). Для жестов выделения задается значение 0offsetXОбозначает горизонтальное направление: 1 — вправо, -1 — влево.offsetYОбозначает вертикальное направление: 1 — вниз, -1 — вверх.shiftKeytrue, если клавиша Shift активна; иначе — false.targetЭкземпляр InteractiveObject под указывающим устройством. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент.
Следующий пример демонстрирует обработку событий GESTURE_SWIPE. Когда пользователь выполняет жест выделения на устройстве с сенсорным экраном, в текстовом поле myTextField отображается текущая фаза all, которая является единственной применимой для событий выделения пальцами. Multitouch.inputMode = MultitouchInputMode.GESTURE; var mySprite = new Sprite(); mySprite.addEventListener(TransformGestureEvent.GESTURE_SWIPE , onSwipe); mySprite.graphics.beginFill(0x336699); mySprite.graphics.drawRect(0, 0, 100, 80); var myTextField = new TextField(); myTextField.y = 200; addChild(mySprite); addChild(myTextField); function onSwipe(evt:TransformGestureEvent):void { if (evt.offsetX == 1 ) { myTextField.text = "right"; } if (evt.offsetY == -1) { myTextField.text = "up"; } myTextField.text = evt.phase; }
flash.display.InteractiveObject.gestureSwipeflash.events.GesturePhase
GESTURE_ZOOM Определяет значение свойства type объекта события сенсорного экрана GESTURE_ZOOM.gestureZoomString Определяет значение свойства type объекта события сенсорного экрана GESTURE_ZOOM.

Объект TransformGestureEvent имеет следующие свойства.

СвойствоЗначениеaltKeytrue, если клавиша Alt активна (Windows или Linux).bubblestruecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.commandKeytrue в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows.controlKeytrue, если клавиша Ctrl или Control активна; false, если неактивна.ctrlKeytrue в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.phaseТекущая фаза в потоке событий, значение представляет собой экземпляр класса GesturePhase.localXГоризонтальная координата события относительно экранного объекта-контейнера.localYВертикальная координата события относительно экранного объекта-контейнера.scaleXМасштабирование экранного объекта по горизонтали с момента предыдущего события жеста.scaleYМасштабирование экранного объекта по вертикали с момента предыдущего события жеста.rotationТекущий угол поворота экранного объекта относительно оси z с момента предыдущего события жеста.offsetXПеремещение экранного объекта по горизонтали относительно предыдущего события жеста.offsetYПеремещение экранного объекта по вертикали относительно предыдущего события жеста.shiftKeytrue, если клавиша Shift активна; иначе — false.targetЭкземпляр InteractiveObject под указывающим устройством. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент.
Следующий пример демонстрирует обработку событий GESTURE_ZOOM. Когда пользователь выполняет жест изменения масштаба на устройстве с сенсорным экраном, в текстовом поле myTextField отображается текущая фаза. Multitouch.inputMode = MultitouchInputMode.GESTURE; var mySprite = new Sprite(); mySprite.addEventListener(TransformGestureEvent.GESTURE_ZOOM , onZoom); mySprite.graphics.beginFill(0x336699); mySprite.graphics.drawRect(0, 0, 100, 80); var myTextField = new TextField(); myTextField.y = 200; addChild(mySprite); addChild(myTextField); function onZoom(evt:TransformGestureEvent):void { evt.target.scaleX++; if (evt.phase==GesturePhase.BEGIN) { myTextField.text = "Begin"; } if (evt.phase==GesturePhase.UPDATE) { myTextField.text = "Update"; } if (evt.phase==GesturePhase.END) { myTextField.text = "End"; } }
flash.display.InteractiveObject.gestureZoomflash.events.GesturePhase
offsetX Перемещение экранного объекта по горизонтали с момента предыдущего события жеста.Number Перемещение экранного объекта по горизонтали с момента предыдущего события жеста. offsetY Перемещение экранного объекта по вертикали с момента предыдущего события жеста.Number Перемещение экранного объекта по вертикали с момента предыдущего события жеста. rotation Текущий угол поворота экранного объекта относительно оси z с момента предыдущего события жеста.Number Текущий угол поворота экранного объекта относительно оси z с момента предыдущего события жеста. scaleX Масштабирование экранного объекта по горизонтали с момента предыдущего события жеста.Number Масштабирование экранного объекта по горизонтали с момента предыдущего события жеста. scaleY Масштабирование экранного объекта по вертикали с момента предыдущего события жеста.Number Масштабирование экранного объекта по вертикали с момента предыдущего события жеста.
NativeDragEvent События собственного перетаскивания отправляются интерактивными объектами, участвующими в операции перетаскивания.flash.events:MouseEvent События собственного перетаскивания отправляются интерактивными объектами, участвующими в операции перетаскивания.

Инициирующий объект отправляет:

  • nativeDragStart в момент начала операции перетаскивания;
  • nativeDragUpdate по ходу выполнения операции перетаскивания;
  • nativeDragComplete, когда пользователь отпускает перетаскиваемый объект (независимо от того, принято ли новое положение объекта).

Инициирующий объект — это передаваемый интерактивный объект, то есть объект NativeDragManager в вызове метода NativeDragManager.doDrag(), начавшего операцию перетаскивания.

Потенциальные целевые интерактивные объекты отправляют:

  • nativeDragEnter при попадании траектории перетаскивания в границы объекта;
  • nativeDragOver во время пребывания жеста перетаскивания в границах объекта;
  • nativeDragExit при выходе жеста перетаскивания за границы объекта;
  • nativeDragDrop, когда пользователь отпускает перетаскиваемый элемент над объектом и он отпускается, предварительно вызвав метод NativeDragManager.acceptDragDrop().

Как правило, обработчик события nativeDragEnter или nativeDragOver оценивает перетаскиваемые данные и допустимые действия перетаскивания, чтобы определить, может ли интерактивный объект принять опускание. Чтобы указать, что интерактивный объект может быть целью, обработчик событий должен вызвать функцию NativeDragManager.acceptDrop(), передающую ссылку на объект. Если пользователь отпускает кнопку мыши над заданным объектом, этот объект становиться целью опускания и отправляет событие nativeDragDrop.

Любой объект типа InteractiveObject может быть инициатором перетаскивания или целью опускания.

flash.desktop.NativeDragManagerflash.desktop.Clipboardflash.desktop.NativeDragOptionsflash.desktop.NativeDragActionsflash.display.InteractiveObjectnativeDragCompleteflash.events:NativeDragEvent:NATIVE_DRAG_COMPLETEflash.events:NativeDragEventОтправляется исходным объектом InteractiveObject, когда завершается жест перетаскивания. flash.display.InteractiveObject.nativeDragCompleteflash.desktop.NativeDragActionsnativeDragDropflash.events:NativeDragEvent:NATIVE_DRAG_DROPflash.events:NativeDragEventОтправляется объектами InteractiveObject, когда жест перетаскивания завершается над объектом. flash.display.InteractiveObject.nativeDragDropnativeDragEnterflash.events:NativeDragEvent:NATIVE_DRAG_ENTERflash.events:NativeDragEventОтправляется объектами InteractiveObject, когда жест перетаскивания попадает в границы объекта. flash.display.InteractiveObject.nativeDragEnternativeDragExitflash.events:NativeDragEvent:NATIVE_DRAG_EXITflash.events:NativeDragEventОтправляется объектами InteractiveObject, когда жест перетаскивания покидает границы объекта. flash.display.InteractiveObject.nativeDragExitnativeDragOverflash.events:NativeDragEvent:NATIVE_DRAG_OVERflash.events:NativeDragEventОтправляется объектами InteractiveObject, когда жест перетаскивания наводится на объект. flash.display.InteractiveObject.nativeDragOvernativeDragStartflash.events:NativeDragEvent:NATIVE_DRAG_STARTflash.events:NativeDragEventОтправляется исходным объектом InteractiveObject, когда начинается собственный жест перетаскивания. flash.display.InteractiveObject.nativeDragStartnativeDragUpdateflash.events:NativeDragEvent:NATIVE_DRAG_UPDATEflash.events:NativeDragEventОтправляется исходным объектом InteractiveObject, когда завершается жест перетаскивания. flash.display.InteractiveObject.nativeDragUpdateNativeDragEvent Создает объект Event со специфической информацией, имеющей отношение к собственным событиям перетаскивания.typeString Тип события. Возможные значения: NativeDragEvent.NATIVE_DRAG_START, NativeDragEvent.NATIVE_DRAG_UPDATE, NativeDragEvent.NATIVE_DRAG_ENTER, NativeDragEvent.NATIVE_DRAG_OVER, NativeDragEvent.NATIVE_DRAG_EXIT, NativeDragEvent.NATIVE_DRAG_DROP и NativeDragEvent.NATIVE_DRAG_COMPLETE. bubblesBooleanfalseУказывает, участвует ли объект Event в фазе восходящей цепочки потока событий. cancelableBooleantrueУказывает, можно ли отменить объект Event. localXNumberunknownГоризонтальная координата события относительно спрайта-контейнера. localYNumberunknownВертикальная координата события относительно спрайта-контейнера. relatedObjectflash.display:InteractiveObjectnullСвязанный интерактивный экранный объект. clipboardflash.desktop:ClipboardnullОбъект Clipboard, содержащий передаваемые данные. allowedActionsflash.desktop:NativeDragOptionsnullОбъект NativeDragOptions, определяющий допустимые действия (перемещение, копирование или ссылка). dropActionStringnullТекущее действие. controlKeyBooleanfalseУказывает, активирована ли клавиша Control. altKeyBooleanfalseУказывает, активирована ли клавиша Alt. shiftKeyBooleanfalseУказывает, активирована ли клавиша Shift. commandKeyBooleanfalseУказывает, активирована ли клавиша Command. Создает объект Event со специфической информацией, имеющей отношение к собственным событиям перетаскивания.

Объекты Event передаются прослушивателям событий в качестве параметров. Отправка события собственного перетаскивания не запускает связанного с этим поведения.

clone Создает копию данного объекта NativeDragEvent.Новый объект NativeDragEvent, значения свойств которого соответствуют значениям оригинала. flash.events:Event Создает копию данного объекта NativeDragEvent. toString Форматирует свойства данного объекта NativeDragEvent в виде строки.Свойства данного объекта NativeDragEvent в виде строки. String Форматирует свойства данного объекта NativeDragEvent в виде строки.

Строка имеет следующий формат:

[NativeDragEvent type=value bubbles=value cancelable=value ... commandKey=value]

NATIVE_DRAG_COMPLETE NativeDragEvent.NATIVE_DRAG_COMPLETE определяет значение свойства type объекта события nativeDragComplete.nativeDragCompleteStringОтправляется исходным объектом InteractiveObject, когда завершается жест перетаскивания. NativeDragEvent.NATIVE_DRAG_COMPLETE определяет значение свойства type объекта события nativeDragComplete.

Это событие имеет следующие свойства:

СвойствоЗначениеallowedActionsОбъект NativeDragOptions, указывающий действия, имеющие отношение к данной операции перетаскивания.bubblestruecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.clipboardОбъект Clipboard, содержащий перетаскиваемые данные.dropActionДействие, выбранное целью опускания (или none, если действие не было задано).
flash.display.InteractiveObject.nativeDragCompleteflash.desktop.NativeDragActions
NATIVE_DRAG_DROP NativeDragEvent.NATIVE_DRAG_DROP определяет значение свойства type объекта события nativeDragDrop.nativeDragDropStringОтправляется объектами InteractiveObject, когда жест перетаскивания завершается над объектом. NativeDragEvent.NATIVE_DRAG_DROP определяет значение свойства type объекта события nativeDragDrop.

Это событие имеет следующие свойства:

СвойствоЗначениеallowedActionsОбъект NativeDragOptions, указывающий действия, имеющие отношение к данной операции перетаскивания.bubblestruecancelabletrue; отмена данного события отменяет операцию перетаскивания.clipboardОбъект Clipboard, содержащий перетаскиваемые данные. Буфер обмена может считываться даже если объект, отправивший данное событие находится не в том же домене защиты, что и инициатор.dropActionДействие, выбранное целью опускания (или none, если действие не было задано).
flash.display.InteractiveObject.nativeDragDrop
NATIVE_DRAG_ENTER NativeDragEvent.NATIVE_DRAG_ENTER определяет значение свойства type объекта события nativeDragEnter.nativeDragEnterStringОтправляется объектами InteractiveObject, когда жест перетаскивания попадает в границы объекта. NativeDragEvent.NATIVE_DRAG_ENTER определяет значение свойства type объекта события nativeDragEnter.

Это событие имеет следующие свойства:

СвойствоЗначениеallowedActionsОбъект NativeDragOptions, указывающий действия, имеющие отношение к данной операции перетаскивания.bubblestruecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.clipboardОбъект Clipboard, содержащий перетаскиваемые данные. Буфер обмена может считываться только если объект, отправивший данное событие находится том же домене защиты, что и инициатор.dropActionДействие, выбранное целью опускания (или none, если действие не было задано).
flash.display.InteractiveObject.nativeDragEnter
NATIVE_DRAG_EXIT NativeDragEvent.NATIVE_DRAG_EXIT определяет значение свойства type объекта события nativeDragExit.nativeDragExitStringОтправляется объектами InteractiveObject, когда жест перетаскивания покидает границы объекта. NativeDragEvent.NATIVE_DRAG_EXIT определяет значение свойства type объекта события nativeDragExit.

Это событие имеет следующие свойства:

СвойствоЗначениеallowedActionsОбъект NativeDragOptions, указывающий действия, имеющие отношение к данной операции перетаскивания.bubblestruecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.clipboardОбъект Clipboard, содержащий перетаскиваемые данные. Буфер обмена может считываться только если объект, отправивший данное событие находится том же домене защиты, что и инициатор.dropActionДействие, выбранное целью опускания (или none, если действие не было задано).
flash.display.InteractiveObject.nativeDragExit
NATIVE_DRAG_OVER NativeDragEvent.NATIVE_DRAG_OVER определяет значение свойства type объекта события nativeDragOver.nativeDragOverStringОтправляется объектами InteractiveObject, когда жест перетаскивания наводится на объект. NativeDragEvent.NATIVE_DRAG_OVER определяет значение свойства type объекта события nativeDragOver.

Это событие имеет следующие свойства:

СвойствоЗначениеallowedActionsОбъект NativeDragOptions, указывающий действия, имеющие отношение к данной операции перетаскивания.bubblestruecancelabletrue; отмена данного события отменяет операцию перетаскивания.clipboardОбъект Clipboard, содержащий перетаскиваемые данные. Буфер обмена может считываться только если объект, отправивший данное событие находится том же домене защиты, что и инициатор.dropActionДействие, выбранное целью опускания (или none, если действие не было задано).
flash.display.InteractiveObject.nativeDragOver
NATIVE_DRAG_START NativeDragEvent.NATIVE_DRAG_START определяет значение свойства type объекта события nativeDragStart.nativeDragStartStringОтправляется исходным объектом InteractiveObject, когда начинается собственный жест перетаскивания. NativeDragEvent.NATIVE_DRAG_START определяет значение свойства type объекта события nativeDragStart.

Это событие имеет следующие свойства:

СвойствоЗначениеallowedActionsОбъект NativeDragOptions, указывающий действия, имеющие отношение к данной операции перетаскивания.bubblestruecancelabletrue; отмена данного события отменяет операцию перетаскивания.clipboardОбъект Clipboard, содержащий перетаскиваемые данные.dropActionДействие, выбранное целью опускания (или none, если действие не было задано).
flash.display.InteractiveObject.nativeDragStart
NATIVE_DRAG_UPDATE NativeDragEvent.NATIVE_DRAG_UPDATE определяет значение свойства type объекта события nativeDragUpdate.nativeDragUpdateStringОтправляется исходным объектом InteractiveObject, когда завершается жест перетаскивания. NativeDragEvent.NATIVE_DRAG_UPDATE определяет значение свойства type объекта события nativeDragUpdate.

Это событие имеет следующие свойства:

СвойствоЗначениеallowedActionsОбъект NativeDragOptions, указывающий действия, имеющие отношение к данной операции перетаскивания.bubblestruecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.clipboardОбъект Clipboard, содержащий перетаскиваемые данные.dropActionДействие, выбранное целью опускания (или none, если действие не было задано).
flash.display.InteractiveObject.nativeDragUpdate
allowedActions Объект NativeDragOptions, указывающий действия, разрешенные экранным объектом, инициировавшим данную операцию перетаскивания.flash.desktop:NativeDragOptions Объект NativeDragOptions, указывающий действия, разрешенные экранным объектом, инициировавшим данную операцию перетаскивания. flash.desktop.NativeDragOptionsclipboard Объект Clipboard, содержащий данные этой операции перетаскивания.flash.desktop:Clipboard Объект Clipboard, содержащий данные этой операции перетаскивания.

Если объект, отправивший событие, находится не в том же домене защиты, что и объект-инициатор, то буфер обмена может считываться только в обработчике события nativeDragDrop.

flash.desktop.Clipboard
dropAction Текущее действие.String Текущее действие. В событии nativeDragComplete свойство dropAction сообщает окончательное действие.
PressAndTapGestureEvent Класс PressAndTapGestureEvent позволяет обрабатывать жесты нажатия вместе с касанием на устройствах с сенсорным экраном.обеспечивает поддержку обработки событий для жеста нажатия вместе с касанием. flash.events:GestureEvent Класс PressAndTapGestureEvent позволяет обрабатывать жесты нажатия вместе с касанием на устройствах с сенсорным экраном. Объекты, которые наследуют свойства класса InteractiveObject захватывают основную точку контакта (нажатие) и второстепенную точку (касание) в отправляемом объекте события. Жест нажатия вместе с касанием обычно используется дл вызова контекстного всплывающего меню. Следующий пример демонстрирует обработку события GESTURE_PRESS_AND_TAP. Когда пользователь выполняет жест нажатия вместе с касанием, объект mySprite поворачивается, а текстовое поле myTextField отображает текущую фазу. Multitouch.inputMode = MultitouchInputMode.GESTURE; var mySprite = new Sprite(); mySprite.addEventListener(PressAndTapGestureEvent.GESTURE_PRESS_AND_TAP , onPressAndTap ); mySprite.graphics.beginFill(0x336699); mySprite.graphics.drawRect(0, 0, 100, 80); var myTextField = new TextField(); myTextField.y = 200; addChild(mySprite); addChild(myTextField); function onPressAndTap(evt:PressAndTapGestureEvent):void { evt.target.rotation -= 45; if (evt.phase==GesturePhase.BEGIN) { myTextField.text = "Begin"; } if (evt.phase==GesturePhase.UPDATE) { myTextField.text = "Update"; } if (evt.phase==GesturePhase.END) { myTextField.text = "End"; } } flash.ui.Multitouchflash.display.InteractiveObjectflash.events.TouchEventflash.events.GestureEventflash.events.MouseEventflash.events.EventDispatcher.addEventListener()gesturePressAndTapflash.events:PressAndTapGestureEvent:GESTURE_PRESS_AND_TAPflash.events:PressAndTapGestureEventflash.display.InteractiveObject.gesturePressAndTapflash.events.GesturePhasePressAndTapGestureEvent Создает объект Event, который содержит информацию о сложных мультисенсорных событиях, например о вызове контекстового всплывающего меню.typeString Тип события: PressAndTapGestureEvent.GESTURE_PRESS_AND_TAP. bubblesBooleantrue Определяет, участвует ли объект Event в фазе восходящей цепочки потока событий. cancelableBooleanfalseОпределяет, можно ли отменить объект Event. phaseStringnullЭти значения отслеживает начало, ход выполнения, и конец жеста. Возможные значения: GesturePhase.BEGIN, GesturePhase.END, GesturePhase.UPDATE или GesturePhase.ALL. localXNumber0Горизонтальная координата события относительно экранного объекта-контейнера. localYNumber0Вертикальная координата события относительно экранного объекта-контейнера. tapLocalXNumber0Горизонтальная координата события относительно интерактивного объекта-контейнера. tapLocalYNumber0Вертикальная координата события относительно интерактивного объекта-контейнера. ctrlKeyBooleanfalseВ Windows или Linux указывает на то, активирована ли клавиша Ctrl. В Mac указывает на то, активирована ли клавиша Ctrl или Command. altKeyBooleanfalseУказывает на то, активирована ли клавиша Alt (только для Windows или Linux). shiftKeyBooleanfalseУказывает, активирована ли клавиша Shift. commandKeyBooleanfalse(Только для AIR) Указывает, активирована ли клавиша Command (только для Mac). Этот параметр только для Adobe AIR; не устанавливать его для содержимого Flash Player. controlKeyBooleanfalse(Только для AIR)Указывает активирована ли клавиша Control или Ctrl. Этот параметр только для Adobe AIR; не устанавливать его для содержимого Flash Player. Конструктор для объектов PressAndTapGestureEvent. Создает объект Event, который содержит информацию о сложных мультисенсорных событиях, например о вызове контекстового всплывающего меню. Объекты Event передаются прослушивателям событий в качестве параметров. flash.ui.Multitouchflash.events.TouchEventflash.events.GestureEventflash.events.GesturePhaseflash.events.MouseEventflash.events.EventDispatcher.addEventListener()clone Создает копию объекта PressAndTapGestureEvent и задает значение каждого свойства, совпадающее с оригиналом.Новый объект PressAndTapGestureEvent, значения свойств которого соответствуют значениям оригинала. flash.events:Event Создает копию объекта PressAndTapGestureEvent и задает значение каждого свойства, совпадающее с оригиналом. toString Возвращает строку, содержащую все свойства объекта PressAndTapGestureEvent.Строка, содержащая все свойства объекта PressAndTapGestureEvent. String Возвращает строку, содержащую все свойства объекта PressAndTapGestureEvent. Строка имеет следующий формат:

[PressAndTapGestureEvent type=value bubbles=value cancelable=value ... ]

GESTURE_PRESS_AND_TAP Определяет значение свойства type объекта события сенсорного экрана GESTURE_PRESS_AND_TAP.gesturePressAndTapString Определяет значение свойства type объекта события сенсорного экрана GESTURE_PRESS_AND_TAP.

Объект PressAndTapGestureEvent имеет следующие свойства.

СвойствоЗначениеaltKeytrue, если клавиша Alt активна (Windows или Linux).bubblestruecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.commandKeytrue в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows.controlKeytrue, если клавиша Ctrl или Control активна; false, если неактивна.ctrlKeytrue в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.eventPhaseТекущая фаза, когда событие проходит через иерархию объектов; числовое значение, которое указывает на то, что событие захвачено (1), достигло цели (2) или восходит по цепочке (3).localXГоризонтальная координата события относительно экранного объекта-контейнера.localYВертикальная координата события относительно экранного объекта-контейнера.phaseТекущая файла в потоке событий; GesturePhase class.Possible может иметь следующие значения: GesturePhase.BEGIN, GesturePhase.UPDATE, GesturePhase.END или GesturePhase.ALL. Жест нажатия и касания создает последовательность событий GesturePhase.BEGIN, GesturePhase.UPDATE, GesturePhase.END или одну фазу GesturePhase.ALL.shiftKeytrue, если клавиша Shift активна; иначе — false.stageXГоризонтальная координата события в глобальных координатах рабочей области.stageYВертикальная координата события в глобальных координатах рабочей области.tapLocalXГоризонтальная координата события относительно интерактивного объекта-контейнера.tapLocalYВертикальная координата события относительно интерактивного объекта-контейнера.tapStageXГоризонтальная координата касания в глобальных координатах рабочей области.tapStageYВертикальная координата касания в глобальных координатах рабочей области.targetЭкземпляр InteractiveObject под указывающим устройством. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент.
flash.display.InteractiveObject.gesturePressAndTapflash.events.GesturePhase
tapLocalX Горизонтальная координата события относительно интерактивного объекта-контейнера.Number Горизонтальная координата события относительно интерактивного объекта-контейнера. tapLocalY Вертикальная координата события относительно интерактивного объекта-контейнера.Number Вертикальная координата события относительно интерактивного объекта-контейнера. tapStageX Горизонтальная координата касания в глобальных координатах рабочей области.Number Горизонтальная координата касания в глобальных координатах рабочей области. Это свойство вычисляется, когда задано свойство tapLocalY. tapStageY Вертикальная координата касания в глобальных координатах рабочей области.Number Вертикальная координата касания в глобальных координатах рабочей области. Это свойство вычисляется, когда задано свойство tapLocalY.
GeolocationEvent Объект Geolocation отправляет объекты GeolocationEvent, когда получает обновления от датчика местоположения, установленного в устройстве.flash.events:Event Объект Geolocation отправляет объекты GeolocationEvent, когда получает обновления от датчика местоположения, установленного в устройстве. updateflash.events:GeolocationEvent:UPDATEflash.events:GeolocationEventGeolocationEvent Создает объект GeolocationEvent, который содержит информацию о местоположении устройства.typeString Указывает тип события. Прослушиватели событий могут получать эту информацию через унаследованное свойство type. Существует только один тип события обновления: GeolocationEvent.UPDATE. bubblesBooleanfalseОпределяет, может ли событие восходить по цепочке. Прослушиватели событий могут получать эту информацию через унаследованное свойство bubbles. cancelableBooleanfalseОпределяет, можно ли отменить объект события. Прослушиватели событий могут получать эту информацию через унаследованное свойство cancelable. latitudeNumber0Возвращает широту в градусах. Значения находятся в следующем диапазоне: (-90 <= широта <= +90). longitudeNumber0Возвращает долготу в градусах. Значения находятся в следующем диапазоне: (-180 <= долгота <= +180). altitudeNumber0Возвращает высотную отметку в метрах. hAccuracyNumber0Возвращает точность контуров в метрах. vAccuracyNumber0Возвращает точность нивелирования в метрах. speedNumber0 Возвращает скорость в м/с. headingNumber0Возвращает направление движения (относительно истинного севера) в целочисленных градусах. timestampNumber0Определяет метку времени обновления географического местоположения. Конструктор для объектов GeolocationEvent. Создает объект GeolocationEvent, который содержит информацию о местоположении устройства. Объекты Event передаются прослушивателям событий в качестве параметров. clone Создает копию объекта GeolocationEvent и задает значение каждого свойства, совпадающее с оригиналом.Новый объект GeolocationEvent, значения свойств которого соответствуют значениям оригинала. flash.events:Event Создает копию объекта GeolocationEvent и задает значение каждого свойства, совпадающее с оригиналом. toString Возвращает строку, содержащую все свойства объекта GeolocationEvent.Строка, содержащая все свойства объекта GeolocationEvent. String Возвращает строку, содержащую все свойства объекта GeolocationEvent. Строка имеет следующий формат:

[GeolocationEvent type=value bubbles=value cancelable=value status=value]

UPDATE Задает значение свойства type для объекта события GeolocationEvent.updateString Задает значение свойства type для объекта события GeolocationEvent.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.targetОбъект Geolocation, получающий данные.
altitude Высотная отметка в метрах.Number Высотная отметка в метрах.

Если устройство не поддерживает высотную отметку, свойство получает значение NaN.

heading Направление движения (относительно истинного севера) в целочисленных градусах.Number Направление движения (относительно истинного севера) в целочисленных градусах. Не следует путать это понятие с румбом, который обозначает направление движения относительно другой точки.

Примечание. На устройствах Android направление не поддерживается. Значением свойства heading всегда является NaN (не число).

horizontalAccuracy Возвращает точность контуров в метрах.Number Возвращает точность контуров в метрах. latitude Широта в градусах.Number Широта в градусах. Значения широты находятся в диапазоне (-90 <= latitude <= 90). Отрицательные значения обозначают Юг, а положительные — Север. longitude Долгота в градусах.Number Долгота в градусах. Значения долготы находятся в диапазоне (-180 <= longitude <180). Отрицательные значения долготы обозначают Запад, а положительные — Восток. speed Скорость в метрах на секунду.Number Скорость в метрах на секунду. timestamp Число миллисекунд на момент события начиная с инициализации среды выполнения.Number Число миллисекунд на момент события начиная с инициализации среды выполнения. Например, если устройство захватывает данные географического положения через 4 секунды после запуска программы, свойство timestamp события будет иметь значение 4000. verticalAccuracy Точность нивелирования в метрах.Number Точность нивелирования в метрах.
MediaEvent Классы CameraRoll и CameraUI отправляют объекты MediaEvent, когда доступен поток мультимедиа.flash.events:Event Классы CameraRoll и CameraUI отправляют объекты MediaEvent, когда доступен поток мультимедиа.

Класс CameraRoll отправляет объект MediaEvent типа select, когда пользователь выбирает изображение. Класс CameraUI отправляет объект MediaEvent типа complete при возврате изображения или видео, захваченного с камеры устройства.

CameraRollCameraUIcompleteflash.events:MediaEvent:COMPLETEflash.events:MediaEventТип события завершения. selectflash.events:MediaEvent:SELECTflash.events:MediaEventТип события выбора. MediaEvent Создает объект MediaEvent, который содержит информацию о доступном файле мультимедиа.typeStringТип события. bubblesBooleanfalseОпределяет, находится ли объект Event в фазе восходящей цепочки. cancelableBooleanfalseОпределяет, можно ли отменить объект Event. dataflash.media:MediaPromisenullОбъект MediaPromise, соответствующий выбранному изображению. Конструктор для объектов MediaEvent. Создает объект MediaEvent, который содержит информацию о доступном файле мультимедиа. Объекты Event передаются прослушивателям событий в качестве параметров. clone Создает копию объекта MediaEvent и задает значение каждого свойства, совпадающее с оригиналом.Новый объект MediaEvent, значения свойств которого соответствуют значениям оригинала. flash.events:Event Создает копию объекта MediaEvent и задает значение каждого свойства, совпадающее с оригиналом. toString Возвращает строку, содержащую все свойства объекта MediaEvent.Новый объект MediaEvent, значения свойств которого соответствуют значениям оригинала. String Возвращает строку, содержащую все свойства объекта MediaEvent. Используется следующий формат:

[MediaEvent type=value bubbles=value cancelable=value data=value ]

COMPLETE Константа для события завершения MediaEvent.completeStringТип события завершения. Константа для события MediaEvent типа complete.

Задает значение свойства type объекта события MediaEvent. Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.dataОбъект MediaPromise доступного экземпляра мультимедиа.
SELECT Константа для события выбора MediaEvent.selectStringТип события выбора. Константа для события MediaEvent типа select.

Задает значение свойства type объекта события MediaEvent. Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.dataОбъект MediaPromise доступного экземпляра мультимедиа.
data Объект MediaPromise для доступного файла мультимедиа.flash.media:MediaPromise Объект MediaPromise для доступного файла мультимедиа.
StageVideoEvent Объект StageVideo отправляет объект StageVideoEvent после того, как были вызваны метод attachNetStream() объекта StageVideo и метод play() присоединенного объекта NetStream.Объекты событий StageVideo. flash.events:Event Объект StageVideo отправляет объект StageVideoEvent после того, как были вызваны метод attachNetStream() объекта StageVideo и метод play() присоединенного объекта NetStream. Кроме того, в зависимости от платформы любое изменение состояния воспроизведения может приводить к отправке события. Одним из типов StageVideoEvent является StageVideoEvent.RENDER_STATE. renderStateflash.events:StageVideoEvent:RENDER_STATEflash.events:StageVideoEventflash.events.StageVideoEvent.RENDER_STATEflash.events.StageVideoEvent.RENDER_STATUS_UNAVAILABLEflash.events.StageVideoEvent.RENDER_STATUS_SOFTWAREflash.events.StageVideoEvent.RENDER_STATUS_ACCELERATEDStageVideoEvent Создает объект Event, содержащий данные о событиях StageVideo.typeString Тип события. Прослушиватели событий могут получать эту информацию через унаследованное свойство type. Одним из типов StageVideoEvent является StageVideoEvent.RENDER_STATE. bubblesBooleanfalseОпределяет, участвует ли объект Event в фазе восходящей цепочки потока событий. Прослушиватели событий могут получать эту информацию через унаследованное свойство bubbles. cancelableBooleanfalseОпределяет, можно ли отменить объект Event. Прослушиватели событий могут получать эту информацию через унаследованное свойство cancelable. statusStringnullОбозначает состояние целевого объекта StageVideo. colorSpaceStringnullЦветовое пространство, используемое отображаемым видео. Конструктор для объектов StageVideoEvent. Создает объект Event, содержащий данные о событиях StageVideo. Объекты Event передаются прослушивателям событий в качестве параметров. flash.media.StageVideoflash.display.Stage.stageVideosflash.events.StageVideoEvent.RENDER_STATERENDER_STATE Константа StageVideoEvent.RENDER_STATE определяет значение свойства type объекта события renderState.renderStateString Константа StageVideoEvent.RENDER_STATE определяет значение свойства type объекта события renderState.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.colorSpaceДоступные цветовые пространства для отображения видео.currentTargetОбъект, активно обрабатывающий объект StageVideoEvent с помощью прослушивателя событий.statusОбозначает, выполняется ли визуализация (декодирование и отображение) видео на аппаратном или программном уровне или не выполняется вовсе.targetОбъект StageVideo, изменивший состояние.
flash.events.StageVideoEvent.RENDER_STATEflash.events.StageVideoEvent.RENDER_STATUS_UNAVAILABLEflash.events.StageVideoEvent.RENDER_STATUS_SOFTWAREflash.events.StageVideoEvent.RENDER_STATUS_ACCELERATED
RENDER_STATUS_ACCELERATED Обозначает, что декодирование и отображение видео выполняются на аппаратном уровне.acceleratedString Обозначает, что декодирование и отображение видео выполняются на аппаратном уровне.

Это значение является одним из возможных значений свойства status объекта StageVideoEvent.

status
RENDER_STATUS_SOFTWARE Обозначает, что декодирование и отображение видео выполняются на программном уровне.softwareString Обозначает, что декодирование и отображение видео выполняются на программном уровне.

Это значение является одним из возможных значений свойства status объекта StageVideoEvent.

Например, если платформа не поддерживает аппаратное декодирование и отображение аудио- или видеокодека видеоролика, объект StageVideoEvent имеет это значение состояния.

status
RENDER_STATUS_UNAVAILABLE Обозначает, что отображение видео с использованием объекта StageVideo невозможно.unavailableString Обозначает, что отображение видео с использованием объекта StageVideo невозможно.

Это значение является одним из возможных значений свойства status объекта StageVideoEvent.

Например, рассмотрим платформу, которая не поддерживает декодирование и отображение аудио- или видеокодека видеоролика на программном или аппаратном уровне. В этом случае объект StageVideoEvent имеет это значение состояния.

Это значение состояния также используется, если аппаратные декодеры недоступны. Такая ситуация возможна в среде AIR для телевизионных устройств. В целях обратной совместимости с предыдущими выпусками в среде AIR для телевизионных устройств можно использовать объект Video для аппаратного декодирования и отображения. При использовании объекта Video применяется базовый аппаратный декодер, поэтому число доступных для использования объектов StageVideo на единицу меньше. Обратите внимание, что для аппаратного декодирования и отображения видео рекомендуется использовать объект StageVideo.

status
colorSpace Цветовое пространство, которое используется видео, отображаемым в объекте StageVideo.String Цветовое пространство, которое используется видео, отображаемым в объекте StageVideo. flash.media.StageVideostatus Состояние объекта StageVideo.String Состояние объекта StageVideo. flash.events.StageVideoEvent.RENDER_STATUS_UNAVAILABLEflash.events.StageVideoEvent.RENDER_STATUS_SOFTWAREflash.events.StageVideoEvent.RENDER_STATUS_ACCELERATED
LocationChangeEvent Объект HTMLLoader или StageWebView отправляет объект LocationChangeEvent при загрузке новой страницы.flash.events:Event Объект HTMLLoader или StageWebView отправляет объект LocationChangeEvent при загрузке новой страницы.

Существует два типа событий LocationChangeEvent:

  • LocationChangeEvent.LOCATION_CHANGING: отправляется перед изменением, инициированным в содержимом, отображаемом в объекте StageWebView. Может быть отменено.
  • LocationChangeEvent.LOCATION_CHANGE: отправляется после каждого изменения расположения. Отмена невозможна.
StageWebViewLocationChangeEvent Создает объект LocationChangeEvent.typeStringbubblesBooleanfalsecancelableBooleanfalselocationStringnull Создает объект LocationChangeEvent. clone flash.events:Event toString Возвращает строку, содержащую все свойства объекта LocationChangeEvent.String Возвращает строку, содержащую все свойства объекта LocationChangeEvent. Строка имеет следующий формат:

[LocationChangeEvent type=value bubbles=value cancelable=value eventPhase=value location=value

LOCATION_CHANGE Отправляется после каждого изменения расположения.locationChangeString Отправляется после каждого изменения расположения. LOCATION_CHANGING Константа LOCATION_CHANGING определяет значение объекта LocationChangeEvent свойства текста, отправляемого перед изменением положения страницы.locationChangingString Константа LOCATION_CHANGING определяет значение объекта LocationChangeEvent свойства текста, отправляемого перед изменением положения страницы. location URL-адрес пункта назначения изменения.String URL-адрес пункта назначения изменения.
NetDataEvent Объект NetStream отправляет объект NetDataEvent при обнаружении сообщения с данными в медиапотоке.flash.events:Event Объект NetStream отправляет объект NetDataEvent при обнаружении сообщения с данными в медиапотоке.

NetDataEvent отправляется для следующих сообщений:

  • onCuePoint
  • onImageData
  • onMetaData
  • onPlayStatus (для кода NetStream.Play.Complete)
  • onTextData
  • onXMPData
NetDataEvent Создает объект Event, содержащий информацию о событиях медиаданных.typeString Тип события. Прослушиватели событий могут получать эту информацию через унаследованное свойство type. bubblesBooleanfalseОпределяет, участвует ли объект Event в фазе восходящей цепочки потока событий. Прослушиватели событий могут получать эту информацию через унаследованное свойство bubbles. cancelableBooleanfalseОпределяет, можно ли отменить объект Event. Прослушиватели событий могут получать эту информацию через унаследованное свойство cancelable. timestampNumber0метка времени сообщения о данных infoObjectnullобъект сообщения о данных Создает объект Event, содержащий информацию о событиях медиаданных. Объекты Event передаются прослушивателям событий в качестве параметров. clone Создает копию объекта NetDataEvent и задает значение каждого свойства, совпадающее с оригиналом.Новый объект NetDataEvent, значения свойств которого соответствуют значениям оригинала. flash.events:Event Создает копию объекта NetDataEvent и задает значение каждого свойства, совпадающее с оригиналом. toString Возвращает строку, содержащую все свойства объекта NetDataEvent.Строка, содержащая все свойства объекта NetMediaEvent. String Возвращает строку, содержащую все свойства объекта NetDataEvent. Используется следующий формат:

[NetDataEvent type=значение bubbles=значение cancelable=значение timestamp=значение]

MEDIA_TYPE_DATA Константа NetDataEvent.MEDIA_TYPE_DATA определяет значение объекта NetDataEvent свойства текста, который отправляется, когда объект NetStream обнаруживает сообщение с данными в медиапотоке.mediaTypeDataString Константа NetDataEvent.MEDIA_TYPE_DATA определяет значение объекта NetDataEvent свойства текста, который отправляется, когда объект NetStream обнаруживает сообщение с данными в медиапотоке. info Объект данных, описывающий сообщение.Object Объект данных, описывающий сообщение. Объект info имеет два свойства: info.handler и info.args. Свойство info.handler является именем объекта, например onMetaData или onXMPData. Свойство info.args является массивом аргументов. timestamp Метка времени сообщения с данными в медиапотоке.Number Метка времени сообщения с данными в медиапотоке.
NativeProcessExitEvent Это событие отправляется объектом NativeProcess после завершения процесса.flash.events:Event Это событие отправляется объектом NativeProcess после завершения процесса. Это событие может совсем не отправляться. Например, если дочерний процесс продолжает работу после завершения работы запустившего его приложения AIR, то событие не отправляется. flash.desktop.NativeProcessexitflash.events:NativeProcessExitEvent:EXITflash.events:NativeProcessExitEventNativeProcessExitEvent Создает объект NativeProcessExitEvent, который содержит конкретную информацию о коде завершения NativeProcess. typeString Тип события, представленный в виде Event.type. bubblesBooleanfalse Определяет, участвует ли объект Event в фазе восходящей цепочки потока событий. Значение по умолчанию false. cancelableBooleanfalseОпределяет, можно ли отменить объект Event. Значение по умолчанию - false. exitCodeNumberunknownЧисло, которое процесс вернул операционной системе при завершении. Создает объект NativeProcessExitEvent, который содержит конкретную информацию о коде завершения NativeProcess. clone Создает копию объекта NativeProcessExitEvent и задает значение каждого свойства, совпадающее с оригиналом.Новый объект NativeProcessExitEvent, значения свойств которого соответствуют значениям оригинала. flash.events:Event Создает копию объекта NativeProcessExitEvent и задает значение каждого свойства, совпадающее с оригиналом. toString Возвращает строку, содержащую все свойства объекта NativeProcessExitEvent.Строка, содержащая все свойства объекта ProgressEvent. String Возвращает строку, содержащую все свойства объекта NativeProcessExitEvent. Строка имеет следующий формат:

[NativeProcessExitEvent type=value bubbles=value cancelable=value exitCode=value]

EXIT Задает значение свойства type для объекта события exit.exitString Задает значение свойства type для объекта события exit. exitCode Код завершения, который собственный процесс вернул к операционной системе хоста при завершении.Number Код завершения, который собственный процесс вернул к операционной системе хоста при завершении. Если программа AIR завершает процесс с помощью метода exit() объекта NativeProcess, свойство exitCode получает значение NaN. ПРИМЕЧАНИЕ. В операционных системах Windows этот код может иметь значение 259 (STILL_ACTIVE), если процесс продолжается после выхода из среды выполнения или произошла ошибка. Во избежание недоразумений, нее используйте код возврата 259 для собственных процессов.
DNSResolverEvent Класс DNSResolverEvent представляет результаты операции поиска DNS.flash.events:Event Класс DNSResolverEvent представляет результаты операции поиска DNS.

Используйте метод lookup() объекта DNSResolver, чтобы инициировать запрос DNS. Записи ресурсов, возвращенные в ответ на запрос, помещаются в массив resourceRecords этого объекта DNSResolverEvent.

DNSResolverlookupflash.events:DNSResolverEvent:LOOKUPflash.events:DNSResolverEventОтправляется объектом DNSResolver, когда завершается операция поиска. DNSResolverEvent Создает объект DNSResolverEvent, содержащий результаты операции поиска DNS.typeString Тип события. Возможные значения: DNSResolverEvent.LOOKUP bubblesBooleanfalse Определяет, участвует ли объект Event в фазе восходящей цепочки потока событий. cancelableBooleanfalseОпределяет, можно ли отменить объект Event. hostStringСтрока запроса, например имя хоста, IP-адрес или URL-адрес службы, используемая в вызове метода lookup() класса DNSResolver, на которое отвечает новое событие. resourceRecordsArraynullСписок возвращенных записей ресурсов DNS. Создает объект DNSResolverEvent, содержащий результаты операции поиска DNS. Объекты Event передаются прослушивателям событий в качестве параметров. clone Создает копию объекта DNSResolverEvent и задает значение каждого свойства, совпадающее с оригиналом.Новый объект DNSResolverEvent, значения свойств которого соответствуют значениям оригинала. flash.events:Event Создает копию объекта DNSResolverEvent и задает значение каждого свойства, совпадающее с оригиналом. toString Возвращает строку, содержащую все свойства объекта DNSResolverEvent.Строка, содержащая все свойства объекта ProgressEvent. String Возвращает строку, содержащую все свойства объекта DNSResolverEvent. Строка имеет следующий формат:

[DNSResolverEvent type=value bubbles=value cancelable=value host=value resourceRecords=value]

LOOKUP Задает значение свойства type для объекта события lookup.lookupStringОтправляется объектом DNSResolver, когда завершается операция поиска. Задает значение свойства type для объекта события lookup. host Строка запроса, например имя хоста, IP-адрес или URL-адрес службы, используемая в вызове метода lookup() класса DNSResolver, на которое отвечает это событие.StringСтрока запроса, используемая в операции поиска. Строка запроса, например имя хоста, IP-адрес или URL-адрес службы, используемая в вызове метода lookup() класса DNSResolver, на которое отвечает это событие. resourceRecords Массив, содержащий записи ресурсов, возвращенные в результате поиска DNS.Array Массив, содержащий записи ресурсов, возвращенные в результате поиска DNS.
Event Класс Event используется как базовый класс для создания объектов Event, которые передаются прослушивателям событий в качестве параметров, когда происходит какое-либо событие.Базовый класс объектов событий. Object Класс Event используется как базовый класс для создания объектов Event, которые передаются прослушивателям событий в качестве параметров, когда происходит какое-либо событие.

Свойства класса Event передают базовую информацию о событии, такую как его тип или возможность отмены действия по умолчанию. Для многих событий, таких как представленные константами класса Events, достаточно этих базовых сведений. Однако для других событий может потребоваться более подробная информация. События, связанные с нажатием кнопки мыши, например, требуют включения дополнительной информации о положении события click и о том, были ли нажаты какие-либо клавиши во время события click. Такую дополнительную информацию можно передать прослушивателям событий, расширив класс Event с помощью класса MouseEvent. ActionScript 3.0 API определяет несколько подклассов Event для общих событий, требующих дополнительной информации. События, связанные подклассами Event, описываются в документации по каждому такому классу.

Методы класса Event можно использовать в функциях прослушивателей событий с целью воздействия на повеление объекта события. С некоторыми событиями связано поведение по умолчанию. Например, событие doubleClick по умолчанию, как правило, выделяет слово, на которое наведен указатель мыши в момент события. Прослушиватель события может изменить это поведение, вызвав метод preventDefault(). Также можно сделать текущий прослушиватель событий последним для обработки события путем вызова метода stopPropogation() или stopImmediatePropogation().

Можно также использовать другие источники информации, включая следующие.

  • Полезное описание синхронизации событий, выполнения кода и визуализации в среде выполнения можно найти в сообщении блога от Теда Патрика (Ted Patrick): Flash Player Mental Model — The Elastic Racetrack (Модель мышления Flash Player: эластичная беговая дорожка).
  • Сообщение блога от Йоханеса Тачковича (Johannes Tacskovics) посвящено синхронизации событий кадра, таких как ENTER_FRAME, EXIT_FRAME: The MovieClip Lifecycle (Жизненный цикл MovieClip).
  • Статья Тревора Макколи (Trevor McCauley) посвящена порядку операций ActionScript: Order of Operations in ActionScript (Порядок операций в ActionScript).
  • Сообщение блога от Мэтта Пржибыльского (Matt Przybylski) о создании пользовательских событий: AS3: Custom Events (AS3: пользовательские события).
В следующем примере класс EventExample и пользовательский класс Square используются, чтобы показать возможности управления фазой восходящей цепочки события. package { import flash.display.Sprite; import flash.events.Event; import flash.events.MouseEvent; public class EventExample extends Sprite { public function EventExample() { var square_0:Square = new Square(300, 0x336633); addChild(square_0); var square_1:Square = new Square(250, 0x669966); square_0.addChild(square_1); var square_2:Square = new Square(200, 0x66CC66); square_1.addChild(square_2); var square_3:Square = new Square(150, 0xAA0000); square_3.shouldBubble = false; square_2.addChild(square_3); var square_4:Square = new Square(100, 0x66FF66); square_3.addChild(square_4); var square_5:Square = new Square(50, 0xCC0000); square_5.shouldBubble = false; square_4.addChild(square_5); this.addEventListener(MouseEvent.CLICK, clickHandler); } private function clickHandler(e:Event):void { trace(">> stage: " + e.type + " event from " + e.target.name + " called on " + this.name); trace(">> --------------------------------------------"); } } } import flash.display.Sprite; import flash.events.Event; import flash.events.MouseEvent; class Square extends Sprite { private var sideLen:int; private var color:Number; public var shouldBubble:Boolean = true; public function Square(sideLen:int, color:Number) { this.sideLen = sideLen; this.color = color; init(); draw(); } private function init():void { buttonMode = true; this.addEventListener(MouseEvent.CLICK, firstClickHandler); this.addEventListener(MouseEvent.CLICK, secondClickHandler); this.addEventListener(MouseEvent.CLICK, thirdClickHandler); } private function draw():void { this.graphics.beginFill(color); this.graphics.drawRect(0, 0, sideLen, sideLen); } private function firstClickHandler(e:Event):void { trace(">> 1e: " + e.type + " event from " + e.target.name + " called on " + this.name); if(!shouldBubble) { e.stopPropagation(); } } private function secondClickHandler(e:Event):void { trace(">> 2e: " + e.type + " event from " + e.target.name + " called on " + this.name); if(!shouldBubble) { e.stopImmediatePropagation(); trace(">> --------------------------------------------"); } } private function thirdClickHandler(e:Event):void { trace(">> 3e: " + e.type + " event from " + e.target.name + " called on " + this.name); } } Для этого создается интерактивная демонстрация различий между событиями ADDED и ADDED_TO_STAGE, а также между событиями REMOVED и REMOVED_FROM_STAGE. Щелчок по спрайту приводит к тому, что он и все его вложенные элементы удаляются из рабочей области. Например, щелчок по самому большому спрайту вызовет событие REMOVED, а также три события REMOVED_FROM_STAGE. package { import flash.display.Sprite; import flash.events.*; public class EventExample2 extends Sprite { public function EventExample2():void { var parentSprite:Sprite = createSprite("parentSprite",200); var childSprite:Sprite = createSprite("childSprite",100); var childOfChildSprite:Sprite = createSprite("childOfChildSprite",50); trace(":: Adding to Stage ::"); this.addChild(parentSprite); trace(":: Adding to Stage ::"); parentSprite.addChild(childSprite); trace(":: Adding to Stage ::"); childSprite.addChild(childOfChildSprite); } private function createSprite(name:String,size:uint):Sprite { trace(":: Creating Sprite ::"); var newSprite:Sprite = new Sprite(); newSprite.name = name; newSprite.graphics.beginFill(0xFFFFFF * Math.random(),1); newSprite.graphics.drawRect(0,0,size,size); newSprite.graphics.endFill(); newSprite.addEventListener(Event.ADDED, spriteAdded); newSprite.addEventListener(Event.ADDED_TO_STAGE, spriteAddedToStage); newSprite.addEventListener(Event.REMOVED, spriteRemoved); newSprite.addEventListener(Event.REMOVED_FROM_STAGE, spriteRemovedFromStage); newSprite.addEventListener(MouseEvent.CLICK, remove); return newSprite; } private function remove(event:Event) { if(event.target == event.currentTarget) { trace(":: Removing Clicked Sprite ::"); var target:Sprite = Sprite(event.target); target.parent.removeChild(target); } } private function spriteRemovedFromStage(event:Event):void { trace("REMOVED_FROM_STAGE: " + event.target.name + " : " + event.currentTarget.name); } private function spriteRemoved(event:Event):void { trace("REMOVED: " + event.target.name + " from " + event.currentTarget.name); } private function spriteAddedToStage(event:Event):void { trace("ADDED_TO_STAGE: " + event.target.name + " : " + event.currentTarget.name); } private function spriteAdded(event:Event):void { trace("ADDED: " + event.target.name + " within " + event.currentTarget.name); } } }
flash.events.EventDispatcheractivateflash.events:Event:ACTIVATEflash.events:Eventflash.events.EventDispatcher.activateDEACTIVATEaddedToStageflash.events:Event:ADDED_TO_STAGEflash.events:Eventflash.display.DisplayObject.addedToStageADDEDREMOVEDREMOVED_FROM_STAGEaddedflash.events:Event:ADDEDflash.events:Eventflash.display.DisplayObject.addedADDED_TO_STAGEREMOVEDREMOVED_FROM_STAGEcancelflash.events:Event:CANCELflash.events:Eventflash.net.FileReference.cancelchangeflash.events:Event:CHANGEflash.events:Eventflash.text.TextField.changeflash.events.TextEvent.TEXT_INPUTcopyflash.events:Event:CLEARflash.events:Eventflash.display.InteractiveObject.clearcloseflash.events:Event:CLOSEflash.events:Eventflash.net.Socket.closeflash.net.XMLSocket.closeflash.display.NativeWindow.closeclosingflash.events:Event:CLOSINGflash.events:Eventflash.display.NativeWindow.closingcompleteflash.events:Event:COMPLETEflash.events:Eventflash.display.LoaderInfo.completeflash.html.HTMLLoader.completeflash.media.Sound.completeflash.net.FileReference.completeflash.net.URLLoader.completeflash.net.URLStream.completeconnectflash.events:Event:CONNECTflash.events:Eventflash.net.Socket.connectflash.net.XMLSocket.connectcopyflash.events:Event:COPYflash.events:Eventflash.display.InteractiveObject.copycutflash.events:Event:CUTflash.events:Eventflash.display.InteractiveObject.cutdeactivateflash.events:Event:DEACTIVATEflash.events:Eventflash.events.EventDispatcher.deactivateACTIVATEdisplayingflash.events:Event:DISPLAYINGflash.events:Eventflash.display.NativeMenu.displayingflash.display.NativeMenuItem.displayingenterFrameflash.events:Event:ENTER_FRAMEflash.events:Eventflash.display.DisplayObject.enterFrameexitingflash.events:Event:EXITINGflash.events:Eventflash.desktop.NativeApplication.exitingexitFrameflash.events:Event:EXIT_FRAMEflash.events:Eventflash.display.DisplayObject.exitFrameframeConstructedflash.events:Event:FRAME_CONSTRUCTEDflash.events:Eventflash.display.DisplayObject.frameConstructedfullScreenflash.events:Event:FULLSCREENflash.events:Eventflash.display.Stage.fullScreenhtmlBoundsChangeflash.events:Event:HTML_BOUNDS_CHANGEflash.events:EventСобытие htmlBoundsChangehtmlDOMInitializeflash.events:Event:HTML_DOM_INITIALIZEflash.events:EventСобытие htmlDOMInitializehtmlRenderflash.events:Event:HTML_RENDERflash.events:EventСобытие htmlRenderid3flash.events:Event:ID3flash.events:Eventflash.media.Sound.id3initflash.events:Event:INITflash.events:Eventflash.display.LoaderInfo.initlocationChangeflash.events:Event:LOCATION_CHANGEflash.events:EventСобытие locationChangemouseLeaveflash.events:Event:MOUSE_LEAVEflash.events:Eventflash.display.Stage.mouseLeaveflash.events.MouseEventnetworkChangeflash.events:Event:NETWORK_CHANGEflash.events:Eventflash.desktop.NativeApplication.networkChangeopenflash.events:Event:OPENflash.events:Eventflash.display.LoaderInfo.openflash.media.Sound.openflash.net.FileReference.openflash.net.URLLoader.openflash.net.URLStream.openpasteflash.events:Event:PASTEflash.events:Eventflash.display.InteractiveObject.pasteflash.events.Eventвспышка events:Event:PREPARINGflash.events:Eventflash.display. NativeMenu.preparingflash.display. NativeMenuItem.preparingremovedFromStageflash.events:Event:REMOVED_FROM_STAGEflash.events:Eventflash.display.DisplayObject.removedFromStageADDEDREMOVEDADDED_TO_STAGEremovedflash.events:Event:REMOVEDflash.events:Eventflash.display.DisplayObject.removedADDEDADDED_TO_STAGEREMOVED_FROM_STAGErenderflash.events:Event:RENDERflash.events:Eventflash.display.DisplayObject.renderflash.display.Stage.invalidate()resizeflash.events:Event:RESIZEflash.events:Eventflash.display.Stage.resizescrollflash.events:Event:SCROLLflash.events:Eventflash.text.TextField.scrollflash.html.HTMLLoader.scrollselectAllflash.events:Event:SELECT_ALLflash.events:Eventflash.display.InteractiveObject.selectAllselectflash.events:Event:SELECTflash.events:Eventflash.net.FileReference.selectflash.display.NativeMenu.selectflash.display.NativeMenuItem.selectsoundCompleteflash.events:Event:SOUND_COMPLETEflash.events:Eventflash.media.SoundChannel.soundCompleteflash.events.Eventflash.events:Event:STANDARD_ERROR_CLOSEflash.events:Eventflash.events.Eventflash.events:Event:STANDARD_INPUT_CLOSEflash.events:Eventflash.events.Eventflash.events:Event:STANDARD_OUTPUT_CLOSEflash.events:EventtabChildrenChangeflash.events:Event:TAB_CHILDREN_CHANGEflash.events:Eventflash.display.InteractiveObject.tabChildrenChangetabEnabledChangeflash.events:Event:TAB_ENABLED_CHANGEflash.events:Eventflash.display.InteractiveObject.tabEnabledChangetabIndexChangeflash.events:Event:TAB_INDEX_CHANGEflash.events:Eventflash.display.InteractiveObject.tabIndexChangetextInteractionModeChangeвспышка events:Event:TEXT_INTERACTION_MODE_CHANGEflash.events:Eventflash.text.TextField.textInteractionModeChangeunloadflash.events:Event:UNLOADflash.events:Eventflash.display.LoaderInfo.unloaduserIdleflash.events:Event:USER_IDLEflash.events:Eventflash.desktop.NativeApplication.userIdleuserIdleflash.events:Event:USER_PRESENTflash.events:Eventflash.desktop.NativeApplication.userPresentEvent Создает объект Event для передачи в качестве параметра прослушивателям событий.typeString Тип события, представленный в виде Event.type. bubblesBooleanfalse Определяет, участвует ли объект Event в фазе восходящей цепочки потока событий. Значение по умолчанию false. cancelableBooleanfalseОпределяет, можно ли отменить объект Event. Значение по умолчанию - false. Используется для создания нового объекта Event. Создает объект Event для передачи в качестве параметра прослушивателям событий. clone Создает дубликат экземпляра подкласса Event.Новый объект Event, идентичный исходному. flash.events:Event Создает дубликат экземпляра подкласса Event.

Возвращает новый объект Event, являющийся копией исходного экземпляра объекта Event. Обычно метод clone() не вызывается; класс EventDispatcher вызывает его автоматически при повторной отправке события, то есть, при вызове dispatchEvent(event) из обработчика события event.

Новый объект Event включает все свойства исходного.

При создании собственного пользовательского класса Event, необходимо переопределять наследуемый метод Event.clone(), чтобы дублировать свойства пользовательского класса. Если не задать все свойства, добавляемые в ваш подкласс Event, они могут иметь неправильные значения, когда прослушиватели будут обрабатывать повторно отправленное событие.

В данном примере PingEvent является подклассом класса Event и реализует собственную версию clone().

class PingEvent extends Event { var URL:String; public override function clone():Event { return new PingEvent(type, bubbles, cancelable, URL); } }
formatToString Служебная функция для реализации метода toString() в пользовательских классах ActionScript 3.0 Event.Имя пользовательского класса Event и строковое значение для параметра ...arguments. StringclassNameStringИмя пользовательского класса Event. В предыдущем примере параметру className задано значение PingEvent. argumentsСвойства класса Event и свойства, добавляемые в пользовательский класс Event. В предыдущем примере параметр ...arguments включает в себя свойства type, bubbles, cancelable, eventPhase и URL. Служебная функция для реализации метода toString() в пользовательских классах ActionScript 3.0 Event. Переопределение метода toString() рекомендуется, но не является обязательным.
	 class PingEvent extends Event {
	  var URL:String;
	 
	 public override function toString():String { 
	  return formatToString("PingEvent", "type", "bubbles", "cancelable", "eventPhase", "URL"); 
	    }
	 }
	 
isDefaultPrevented Проверяет, выполнялся ли для события вызова метода preventDefault().Если был вызван метод preventDefault(), возвращается значение true; иначе - false. Boolean Проверяет, выполнялся ли для события вызова метода preventDefault(). Если был вызван метод preventDefault(), возвращается значение true; иначе - false. flash.events.Event.preventDefault()preventDefault Отменяет поведение по умолчанию для события, если такое поведение можно отменить. Отменяет поведение по умолчанию для события, если такое поведение можно отменить.

Многие события связаны с поведением по умолчанию. Например, если пользователь вводит символ в текстовое поле, этот символ по умолчанию отображается в текстовом поле. Так как поведение события TextEvent.TEXT_INPUT, принятое по умолчанию, можно отменить, можно использовать метод preventDefault() для предотвращения отображения символа.

Примером неотменяемого поведения является поведение по умолчанию, связанное с событием Event.REMOVED, которое создается при каждой попытке Flash Player удалить экранный объект из списка отображения. Такое поведение по умолчанию (удаление элемента) нельзя отменить, поэтому метод preventDefault() не влияет на такое поведение по умолчанию.

Можно использовать свойство Event.cancelable, чтобы проверить, можно ли отменить поведение по умолчанию, связанное с тем или иным событием. Если Event.cancelable имеет значение true, то метод preventDefault() можно вызвать для отмены события; в противном случае, preventDefault() не будет иметь силы.

flash.events.Event.isDefaultPrevented()Event.cancelable
stopImmediatePropagation Отменяет обработку прослушивателей событий в текущем узле, а также во всех узлах, которые следуют в потоке событий за текущим узлом. Отменяет обработку прослушивателей событий в текущем узле, а также во всех узлах, которые следуют в потоке событий за текущим узлом. Данный метод начинает действовать немедленно и влияет на прослушивателей событий в текущем узле. Наоборот, метод stopPropagation() не начнет действовать, пока все прослушиватели событий не закончат обработку в текущем узле.

Примечание. Данный метод не отменяет поведение, связанное с данным событием; см. описание preventDefault(), чтобы использовать эту функцию.

flash.events.Event.stopPropagation()flash.events.Event.preventDefault()
stopPropagation Отменяет обработку прослушивателей событий в узлах, которые следуют в потоке событий за текущим узлом. Отменяет обработку прослушивателей событий в узлах, которые следуют в потоке событий за текущим узлом. Этот метод не влияет на прослушивателей событий в текущем узле (currentTarget). Наоборот, метод stopImmediatePropagation() предотвращает обработку прослушивателями событий и в текущем, и в последующих узлах. Дополнительные вызовы этого метода не имеют эффекта. Этот метод можно вызвать на любой стадии потока событий.

Примечание. Данный метод не отменяет поведение, связанное с данным событием; см. описание preventDefault(), чтобы использовать эту функцию.

flash.events.Event.stopImmediatePropagation()flash.events.Event.preventDefault()
toString Возвращает строку, содержащую все свойства объекта Event.Строка, содержащая все свойства объекта Event. String Возвращает строку, содержащую все свойства объекта Event. Строка имеет следующий формат:

[Event type=value bubbles=value cancelable=value]

ACTIVATE Константа ACTIVATE определяет значение свойства type объекта события activate.activateString Константа ACTIVATE определяет значение свойства type объекта события activate.

Примечание. Это событие не имеет фазы захвата и фазы восходящей цепочки, поэтому отправляется непосредственно целевому элементу независимо от того, находится он в списке отображения или нет.

В среде AIR для телевизионных устройств это событие никогда не отправляется автоматически. Однако его можно отправить вручную.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.targetЛюбой экземпляр DisplayObject, для которого зарегистрирован прослушиватель события activate.
flash.events.EventDispatcher.activateDEACTIVATE
ADDED_TO_STAGE Константа Event.ADDED_TO_STAGE определяет значение свойства type объекта события addedToStage.addedToStageString Константа Event.ADDED_TO_STAGE определяет значение свойства type объекта события addedToStage.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.targetЭкземпляр DisplayObject, добавляемый в список отображения рабочей области напрямую или путем добавления поддерева, в котором он содержится. Если экземпляр DisplayObject добавляется напрямую, перед этим событием отправляется событие added.
flash.display.DisplayObject.addedToStageADDEDREMOVEDREMOVED_FROM_STAGE
ADDED Константа Event.ADDED определяет значение свойства type объекта события added.addedString Константа Event.ADDED определяет значение свойства type объекта события added.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblestruecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.targetЭкземпляр DisplayObject, добавляемый в список отображения. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент.
flash.display.DisplayObject.addedADDED_TO_STAGEREMOVEDREMOVED_FROM_STAGE
CANCEL Константа Event.CANCEL определяет значение свойства type объекта события cancel.cancelString Константа Event.CANCEL определяет значение свойства type объекта события cancel.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.targetСсылка на объект, для которого отменена операция.
flash.net.FileReference.cancel
CHANGE Константа Event.CHANGE определяет значение свойства type объекта события change.changeString Константа Event.CHANGE определяет значение свойства type объекта события change.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblestruecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.targetОбъект, значение которого было изменено. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент.
flash.text.TextField.changeflash.events.TextEvent.TEXT_INPUT
CLEAR Константа Event.CLEAR определяет значение свойства type объекта события clear.clearString Константа Event.CLEAR определяет значение свойства type объекта события clear.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.targetЛюбой экземпляр DisplayObject, для которого зарегистрирован прослушиватель события clear.

Примечание. Объектами TextField не отправляются события clear, copy, cut, paste или selectAll. Объекты TextField в контекстном меню всегда включают команды «Вырезать», «Скопировать», «Вставить» и «Выбрать все». Удалить эти команды из контекстного меню для объектов TextField невозможно. Для объектов TextField выбор этих команд (или сочетаний клавиш, эквивалентных элементу меню) не приводит к генерации событий clear, copy, cut, paste или selectAll. Однако другие классы, которые распространяют класс InteractiveObject, включая компоненты, построенные, используя текстовую Службу Flash (FTE), отправят эти события в ответ на операции пользователя, например, комбинации клавиш и контекстные меню.

flash.display.InteractiveObject.clear
CLOSE Константа Event.CLOSE определяет значение свойства type объекта события close.closeString Константа Event.CLOSE определяет значение свойства type объекта события close.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.targetОбъект, для которого разорвано подключение.
flash.net.Socket.closeflash.net.XMLSocket.closeflash.display.NativeWindow.close
CLOSING Константа Event.CLOSING определяет значение свойства type объекта события closing.closingString Константа Event.CLOSING определяет значение свойства type объекта события closing.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsecancelabletrue; отмена данного объекта отменяет операцию закрытия.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.targetОбъект, для которого подключение будет разорвано.
flash.display.NativeWindow.closing
COMPLETE Константа Event.COMPLETE определяет значение свойства type объекта complete.completeString Константа Event.COMPLETE определяет значение свойства type объекта complete.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.targetСетевой объект, который завершил загрузку.
flash.display.LoaderInfo.completeflash.html.HTMLLoader.completeflash.media.Sound.completeflash.net.FileReference.completeflash.net.URLLoader.completeflash.net.URLStream.complete
CONNECT Константа Event.CONNECT определяет значение свойства type объекта события connect.connectString Константа Event.CONNECT определяет значение свойства type объекта события connect.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.targetОбъект Socket или XMLSocket, установивший сетевое подключение.
flash.net.Socket.connectflash.net.XMLSocket.connect
COPY Задает значение свойства type для объекта события copy.copyString Задает значение свойства type для объекта события copy.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.targetЛюбой экземпляр InteractiveObject, для которого зарегистрирован прослушиватель события copy.

Примечание. Объектами TextField не отправляются события clear, copy, cut, paste или selectAll. Объекты TextField в контекстном меню всегда включают команды «Вырезать», «Скопировать», «Вставить» и «Выбрать все». Удалить эти команды из контекстного меню для объектов TextField невозможно. Для объектов TextField выбор этих команд (или сочетаний клавиш, эквивалентных элементу меню) не приводит к генерации событий clear, copy, cut, paste или selectAll. Однако другие классы, которые распространяют класс InteractiveObject, включая компоненты, построенные, используя текстовую Службу Flash (FTE), отправят эти события в ответ на операции пользователя, например, комбинации клавиш и контекстные меню.

flash.display.InteractiveObject.copy
CUT Задает значение свойства type для объекта события cut.cutString Задает значение свойства type для объекта события cut.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.targetЛюбой экземпляр InteractiveObject, для которого зарегистрирован прослушиватель события cut.

Примечание. Объектами TextField не отправляются события clear, copy, cut, paste или selectAll. Объекты TextField в контекстном меню всегда включают команды «Вырезать», «Скопировать», «Вставить» и «Выбрать все». Удалить эти команды из контекстного меню для объектов TextField невозможно. Для объектов TextField выбор этих команд (или сочетаний клавиш, эквивалентных элементу меню) не приводит к генерации событий clear, copy, cut, paste или selectAll. Однако другие классы, которые распространяют класс InteractiveObject, включая компоненты, построенные, используя текстовую Службу Flash (FTE), отправят эти события в ответ на операции пользователя, например, комбинации клавиш и контекстные меню.

flash.display.InteractiveObject.cut
DEACTIVATE Константа Event.DEACTIVATE определяет значение свойства type объекта события deactivate.deactivateString Константа Event.DEACTIVATE определяет значение свойства type объекта события deactivate.

Примечание. Это событие не имеет фазы захвата и фазы восходящей цепочки, поэтому отправляется непосредственно целевому элементу независимо от того, находится он в списке отображения или нет.

В среде AIR для телевизионных устройств это событие никогда не отправляется автоматически. Однако его можно отправить вручную.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.targetЛюбой экземпляр DisplayObject, для которого зарегистрирован прослушиватель события deactivate.
flash.events.EventDispatcher.deactivateACTIVATE
DISPLAYING Константа Event.DISPLAYING определяет значение свойства type объекта события displaying.displayingString Константа Event.DISPLAYING определяет значение свойства type объекта события displaying.

Примечание. Это событие не проходит фазу захвата и отправляется непосредственно целевому элементу независимо от того, находится он в списке отображения или нет.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsecancelablefalsecurrentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.targetОбъект, который сейчас будет отображаться.
flash.display.NativeMenu.displayingflash.display.NativeMenuItem.displaying
ENTER_FRAME Константа Event.ENTER_FRAME определяет значение свойства type объекта события enterFrame.enterFrameString Константа Event.ENTER_FRAME определяет значение свойства type объекта события enterFrame.

Примечание. Это событие не имеет фазы захвата и фазы восходящей цепочки, поэтому отправляется непосредственно целевому элементу независимо от того, находится он в списке отображения или нет.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.targetЛюбой экземпляр DisplayObject, для которого зарегистрирован прослушиватель события enterFrame.
flash.display.DisplayObject.enterFrame
EXITING Константа Event.EXITING определяет значение свойства type объекта события exiting.exitingString Константа Event.EXITING определяет значение свойства type объекта события exiting.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsecancelabletrue; отмена данного объекта отменяет операцию выхода.currentTargetОбъект NativeApplication.targetОбъект NativeApplication.
flash.desktop.NativeApplication.exiting
EXIT_FRAME Константа Event.EXIT_FRAME определяет значение свойства type объекта события exitFrame.exitFrameString Константа Event.EXIT_FRAME определяет значение свойства type объекта события exitFrame.

Примечание. Это событие не имеет фазы захвата и фазы восходящей цепочки, поэтому отправляется непосредственно целевому элементу независимо от того, находится он в списке отображения или нет.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.targetЛюбой экземпляр DisplayObject, для которого зарегистрирован прослушиватель события enterFrame.
flash.display.DisplayObject.exitFrame
FRAME_CONSTRUCTED Константа Event.FRAME_CONSTRUCTED определяет значение свойства type объекта события frameConstructed.frameConstructedString Константа Event.FRAME_CONSTRUCTED определяет значение свойства type объекта события frameConstructed.

Примечание. Это событие не имеет фазы захвата и фазы восходящей цепочки, поэтому отправляется непосредственно целевому элементу независимо от того, находится он в списке отображения или нет.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.targetЛюбой экземпляр DisplayObject, для которого зарегистрирован прослушиватель события frameConstructed.
flash.display.DisplayObject.frameConstructed
FULLSCREEN Константа Event.FULL_SCREEN определяет значение свойства type объекта события fullScreen.fullScreenString Константа Event.FULL_SCREEN определяет значение свойства type объекта события fullScreen.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.targetОбъект Stage.
flash.display.Stage.fullScreen
HTML_BOUNDS_CHANGE Константа Event.HTML_BOUNDS_CHANGE определяет значение свойства type объекта события htmlBoundsChange.htmlBoundsChangeString Константа Event.HTML_BOUNDS_CHANGE определяет значение свойства type объекта события htmlBoundsChange.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект HTMLLoader.targetОбъект HTMLLoader.
Событие htmlBoundsChange
HTML_DOM_INITIALIZE Константа Event.HTML_DOM_INITIALIZE определяет значение свойства type объекта события htmlDOMInitialize.htmlDOMInitializeString Константа Event.HTML_DOM_INITIALIZE определяет значение свойства type объекта события htmlDOMInitialize.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект HTMLLoader.targetОбъект HTMLLoader.
Событие htmlDOMInitialize
HTML_RENDER Константа Event.HTML_RENDER определяет значение свойства type объекта события htmlRender.htmlRenderString Константа Event.HTML_RENDER определяет значение свойства type объекта события htmlRender.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект HTMLLoader.targetОбъект HTMLLoader.
Событие htmlRender
ID3 Константа Event.ID3 определяет значение свойства type объекта события id3.id3String Константа Event.ID3 определяет значение свойства type объекта события id3.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.targetОбъект Sound, загружающий MP3, для которого уже стали доступными данные ID3. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент.
flash.media.Sound.id3
INIT Константа Event.INIT определяет значение свойства type объекта события init.initString Константа Event.INIT определяет значение свойства type объекта события init.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.targetОбъект LoaderInfo, связанный с загружаемым SWF-файлом.
flash.display.LoaderInfo.init
LOCATION_CHANGE Константа Event.LOCATION_CHANGE определяет значение свойства type объекта события locationChange.locationChangeString Константа Event.LOCATION_CHANGE определяет значение свойства type объекта события locationChange.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект HTMLLoader.targetОбъект HTMLLoader.
Событие locationChange
MOUSE_LEAVE Константа Event.MOUSE_LEAVE определяет значение свойства type объекта события mouseLeave.mouseLeaveString Константа Event.MOUSE_LEAVE определяет значение свойства type объекта события mouseLeave.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.targetОбъект Stage. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент.
flash.display.Stage.mouseLeaveflash.events.MouseEvent
NETWORK_CHANGE Константа Event.NETWORK_CHANGE определяет значение свойства type объекта события networkChange.networkChangeString Константа Event.NETWORK_CHANGE определяет значение свойства type объекта события networkChange.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.targetОбъект NativeApplication.
flash.desktop.NativeApplication.networkChange
OPEN Константа Event.OPEN определяет значение свойства type объекта события open.openString Константа Event.OPEN определяет значение свойства type объекта события open.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.targetСетевой объект, установивший подключение.
flash.display.LoaderInfo.openflash.media.Sound.openflash.net.FileReference.openflash.net.URLLoader.openflash.net.URLStream.open
PASTE Константа Event.PASTE определяет значение свойства type объекта события paste.pasteString Константа Event.PASTE определяет значение свойства type объекта события paste.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.targetЛюбой экземпляр InteractiveObject, для которого зарегистрирован прослушиватель события paste.

Примечание. Объектами TextField не отправляются события clear, copy, cut, paste или selectAll. Объекты TextField в контекстном меню всегда включают команды «Вырезать», «Скопировать», «Вставить» и «Выбрать все». Удалить эти команды из контекстного меню для объектов TextField невозможно. Для объектов TextField выбор этих команд (или сочетаний клавиш, эквивалентных элементу меню) не приводит к генерации событий clear, copy, cut, paste или selectAll. Однако другие классы, которые распространяют класс InteractiveObject, включая компоненты, построенные, используя текстовую Службу Flash (FTE), отправят эти события в ответ на операции пользователя, например, комбинации клавиш и контекстные меню.

flash.display.InteractiveObject.paste
PREPARING Константа Event.PREPARING определяет значение свойства type объекта события clear.preparingString Константа Event.PREPARING определяет значение свойства type объекта события preparing.

Примечание. Это событие не проходит фазу захвата и отправляется непосредственно целевому элементу независимо от того, находится он в списке отображения или нет.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsecancelablefalsecurrentTargetОбъект, отправивший это событие.targetОбъект, отправивший это событие.
flash.display. NativeMenu.preparingflash.display. NativeMenuItem.preparing
REMOVED_FROM_STAGE Константа Event.REMOVED_FROM_STAGE определяет значение свойства type объекта события removedFromStage.removedFromStageString Константа Event.REMOVED_FROM_STAGE определяет значение свойства type объекта события removedFromStage.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.targetЭкземпляр DisplayObject, удаляемый из списка отображения рабочей области напрямую или путем удаления поддерева, в котором он содержится. Если экземпляр DisplayObject добавляется напрямую, перед этим событием отправляется событие removed.
flash.display.DisplayObject.removedFromStageADDEDREMOVEDADDED_TO_STAGE
REMOVED Константа Event.REMOVED определяет значение свойства type объекта события removed.removedString Константа Event.REMOVED определяет значение свойства type объекта события removed.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblestruecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.targetЭкземпляр DisplayObject, удаляемый из списка отображения. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент.
flash.display.DisplayObject.removedADDEDADDED_TO_STAGEREMOVED_FROM_STAGE
RENDER Константа Event.RENDER определяет значение свойства type объекта события render.renderString Константа Event.RENDER определяет значение свойства type объекта события render.

Примечание. Это событие не имеет фазы захвата и фазы восходящей цепочки, поэтому отправляется непосредственно целевому элементу независимо от того, находится он в списке отображения или нет.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию отменить невозможно.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.targetЛюбой экземпляр DisplayObject, для которого зарегистрирован прослушиватель события render.
flash.display.DisplayObject.renderflash.display.Stage.invalidate()
RESIZE Константа Event.RESIZE определяет значение свойства type объекта события resize.resizeString Константа Event.RESIZE определяет значение свойства type объекта события resize.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.targetОбъект Stage.
flash.display.Stage.resize
SCROLL Константа Event.SCROLL определяет значение свойства type объекта события scroll.scrollString Константа Event.SCROLL определяет значение свойства type объекта события scroll.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.targetПрокручиваемый объект TextField. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент.
flash.text.TextField.scrollflash.html.HTMLLoader.scroll
SELECT_ALL Константа Event.SELECT_ALL определяет значение свойства type объекта события selectAll.selectAllString Константа Event.SELECT_ALL определяет значение свойства type объекта события selectAll.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.targetЛюбой экземпляр InteractiveObject, для которого зарегистрирован прослушиватель события selectAll.

Примечание. Объектами TextField не отправляются события clear, copy, cut, paste или selectAll. Объекты TextField в контекстном меню всегда включают команды «Вырезать», «Скопировать», «Вставить» и «Выбрать все». Удалить эти команды из контекстного меню для объектов TextField невозможно. Для объектов TextField выбор этих команд (или сочетаний клавиш, эквивалентных элементу меню) не приводит к генерации событий clear, copy, cut, paste или selectAll. Однако другие классы, которые распространяют класс InteractiveObject, включая компоненты, построенные, используя текстовую Службу Flash (FTE), отправят эти события в ответ на операции пользователя, например, комбинации клавиш и контекстные меню.

flash.display.InteractiveObject.selectAll
SELECT Константа Event.SELECT определяет значение свойства type объекта события select.selectString Константа Event.SELECT определяет значение свойства type объекта события select.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.targetОбъект, в котором выделен элемент.
flash.net.FileReference.selectflash.display.NativeMenu.selectflash.display.NativeMenuItem.select
SOUND_COMPLETE Константа Event.SOUND_COMPLETE определяет значение свойства type объекта события soundComplete.soundCompleteString Константа Event.SOUND_COMPLETE определяет значение свойства type объекта события soundComplete.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.targetОбъект SoundChannel, в котором завершилось воспроизведение звука.
flash.media.SoundChannel.soundComplete
STANDARD_ERROR_CLOSE Константа Event.STANDARD_ERROR_CLOSE определяет значение свойства type объекта события standardErrorClose.standardErrorCloseString Константа Event.STANDARD_ERROR_CLOSE определяет значение свойства type объекта события standardErrorClose.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.targetОбъект NativeProcess.
STANDARD_INPUT_CLOSE Константа Event.STANDARD_INPUT_CLOSE определяет значение свойства type объекта события standardInputClose.standardInputCloseString Константа Event.STANDARD_INPUT_CLOSE определяет значение свойства type объекта события standardInputClose.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.targetОбъект NativeProcess.
STANDARD_OUTPUT_CLOSE Константа Event.STANDARD_OUTPUT_CLOSE определяет значение свойства type объекта события standardOutputClose.standardOutputCloseString Константа Event.STANDARD_OUTPUT_CLOSE определяет значение свойства type объекта события standardOutputClose.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.targetОбъект NativeProcess.
TAB_CHILDREN_CHANGE Константа Event.TAB_CHILDREN_CHANGE определяет значение свойства type объекта события tabChildrenChange.tabChildrenChangeString Константа Event.TAB_CHILDREN_CHANGE определяет значение свойства type объекта события tabChildrenChange.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblestruecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.targetОбъект, для которого изменен флаг tabChildren. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент.
flash.display.InteractiveObject.tabChildrenChange
TAB_ENABLED_CHANGE Константа Event.TAB_ENABLED_CHANGE определяет значение свойства type объекта события tabEnabledChange.tabEnabledChangeString Константа Event.TAB_ENABLED_CHANGE определяет значение свойства type объекта события tabEnabledChange.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblestruecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.targetОбъект InteractiveObject, для которого изменен флаг tabEnabled. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент.
flash.display.InteractiveObject.tabEnabledChange
TAB_INDEX_CHANGE Константа Event.TAB_INDEX_CHANGE определяет значение свойства type объекта события tabIndexChange.tabIndexChangeString Константа Event.TAB_INDEX_CHANGE определяет значение свойства type объекта события tabIndexChange.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblestruecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.targetОбъект, для которого изменилось свойство tabIndex. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент.
flash.display.InteractiveObject.tabIndexChange
TEXT_INTERACTION_MODE_CHANGE Событие. Константа TEXT_INTERACTION_MODE_CHANGE определяет значение свойства текста объекта event режима взаимодействия.textInteractionModeChangeString Константа Event.TEXT_INTERACTION_MODE_CHANGE определяет значение свойства type объекта события interaction mode.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.targetОбъект TextField, свойства режима взаимодействия которого изменены. Например на Андроиде, можно изменить режим взаимодействия на ВЫДЕЛЕННЫЙ ФРАГМЕНТ через контекстное меню. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент.
flash.text.TextField.textInteractionModeChange
UNLOAD Константа Event.UNLOAD определяет значение свойства type объекта события unload.unloadString Константа Event.UNLOAD определяет значение свойства type объекта события unload.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.targetОбъект LoaderInfo, связанный с выгружаемым или заменяемым SWF-файлом.
flash.display.LoaderInfo.unload
USER_IDLE Константа Event.USER_IDLE определяет значение свойства type объекта события userIdle.userIdleString Константа Event.USER_IDLE определяет значение свойства type объекта события userIdle.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.targetОбъект NativeApplication.
flash.desktop.NativeApplication.userIdle
USER_PRESENT Константа Event.USER_PRESENT определяет значение свойства type объекта события userPresent.userPresentString Константа Event.USER_PRESENT определяет значение свойства type объекта события userPresent.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.targetОбъект NativeApplication.
flash.desktop.NativeApplication.userPresent
bubbles Определяет, является ли событие событием восходящей цепочки.Boolean Определяет, является ли событие событием восходящей цепочки. Если событие может переходить вверх по цепочке, то значение — true; иначе — false.

При возникновении события оно проходит три фазы потока событий: фазу захвата, которая идет сверху иерархии списка отображения до узла непосредственно перед целевым узлом; фазу цели, которая включает только целевой узел; и фазу восходящей цепочки, которая идет от узла, следующего за целевым, обратно вверх по иерархии списка отображения.

Некоторые события, например события activate и unload, не имеют фазы восходящей цепочки. Свойство bubbles имеет значение false для событий, не имеющих фазы восходящей цепочки.

cancelable Указывает, можно ли предотвратить поведение, связанное с событием.Boolean Указывает, можно ли предотвратить поведение, связанное с событием. Если событие может быть отменено, то значение — true; иначе — false. Event.preventDefault()currentTarget Объект, активно обрабатывающий объект Event с помощью прослушивателя событий.Object Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. Например, если пользователь нажимает кнопку «ОК», текущей целью может быть узел, содержащий эту кнопку, или один из его предшественников, для которого зарегистрирован прослушиватель данного события. eventPhase Текущая фаза в потоке событий.uint Текущая фаза в потоке событий. Это свойство может содержать следующие численные значения:
  • Фаза захвата (EventPhase.CAPTURING_PHASE).
  • Фаза цели (EventPhase.AT_TARGET).
  • Фаза восходящей цепочки (EventPhase.BUBBLING_PHASE).
target Целевой объект события.Object Целевой объект события. Это свойство содержит целевой узел. Например, если пользователь нажимает кнопку «ОК», целевым является узел списка отображения, содержащий эту кнопку. type Тип события.String Тип события. Данный тип является зависит от регистра.
TextEvent Объект передает объект TextEvent при вводе текста в текстовое поле или при выборе гиперссылки в текстовом поле с поддержкой HTML.Объекты событий TextEvent. flash.events:Event Объект передает объект TextEvent при вводе текста в текстовое поле или при выборе гиперссылки в текстовом поле с поддержкой HTML. Существует два типа событий текста: TextEvent.LINK и TextEvent.TEXT_INPUT. В следующем примере используется класс TextEventExample для создания текстовых полей и прослушивания различных событий текста. Для этого выполняются следующие задачи:
  1. Объявляются константы для двух URL-адресов, которые будут использоваться в дальнейшем.
  2. Объявляются две переменные типа TextField для использования в дальнейшем.
  3. Конструктор класса вызывает два следующих метода:
    • init() инициализирует объекты TextField и добавляет к ним прослушиватели событий;
    • draw() добавляет объекты TextField в список отображения и назначает им текст для отображения.
  4. Прослушиватели linkHandler() и textInputHandler() реагируют на соответствующие события. Метод linkHandler() открывает web-браузер, если это еще не сделано и открывает URL-адрес, по которому щелкнул пользователь. Метод textInputHandler() просто отображает информацию при каждом нажатии клавиши в соответствующем текстовом поле.

Примечание. В этом примере используется вымышленный домен, [yourDomain] необходимо заменить существующим доменом.

package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldType; import flash.text.TextFieldAutoSize; import flash.events.TextEvent; import flash.events.TextEvent; import flash.net.URLRequest; import flash.net.navigateToURL; public class TextEventExample extends Sprite { private const DOMAIN_1_URL:String = "http://www.[yourDomain].com"; private const DOMAIN_2_URL:String = "http://www.[yourDomain].com"; private var linkTxt:TextField; private var textInputTxt:TextField; public function TextEventExample() { init(); draw(); } private function init():void { linkTxt = new TextField(); linkTxt.addEventListener(TextEvent.LINK, linkHandler); linkTxt.height = 60; linkTxt.autoSize = TextFieldAutoSize.LEFT; linkTxt.multiline = true; textInputTxt = new TextField(); textInputTxt.addEventListener(TextEvent.TEXT_INPUT, textInputHandler); textInputTxt.type = TextFieldType.INPUT; textInputTxt.background = true; textInputTxt.border = true; textInputTxt.height = 20; } private function draw():void { addChild(linkTxt); linkTxt.htmlText += createLink(DOMAIN_1_URL, "Click to go to first domain"); linkTxt.htmlText += "<br />"; linkTxt.htmlText += createLink(DOMAIN_2_URL, "Click to go to second domain"); addChild(textInputTxt); textInputTxt.y = linkTxt.height; textInputTxt.text = "type here"; } private function createLink(url:String, text:String):String { var link:String = ""; link += "<font color='#0000FF'>"; link += "<u>"; link += "<b>"; link += "<a href='event:" + url + "'>" + text + "</a>"; link += "</b>"; link += "</u>"; link += "</font>"; return link; } private function linkHandler(e:TextEvent):void { var request:URLRequest = new URLRequest(e.text); navigateToURL(request); } private function textInputHandler(e:TextEvent):void { trace(">> ============================"); trace(">> e.text: " + e.text); trace(">> textInputTxt.text: " + textInputTxt.text); } } }
flash.text.TextFieldlinkflash.events:TextEvent:LINKflash.events:TextEvent В данном примере, когда пользователь щелкает гиперссылку и HTML-тексте, отправляется событие текста. В зависимости от ссылки пользователь направляется на заданный web-сайт в зависимости от операционной системы компьютера, либо рисуется круг с использованием выбранного пользователем радиуса.

Создается текстовое поле, а его содержимому задается вид строки в формате HTML с помощью свойства htmlText. Ссылки подчеркиваются, чтобы пользователю было проще их найти. (Adobe Flash Player изменяет указатель мыши только после того, как он наводится на ссылку.) Чтобы щелчок пользователя гарантированно вызвал метод ActionScript, URL-адрес ссылки начинается со строки event:, а для события TextEvent.LINK добавляется прослушиватель.

Метод linkHandler(), запускаемый после щелчка пользователя по ссылке, управляет всеми событиями ссылок для текстового поля. Первая инструкция if проверяет свойство text события, которое содержит остальную часть URL-адрес после строки event:. Если пользователь щелкнул ссылку для операционной системы, имя его текущей операционной системы, полученное из свойства системы Capabilities.os, используется для перехода на заданный web-сайт. В противном случае под текстовым полем рисуется круг с использованием радиуса выбранного размера, передаваемого свойством text. Каждый раз, когда пользователь нажимает на ссылку радиуса, нарисованный ранее круг удаляется и отображается новый красный круг с радиусом выбранного размера.

package { import flash.display.Sprite; import flash.events.TextEvent; import flash.errors.IOError; import flash.events.IOErrorEvent; import flash.system.Capabilities; import flash.net.navigateToURL; import flash.net.URLRequest; import flash.text.TextField; import flash.text.TextFieldAutoSize; import flash.display.Shape; import flash.display.Graphics; public class TextEvent_LINKExample extends Sprite { private var myCircle:Shape = new Shape(); public function TextEvent_LINKExample() { var myTextField:TextField = new TextField(); myTextField.autoSize = TextFieldAutoSize.LEFT; myTextField.multiline = true; myTextField.background = true; myTextField.htmlText = "Draw a circle with the radius of <u><a href=\"event:20\">20 pixels</a></u>.<br>" + "Draw a circle with the radius of <u><a href=\"event:50\">50 pixels</a></u>.<br><br>" + "<u><a href=\"event:os\">Learn about your operating system.</a></u><br>"; myTextField.addEventListener(TextEvent.LINK, linkHandler); this.addChild(myTextField); this.addChild(myCircle); } private function linkHandler(e:TextEvent):void { var osString:String = Capabilities.os; if(e.text == "os") { if (osString.search(/Windows/) != -1 ){ navigateToURL(new URLRequest("http://www.microsoft.com/"), "_self"); }else if (osString.search(/Mac/) != -1 ) { navigateToURL(new URLRequest("http://www.apple.com/"), "_self"); } else if (osString.search(/linux/i)!= -1) { navigateToURL(new URLRequest("http://www.tldp.org/"), "_self"); } } else { myCircle.graphics.clear(); myCircle.graphics.beginFill(0xFF0000); myCircle.graphics.drawCircle(100, 150, Number(e.text)); myCircle.graphics.endFill(); } } } }
textflash.text.TextField.link
textInputflash.events:TextEvent:TEXT_INPUTflash.events:TextEvent В следующем примере рассматривается руководство по созданию особой комбинации ключа (напоминающей пароль). Эта комбинация состоит из семи буквенно-числовых символов, в которой второй и пятый символы — это цифры.

Создается три текстовых поля для предварительных инструкций, пользовательского ввода и предупреждения (ошибки) Добавляется прослушиватель событий, который реагирует на ввод текста пользователем, запуская метод textInputHandler(). Каждый раз, когда пользователь вводит текст, отправляется событие TextEvent.TEXT_INPUT.

Примечание. События текста отправляются, когда пользователь вводит символы, и не отправляются в ответ на любой ввод с клавиатуры, например на нажатие клавиши «Назад». Чтобы фиксировать все события клавиатуры, необходимо использовать прослушиватель событий KeyboardEvent.)

Метод textInputHandler() контролирует пользовательский ввод и управляет им. Метод preventDefault() используется для того, чтобы проигрыватель Adobe Flash Player не отображал текст в поле ввода текста сразу. За обновление поля отвечает приложение. Чтобы отменить удаление или изменение уже введенных пользователем символов (строка result, содержимое поля ввода текста переназначается строке result, когда пользователь вводит новые символы. Также для обеспечения согласованности функций, метод setSelection() помещает точку вставки (знак «^») после последнего выделенного символа в текстовом поле.

Первая инструкция if в методе textInputHandler() проверяет ввод для второй и пятой позиции символов в комбинации ключа, в которых должны быть цифры. Если пользователь ввел правильные символы, вызывается метод updateCombination(), и в строку комбинации ключа (result) добавляется ввод пользователя. Метод updateCombination() также помещает точку вставки после выделенного символа.. После ввода седьмого символа последняя инструкция if метода textInputHandler() изменяет тип текстового поля inputTextField с INPUT на DYNAMIC: это значит, что пользователь больше не может вводить и изменять символы.

package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldType; import flash.text.TextFieldAutoSize; import flash.events.TextEvent; public class TextEvent_TEXT_INPUTExample extends Sprite { private var instructionTextField:TextField = new TextField(); private var inputTextField:TextField = new TextField(); private var warningTextField:TextField = new TextField(); private var result:String = ""; public function TextEvent_TEXT_INPUTExample() { instructionTextField.x = 10; instructionTextField.y = 10; instructionTextField.background = true; instructionTextField.autoSize = TextFieldAutoSize.LEFT; instructionTextField.text = "Please enter a value in the format A#AA#AA,\n" + "where 'A' represents a letter and '#' represents a number.\n" + "(Note that once you input a character you can't change it.)" ; inputTextField.x = 10; inputTextField.y = 70; inputTextField.height = 20; inputTextField.width = 75; inputTextField.background = true; inputTextField.border = true; inputTextField.type = TextFieldType.INPUT; warningTextField.x = 10; warningTextField.y = 100; warningTextField.autoSize = TextFieldAutoSize.LEFT; inputTextField.addEventListener(TextEvent.TEXT_INPUT, textInputHandler); this.addChild(instructionTextField); this.addChild(inputTextField); this.addChild(warningTextField); } private function textInputHandler(event:TextEvent):void { var charExp:RegExp = /[a-zA-z]/; var numExp:RegExp = /[0-9]/; event.preventDefault(); inputTextField.text = result; inputTextField.setSelection(result.length + 1, result.length + 1); if (inputTextField.text.length == 1 || inputTextField.text.length == 4) { if(numExp.test(event.text) == true) { updateCombination(event.text); } else { warningTextField.text = "You need a single digit number."; } }else { if(charExp.test(event.text) == true) { updateCombination(event.text); } else { warningTextField.text = "You need an alphabet character."; } } if(inputTextField.text.length == 7) { inputTextField.type = TextFieldType.DYNAMIC; instructionTextField.text = "CONGRATULATIONS. You've done."; } } private function updateCombination(s:String):void { warningTextField.text = ""; result += s; inputTextField.text = result; inputTextField.setSelection(result.length + 1, result.length + 1); } } }
flash.text.TextField.textInputtext
TextEvent Создает объект Event, содержащий данные о событиях text.typeString Тип события. Прослушиватели событий могут получать эту информацию через унаследованное свойство type. Возможные значения: TextEvent.LINK и TextEvent.TEXT_INPUT. bubblesBooleanfalseОпределяет, участвует ли объект Event в фазе восходящей цепочки потока событий. Прослушиватели событий могут получать эту информацию через унаследованное свойство bubbles. cancelableBooleanfalseОпределяет, можно ли отменить объект Event. Прослушиватели событий могут получать эту информацию через унаследованное свойство cancelable. textStringОдин или несколько символов текста, введенные пользователем. Прослушиватели событий могут получать эту информацию через свойство text. Конструктор для объектов TextEvent. Создает объект Event, содержащий данные о событиях text. Объекты Event передаются прослушивателям событий в качестве параметров. flash.text.TextFieldclone Создает копию объекта TextEvent и задает значение каждого свойства, совпадающее с оригиналом.Новый объект TextEvent, значения свойств которого соответствуют значениям оригинала. flash.events:Event Создает копию объекта TextEvent и задает значение каждого свойства, совпадающее с оригиналом. toString Возвращает строку, содержащую все свойства объекта TextEvent.Строка, содержащая все свойства объекта TextEvent. String Возвращает строку, содержащую все свойства объекта TextEvent. Строка имеет следующий формат:

[TextEvent type=value bubbles=value cancelable=value text=value]

LINK Задает значение свойства type для объекта события link.linkString Задает значение свойства type для объекта события link.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblestruecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.targetТекстовое поле, содержащее гиперссылку, по которой щелкнул пользователь. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент.textОставшаяся часть URL-адреса после event:
В данном примере, когда пользователь щелкает гиперссылку и HTML-тексте, отправляется событие текста. В зависимости от ссылки пользователь направляется на заданный web-сайт в зависимости от операционной системы компьютера, либо рисуется круг с использованием выбранного пользователем радиуса.

Создается текстовое поле, а его содержимому задается вид строки в формате HTML с помощью свойства htmlText. Ссылки подчеркиваются, чтобы пользователю было проще их найти. (Adobe Flash Player изменяет указатель мыши только после того, как он наводится на ссылку.) Чтобы щелчок пользователя гарантированно вызвал метод ActionScript, URL-адрес ссылки начинается со строки event:, а для события TextEvent.LINK добавляется прослушиватель.

Метод linkHandler(), запускаемый после щелчка пользователя по ссылке, управляет всеми событиями ссылок для текстового поля. Первая инструкция if проверяет свойство text события, которое содержит остальную часть URL-адрес после строки event:. Если пользователь щелкнул ссылку для операционной системы, имя его текущей операционной системы, полученное из свойства системы Capabilities.os, используется для перехода на заданный web-сайт. В противном случае под текстовым полем рисуется круг с использованием радиуса выбранного размера, передаваемого свойством text. Каждый раз, когда пользователь нажимает на ссылку радиуса, нарисованный ранее круг удаляется и отображается новый красный круг с радиусом выбранного размера.

package { import flash.display.Sprite; import flash.events.TextEvent; import flash.errors.IOError; import flash.events.IOErrorEvent; import flash.system.Capabilities; import flash.net.navigateToURL; import flash.net.URLRequest; import flash.text.TextField; import flash.text.TextFieldAutoSize; import flash.display.Shape; import flash.display.Graphics; public class TextEvent_LINKExample extends Sprite { private var myCircle:Shape = new Shape(); public function TextEvent_LINKExample() { var myTextField:TextField = new TextField(); myTextField.autoSize = TextFieldAutoSize.LEFT; myTextField.multiline = true; myTextField.background = true; myTextField.htmlText = "Draw a circle with the radius of <u><a href=\"event:20\">20 pixels</a></u>.<br>" + "Draw a circle with the radius of <u><a href=\"event:50\">50 pixels</a></u>.<br><br>" + "<u><a href=\"event:os\">Learn about your operating system.</a></u><br>"; myTextField.addEventListener(TextEvent.LINK, linkHandler); this.addChild(myTextField); this.addChild(myCircle); } private function linkHandler(e:TextEvent):void { var osString:String = Capabilities.os; if(e.text == "os") { if (osString.search(/Windows/) != -1 ){ navigateToURL(new URLRequest("http://www.microsoft.com/"), "_self"); }else if (osString.search(/Mac/) != -1 ) { navigateToURL(new URLRequest("http://www.apple.com/"), "_self"); } else if (osString.search(/linux/i)!= -1) { navigateToURL(new URLRequest("http://www.tldp.org/"), "_self"); } } else { myCircle.graphics.clear(); myCircle.graphics.beginFill(0xFF0000); myCircle.graphics.drawCircle(100, 150, Number(e.text)); myCircle.graphics.endFill(); } } } }
textflash.text.TextField.link
TEXT_INPUT Задает значение свойства type для объекта события textInput.textInputString Задает значение свойства type для объекта события textInput.

Примечание. Это событие не отправляется для клавиш Delete или Backspace.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblestruecancelabletrue; вызовите метод preventDefault() для отмены поведения по умолчанию.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.targetТекстовое поле, в которое вводятся символы. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент.textСимвол или последовательность символов, введенных пользователем.
В следующем примере рассматривается руководство по созданию особой комбинации ключа (напоминающей пароль). Эта комбинация состоит из семи буквенно-числовых символов, в которой второй и пятый символы — это цифры.

Создается три текстовых поля для предварительных инструкций, пользовательского ввода и предупреждения (ошибки) Добавляется прослушиватель событий, который реагирует на ввод текста пользователем, запуская метод textInputHandler(). Каждый раз, когда пользователь вводит текст, отправляется событие TextEvent.TEXT_INPUT.

Примечание. События текста отправляются, когда пользователь вводит символы, и не отправляются в ответ на любой ввод с клавиатуры, например на нажатие клавиши «Назад». Чтобы фиксировать все события клавиатуры, необходимо использовать прослушиватель событий KeyboardEvent.)

Метод textInputHandler() контролирует пользовательский ввод и управляет им. Метод preventDefault() используется для того, чтобы проигрыватель Adobe Flash Player не отображал текст в поле ввода текста сразу. За обновление поля отвечает приложение. Чтобы отменить удаление или изменение уже введенных пользователем символов (строка result, содержимое поля ввода текста переназначается строке result, когда пользователь вводит новые символы. Также для обеспечения согласованности функций, метод setSelection() помещает точку вставки (знак «^») после последнего выделенного символа в текстовом поле.

Первая инструкция if в методе textInputHandler() проверяет ввод для второй и пятой позиции символов в комбинации ключа, в которых должны быть цифры. Если пользователь ввел правильные символы, вызывается метод updateCombination(), и в строку комбинации ключа (result) добавляется ввод пользователя. Метод updateCombination() также помещает точку вставки после выделенного символа.. После ввода седьмого символа последняя инструкция if метода textInputHandler() изменяет тип текстового поля inputTextField с INPUT на DYNAMIC: это значит, что пользователь больше не может вводить и изменять символы.

package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldType; import flash.text.TextFieldAutoSize; import flash.events.TextEvent; public class TextEvent_TEXT_INPUTExample extends Sprite { private var instructionTextField:TextField = new TextField(); private var inputTextField:TextField = new TextField(); private var warningTextField:TextField = new TextField(); private var result:String = ""; public function TextEvent_TEXT_INPUTExample() { instructionTextField.x = 10; instructionTextField.y = 10; instructionTextField.background = true; instructionTextField.autoSize = TextFieldAutoSize.LEFT; instructionTextField.text = "Please enter a value in the format A#AA#AA,\n" + "where 'A' represents a letter and '#' represents a number.\n" + "(Note that once you input a character you can't change it.)" ; inputTextField.x = 10; inputTextField.y = 70; inputTextField.height = 20; inputTextField.width = 75; inputTextField.background = true; inputTextField.border = true; inputTextField.type = TextFieldType.INPUT; warningTextField.x = 10; warningTextField.y = 100; warningTextField.autoSize = TextFieldAutoSize.LEFT; inputTextField.addEventListener(TextEvent.TEXT_INPUT, textInputHandler); this.addChild(instructionTextField); this.addChild(inputTextField); this.addChild(warningTextField); } private function textInputHandler(event:TextEvent):void { var charExp:RegExp = /[a-zA-z]/; var numExp:RegExp = /[0-9]/; event.preventDefault(); inputTextField.text = result; inputTextField.setSelection(result.length + 1, result.length + 1); if (inputTextField.text.length == 1 || inputTextField.text.length == 4) { if(numExp.test(event.text) == true) { updateCombination(event.text); } else { warningTextField.text = "You need a single digit number."; } }else { if(charExp.test(event.text) == true) { updateCombination(event.text); } else { warningTextField.text = "You need an alphabet character."; } } if(inputTextField.text.length == 7) { inputTextField.type = TextFieldType.DYNAMIC; instructionTextField.text = "CONGRATULATIONS. You've done."; } } private function updateCombination(s:String):void { warningTextField.text = ""; result += s; inputTextField.text = result; inputTextField.setSelection(result.length + 1, result.length + 1); } } }
flash.text.TextField.textInputtext
text Для события textInput — введенный пользователем знак или последовательность знаков.String Для события textInput — введенный пользователем знак или последовательность знаков. Для события link — текст атрибута event атрибута href тега <a>. На примере следующего кода показывается отправка события link, когда пользователь щелкает гипертекстовую ссылку. import flash.text.TextField; import flash.events.TextEvent; var tf:TextField = new TextField(); tf.htmlText = "<a href='event:myEvent'>Click Me.</a>"; tf.addEventListener("link", clickHandler); addChild(tf); function clickHandler(e:TextEvent):void { trace(e.type); // link trace(e.text); // myEvent }
SampleDataEvent Отправляется, когда объект Sound запрашивает новые аудиоданные или когда объект Microphone может предоставить новые аудиоданные.flash.events:Event Отправляется, когда объект Sound запрашивает новые аудиоданные или когда объект Microphone может предоставить новые аудиоданные.

Это событие может применяться двумя способами:

  • для предоставления динамически создаваемых аудиоданных объекту Sound;
  • для получения данных от объекта Microphone.

Динамическое создание аудио с помощью объекта Sound. Используйте событие sampleData для воспроизведения динамически создаваемого аудио. В данной среде объект Sound на самом деле не содержит звуковых данных. Вместо этого он выполняет функцию сокета для потока звуковых данных, направляемых ему при помощи функции, назначенной в качестве обработчика события sampleData.

В функции используется метод ByteArray.writeFloat() для записи в свойство data события, которое содержит отобранные для воспроизведения данные.

Если объект Sound не загрузил файл MP3, то при вызове его метода play() объект начинает отправлять события sampleData, запрашивая образцы звука. Объект Sound продолжает отправлять события в процессе воспроизведения звука, пока не прекращается передача данных или пока не будет вызван метод stop() объекта SoundChannel.

Время ожидания события варьируется от платформы к платформе и может измениться в будущих версиях Flash Player или AIR. Не следует привязывать программу к определенному времени ожидания. Вместо этого его следует вычислять по формуле ((SampleDataEvent.position/44.1) - SoundChannelObject.position).

Предоставьте от 2048 до 8192 образцов для свойства data объекта SampleDataEvent. Для лучшей производительности укажите как можно больше образцов. Чем меньше образцов вы укажете, тем больше вероятность возникновения звуковых помех во время воспроизведения. Однако этот принцип действует по-разному на разных платформах, и помехи могут возникнуть в различных ситуациях, например при изменении размера браузера. Вы можете написать код, который будет работать на одной платформе с 2048 образцами, но это не значит, что этот код будет работать так же хорошо на другой платформе. Если вам требуется как можно меньший период ожидания, предоставьте пользователям возможность выбирать объем данных.

Если указать менее 2048 образцов, объект Sound воспроизведет оставшиеся образцы и остановит звук, как будто был достигнут конец аудиофайла, создав событие complete

С помощью метода extract() объекта Sound можно извлечь его аудиоданные, которые затем можно записать в динамический поток для воспроизведения.

При использовании прослушивателя события sampleData с объектом Sound единственными доступными методами класса Sound являются extract() и play(). Вызов любых других методов или свойств приводит к возникновению исключения «недопустимый вызов». Все методы и свойства объекта SoundChannel остаются доступными.

Захват аудио из объекта Microphone Используйте событие sampleData для захвата аудиоданных с микрофона. При добавлении прослушивателя для события sampleData объект Microphone отправляет это событие, когда становятся доступны образцы звука.

В функции обработчика событий следует использовать метод ByteArray.readFloat() для чтения свойства data, содержащего данные образца. Событие будет содержать несколько образцов, поэтому следует использовать цикл while для чтения доступных данных.

var soundBytes:ByteArray = new ByteArray(); while(event.data.bytesAvailable) { var sample:Number = event.data.readFloat(); soundBytes.writeFloat(sample); }
Следующий пример воспроизводит простую гармоническую волну. var mySound:Sound = new Sound(); function sineWaveGenerator(event:SampleDataEvent):void { for ( var c:int=0; c<8192; c++ ) { event.data.writeFloat(Math.sin((Number(c+event.position)/Math.PI/2))*0.25); event.data.writeFloat(Math.sin((Number(c+event.position)/Math.PI/2))*0.25); } } mySound.addEventListener(SampleDataEvent.SAMPLE_DATA,sineWaveGenerator); mySound.play();
flash.media.SoundsampleDataflash.events:SampleDataEvent:SAMPLE_DATAflash.events:SampleDataEventflash.media.Sound.sampleDataflash.events.SampleDataEventSampleDataEvent Создает объект события, содержащий данные о событиях звуковых данных.typeString Тип события. Этим значением является: Event.SAMPLE_DATA. bubblesBooleanfalse Определяет, участвует ли объект Event в фазе восходящей цепочки потока событий. cancelableBooleanfalseОпределяет, можно ли отменить объект Event. thepositionNumber0Положение данных в аудиопотоке. thedataflash.utils:ByteArraynullМассив байт данных. Создает объект события, содержащий данные о событиях звуковых данных. Объекты Event передаются прослушивателям событий в качестве параметров. clone Создает копию объекта SampleDataEvent и задает значение каждого свойства, совпадающее с оригиналом.Новый объект SampleDataEvent, значения свойств которого соответствуют значениям оригинала. flash.events:Event Создает копию объекта SampleDataEvent и задает значение каждого свойства, совпадающее с оригиналом. toString Возвращает строку, содержащую все свойства объекта SampleDataEvent.Строка, содержащая все свойства объекта SampleDataEvent. String Возвращает строку, содержащую все свойства объекта SampleDataEvent. Строка имеет следующий формат:

[SampleDataEvent type=value bubbles=value cancelable=value theposition=value thedata=value]

SAMPLE_DATA Задает значение свойства type для объекта события SampleDataEvent.sampleDataString Задает значение свойства type для объекта события SampleDataEvent.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.positionТочка, из которой поступают аудиоданные.
flash.media.Sound.sampleDataflash.events.SampleDataEvent
data Данные в аудиопотоке.flash.utils:ByteArray Данные в аудиопотоке. position Положение данных в аудиопотоке.Number Положение данных в аудиопотоке.
HTTPStatusEvent Приложение отправляет объекты HTTPStatusEvent, когда сетевой запрос возвращает код состояния HTTP.flash.events:Event Приложение отправляет объекты HTTPStatusEvent, когда сетевой запрос возвращает код состояния HTTP.

Объекты HTTPStatusEvent всегда отправляются перед событиями ошибок или выполнения. Объект HTTPStatusEvent не обязательно указывает на наличие ошибок; он просто отражает код состояния HTTP (если он есть), передаваемый сетевым стеком. Некоторые среды выполнения Flash Player не могут отслеживать коды состояния HTTP; в таких случаях всегда выдается код состояния 0.

В Flash Player существует только один тип события HTTPStatus: httpStatus. В среде выполнения AIR есть возможность зарегистрировать FileReference, URLLoader или URLStream в качестве прослушивателей httpResponseStatus, куда входят свойства responseURL и responseHeaders. В событии httpStatus данные свойства имеют значение undefined.

В следующем примере предпринимается попытка загрузить несуществующий файл из корневого web-каталога http://www. [yourDomain].com, в результате чего должно быть передано событие httpStatusHandler с кодом состояния 404, указывающим на то, что файл не найден. Событие httpStatusHandler обрабатывается методом httpStatusHandler(), который просто печатает две строки сведений о событии.

Примечания.

  1. SWF-файл необходимо компилировать с параметром «Безопасность локального воспроизведения» в значении «Доступ только к сети», чтобы генерировать событие securityError в этом примере.
  2. Для реализации примера нужен сервер в домене http://www. [yourDomain].com, прослушивающий порт 80, иначе событие httpStatusHandler будет отправлено с кодом состояния 0 вместо 404.
  3. Не должно быть файла с именем MissingFile.html в корневом web-каталоге домена http://www. [yourDomain].com, иначе не будет отправлено требуемое событие httpStatusHandler.

package { import flash.display.Sprite; import flash.net.URLLoader; import flash.net.URLRequest; import flash.events.HTTPStatusEvent; public class HTTPStatusEventExample extends Sprite { public function HTTPStatusEventExample() { var loader:URLLoader = new URLLoader(); loader.addEventListener(HTTPStatusEvent.HTTP_STATUS, httpStatusHandler); var request:URLRequest = new URLRequest("http://www.[yourDomain].com/MissingFile.html"); loader.load(request); } private function httpStatusHandler(event:HTTPStatusEvent):void { trace("httpStatusHandler: " + event); trace("status: " + event.status); } } }
httpResponseStatusflash.events:HTTPStatusEvent:HTTP_RESPONSE_STATUSflash.events:HTTPStatusEventflash.net.URLStream.httpResponseStatusflash.net.FileReference.httpResponseStatushttpStatusflash.events:HTTPStatusEvent:HTTP_STATUSflash.events:HTTPStatusEventflash.display.LoaderInfo.httpStatusflash.net.FileReference.httpStatusflash.net.URLLoader.httpStatusflash.net.URLStream.httpStatusHTTPStatusEvent Создает объект Event, содержащий данные о событиях состояния HTTP.typeString Тип события. Прослушиватели событий могут получать эту информацию через унаследованное свойство type. Существует только один тип события HTTPStatus: HTTPStatusEvent.HTTP_STATUS. bubblesBooleanfalseОпределяет, участвует ли объект Event в фазе восходящей цепочки потока событий. Прослушиватели событий могут получать эту информацию через унаследованное свойство bubbles. cancelableBooleanfalseОпределяет, можно ли отменить объект Event. Прослушиватели событий могут получать эту информацию через унаследованное свойство cancelable. statusint0Численный код состояния. Прослушиватели событий могут получать эту информацию через свойство status. Конструктор для объектов HTTPStatusEvent. Создает объект Event, содержащий данные о событиях состояния HTTP. Объекты Event передаются прослушивателям событий в качестве параметров. HTTP_STATUSclone Создает копию объекта HTTPStatusEvent и задает значение каждого свойства, совпадающее с оригиналом.Новый объект HTTPStatusEvent, значения свойств которого соответствуют значениям оригинала. flash.events:Event Создает копию объекта HTTPStatusEvent и задает значение каждого свойства, совпадающее с оригиналом. toString Возвращает строку, содержащую все свойства объекта HTTPStatusEvent.Строка, содержащая все свойства объекта HTTPStatusEvent. String Возвращает строку, содержащую все свойства объекта HTTPStatusEvent. Строка имеет следующий формат:

[HTTPStatusEvent type=value bubbles=value cancelable=value status=value]

HTTP_RESPONSE_STATUS В отличии от события httpStatus, событие httpResponseStatus доставляется до получения данных ответа.httpResponseStatusString В отличии от события httpStatus, событие httpResponseStatus доставляется до получения данных ответа. Таким образом, в событие httpResponseStatus входят значения свойств responseHeaders и responseURL (которые для события httpStatus имеют значение undefined.) Обратите внимание на то, что httpResponseStatus (при наличии такового) будет отправляться до (как дополнение) любого события complete или error.

Константа HTTPStatusEvent.HTTP_RESPONSE_STATUS определяет значение свойства type объекта события httpResponseStatus.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.responseURLURL-адрес, с которого был получен ответ.responseHeadersЗаголовки ответа, возвращаемые в ответе, представляют собой массив объектов URLRequestHeader.statusКод состояния HTTP, возвращенный сервером.targetСетевой объект, получающий код состояния НТТР.
flash.net.URLStream.httpResponseStatusflash.net.FileReference.httpResponseStatus
HTTP_STATUS Константа HTTPStatusEvent.HTTP_STATUS определяет значение свойства type объекта события httpStatus.httpStatusString Константа HTTPStatusEvent.HTTP_STATUS определяет значение свойства type объекта события httpStatus.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.statusКод состояния HTTP, возвращенный сервером.targetСетевой объект, получающий код состояния НТТР.
flash.display.LoaderInfo.httpStatusflash.net.FileReference.httpStatusflash.net.URLLoader.httpStatusflash.net.URLStream.httpStatus
responseHeaders Заголовки ответа, возвращаемые в ответе, представляют собой массив объектов URLRequestHeader.Array Заголовки ответа, возвращаемые в ответе, представляют собой массив объектов URLRequestHeader. flash.net.URLRequestHeaderresponseURL URL-адрес, с которого был получен ответ.String URL-адрес, с которого был получен ответ. При наличии перенаправлений данный адрес будет отличаться от URL-адреса, на который отправлен запрос. status Код состояния HTTP, возвращенный сервером.int Код состояния HTTP, возвращенный сервером. Например, значение 404 указывает на то, что сервер не нашел соответствия для запрашиваемого URI. Коды состояния HTTP можно найти в разделах 10.4 и 10.5 спецификации HTTP по адресу http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html.

Если Flash Player или AIR не удается получить код состояния от сервера или не удается установить связь с сервером, значение по умолчанию 0 передается в ваш код. Значение 0 может быть создано в любом проигрывателе (например, при запросе неправильного URL-адреса), и оно всегда создается подключаемым программным модулем Flash Player при его выполнении в следующих браузерах, которые не передают код состояния HTTP проигрывателю: Netscape, Mozilla, Safari, Opera и Internet Explorer для ОС Macintosh.

FileListEvent Объект File отправляет событие FileListEvent, когда вызов его метода getDirectoryListingAsync() успешно перечисляет набор файлов и каталогов или когда пользователь выделяет файлы после вызова метода browseForOpenMultiple().Объект File отправляет объект FileListEvent после успешных вызовов метода getDirectoryListingAsync() или browseForOpenMultiple(). flash.events:Event Объект File отправляет событие FileListEvent, когда вызов его метода getDirectoryListingAsync() успешно перечисляет набор файлов и каталогов или когда пользователь выделяет файлы после вызова метода browseForOpenMultiple(). File.getDirectoryListingAsync()directoryListingflash.events:FileListEvent:DIRECTORY_LISTINGflash.events:FileListEventselectMultipleflash.events:FileListEvent:SELECT_MULTIPLEflash.events:FileListEventFileListEvent Функция конструктора для объекта FileListEvent.typeStringТип события. bubblesBooleanfalseОпределяет, имеет ли объект Event фазу восходящей цепочки (false для объекта FileListEvent). cancelableBooleanfalseОпределяет, можно ли отменить объект Event (false для объекта FileListEvent). filesArraynullМассив объектов File. Функция конструктора для объекта FileListEvent.

Во время выполнения этот класс используется для создания объектов FileListEvent. Этот конструктор не используется в коде напрямую.

DIRECTORY_LISTING Константа FileListEvent.DIRECTORY_LISTING определяет значение свойства type объекта события directoryListing.directoryListingString Константа FileListEvent.DIRECTORY_LISTING определяет значение свойства type объекта события directoryListing.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.filesМассив объектов File, представляющий найденные файлы и каталоги.targetОбъект FileListEvent.
SELECT_MULTIPLE Константа FileListEvent.SELECT_MULTIPLE определяет значение свойства type объекта события selectMultiple.selectMultipleString Константа FileListEvent.SELECT_MULTIPLE определяет значение свойства type объекта события selectMultiple. СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.filesМассив объектов File, представляющий выделенные файлы.targetОбъект FileListEvent. files Массив объектов File, представляющий найденные или выделенные файлы и каталоги.Array Массив объектов File, представляющий найденные или выделенные файлы и каталоги.

Для метода File.getDirectoryListingAsync() это список файлов и каталогов, найденных в корне каталога, представленного объектом File, который вызвал этот метод. Для метода File.browseForOpenMultiple() это список файлов, выделенных пользователем.

NativeWindowBoundsEvent Объект NativeWindow отправляет событие NativeWindowBoundsEvent при изменении размера или местоположения окна.Объекты событий NativeWindow, изменяющие размер и/или местоположение окна. flash.events:Event Объект NativeWindow отправляет событие NativeWindowBoundsEvent при изменении размера или местоположения окна.

Существует четыре типа событий:

  • NativeWindowBoundsEvent.MOVING
  • NativeWindowBoundsEvent.MOVE
  • NativeWindowBoundsEvent.RESIZING
  • NativeWindowBoundsEvent.RESIZE
flash.events.NativeWindowBoundsEvent.MOVINGflash.events.NativeWindowBoundsEvent.MOVEflash.events.NativeWindowBoundsEvent.RESIZINGflash.events.NativeWindowBoundsEvent.RESIZEmoveflash.events:NativeWindowBoundsEvent:MOVEflash.events:NativeWindowBoundsEventОтправляется объектом NativeWindow после его перемещения. flash.display.NativeWindowmovingflash.events:NativeWindowBoundsEvent:MOVINGflash.events:NativeWindowBoundsEventОтправляется объектом NativeWindow перед его перемещением. flash.display.NativeWindowresizeflash.events:NativeWindowBoundsEvent:RESIZEflash.events:NativeWindowBoundsEventОтправляется объектом NativeWindow после изменения его размера. flash.display.NativeWindowresizingflash.events:NativeWindowBoundsEvent:RESIZINGflash.events:NativeWindowBoundsEventОтправляется объектом NativeWindow перед изменением его размера. flash.display.NativeWindowNativeWindowBoundsEvent Создает объект Event со специфической информацией, имеющей отношение к событиям границ окна.typeString Тип события. Возможные значения:
  • NativeWindowBoundsEvent.MOVING
  • NativeWindowBoundsEvent.MOVE
  • NativeWindowBoundsEvent.RESIZING
  • NativeWindowBoundsEvent.RESIZE
bubblesBooleanfalse Указывает, участвует ли объект Event в фазе восходящей цепочки потока событий. cancelableBooleanfalseУказывает, можно ли отменить объект Event. beforeBoundsflash.geom:RectanglenullУказывает границы до самого последнего или ожидаемого изменения. afterBoundsflash.geom:RectanglenullУказывает границы после самого последнего или ожидаемого изменения.
Создает объект Event со специфической информацией, имеющей отношение к событиям границ окна. Объекты Event передаются прослушивателям событий в качестве параметров.
clone Создает копию объекта NativeWindowBoundsEvent и задает значение каждого свойства, совпадающее с оригиналом.Новый объект NativeWindowBoundsEvent, значения свойств которого соответствуют значениям оригинала. flash.events:Event Создает копию объекта NativeWindowBoundsEvent и задает значение каждого свойства, совпадающее с оригиналом. toString Возвращает строку, содержащую все свойства объекта NativeWindowBoundsEvent.Строка, содержащая все свойства объекта NativeWindowBoundsEvent. String Возвращает строку, содержащую все свойства объекта NativeWindowBoundsEvent. Строка имеет следующий формат:

[NativeWindowBoundsEvent type=value bubbles=value cancelable=value previousDisplayState=value currentDisplayState=value]

MOVE Задает значение свойства type для объекта события move.moveStringОтправляется объектом NativeWindow после его перемещения. Задает значение свойства type для объекта события move.

Это событие имеет следующие свойства:

СвойстваЗначенияafterBoundsНовые границы окна.beforeBoundsСтарые границы окна.targetОбъект NativeWindow, который только что изменил состояние. bubblesНет.currentTargetУказывает объект, активно обрабатывающий объект Event с помощью прослушивателя событий.cancelablefalse; нет поведения по умолчанию для отмены.
flash.display.NativeWindow
MOVING Задает значение свойства type для объекта события moving.movingStringОтправляется объектом NativeWindow перед его перемещением. Задает значение свойства type для объекта события moving.

Это событие имеет следующие свойства:

СвойстваЗначенияafterBoundsГраницы окна после ожидаемого изменения.beforeBoundsГраницы окна до ожидаемого изменения.bubblesНет.cancelabletrue; отмена события предотвращает перемещение окна.currentTargetУказывает объект, активно обрабатывающий объект Event с помощью прослушивателя событий.targetОбъект NativeWindow, который только что изменил состояние.

Примечание. В ОС Linux для этого события не поддерживается метод preventDefault().

flash.display.NativeWindow
RESIZE Задает значение свойства type для объекта события Resize.resizeStringОтправляется объектом NativeWindow после изменения его размера. Задает значение свойства type для объекта события Resize.

Это событие имеет следующие свойства:

СвойстваЗначенияafterBoundsНовые границы окна.beforeBoundsСтарые границы окна.targetОбъект NativeWindow, который только что изменил состояние. bubblesНет.currentTargetУказывает объект, активно обрабатывающий объект Event с помощью прослушивателя событий.cancelablefalse; нет поведения по умолчанию для отмены.
flash.display.NativeWindow
RESIZING Задает значение свойства type для объекта события resizing.resizingStringОтправляется объектом NativeWindow перед изменением его размера. Задает значение свойства type для объекта события resizing.

Это событие имеет следующие свойства:

СвойстваЗначенияafterBoundsГраницы окна после ожидаемого изменения.beforeBoundsГраницы окна до ожидаемого изменения.targetОбъект NativeWindow, который только что изменил состояние. bubblesНет.currentTargetУказывает объект, активно обрабатывающий объект Event с помощью прослушивателя событий.cancelabletrue; отмена события предотвращает перемещение окна.

Примечание. В ОС Linux для этого события не поддерживается метод preventDefault().

flash.display.NativeWindow
afterBounds Границы окна после изменения.flash.geom:Rectangle Границы окна после изменения.

Если событие — moving или resizing, границы еще не изменены; afterBounds показывает новые границы, если событие не будет отменено. Если событие — move или resize, afterBounds показывает новые границы.

beforeBounds Границы окна до изменения.flash.geom:Rectangle Границы окна до изменения.

Если событие — moving или resizing, границы еще не изменены; beforeBounds отражает текущие границы. Если событие — move или resize, beforeBounds показывает исходное значение.

SQLUpdateEvent Объект SQLUpdateEvent отправляется объектом SQLConnection при изменении данных в любой таблице, связанной с экземпляром SQLConnection.flash.events:Event Объект SQLUpdateEvent отправляется объектом SQLConnection при изменении данных в любой таблице, связанной с экземпляром SQLConnection. Изменение данных может возникнуть в результате выполнения инструкции SQL INSERT, UPDATE или DELETE, либо напрямую, либо из-за пускового механизма, активированного выполнением инструкции. Следующий пример иллюстрирует использование экземпляра SQLUpdateEvent при ответе на событие update. var dbStatement:SQLStatement; function initConnection():void { var dbFile:File = new File(File.separator + "employee.db"); db.addEventListener(SQLEvent.OPEN, dbOpenHandler); db.addEventListener(SQLUpdateEvent.UPDATE, dbUpdateHandler); dbStatement.text = "UPDATE employees SET name = :name WHERE id = :id"; dbStatement.parameters[:name] = "Bruce"; dbStatement.parameters[:id] = 100; dbStatement.sqlConnection = db; db.open(dbFile); } function dbUpdateHandler(event:SQLUpdateEvent):void { trace(event.type + " for table '" + event.table + "' was fired for row with ID:" + event.rowID); } function dbOpenHandler(event:SQLEvent):void { dbStatement.execute(); } flash.data.SQLConnectiondeleteflash.events:SQLUpdateEvent:DELETEflash.events:SQLUpdateEventinsertflash.events:SQLUpdateEvent:INSERTflash.events:SQLUpdateEventupdateflash.events:SQLUpdateEvent:UPDATEflash.events:SQLUpdateEventSQLUpdateEvent Создает новый экземпляр класса SQLUpdateEvent.typeString Тип события, доступный через свойство type. bubblesBooleanfalse Определяет, участвует ли объект Event в фазе восходящей цепочки потока событий. Значение по умолчанию false. cancelableBooleanfalseОпределяет, может ли объект Event быть отменен. Значение по умолчанию false. tableStringnullУказывает имя таблицы, в которой изменились данные. rowIDNumber0Уникальный идентификатор строки, которая была вставлена, удалена или обновлена. Используется для создания нового объекта SQLUpdateEvent. Создает новый экземпляр класса SQLUpdateEvent. clone Создает копию объекта SQLUpdateEvent и задает значение каждого свойства, совпадающее с оригиналом.Новый объект SQLUpdateEvent, значения свойств которого соответствуют значениям оригинала. flash.events:Event Создает копию объекта SQLUpdateEvent и задает значение каждого свойства, совпадающее с оригиналом. DELETE Константа SQLUpdateEvent.DELETE определяет значение свойства type события delete для SQLConnection.deleteString Константа SQLUpdateEvent.DELETE определяет значение свойства type события delete для SQLConnection. Объект события delete имеет следующие свойства. СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.rowIDУникальный идентификатор строки, которая была вставлена, удалена или обновлена.targetОбъект SQLConnection, для которого выполнялась операция.tableИмя таблицы, в которой произошло изменение. INSERT Константа SQLUpdateEvent.INSERT определяет значение свойства typeсобытия insert для SQLConnection.insertString Константа SQLUpdateEvent.INSERT определяет значение свойства type события insert для SQLConnection. Объект события insert имеет следующие свойства. СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.rowIDУникальный идентификатор строки, которая была вставлена, удалена или обновлена.targetОбъект SQLConnection, для которого выполнялась операция.tableИмя таблицы, в которой произошло изменение. UPDATE Константа SQLUpdateEvent.UPDATE определяет значение свойства typeсобытия update для SQLConnection.updateString Константа SQLUpdateEvent.UPDATE определяет значение свойства type события update для SQLConnection.

Объект события update имеет следующие свойства.

СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.rowIDУникальный идентификатор строки, которая была вставлена, удалена или обновлена.targetОбъект SQLConnection, для которого выполнялась операция.tableИмя таблицы, в которой произошло изменение.
rowID Уникальный идентификатор строки, которая была вставлена, удалена или обновлена.Number Уникальный идентификатор строки, которая была вставлена, удалена или обновлена.

Уникальный идентификатор строки в таблице, используемый для поиска в базе данных. Это значение часто генерируется базой данных.

Идентификатор строки для однократного выполнения инструкции SQL INSERT можно получить через свойство lastInsertRowID объекта SQLResult, возвращенного методом getResult() объекта SQLStatement (когда он вызывается после отправки объектом SQLStatement события result).

Дополнительные сведения о первичных ключах и созданных идентификаторах строк см. в разделах «CREATE TABLE» и «Выражения» в приложении «Поддержка SQL в локальных базах данных».

flash.data.SQLConnection.lastInsertRowIDflash.data.SQLResult.lastInsertRowID
table Имя таблицы, изменение данных которой вызвало отправку события.String Имя таблицы, изменение данных которой вызвало отправку события.
EventDispatcher Класс EventDispatcher является базовым классом для всех классов среды выполнения, отправляющих события.flash.events:IEventDispatcherObject Класс EventDispatcher является базовым классом для всех классов, отправляющих события. Класс EventDispatcher реализует интерфейс IEventDispatcher и является базовым классом для класса DisplayObject. Класс EventDispatcher позволяет любому объекту в списке отображения стать целью события и в этом качестве использовать методы интерфейса IEventDispatcher.

Цели событий являются важным компонентом модели событий во Flash® Player и Adobe® AIR® Цель события является основным фактором, определяющим прохождение потока событий по иерархии списка отображения. Когда происходит такое событие, как щелчок мыши или нажатие клавиши, Flash Player или приложение AIR отправляет объект Event в поток событий из корня списка отображения. Тогда объект события проходит путь через список отображения, пока не достигнет цели события, после чего он возвращается в начало пути. Путь к цели события и обратно разделен на три фазы: фаза захвата проходит от корня к последнему узлу перед целевым узлом события; фаза цели включает только целевой узел события; а фаза восходящей цепочки включает все последующие узлы на пути обратно к корневому узлу списка отображения.

Как правило, чтобы дать определенному пользователем классу возможность отправлять события, проще всего расширить класс EventDispatcher. Если это невозможно (например, если класс уже расширяет другой класс), можно внедрить интерфейс IEventDispatcher, создайте элемент EventDispatcher и создайте простые процедуры для направления вызовов в собранный EventDispatcher.

В следующем примере используются классы EventDispatcherExample и CustomDispatcher, подкласс EventDispatcher, чтобы показать процесс создания и отправки пользовательского события. Для этого выполняются следующие задачи:
  1. Конструктор EventDispatcherExample создает локальную переменную dispatcher и назначает ее новому экземпляру CustomDispatcher.
  2. Внутри CustomDispatcher задается строка, присваивающая событию имя action, и объявляется метод doAction(). При вызове этого метода создается событие action и отправляется с помощью метода EventDispatcher.dispatchEvent().
  3. Затем используется свойство dispatcher для добавления прослушивателя события action и связанного метода подписчика actionHandler(), который при отправке события просто печатает информацию о нем.
  4. Вызывается метод doAction(), отправляющий событие action.
package { import flash.display.Sprite; import flash.events.Event; public class EventDispatcherExample extends Sprite { public function EventDispatcherExample() { var dispatcher:CustomDispatcher = new CustomDispatcher(); dispatcher.addEventListener(CustomDispatcher.ACTION, actionHandler); dispatcher.doAction(); } private function actionHandler(event:Event):void { trace("actionHandler: " + event); } } } import flash.events.EventDispatcher; import flash.events.Event; class CustomDispatcher extends EventDispatcher { public static var ACTION:String = "action"; public function doAction():void { dispatchEvent(new Event(CustomDispatcher.ACTION)); } }
deactivate [многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR теряет фокус системы и становится неактивным.flash.events.Event.DEACTIVATEflash.events.Event [многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR теряет фокус системы и становится неактивным. Это многоадресное событие, которое отправляется всеми объектами EventDispatcher, для которых зарегистрированы прослушиватели данного события. Дополнительную информацию о многоадресных событиях см. в описании класса DisplayObject. flash.display.DisplayObjectactivate [многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR перемещается в фокус операционной системы и становится активным.flash.events.Event.ACTIVATEflash.events.Event [многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR перемещается в фокус операционной системы и становится активным. Это многоадресное событие, которое отправляется всеми объектами EventDispatcher, для которых зарегистрированы прослушиватели данного события. Дополнительную информацию о многоадресных событиях см. в описании класса DisplayObject. flash.display.DisplayObjectEventDispatcher Агрегирует экземпляр класса EventDispatcher.targetflash.events:IEventDispatchernullЦелевой объект для событий, отправляемых объекту EventDispatcher. Этот параметр используется, когда экземпляр EventDispatcher агрегируется классом, внедряющим IEventDispatcher; это необходимо, чтобы содержащий его объект мог быть целью для событий. Не используйте этот параметр в простых случаях, когда класс расширяет EventDispatcher. Агрегирует экземпляр класса EventDispatcher.

Класс EventDispatcher обычно используется в качестве базового класса: большинству разработчиков не требуется эта функция конструктора. Однако более опытным разработчикам, внедряющим интерфейс IEventDispatcher, использовать этот конструктор необходимо. Если не удается расширить класс EventDispatcher и вместо этого приходится внедрять интерфейс IEventDispatcher, используйте этот конструктор, чтобы агрегировать экземпляр класса EventDispatcher.

addEventListener Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии.Заданный объект listener не является функцией. ArgumentErrorArgumentErrortypeStringТип события. listenerFunctionФункция прослушивателя, обрабатывающая событие. Эта функция должна принимать объект Event в качестве единственного параметра и не должна что-либо возвращать , как показано в примере: function(evt:Event):void

Эта функция может иметь любое имя.

useCaptureBooleanfalse Определяет, работает ли прослушиватель в фазе захвата или в целевой фазе и в фазе восходящей цепочки. Если значение useCapture равно true, прослушиватель обрабатывает событие только во время фазы захвата, но не во время целевой фазы или фазы восходящей цепочки. Если значение useCapture равно false, то прослушиватель обрабатывает событие только в целевой фазе или фазе восходящей цепочки. Чтобы прослушивать событие во всех трех фазах, необходимо вызвать addEventListener() дважды: один раз с useCapture в значении true, а другой — с useCapture в значении false. priorityint0Уровень приоритета прослушивателя событий. Приоритет определяется 32-разрядным целым числом со знаком. Чем больше число, тем выше приоритет. Все прослушиватели событий с приоритетом n обрабатываются перед прослушивателями с приоритетом n-1. Прослушиватели с одинаковым приоритетом обрабатываются в порядке их добавления. Значение приоритета по умолчанию равно 0. useWeakReferenceBooleanfalseОпределяет, является ли ссылка на listener «сильной» или «слабой». «Сильная» ссылка (по умолчанию) предотвращает удаление listener сборщиком мусора. «Слабая» ссылка не выполняет эту функцию.

Функции элементов уровня класса не подлежат удалению в качестве мусора, вследствие чего можно установить useWeakReference равным true для функций элементов уровня класса, не подвергая их возможности подобного удаления. Если свойству useWeakReference присвоить значение true для прослушивателя, который является вложенной внутренней функцией, то функция будет очищена и перестанет быть постоянной. При создании ссылок на внутреннюю функцию (возможно сохранение в другой переменной) она не будет собираться в качестве мусора и останется устойчивой.

Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии. Можно регистрировать прослушиватели событий в любом узле из списка отображения для каждого типа события, фазы и приоритета.

После успешной регистрации прослушивателя событий невозможно изменить его приоритет путем дополнительных вызовов addEventListener(). Чтобы изменить приоритет прослушивателя, необходимо сначала вызвать метод removeListener(). Затем можно снова зарегистрировать прослушиватель с новым приоритетом.

Следует учесть, что после регистрации прослушивателя последующие вызовы метода addEventListener() с другим значением свойства type или useCapture приводят к регистрации другого прослушивателя. Например, прослушиватель, изначально зарегистрированный со значением useCapture, равным true, прослушивает только во время фазы захвата. Если вызвать метод addEventListener() еще раз с тем же объектом прослушивателя, но со свойством useCapture в значении false, то будет два прослушивателя: один — прослушивающий в фазе захвата, а другой — в целевой фазе и фазе восходящей цепочки.

Невозможно зарегистрировать прослушиватель события только для целевой фазы или для фазы восходящей цепочки. Эти фазы соединены при регистрации, поскольку восходящая цепочка применяется только к предшественникам целевого узла.

Если прослушиватель событий больше не нужен, его можно удалить, вызвав метод removeEventListener(), иначе могут возникнуть проблемы с памятью. Прослушиватели событий не удаляются из памяти автоматически, так как сборщик мусора не удаляет прослушиватель, пока существует объект, отправляющий соответствующее событие (если параметру useWeakReference не задано значение true).

Копирование экземпляра EventDispatcher не приводит к копированию прослушивателей событий, присоединенных к нему. (Если для вновь создаваемого узла требуется прослушиватель событий, его необходимо присоединить после создания узла.) При этом при перемещении экземпляра EventDispatcher присоединенные к нему прослушиватели событий перемещаются вместе с ним.

Если прослушиватель регистрируется для узла в тот момент, когда на нем обрабатывается событие, то в текущей фазе он не запускается, однако может запуститься в следующей фазе потока события, например в фазе восходящей цепочки.

Прослушиватель событий, удаленный из узла во время обработки события на этом узле, будет запускаться текущими операциями. После удаления прослушиватель событий больше не вызывается (если не будет снова зарегистрирован для дальнейшей обработки).

dispatchEvent Посылает событие в поток событий.Достигнут предел рекурсии отправки события. ErrorErrorЗначение true в случае успешной передачи события. Значение false указывает на ошибку или на то, что для события был вызван метод preventDefault(). Booleaneventflash.events:EventОбъект события, передаваемый в поток событий. Если осуществляется повторная отправка события, автоматически создается его клон. После отправки события нельзя изменить его свойство target, поэтому необходимо создать новую копию события, чтобы обеспечить правильное выполнение повторной отправки. Посылает событие в поток событий. Целью события является объект EventDispatcher, для которого вызывается метод dispatchEvent(). hasEventListener Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события.Значение true, если прослушиватель указанного типа зарегистрирован; в противном случае – false. BooleantypeStringТип события. Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события. Это позволяет определить, где объект EventDispatcher изменил обработку типа события в иерархии потока событий. Чтобы определить, запускает ли на самом деле определенный тип событий прослушиватель, используйте метод willTrigger().

Различие между hasEventListener() и willTrigger() заключается в том, что hasEventListener() анализирует только объект, к которому он принадлежит, тогда как willTrigger() — весь поток событий для события, указанного параметром type.

Когда метод hasEventListener() вызывается из объекта LoaderInfo, учитываются только те прослушиватели, к которым есть доступ у вызывающего объекта.

willTrigger()
removeEventListener Удаляет прослушиватель из объекта EventDispatcher.typeStringТип события. listenerFunctionУдаляемый объект прослушивателя. useCaptureBooleanfalse Указывает, был ли прослушиватель зарегистрирован для фазы захвата или целевой фазы и фазы восходящей цепочки. Если прослушиватель зарегистрирован и для фазы захвата, и для фаз цели и восходящей цепочки, метод removeEventListener() необходимо вызвать дважды: один раз с useCapture() в значении true, а другой раз с useCapture() в значении false. Удаляет прослушиватель из объекта EventDispatcher. При отсутствии прослушивателя, зарегистрированного с объектом EventDispatcher, вызов этого метода не оказывает эффекта. willTrigger Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником.Значение равно true при запуске прослушивателя указанного типа; в противном случае значение равно false. BooleantypeStringТип события. Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником. Этот метод возвращает значение true, если прослушиватель события запускается в течение любой фазы потока событий, когда событие указанного типа передается объекту EventDispatcher или любому из его нижестоящих элементов.

Разница между методами hasEventListener() и willTrigger() заключается в том, что hasEventListener() просматривает только тот объект, которому он принадлежит, а willTrigger() просматривает весь поток событий для события, указанного в параметре type.

Когда метод willTrigger() вызывается из объекта LoaderInfo, учитываются только те прослушиватели, к которым есть доступ у вызывающего объекта.

TouchEvent Класс TouchEvent позволяет обрабатывать события на устройствах, которые регистрируют жесты пользователя при взаимодействии с устройством (например, прикосновение к сенсорному экрану).обеспечивает возможность обработки событий для взаимодействия с сенсорным экраном. flash.events:Event Класс TouchEvent позволяет обрабатывать события на устройствах, которые регистрируют жесты пользователя при взаимодействии с устройством (например, прикосновение к сенсорному экрану). При взаимодействии с таким устройством, как мобильный телефон или планшетный компьютер с сенсорным экраном, пользователь, как правило, касается экрана пальцами или указывающим устройством. Можно разработать программы, которые будут реагировать на базовые события сенсорного экрана (такие как касание одним пальцем) с помощью класса TouchEvent. Создайте прослушиватели для типов событий, определенных этим классом. Для взаимодействия пользователя сразу с несколькими точками контакта (например, пользователь проводит по сенсорному экрану сразу несколькими пальцами) используются связанные классы GestureEvent, PressAndTapGestureEvent и TransformGestureEvent. И с помощью свойств и методов этих классов создайте обработчики событий, которые реагируют на жесты пользователя.

Класс Multitouch служит для определения поддержки сенсорного взаимодействия в текущей среде и для управления этой поддержкой, если она имеется.

Примечание. Когда объекты вложены в список отображения, события сенсорного экрана нацеливаются на самый глубокий из видимых вложенных объектов. Этот объект называется целевым узлом. Чтобы родительский элемент целевого узла (объект, содержащий целевой узел в списке отображения) получил уведомление о событии сенсорного экрана, вызовите метод EventDispatcher.addEventListener() для родительского элемента, задав в качестве параметра type конкретное событие, которое требуется отслеживать.

Следующий пример демонстрирует обработку событий TOUCH_BEGIN, TOUCH_MOVE и TOUCH_END. Во время перемещения точки контакта по экрану (onTouchMove), отслеживается и отображается ее координата по оси X относительно рабочей области. Для параметров Sprite.startTouchDrag в функции onTouchBegin значением touchPointID является значение, присвоенное объекту события. Параметр bounds представляет собой прямоугольник, определяющий границы родительского экранного объекта (bg является экранным объектом, содержащим MySprite). Multitouch.inputMode = MultitouchInputMode.TOUCH_POINT; MySprite.addEventListener(TouchEvent.TOUCH_BEGIN, onTouchBegin); MySprite.addEventListener(TouchEvent.TOUCH_MOVE, onTouchMove); MySprite.addEventListener(TouchEvent.TOUCH_END, onTouchEnd); function onTouchBegin(eBegin:TouchEvent) { eBegin.target.startTouchDrag(eBegin.touchPointID, false, bg.getRect(this)); trace("touch begin"); } function onTouchMove(eMove:TouchEvent) { trace(eMove.stageX); } function onTouchEnd(eEnd:TouchEvent) { eEnd.target.stopTouchDrag(eEnd.touchPointID); trace("touch end"); } Следующий пример демонстрирует обработку событий прикосновения и их фаз, а также свойство Multitouch.maxTouchPoints и свойство touchPointID объекта события прикосновения. Этот пример предоставлен Кристианом Кантреллом (Christian Cantrell), более подробное объявление приводится в его руководстве по быстрому началу работы: Multi-touch and gesture support on the Flash Platform (Поддержка технологии Multi-Touch и жестов на платформе Flash Platform). package { import flash.display.Sprite; import flash.events.TouchEvent; import flash.text.AntiAliasType; import flash.text.TextField; import flash.text.TextFormat; import flash.ui.Multitouch; import flash.ui.MultitouchInputMode; [SWF(width=320, height=460, frameRate=24, backgroundColor=0xEB7F00)] public class TouchExample2 extends Sprite { private var dots:Object; private var labels:Object; private var labelFormat:TextFormat; private var dotCount:uint; private var dotsLeft:TextField; private static const LABEL_SPACING:uint = 15; public function TouchExample2() { super(); this.labelFormat = new TextFormat(); labelFormat.color = 0xACF0F2; labelFormat.font = "Helvetica"; labelFormat.size = 11; this.dotCount = 0; this.dotsLeft = new TextField(); this.dotsLeft.width = 300; this.dotsLeft.defaultTextFormat = this.labelFormat; this.dotsLeft.x = 3; this.dotsLeft.y = 0; this.stage.addChild(this.dotsLeft); this.updateDotsLeft(); this.dots = new Object(); this.labels = new Object(); Multitouch.inputMode = MultitouchInputMode.TOUCH_POINT; this.stage.addEventListener(TouchEvent.TOUCH_BEGIN, onTouchBegin); this.stage.addEventListener(TouchEvent.TOUCH_MOVE, onTouchMove); this.stage.addEventListener(TouchEvent.TOUCH_END, onTouchEnd); } private function onTouchBegin(e:TouchEvent):void { if (this.dotCount == Multitouch.maxTouchPoints) return; var dot:Sprite = this.getCircle(); dot.x = e.stageX; dot.y = e.stageY; this.stage.addChild(dot); dot.startTouchDrag(e.touchPointID, true); this.dots[e.touchPointID] = dot; ++this.dotCount; var label:TextField = this.getLabel(e.stageX + ", " + e.stageY); label.x = 3; label.y = this.dotCount * LABEL_SPACING; this.stage.addChild(label); this.labels[e.touchPointID] = label; this.updateDotsLeft(); } private function onTouchMove(e:TouchEvent):void { var label:TextField = this.labels[e.touchPointID]; label.text = (e.stageX + ", " + e.stageY); } private function onTouchEnd(e:TouchEvent):void { var dot:Sprite = this.dots[e.touchPointID]; var label:TextField = this.labels[e.touchPointID]; this.stage.removeChild(dot); this.stage.removeChild(label); delete this.dots[e.touchPointID]; delete this.labels[e.touchPointID]; --this.dotCount; this.updateDotsLeft(); } private function getCircle(circumference:uint = 40):Sprite { var circle:Sprite = new Sprite(); circle.graphics.beginFill(0x1695A3); circle.graphics.drawCircle(0, 0, circumference); return circle; } private function getLabel(initialText:String):TextField { var label:TextField = new TextField(); label.defaultTextFormat = this.labelFormat; label.selectable = false; label.antiAliasType = AntiAliasType.ADVANCED; label.text = initialText; return label; } private function updateDotsLeft():void { this.dotsLeft.text = "Touches Remaining: " + (Multitouch.maxTouchPoints - this.dotCount); } } }
flash.ui.Multitouchflash.events.GestureEventflash.events.TransformGestureEventflash.events.PressAndTapGestureEventflash.events.MouseEventflash.events.EventDispatcher.addEventListener()touchBeginflash.events:TouchEvent:TOUCH_BEGINflash.events:TouchEventflash.display.InteractiveObject.touchBegintouchEndflash.events:TouchEvent:TOUCH_ENDflash.events:TouchEventflash.display.InteractiveObject.touchEndtouchMoveflash.events:TouchEvent:TOUCH_MOVEflash.events:TouchEventflash.display.InteractiveObject.touchMovetouchOutflash.events:TouchEvent:TOUCH_OUTflash.events:TouchEventflash.display.InteractiveObject.touchOuttouchOverflash.events:TouchEvent:TOUCH_OVERflash.events:TouchEventflash.display.InteractiveObject.touchOvertouchRollOutflash.events:TouchEvent:TOUCH_ROLL_OUTflash.events:TouchEventflash.display.InteractiveObject.touchRollOuttouchRollOverflash.events:TouchEvent:TOUCH_ROLL_OVERflash.events:TouchEventflash.display.InteractiveObject.touchRollOvertouchTapflash.events:TouchEvent:TOUCH_TAPflash.events:TouchEvent Следующий код отображает сообщение, когда пользователь прикасается к квадрату, нарисованному в mySprite, на сенсорном экране. Multitouch.inputMode=MultitouchInputMode.TOUCH_POINT; var mySprite:Sprite = new Sprite(); var myTextField:TextField = new TextField(); mySprite.graphics.beginFill(0x336699); mySprite.graphics.drawRect(0,0,40,40); addChild(mySprite); mySprite.addEventListener(TouchEvent.TOUCH_TAP, taphandler); function taphandler(e:TouchEvent): void { myTextField.text = "I've been tapped"; myTextField.y = 50; addChild(myTextField); } flash.display.InteractiveObject.touchTapTouchEvent Создает объект Event, содержащий данные о событиях сенсорного экрана.typeString Тип события. Возможные значения: TouchEvent.TOUCH_BEGIN, TouchEvent.TOUCH_END, TouchEvent.TOUCH_MOVE, TouchEvent.TOUCH_OUT, TouchEvent.TOUCH_OVER, TouchEvent.TOUCH_ROLL_OUT, TouchEvent.TOUCH_ROLL_OVER и TouchEvent.TOUCH_TAP. bubblesBooleantrue Определяет, участвует ли объект Event в фазе восходящей цепочки потока событий. cancelableBooleanfalseОпределяет, можно ли отменить объект Event. touchPointIDint0Уникальный идентификационный номер (целое число), присвоенный точке касания. isPrimaryTouchPointBooleanfalseУказывает, сопоставляется ли первая точка контакта событиям мыши. localXNumberunknownГоризонтальная координата события относительно спрайта-контейнера. localYNumberunknownВертикальная координата события относительно спрайта-контейнера. sizeXNumberunknownШирина области контакта. sizeYNumberunknownВысота области контакта. pressureNumberunknownЗначение в диапазоне 0.01.0, определяющее интенсивность контакта с устройством. Если устройство не поддерживает определение давления, используется значение 1.0. relatedObjectflash.display:InteractiveObjectnullДополняющий экземпляр InteractiveObject, на который влияет событие. Например, когда происходит событие touchOut, relatedObject представляет объект списка отображения, на который теперь показывает указатель. ctrlKeyBooleanfalseВ Windows или Linux указывает на то, активирована ли клавиша Ctrl. В Mac указывает на то, активирована ли клавиша Ctrl или Command. altKeyBooleanfalseУказывает на то, активирована ли клавиша Alt (только для Windows или Linux). shiftKeyBooleanfalseУказывает, активирована ли клавиша Shift. commandKeyBooleanfalse(Только для AIR) Указывает, активирована ли клавиша Command (только для Mac). Этот параметр только для Adobe AIR; не устанавливать его для содержимого Flash Player. controlKeyBooleanfalse(Только для AIR)Указывает активирована ли клавиша Control или Ctrl. Этот параметр только для Adobe AIR; не устанавливать его для содержимого Flash Player. Конструктор для объектов TouchEvent. Создает объект Event, содержащий данные о событиях сенсорного экрана. Объекты Event передаются прослушивателям событий в качестве параметров. clone Создает копию объекта TouchEvent и задает значение каждого свойства, совпадающее с оригиналом.Новый объект TouchEvent, значения свойств которого соответствуют значениям оригинала. flash.events:Event Создает копию объекта TouchEvent и задает значение каждого свойства, совпадающее с оригиналом. toString Возвращает строку, содержащую все свойства объекта TouchEvent.Строка, содержащая все свойства объекта TouchEvent. String Возвращает строку, содержащую все свойства объекта TouchEvent. Строка имеет следующий формат:

[TouchEvent type=value bubbles=value cancelable=value ... ]

updateAfterEvent Предписывает проигрывателю Flash Player или Adobe AIR выполнить визуализацию после обработки данного события, если список отображения был изменен. Предписывает проигрывателю Flash Player или Adobe AIR выполнить визуализацию после обработки данного события, если список отображения был изменен. TOUCH_BEGIN Определяет значение свойства type объекта события касания TOUCH_BEGIN.touchBeginString Определяет значение свойства type объекта события касания TOUCH_BEGIN.

Объект TouchEvent имеет следующие свойства.

СвойствоЗначениеaltKeytrue, если клавиша Alt активна (Windows или Linux).bubblestruecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.commandKeytrue в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows.controlKeytrue, если клавиша Ctrl или Control активна; false, если неактивна.ctrlKeytrue в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.eventPhaseТекущая фаза в потоке событий.isRelatedObjectInaccessibleИмеет значение true, если свойству relatedObject задано значение null в соответствии с правилами изолированной среды безопасности.localXГоризонтальная координата события относительно спрайта-контейнера.localYВертикальная координата события относительно спрайта-контейнера.pressureЗначение в диапазоне 0.01.0, определяющее интенсивность контакта с устройством. Если устройство не поддерживает определение давления, используется значение 1.0.relatedObjectСсылка на объект списка отображения, связанный с событием.shiftKeytrue, если клавиша Shift активна; иначе — false.sizeXШирина области контакта.sizeYВысота области контакта.stageXГоризонтальная координата события в глобальных координатах рабочей области.stageYВертикальная координата события в глобальных координатах рабочей области.targetЭкземпляр InteractiveObject под указывающим устройством. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент.touchPointIDУникальный идентификационный номер (целое число), присвоенный точке касания.
flash.display.InteractiveObject.touchBegin
TOUCH_END Определяет значение свойства type объекта события касания TOUCH_END.touchEndString Определяет значение свойства type объекта события касания TOUCH_END.

Объект TouchEvent имеет следующие свойства.

СвойствоЗначениеaltKeytrue, если клавиша Alt активна (Windows или Linux).bubblestruecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.commandKeytrue в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows.controlKeytrue, если клавиша Ctrl или Control активна; false, если неактивна.ctrlKeytrue в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.eventPhaseТекущая фаза в потоке событий.isRelatedObjectInaccessibleИмеет значение true, если свойству relatedObject задано значение null в соответствии с правилами изолированной среды безопасности.localXГоризонтальная координата события относительно спрайта-контейнера.localYВертикальная координата события относительно спрайта-контейнера.pressureЗначение в диапазоне 0.01.0, определяющее интенсивность контакта с устройством. Если устройство не поддерживает определение давления, используется значение 1.0.relatedObjectСсылка на объект списка отображения, связанный с событием.shiftKeytrue, если клавиша Shift активна; иначе — false.sizeXШирина области контакта.sizeYВысота области контакта.stageXГоризонтальная координата события в глобальных координатах рабочей области.stageYВертикальная координата события в глобальных координатах рабочей области.targetЭкземпляр InteractiveObject под указывающим устройством. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент.touchPointIDУникальный идентификационный номер (целое число), присвоенный точке касания.
flash.display.InteractiveObject.touchEnd
TOUCH_MOVE Определяет значение свойства type объекта события касания TOUCH_MOVE.touchMoveString Определяет значение свойства type объекта события касания TOUCH_MOVE.

Объект TouchEvent имеет следующие свойства.

СвойствоЗначениеaltKeytrue, если клавиша Alt активна (Windows или Linux).bubblestruecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.commandKeytrue в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows.controlKeytrue, если клавиша Ctrl или Control активна; false, если неактивна.ctrlKeytrue в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.eventPhaseТекущая фаза в потоке событий.isRelatedObjectInaccessibleИмеет значение true, если свойству relatedObject задано значение null в соответствии с правилами изолированной среды безопасности.localXГоризонтальная координата события относительно спрайта-контейнера.localYВертикальная координата события относительно спрайта-контейнера.pressureЗначение в диапазоне 0.01.0, определяющее интенсивность контакта с устройством. Если устройство не поддерживает определение давления, используется значение 1.0.relatedObjectСсылка на объект списка отображения, связанный с событием.shiftKeytrue, если клавиша Shift активна; иначе — false.sizeXШирина области контакта.sizeYВысота области контакта.stageXГоризонтальная координата события в глобальных координатах рабочей области.stageYВертикальная координата события в глобальных координатах рабочей области.targetЭкземпляр InteractiveObject под указывающим устройством. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент.touchPointIDУникальный идентификационный номер (целое число), присвоенный точке касания.
flash.display.InteractiveObject.touchMove
TOUCH_OUT Определяет значение свойства type объекта события касания TOUCH_OUT.touchOutString Определяет значение свойства type объекта события касания TOUCH_OUT.

Объект TouchEvent имеет следующие свойства.

СвойствоЗначениеaltKeytrue, если клавиша Alt активна (Windows или Linux).bubblestruecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.commandKeytrue в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows.controlKeytrue, если клавиша Ctrl или Control активна; false, если неактивна.ctrlKeytrue в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.eventPhaseТекущая фаза в потоке событий.isRelatedObjectInaccessibleИмеет значение true, если свойству relatedObject задано значение null в соответствии с правилами изолированной среды безопасности.localXГоризонтальная координата события относительно спрайта-контейнера.localYВертикальная координата события относительно спрайта-контейнера.pressureЗначение в диапазоне 0.01.0, определяющее интенсивность контакта с устройством. Если устройство не поддерживает определение давления, используется значение 1.0.relatedObjectСсылка на объект списка отображения, связанный с событием.shiftKeytrue, если клавиша Shift активна; иначе — false.sizeXШирина области контакта.sizeYВысота области контакта.stageXГоризонтальная координата события в глобальных координатах рабочей области.stageYВертикальная координата события в глобальных координатах рабочей области.targetЭкземпляр InteractiveObject под указывающим устройством. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент.touchPointIDУникальный идентификационный номер (целое число), присвоенный точке касания.
flash.display.InteractiveObject.touchOut
TOUCH_OVER Определяет значение свойства type объекта события касания TOUCH_OVER.touchOverString Определяет значение свойства type объекта события касания TOUCH_OVER.

Объект TouchEvent имеет следующие свойства.

СвойствоЗначениеaltKeytrue, если клавиша Alt активна (Windows или Linux).bubblestruecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.commandKeytrue в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows.controlKeytrue, если клавиша Ctrl или Control активна; false, если неактивна.ctrlKeytrue в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.eventPhaseТекущая фаза в потоке событий.isRelatedObjectInaccessibleИмеет значение true, если свойству relatedObject задано значение null в соответствии с правилами изолированной среды безопасности.localXГоризонтальная координата события относительно спрайта-контейнера.localYВертикальная координата события относительно спрайта-контейнера.pressureЗначение в диапазоне 0.01.0, определяющее интенсивность контакта с устройством. Если устройство не поддерживает определение давления, используется значение 1.0.relatedObjectСсылка на объект списка отображения, связанный с событием.shiftKeytrue, если клавиша Shift активна; иначе — false.sizeXШирина области контакта.sizeYВысота области контакта.stageXГоризонтальная координата события в глобальных координатах рабочей области.stageYВертикальная координата события в глобальных координатах рабочей области.targetЭкземпляр InteractiveObject под указывающим устройством. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент.touchPointIDУникальный идентификационный номер (целое число), присвоенный точке касания.
flash.display.InteractiveObject.touchOver
TOUCH_ROLL_OUT Определяет значение свойства type объекта события касания TOUCH_ROLL_OUT.touchRollOutString Определяет значение свойства type объекта события касания TOUCH_ROLL_OUT.

Объект TouchEvent имеет следующие свойства.

СвойствоЗначениеaltKeytrue, если клавиша Alt активна (Windows или Linux).bubblestruecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.commandKeytrue в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows.controlKeytrue, если клавиша Ctrl или Control активна; false, если неактивна.ctrlKeytrue в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.eventPhaseТекущая фаза в потоке событий.isRelatedObjectInaccessibleИмеет значение true, если свойству relatedObject задано значение null в соответствии с правилами изолированной среды безопасности.localXГоризонтальная координата события относительно спрайта-контейнера.localYВертикальная координата события относительно спрайта-контейнера.pressureЗначение в диапазоне 0.01.0, определяющее интенсивность контакта с устройством. Если устройство не поддерживает определение давления, используется значение 1.0.relatedObjectСсылка на объект списка отображения, связанный с событием.shiftKeytrue, если клавиша Shift активна; иначе — false.sizeXШирина области контакта.sizeYВысота области контакта.stageXГоризонтальная координата события в глобальных координатах рабочей области.stageYВертикальная координата события в глобальных координатах рабочей области.targetЭкземпляр InteractiveObject под указывающим устройством. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент.touchPointIDУникальный идентификационный номер (целое число), присвоенный точке касания.
flash.display.InteractiveObject.touchRollOut
TOUCH_ROLL_OVER Определяет значение свойства type объекта события касания TOUCH_ROLL_OVER.touchRollOverString Определяет значение свойства type объекта события касания TOUCH_ROLL_OVER.

Объект TouchEvent имеет следующие свойства.

СвойствоЗначениеaltKeytrue, если клавиша Alt активна (Windows или Linux).bubblestruecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.commandKeytrue в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows.controlKeytrue, если клавиша Ctrl или Control активна; false, если неактивна.ctrlKeytrue в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.eventPhaseТекущая фаза в потоке событий.isRelatedObjectInaccessibleИмеет значение true, если свойству relatedObject задано значение null в соответствии с правилами изолированной среды безопасности.localXГоризонтальная координата события относительно спрайта-контейнера.localYВертикальная координата события относительно спрайта-контейнера.pressureЗначение в диапазоне 0.01.0, определяющее интенсивность контакта с устройством. Если устройство не поддерживает определение давления, используется значение 1.0.relatedObjectСсылка на объект списка отображения, связанный с событием.shiftKeytrue, если клавиша Shift активна; иначе — false.sizeXШирина области контакта.sizeYВысота области контакта.stageXГоризонтальная координата события в глобальных координатах рабочей области.stageYВертикальная координата события в глобальных координатах рабочей области.targetЭкземпляр InteractiveObject под указывающим устройством. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент.touchPointIDУникальный идентификационный номер (целое число), присвоенный точке касания.
flash.display.InteractiveObject.touchRollOver
TOUCH_TAP Определяет значение свойства type объекта события касания TOUCH_TAP.touchTapString Определяет значение свойства type объекта события касания TOUCH_TAP.

Объект TouchEvent имеет следующие свойства.

СвойствоЗначениеaltKeytrue, если клавиша Alt активна (Windows или Linux).bubblestruecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.commandKeytrue в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows.controlKeytrue, если клавиша Ctrl или Control активна; false, если неактивна.ctrlKeytrue в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.eventPhaseТекущая фаза в потоке событий.isRelatedObjectInaccessibleИмеет значение true, если свойству relatedObject задано значение null в соответствии с правилами изолированной среды безопасности.localXГоризонтальная координата события относительно спрайта-контейнера.localYВертикальная координата события относительно спрайта-контейнера.pressureЗначение в диапазоне 0.01.0, определяющее интенсивность контакта с устройством. Если устройство не поддерживает определение давления, используется значение 1.0.relatedObjectСсылка на объект списка отображения, связанный с событием.shiftKeytrue, если клавиша Shift активна; иначе — false.sizeXШирина области контакта.sizeYВысота области контакта.stageXГоризонтальная координата события в глобальных координатах рабочей области.stageYВертикальная координата события в глобальных координатах рабочей области.targetЭкземпляр InteractiveObject под указывающим устройством. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент.touchPointIDУникальный идентификационный номер (целое число), присвоенный точке касания.
Следующий код отображает сообщение, когда пользователь прикасается к квадрату, нарисованному в mySprite, на сенсорном экране. Multitouch.inputMode=MultitouchInputMode.TOUCH_POINT; var mySprite:Sprite = new Sprite(); var myTextField:TextField = new TextField(); mySprite.graphics.beginFill(0x336699); mySprite.graphics.drawRect(0,0,40,40); addChild(mySprite); mySprite.addEventListener(TouchEvent.TOUCH_TAP, taphandler); function taphandler(e:TouchEvent): void { myTextField.text = "I've been tapped"; myTextField.y = 50; addChild(myTextField); }
flash.display.InteractiveObject.touchTap
altKey Показывает активность клавиши Alt: true — активна, false — неактивна.Boolean Показывает активность клавиши Alt: true — активна, false — неактивна. Поддерживается только в операционных системах Windows и Linux. commandKey Указывает, активирована ли клавиша Command (только для Mac).Boolean Указывает, активирована ли клавиша Command (только для Mac).

В ОС Mac OS свойство commandKey имеет то же значение, что и свойство ctrlKey. Это свойство всегда имеет значение false в ОС Windows или Linux.

controlKey Указывает, активирована ли клавиша Control в Mac или клавиша Ctrl в Windows или Linux.Boolean Указывает, активирована ли клавиша Control в Mac или клавиша Ctrl в Windows или Linux. ctrlKey В Windows или Linux указывает на то, активирована ли клавиша Ctrl (true) или нет (false).Boolean В Windows или Linux указывает на то, активирована ли клавиша Ctrl (true) или нет (false). В Macintosh указывает на то, активирована ли клавиша Control или Command. isPrimaryTouchPoint Указывает, сопоставляется ли первая точка контакта событиям мыши.Boolean Указывает, сопоставляется ли первая точка контакта событиям мыши. flash.events.MouseEventisRelatedObjectInaccessible Если принимает значение true, свойство relatedObject принимает значение null по причинам, связанным с изолированными средами безопасности.Boolean Если принимает значение true, свойство relatedObject принимает значение null по причинам, связанным с изолированными средами безопасности. Если номинальным значением свойства relatedObject является ссылка на объект DisplayObject в другой изолированной среде, свойство relatedObject принимает значение null, пока не будут заданы двусторонние права в границах данной изолированной среды. Права задаются путем вызова метода Security.allowDomain() из SWF-файла или указания файла политик на сервере файла изображений и задания свойства LoaderContext.checkPolicyFile при загрузке изображения. MouseEvent.relatedObjectSecurity.allowDomain()LoaderContext.checkPolicyFilelocalX Горизонтальная координата события относительно спрайта-контейнера.Number Горизонтальная координата события относительно спрайта-контейнера. localY Вертикальная координата события относительно спрайта-контейнера.Number Вертикальная координата события относительно спрайта-контейнера. pressure Значение в диапазоне 0.0 — 1.0, определяющее интенсивность контакта с устройством.Number Значение в диапазоне 0.01.0, определяющее интенсивность контакта с устройством. Если устройство не поддерживает определение давления, используется значение 1.0. relatedObject Ссылка на объект списка отображения, связанный с событием.flash.display:InteractiveObject Ссылка на объект списка отображения, связанный с событием. Например, когда происходит событие touchOut, relatedObject представляет объект списка отображения, на который теперь показывает указатель. Это свойство применимо к событиям touchOut, touchOver, touchRollOut и touchRollOver.

Это свойство может принимать значение null по двум причинам: связанный объект отсутствует или связанный объект существует, но находится в изолированной программной среде безопасности, доступ к которой запрещен. Используйте свойство isRelatedObjectInaccessible() для определения причины.

TouchEvent.isRelatedObjectInaccessible
shiftKey Показывает активность клавиши Shift: true — активна, false — неактивна.Boolean Показывает активность клавиши Shift: true — активна, false — неактивна. sizeX Ширина области контакта.Number Ширина области контакта. sizeY Высота области контакта.Number Высота области контакта. stageX Горизонтальная координата события в глобальных координатах рабочей области.Number Горизонтальная координата события в глобальных координатах рабочей области. Это свойство вычисляется, когда задано свойство localX. stageY Вертикальная координата события в глобальных координатах рабочей области.Number Вертикальная координата события в глобальных координатах рабочей области. Это свойство вычисляется, когда задано свойство localY. touchPointID Уникальный идентификационный номер (целое число), присвоенный точке касания.int Уникальный идентификационный номер (целое число), присвоенный точке касания. В следующем примере вводится переменная touchMoveID для проверки правильного значения touchPointID перед ответом на событие перемещения точки касания. В противном случае другой ввод с помощью касания также запускает обработчика события. Обратите внимание, что прослушиватели фаз перемещения и завершения закреплены за рабочей областью, а не экранным объектом. Рабочая область прослушивает фазы перемещения или завершения, если касание выходит за границы экранного объекта. Multitouch.inputMode = MultitouchInputMode.TOUCH_POINT; var mySprite:Sprite = new Sprite(); mySprite.graphics.beginFill(0x336699); mySprite.graphics.drawRect(0,0,40,40); addChild(mySprite); var myTextField:TextField = new TextField(); addChild(myTextField); myTextField.width = 200; myTextField.height = 20; var touchMoveID:int = 0; mySprite.addEventListener(TouchEvent.TOUCH_BEGIN, onTouchBegin); function onTouchBegin(event:TouchEvent) { if(touchMoveID != 0) { myTextField.text = "already moving. ignoring new touch"; return; } touchMoveID = event.touchPointID; myTextField.text = "touch begin" + event.touchPointID; stage.addEventListener(TouchEvent.TOUCH_MOVE, onTouchMove); stage.addEventListener(TouchEvent.TOUCH_END, onTouchEnd); } function onTouchMove(event:TouchEvent) { if(event.touchPointID != touchMoveID) { myTextField.text = "ignoring unrelated touch"; return; } mySprite.x = event.stageX; mySprite.y = event.stageY; myTextField.text = "touch move" + event.touchPointID; } function onTouchEnd(event:TouchEvent) { if(event.touchPointID != touchMoveID) { myTextField.text = "ignoring unrelated touch end"; return; } touchMoveID = 0; stage.removeEventListener(TouchEvent.TOUCH_MOVE, onTouchMove); stage.removeEventListener(TouchEvent.TOUCH_END, onTouchEnd); myTextField.text = "touch end" + event.touchPointID; }
ServerSocketConnectEvent Объект ServerSocket отправляет объект ServerSocketConnectEvent, когда клиент пытается подключиться к сокету сервера.flash.events:Event Объект ServerSocket отправляет объект ServerSocketConnectEvent, когда клиент пытается подключиться к сокету сервера.

Свойство socket объекта ServerSocketConnectEvent передает объект Socket, который должен использоваться в ходе последующего обмена данными между сервером и клиентом. Чтобы запретить подключение, вызовите метод close() объекта Socket.

Класс ServerSocketServerSocketConnectEvent Создает объект ServerSocketConnectEvent, который содержит информацию о клиентском подключении.typeString Тип события. Должен быть: ServerSocketConnectEvent.CONNECT. bubblesBooleanfalse Определяет, участвует ли объект Event в фазе восходящей цепочки потока событий. Всегда имеет значение false cancelableBooleanfalseОпределяет, можно ли отменить объект Event. Всегда имеет значение false. socketflash.net:SocketnullСокет для нового подключения. Создает объект ServerSocketConnectEvent, который содержит информацию о клиентском подключении. clone Создает копию объекта ServerSocketConnectEvent и задает значение каждого свойства, совпадающее с оригиналом.Новый объект DNSResolverEvent, значения свойств которого соответствуют значениям оригинала. flash.events:Event Создает копию объекта ServerSocketConnectEvent и задает значение каждого свойства, совпадающее с оригиналом. toString Возвращает строку, содержащую все свойства объекта ServerSocketConnectEvent.Строка, содержащая все свойства объекта ServerSocketConnectEvent. String Возвращает строку, содержащую все свойства объекта ServerSocketConnectEvent.

Строка имеет следующий формат:

[ServerSocketConnectEvent type=value bubbles=value cancelable=value socket=value]

CONNECT Задает значение свойства type для объекта события ServerSocketConnectEvent.connectStringОтправляется объектом ServerSocket при получении клиентского соединения. Задает значение свойства type для объекта события ServerSocketConnectEvent.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalse.cancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetЭтот объект ServerSocket.targetЭтот объект ServerSocket.socketОбъект Socket, представляющий новое подключение.
socket Сокет для нового подключения.flash.net:Socket Сокет для нового подключения.

Используйте этот объект Socket на протяжении всего обмена данными с клиентом. Приложение должно поддерживать ссылку на объект Socket. В противном случае объект подлежит сборке мусора и может быть без предупреждения уничтожен во время выполнения.

SyncEvent Объект SharedObject, представляющий удаленный общий объект, отправляет объект SyncEvent при обновлении сервером этого удаленного общего объекта.Объекты событий SyncEvent. flash.events:Event Объект SharedObject, представляющий удаленный общий объект, отправляет объект SyncEvent при обновлении сервером этого удаленного общего объекта. Существует только один тип события sync: SyncEvent.SYNC. Класс SharedObjectsyncflash.events:SyncEvent:SYNCflash.events:SyncEventflash.net.SharedObject.syncSyncEvent Создает объект Event, содержащий данные о событиях sync.typeStringТип события. Прослушиватели событий могут получать эту информацию через унаследованное свойство type. Существует только один тип события sync: SyncEvent.SYNC. bubblesBooleanfalseОпределяет, участвует ли объект Event в фазе восходящей цепочки потока событий. Прослушиватели событий могут получать эту информацию через унаследованное свойство bubbles. cancelableBooleanfalseОпределяет, можно ли отменить объект Event. Прослушиватели событий могут получать эту информацию через унаследованное свойство cancelable. changeListArraynullМассив объектов, описывающих синхронизацию с удаленным объектом SharedObject. Прослушиватели событий могут получать этот объект через свойство changeList. Конструктор для объектов SyncEvent. Создает объект Event, содержащий данные о событиях sync. Объекты Event передаются прослушивателям событий в качестве параметров. changeListclone Создает копию объекта SyncEvent и задает значение каждого свойства, совпадающее с оригиналом.Новый объект SyncEvent, значения свойств которого соответствуют значениям оригинала. flash.events:Event Создает копию объекта SyncEvent и задает значение каждого свойства, совпадающее с оригиналом. toString Возвращает строку, содержащую все свойства объекта SyncEvent.Строка, содержащая все свойства объекта SyncEvent. String Возвращает строку, содержащую все свойства объекта SyncEvent. Строка имеет следующий формат:

[SyncEvent type=value bubbles=value cancelable=value list=value]

SYNC Задает значение свойства type для объекта события sync.syncString Задает значение свойства type для объекта события sync.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.changeListМассив со свойствами, описывающими его состояниеtargetЭкземпляр SharedObject, обновленный сервером.
flash.net.SharedObject.sync
changeList Массив объектов, каждый из которых содержит свойства, описывающие измененные элементы удаленного общего объекта.Array Массив объектов, каждый из которых содержит свойства, описывающие измененные элементы удаленного общего объекта. Каждый объект имеет свойства code, name и oldValue.

При первом подключении к удаленному общему объекту, постоянно находящемуся на компьютере и/или на сервере, строки всех его свойств пусты.

В противном случае, Flash устанавливает свойство code наclear, success, reject, change или delete.

  • Значение clear говорит о том, что либо успешно установлено подключение к удаленному общему объекту, непостоянному на сервере или в клиенте, либо что все свойства объекта удалены (например, когда копии клиента и сервера настолько не синхронизированы, что проигрыватель Flash Player повторно синхронизирует объект клиента с объектом сервера. В последнем случае отправляется событие SyncEvent.SYNC, и code имеет значение "change".
  • Значение success указывает на то, что клиент изменил общий объект.
  • Значение reject говорит о том, что клиент безуспешно попытался изменить объект: вместо этого объект был изменен другим клиентом.
  • Значение change говорит о том, что другой клиент изменил объект или что сервер выполнял повторную синхронизацию объекта.
  • Значение "delete" говорит о том, что атрибут удален.

Свойство name содержит имя измененного свойства.

Свойство oldValue содержит предыдущее значение измененного свойства. Этот параметр имеет значение null, за исключение случаев, когда code имеет значение reject или change.

Класс NetConnectionКласс NetStream
KeyboardEvent Идентификатор объекта KeyboardEvent, отправляемого в ответ на ввод пользователем данных с клавиатуры.Объекты событий Keyboard. flash.events:Event Идентификатор объекта KeyboardEvent, отправляемого в ответ на ввод пользователем данных с клавиатуры. Существует два типа событий клавиатуры: KeyboardEvent.KEY_DOWN и KeyboardEvent.KEY_UP

Так как соответствие клавиш определенным символам варьируется в зависимости от устройства и операционной системы, для обработки ввода символов необходимо использовать тип события TextEvent.

Чтобы прослушивать события клавиш в глобальном масштабе, необходимо добавить прослушиватель события к объекту Stage для фазы захвата и для фаз цели и восходящей цепочки.

В следующем примере используется класс KeyboardEventExample для демонстрации событий клавиатуры и их функций прослушивателей. Для этого выполняются следующие задачи:
  1. Создается новый экземпляр Sprite с именем child.
  2. Объявляются свойства для последующего использования при задании фонового цвета и размера квадрата.
  3. С помощью методов объекта Sprite рисуется голубой квадрат, отображаемый в рабочей области в точке по умолчанию с координатами (0,0), путем вызова метода addChild().
  4. Добавляется один прослушиватель событий мыши и два прослушивателя событий клавиатуры:
    • click/clickHandler отправляется при щелчке по квадрату с целью перевода фокуса на спрайт child, чтобы он мог прослушивать события клавиатуры;
    • keyDown/keyDownHandler отправляется при нажатии любой клавиши; Метод подписчика печатает сведения о событии с помощью оператора trace();
    • keyUp/keyUpHandler отправляется, когда клавиша отпускается.

При тестировании этого примера сначала необходимо щелкнуть по квадрату, чтобы заработали события клавиатуры.

Также, если используется команда «Тестировать ролик» в программе разработки Flash, на некоторые клавиши может реагировать интерфейс программы, а не прослушиватели событий, добавленные для дочернего спрайта.

package { import flash.display.Sprite; import flash.display.DisplayObject; import flash.events.*; public class KeyboardEventExample extends Sprite { private var child:Sprite = new Sprite(); private var bgColor:uint = 0x00CCFF; private var size:uint = 80; public function KeyboardEventExample() { child.graphics.beginFill(bgColor); child.graphics.drawRect(0, 0, size, size); child.graphics.endFill(); addChild(child); child.addEventListener(MouseEvent.CLICK, clickHandler); child.addEventListener(KeyboardEvent.KEY_DOWN, keyDownHandler); child.addEventListener(KeyboardEvent.KEY_UP, keyUpHandler); } private function clickHandler(event:MouseEvent):void { stage.focus = child; } private function keyDownHandler(event:KeyboardEvent):void { trace("keyDownHandler: " + event.keyCode); trace("ctrlKey: " + event.ctrlKey); trace("keyLocation: " + event.keyLocation); trace("shiftKey: " + event.shiftKey); trace("altKey: " + event.altKey); } private function keyUpHandler(event:KeyboardEvent):void { trace("keyUpHandler: " + event.keyCode); } } }
KEY_DOWNKEY_UPKeyLocationkeyDownflash.events:KeyboardEvent:KEY_DOWNflash.events:KeyboardEventflash.display.InteractiveObject.keyDownkeyUpflash.events:KeyboardEvent:KEY_UPflash.events:KeyboardEventflash.display.InteractiveObject.keyUpKeyboardEvent Создает объект Event, содержащий данные о событиях клавиатуры.typeString Тип события. Возможные значения: KeyboardEvent.KEY_DOWN и KeyboardEvent.KEY_UP bubblesBooleantrueОпределяет, участвует ли объект Event в фазе восходящей цепочки потока событий. cancelableBooleanfalseОпределяет, можно ли отменить объект Event. charCodeValueuint0Значение кода символа для нажатой или отпущенной клавиши. Возвращаемые значения кодов символов являются значениями англоязычной раскладки клавиатуры. Например, если нажать «Shift+3», метод Keyboard.charCode() возвращает символ «#» на японской раскладке клавиатуры так же, как на английской. keyCodeValueuint0Значение кода клавиши для нажатой или отпущенной клавиши. keyLocationValueuint0Расположение клавиши на клавиатуре. ctrlKeyValueBooleanfalseВ Windows указывает на то, активирована ли клавиша Ctrl. В Mac указывает на то, активирована ли клавиша Ctrl или Command. altKeyValueBooleanfalseУказывает, активирован ли модификатор клавиши Alt (только для Windows). shiftKeyValueBooleanfalseУказывает, активирован ли модификатор клавиши Shift. controlKeyValueBooleanfalseУказывает, активирована ли клавиша Control в Mac или клавиши Control или Ctrl в Windows или Linux. commandKeyValueBooleanfalseУказывает, активирована ли клавиша Command (только для Mac). Конструктор для объектов KeyboardEvent. Создает объект Event, содержащий данные о событиях клавиатуры. Объекты Event передаются прослушивателям событий в качестве параметров. KEY_DOWNKEY_UPKeyboard.charCodeclone Создает копию объекта KeyboardEvent и задает значение каждого свойства, совпадающее с оригиналом.Новый объект KeyboardEvent, значения свойств которого соответствуют значениям оригинала. flash.events:Event Создает копию объекта KeyboardEvent и задает значение каждого свойства, совпадающее с оригиналом. toString Возвращает строку, содержащую все свойства объекта KeyboardEvent.Строка, содержащая все свойства объекта KeyboardEvent. String Возвращает строку, содержащую все свойства объекта KeyboardEvent. Строка имеет следующий формат:

[KeyboardEvent type=value bubbles=value cancelable=value ... shiftKey=value]

updateAfterEvent Указывает на то, что необходимо выполнить визуализацию после обработки данного события, если список отображения был изменен. Указывает на то, что необходимо выполнить визуализацию после обработки данного события, если список отображения был изменен. KEY_DOWN Константа KeyboardEvent.KEY_DOWN определяет значение свойства type объекта события keyDown.keyDownString Константа KeyboardEvent.KEY_DOWN определяет значение свойства type объекта события keyDown.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblestruecancelabletrue в AIR, false в Flash Player. Отмена этого события в AIR предотвращает ввод этого символа в текстовое поле.charCodeЗначение кода символа для нажатой или отпущенной клавиши.commandKeytrue в Mac, если клавиша Command активна. В противном случае falsecontrolKeytrue в Windows и Linux, если клавиша Ctrl активна. true в Mac, если клавиша Control активна. В противном случае falsectrlKeytrue в Windows и Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.keyCodeЗначение кода клавиши для нажатой или отпущенной клавиши.keyLocationРасположение клавиши на клавиатуре.shiftKeytrue, если клавиша Shift активна; иначе — false.targetЭкземпляр InteractiveObject, находящийся в фокусе. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент.
flash.display.InteractiveObject.keyDown
KEY_UP Константа KeyboardEvent.KEY_UP определяет значение свойства type объекта события keyUp.keyUpString Константа KeyboardEvent.KEY_UP определяет значение свойства type объекта события keyUp.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblestruecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.charCodeСодержит значение кода символа для нажатой или отпущенной клавиши.commandKeytrue в Mac, если клавиша Command активна. В противном случае falsecontrolKeytrue в Windows и Linux, если клавиша Ctrl активна. true в Mac, если клавиша Control активна. В противном случае falsectrlKeytrue в Windows, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.keyCodeЗначение кода клавиши для нажатой или отпущенной клавиши.keyLocationРасположение клавиши на клавиатуре.shiftKeytrue, если клавиша Shift активна; иначе — false.targetЭкземпляр InteractiveObject, находящийся в фокусе. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент.
flash.display.InteractiveObject.keyUp
altKey В Windows указывает на то, активирована клавиша Alt (true) или нет (false). В Mac OS указывает на то, активирована ли клавиша Option.Boolean В Windows указывает на то, активирована клавиша Alt (true) или нет (false). В Mac OS указывает на то, активирована ли клавиша Option. charCode Содержит значение кода символа для нажатой или отпущенной клавиши.uint Содержит значение кода символа для нажатой или отпущенной клавиши. Значения кодов символов являются значениями английской раскладки клавиатуры. Например, если нажать «Shift+3», charCode — это символ «#» на японской раскладке клавиатуры так же, как на английской.

Примечание. Если работает редактор метода ввода (IME), charCode не сообщает точные коды символов.

flash.system.IME
commandKey Показывает активность клавиши Command: true — активна, false — неактивна.Boolean Показывает активность клавиши Command: true — активна, false — неактивна. Поддерживается только для Mac OS. В Mac OS свойство commandKey имеет то же значение, что и свойство ctrlKey. controlKey Показывает активность клавиши Control: true — активна, false — неактивна.Boolean Показывает активность клавиши Control: true — активна, false — неактивна. В Windows и Linux это свойство также имеет значение true, если клавиша Ctrl активна. ctrlKey В Windows и Linux указывает на то, активирована ли клавиша Ctrl (true) или нет (false). В Mac OS указывает на то, активирована ли клавиша Ctrl или Command.Boolean В Windows и Linux указывает на то, активирована ли клавиша Ctrl (true) или нет (false). В Mac OS указывает на то, активирована ли клавиша Ctrl или Command. keyCode Значение кода клавиши для нажатой или отпущенной клавиши.uint Значение кода клавиши для нажатой или отпущенной клавиши.

Примечание. Если работает редактор метода ввода (IME), charCode не сообщает точные коды клавиш.

flash.system.IME
keyLocation Указывает расположение клавиши на клавиатуре.uint Указывает расположение клавиши на клавиатуре. Это целесообразно для дифференциации клавиш, встречающихся на клавиатуре несколько раз. Например, можно дифференцировать левую и правую клавиши Shift по значению этого свойства: KeyLocation.LEFT — левая, а KeyLocation.RIGHT — правая. Другой пример — дифференциация клавиш с цифрами, нажатых на стандартной клавиатуре (KeyLocation.STANDARD) и на числовой панели (KeyLocation.NUM_PAD). shiftKey Показывает, активирован ли модификатор клавиши Shift: true — активирован, false — не активирован.Boolean Показывает, активирован ли модификатор клавиши Shift: true – активирован, false – не активирован.
NativeWindowDisplayStateEvent Объект NativeWindow отправляет события класса NativeWindowDisplayStateEvent при изменении состояния отображения окна.Объекты событий NativeWindow, изменяющие состояние отображения окна. flash.events:Event Объект NativeWindow отправляет события класса NativeWindowDisplayStateEvent при изменении состояния отображения окна. Существует два типа событий:
  • NativeWindowDisplayStateEvent.DISPLAY_STATE_CHANGING
  • NativeWindowDisplayStateEvent.DISPLAY_STATE_CHANGE
flash.events.NativeWindowDisplayStateEvent.DISPLAY_STATE_CHANGINGflash.events.NativeWindowDisplayStateEvent.DISPLAY_STATE_CHANGEdisplayStateChangeflash.events:NativeWindowDisplayStateEvent:DISPLAY_STATE_CHANGEflash.events:NativeWindowDisplayStateEventОтправляется объектом NativeWindow после изменения состояния отображения окна. flash.display.NativeWindowdisplayStateChangingflash.events:NativeWindowDisplayStateEvent:DISPLAY_STATE_CHANGINGflash.events:NativeWindowDisplayStateEventОтправляется объектом NativeWindow перед изменением состояния отображения окна. flash.display.NativeWindowNativeWindowDisplayStateEvent Создает объект Event со специфической информацией, имеющей отношение к событиям состояния отображения окна.typeString Тип события. Возможные значения:
  • NativeWindowDisplayStateEvent.DISPLAY_STATE_CHANGING
  • NativeWindowDisplayStateEvent.DISPLAY_STATE_CHANGE
bubblesBooleantrue Определяет, участвует ли объект Event в фазе восходящей цепочки потока событий. cancelableBooleanfalseОпределяет, можно ли отменить объект Event. beforeDisplayStateStringdisplayState до изменения. afterDisplayStateStringdisplayState после изменения.
Создает объект Event со специфической информацией, имеющей отношение к событиям состояния отображения окна. Объекты Event передаются прослушивателям событий в качестве параметров.
clone Создает копию объекта NativeWindowDisplayStateEvent и задает значение каждого свойства, совпадающее с оригиналом.Новый объект NativeWindowDisplayStateEvent, значения свойств которого соответствуют значениям оригинала. flash.events:Event Создает копию объекта NativeWindowDisplayStateEvent и задает значение каждого свойства, совпадающее с оригиналом. toString Возвращает строку, содержащую все свойства объекта NativeWindowDisplayStateEvent.Строка, содержащая все свойства объекта NativeWindowDisplayStateEvent. String Возвращает строку, содержащую все свойства объекта NativeWindowDisplayStateEvent. Строка имеет следующий формат:

[NativeWindowDisplayStateEvent type=value bubbles=value cancelable=value beforeDisplayState=value afterDisplayState=value]

DISPLAY_STATE_CHANGE Задает значение свойства type для объекта события displayStateChange.displayStateChangeStringОтправляется объектом NativeWindow после изменения состояния отображения окна. Задает значение свойства type для объекта события displayStateChange.

Это событие имеет следующие свойства:

СвойстваЗначенияafterDisplayStateСтарое состояние отображения окна.beforeDisplayStateНовое состояние отображения окна.targetЭкземпляр NativeWindow, который только что изменил состояние. bubblesНет.currentTargetУказывает объект, активно обрабатывающий объект Event с помощью прослушивателя событий.cancelablefalse; нет поведения по умолчанию для отмены.
flash.display.NativeWindow
DISPLAY_STATE_CHANGING Задает значение свойства type для объекта события displayStateChanging.displayStateChangingStringОтправляется объектом NativeWindow перед изменением состояния отображения окна. Задает значение свойства type для объекта события displayStateChanging.

Это событие имеет следующие свойства:

СвойстваЗначенияafterDisplayStateСостояние отображения окна до ожидаемого изменения.beforeDisplayStateСостояние отображения окна после ожидаемого изменения.targetЭкземпляр NativeWindow, который только что изменил состояние. bubblesНет.currentTargetУказывает объект, активно обрабатывающий объект Event с помощью прослушивателя событий.cancelabletrue; отмена события предотвратит изменение.
flash.display.NativeWindow
afterDisplayState Состояние отображения NativeWindow после изменения.String Состояние отображения NativeWindow после изменения.

Если событие — displayStateChanging, состояние отображения еще не изменилось; afterDisplayState указывает новое состояние отображения, если событие не отменено. Если событие — displayStateChanged, afterDisplayState указывает текущее значение.

beforeDisplayState Состояние отображения NativeWindow до изменения.String Состояние отображения NativeWindow до изменения.

Если событие — displayStateChanging, состояние отображения еще не изменилось; beforeDisplayState отражает текущее состояние отображения окна. Если событие – displayStateChanged, beforeDisplayState указывает предыдущее значение.

VideoEvent Этот класс событий сообщает о текущем видео состоянии рендеринга.Сообщает текущее видео состояние рендеринга. flash.events:Event

Этот класс событий сообщает о текущем состоянии визуализации видео. Используйте это событие в следующих целях:

  • Узнать, когда размер изменений Экрана или калибруется. Используйте это событие вместо того, чтобы голосовать для изменений размера. Когда вы получаете это событие, вы можете получить доступ Video.videoSize и Video.videoHeight получать размеры в пикселах видеоролика, который в настоящее время воспроизводит.
  • Узнать, расшифрован ли видеоролик программным обеспечением или графическим процессором. Если состояние возвращения свойств "ускорялись", вы должны переключиться на использование класса StageVideo, если возможный.
flash.events.StageVideoEventflash.events.StageVideoAvailabilityEventflash.display.Stage.stageVideosflash.media.Videoflash.net.NetStreamРабота с видеоVideoEvent Конструктор. typeStringТип события. Возможные значения: VideoEvent.RENDER_STATE. bubblesBooleanfalseУказывает, участвует ли объект Event в фазе восходящей цепочки потока событий. cancelableBooleanfalseОбозначает, можете ли вы отменить операцию, которая вызывает это событие. statusStringnullСостояние рендеринга видеоролика. Конструктор.

Конструктор.

RENDER_STATE Определяет значение свойства type для объекта события renderState.renderStateStringИдентификатор для renderState события объекта Video. Определяет значение свойства type для объекта события renderState.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий событие.statusСостояние рендеринга сообщало событием.targetОбъект Video, сообщая о состоянии рендеринга.
RENDER_STATUS_ACCELERATED Для внутреннего пользования только.acceleratedStringДля внутреннего пользования только.

Только для внутреннего пользования. Используйте flash.media. VideoStatus. УСКОРЕННЫЙ вместо этого.

RENDER_STATUS_SOFTWARE Для внутреннего пользования только.softwareStringДля внутреннего пользования только.

Только для внутреннего пользования. Используйте flash.media. VideoStatus. ПРОГРАММНОЕ ОБЕСПЕЧЕНИЕ вместо этого.

RENDER_STATUS_UNAVAILABLE Для внутреннего пользования только.unavailableStringДля внутреннего пользования только.

Только для внутреннего пользования. Используйте flash.media. VideoStatus. НЕДОСТУПНЫЙ вместо этого.

status Возвращает состояние рендеринга объекта VideoEvent.StringВозвращает состояние визуализации объекта VideoEvent.

Возвращает состояние визуализации объекта VideoEvent. Возможные значения включают "недоступный", "программный", и "ускоренный".

GestureEvent Класс GestureEvent позволяет обрабатывать мультисенсорные события на устройствах, которые способны определять сложное взаимодействие пользователя с устройством (например, пользователь прикасается к сенсорному экрану сразу двумя пальцами).обеспечивает возможность обработки событий для взаимодействия с сенсорным экраном. flash.events:Event Класс GestureEvent позволяет обрабатывать мультисенсорные события на устройствах, которые способны определять сложное взаимодействие пользователя с устройством (например, пользователь прикасается к сенсорному экрану сразу двумя пальцами). При взаимодействии с таким устройством, как мобильный телефон или планшетный компьютер с сенсорным экраном, пользователь, как правило, касается экрана и проводит по нему пальцами или указывающим устройством. Можно разработать программы, которые реагируют на такое пользовательское взаимодействие пользователя с помощью классов GestureEvent и TransformGestureEvent. Создайте прослушиватели для событий, которые определены здесь или в связанных классах TouchEvent и TransformGestureEvent. И с помощью свойств и методов этих классов создайте обработчики событий, которые реагируют на жесты пользователя.

Класс Multitouch служит для определения поддержки сенсорного взаимодействия в текущей среде и для управления этой поддержкой, если она имеется.

Примечание. Когда объекты вложены в список отображения, события сенсорного экрана нацеливаются на самый глубокий из видимых вложенных объектов. Этот объект называется целевым узлом. Чтобы родительский элемент целевого узла (объект, содержащий целевой узел в списке отображения) получил уведомление о событии сенсорного экрана, вызовите метод EventDispatcher.addEventListener() для родительского элемента, задав в качестве параметра type конкретное событие, которое требуется отслеживать.

Следующий пример демонстрирует обработку событий для GESTURE_TWO_FINGER_TAP. Когда пользователь выполняет жест нажатия двумя пальцами, mySprite поворачивается, а в текстовом поле myTextField отображается фаза all, которая является единственной фазой для событий нажатия двумя пальцами. Другие жесты класса TransformGestureEvent поддерживают фазы начала, обновления и завершения. Multitouch.inputMode = MultitouchInputMode.GESTURE; var mySprite = new Sprite(); mySprite.addEventListener(GestureEvent.GESTURE_TWO_FINGER_TAP , onTwoFingerTap ); mySprite.graphics.beginFill(0x336699); mySprite.graphics.drawRect(0, 0, 100, 80); var myTextField = new TextField(); myTextField.y = 200; addChild(mySprite); addChild(myTextField); function onTwoFingerTap(evt:GestureEvent):void { evt.target.rotation -= 45; myTextField.text = evt.phase; //"all" }
flash.ui.Multitouchflash.events.TouchEventflash.events.TransformGestureEventflash.events.PressAndTapGestureEventflash.events.MouseEventflash.events.EventDispatcher.addEventListener()gestureTwoFingerTapflash.events:GestureEvent:GESTURE_TWO_FINGER_TAPflash.events:GestureEventflash.display.InteractiveObject.gestureTwoFingerTapflash.events.GesturePhaseGestureEvent Создает объект Event, который содержит информацию о мультисенсорных событиях (например, пользователь касается сенсорного экрана сразу двумя пальцами).typeString Тип события. Поддерживаемое значение: GestureEvent.GESTURE_TWO_FINGER_TAP. bubblesBooleantrue Определяет, участвует ли объект Event в фазе восходящей цепочки потока событий. cancelableBooleanfalseОпределяет, можно ли отменить объект Event. phaseStringnullЗначение класса GesturePhase, обозначающее ход выполнения сенсорного жеста (начало, обновление, завершение или все). localXNumber0Горизонтальная координата события относительно спрайта-контейнера. localYNumber0Вертикальная координата события относительно спрайта-контейнера. ctrlKeyBooleanfalseВ Windows или Linux указывает на то, активирована ли клавиша Ctrl. В Mac указывает на то, активирована ли клавиша Ctrl или Command. altKeyBooleanfalseУказывает на то, активирована ли клавиша Alt (только для Windows или Linux). shiftKeyBooleanfalseУказывает, активирована ли клавиша Shift. commandKeyBooleanfalse(Только для AIR) Указывает, активирована ли клавиша Command (только для Mac). Этот параметр только для Adobe AIR; не устанавливать его для содержимого Flash Player. controlKeyBooleanfalse(Только для AIR)Указывает активирована ли клавиша Control или Ctrl. Этот параметр только для Adobe AIR; не устанавливать его для содержимого Flash Player. Конструктор для объектов GestureEvent. Создает объект Event, который содержит информацию о мультисенсорных событиях (например, пользователь касается сенсорного экрана сразу двумя пальцами). Объекты Event передаются прослушивателям событий в качестве параметров. flash.events.GesturePhaseclone Создает копию объекта GestureEvent и задает значение каждого свойства, совпадающее с оригиналом.Новый объект GestureEvent, значения свойств которого соответствуют значениям оригинала. flash.events:Event Создает копию объекта GestureEvent и задает значение каждого свойства, совпадающее с оригиналом. toString Возвращает строку, содержащую все свойства объекта GestureEvent.Строка, содержащая все свойства объекта GestureEvent. String Возвращает строку, содержащую все свойства объекта GestureEvent. Строка имеет следующий формат:

[GestureEvent type=value bubbles=value cancelable=value ... ]

updateAfterEvent Обновляет дисплей среды выполнения Flash после обработки события жеста, если список отображения был изменен обработчиком событий. Обновляет дисплей среды выполнения Flash после обработки события жеста, если список отображения был изменен обработчиком событий. GESTURE_TWO_FINGER_TAP Определяет значение свойства type объекта события жеста GESTURE_TWO_FINGER_TAP.gestureTwoFingerTapString Определяет значение свойства type объекта события жеста GESTURE_TWO_FINGER_TAP.

Объект GestureEvent имеет следующие свойства.

СвойствоЗначениеaltKeytrue, если клавиша Alt активна (Windows или Linux).bubblestruecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.commandKey(только в AIR) true в ОС Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows.controlKeytrue, если клавиша Ctrl или Control активна; false, если неактивна.ctrlKeytrue в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.phaseТекущая фаза в потоке событий. При отправке событий нажатия двумя пальцами всегда используется значение all, соответствующее значению GesturePhase.ALL.isRelatedObjectInaccessibleИмеет значение true, если свойству relatedObject задано значение null в соответствии с правилами изолированной среды безопасности.localXГоризонтальная координата события относительно спрайта-контейнера.localYВертикальная координата события относительно спрайта-контейнера.shiftKeytrue, если клавиша Shift активна; иначе — false.targetЭкземпляр InteractiveObject под указывающим устройством. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент.
flash.display.InteractiveObject.gestureTwoFingerTapflash.events.GesturePhase
altKey Показывает активность клавиши Alt: true — активна, false — неактивна.Boolean Показывает активность клавиши Alt: true — активна, false — неактивна. Поддерживается только в операционных системах Windows и Linux. commandKey Указывает, активирована ли клавиша Command (только для Mac).Boolean Указывает, активирована ли клавиша Command (только для Mac).

В ОС Mac OS свойство commandKey имеет то же значение, что и свойство ctrlKey. Это свойство всегда имеет значение false в ОС Windows или Linux.

controlKey Указывает, активирована ли клавиша Control в Mac или клавиша Ctrl в Windows или Linux.Boolean Указывает, активирована ли клавиша Control в Mac или клавиша Ctrl в Windows или Linux. ctrlKey В Windows или Linux указывает на то, активирована ли клавиша Ctrl (true) или нет (false).Boolean В Windows или Linux указывает на то, активирована ли клавиша Ctrl (true) или нет (false). В Macintosh указывает на то, активирована ли клавиша Control или Command. localX Горизонтальная координата события относительно спрайта-контейнера.Number Горизонтальная координата события относительно спрайта-контейнера. localY Вертикальная координата события относительно спрайта-контейнера.Number Вертикальная координата события относительно спрайта-контейнера. phase Значение класса GesturePhase, обозначающее ход выполнения сенсорного жеста (начало, обновление, завершение или все).String Значение класса GesturePhase, обозначающее ход выполнения сенсорного жеста (начало, обновление, завершение или все). Для большинства жестов фаза имеет значение begin, update или end. Для событий выделения и нажатия двумя пальцами фаза всегда имеет значение all при отправке события. Используйте это значение, чтобы определить, когда обработчик событий должен реагировать на сложное взаимодействие пользователя. Также можно определить, должен ли он по-разному реагировать в зависимости от текущей фазы мультисенсорного жеста (например, выполняется раскрытие, перемещение и перетаскивание, когда пользователь касается экранного объекта и перетаскивает его по экрану). flash.events.GesturePhaseshiftKey Показывает активность клавиши Shift: true — активна, false — неактивна.Boolean Показывает активность клавиши Shift: true — активна, false — неактивна. stageX Горизонтальная координата события в глобальных координатах рабочей области.Number Горизонтальная координата события в глобальных координатах рабочей области. Это свойство вычисляется, когда задано свойство localX. stageY Вертикальная координата события в глобальных координатах рабочей области.Number Вертикальная координата события в глобальных координатах рабочей области. Это свойство вычисляется, когда задано свойство localY.
FullScreenEvent Объект Stage отправляет объект FullScreenEvent при каждом переходе объекта Stage в полноэкранный режим или выходе из него.Объекты событий FullScreenEvent. flash.events:ActivityEvent Объект Stage отправляет объект FullScreenEvent при каждом переходе объекта Stage в полноэкранный режим или выходе из него. Существует только один тип события fullScreen: FullScreenEvent.FULL_SCREEN. flash.display.Stage.displayStatefullScreenflash.events:FullScreenEvent:FULL_SCREENflash.events:FullScreenEventflash.display.Stage.displayStateFullScreenEvent Создает объект события, содержащий информацию о событиях fullScreen.typeString Тип события. Прослушиватели событий могут получать эту информацию через унаследованное свойство type. Существует только один тип события fullScreen: FullScreenEvent.FULL_SCREEN. bubblesBooleanfalseОпределяет, участвует ли объект Event в фазе восходящей цепочки потока событий. Прослушиватели событий могут получать эту информацию через унаследованное свойство bubbles. cancelableBooleanfalseОпределяет, можно ли отменить объект Event. Прослушиватели событий могут получать эту информацию через унаследованное свойство cancelable. fullScreenBooleanfalseПоказывает состояние, в которое переходит устройство: активное (true) или неактивное (false). Прослушиватели событий могут получать эту информацию через свойство activating. Конструктор для объектов FullScreenEvent. Создает объект события, содержащий информацию о событиях fullScreen. Объекты Event передаются прослушивателям событий в качестве параметров. FullScreenEvent.FULL_SCREENclone Создает копию объекта FullScreenEvent и задает значение каждого свойства, совпадающее с оригиналом.Новый объект FullScreenEvent, значения свойств которого соответствуют значениям оригинала. flash.events:Event Создает копию объекта FullScreenEvent и задает значение каждого свойства, совпадающее с оригиналом. toString Возвращает строку, содержащую все свойства объекта FullScreenEvent.Строка, содержащая все свойства объекта FullScreenEvent. String Возвращает строку, содержащую все свойства объекта FullScreenEvent. Используется следующий формат:

[FullScreenEvent type=value bubbles=value cancelable=value activating=value]

FULL_SCREEN Константа FullScreenEvent.FULL_SCREEN определяет значение свойства type для объекта события fullScreen.fullScreenString Константа FullScreenEvent.FULL_SCREEN определяет значение свойства type для объекта события fullScreen.

Это событие имеет следующие свойства:

СвойствоЗначениеfullScreentrue, если состояние отображения — на весь экран или false, если состояние обычное.bubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.targetОбъект Stage.
flash.display.Stage.displayState
fullScreen Показывает, что объект Stage находится в полноэкранном режиме (true) или в оконном режиме (false).Boolean Показывает, что объект Stage находится в полноэкранном режиме (true) или в оконном режиме (false).
StageVideoAvailabilityEvent Это событие стреляет, когда состояние свойств Stage.stageVideos изменяется.Сообщает о текущей доступности видео рабочей области. flash.events:Event

Это событие стреляет когда состояние Stage.stageVideos изменения свойств. Это свойство может измениться, если пользователь развертывает видео на полный экран из режима wmode, не поддерживающего StageVideo (например, wmode=normal, wmode=opaque или wmode=transparent). Развертывание видео на полный экран может привести к заполнению вектора Stage.stageVideos. И наоборот, выход из полноэкранного режима может привести к опустошению вектора Stage.stageVideos.

ПРИМЕЧАНИЕ. Это уведомление выдается, только если состояние свойства Stage.stageVideos изменяется. В результате поведение может измениться в зависимости от платформы и браузера. Например, в Windows событие stageVideoAvailability не отправляется при переходе в полноэкранный режим, в то время как для режима wmode устанавливается значение direct. Однако на некоторых других платформах при том же самом поведении Flash Player перераспределяет ресурсы. В этих случаях состояние свойства Stage.stageVideos изменяется, и событие отправляется. Переход в полноэкранный режим можно определить с помощью прослушивания события flash.events.FullScreenEvent. Это событие отправляется объектом Stage.

flash.events.StageVideoEventflash.media.StageVideoAvailabilityflash.events.VideoEventflash.events.FullScreenEventflash.display.Stage.stageVideosflash.events.FullScreenEventflash.media.Videoflash.net.NetStreamРабота с видеоStageVideoAvailabilityEvent Конструктор. typeStringТип события. Возможные значения: StageVideoAvailabilityEvent.STAGE_VIDEO_AVAILABILITY. bubblesBooleanfalseУказывает, участвует ли объект Event в фазе восходящей цепочки потока событий. cancelableBooleanfalseОбозначает, можете ли вы отменить операцию, которая вызывает это событие. availabilityStringnullТекущая доступность видео рабочей области. Конструктор.

Конструктор.

STAGE_VIDEO_AVAILABILITY Определяет значение свойства type для объекта события stageVideoAvailability.stageVideoAvailabilityStringИдентификатор для события stageVideoAvailability объекта Stage. Определяет значение свойства type для объекта события stageVideoAvailability.

Это событие имеет следующие свойства:

СвойствоЗначениеavailabilityСостояние сообщало событием.bubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий событие.targetОбъект Stage, сообщающий о доступности видео рабочей области.
availability Сообщает о текущей доступности видео рабочей области с использованием класса flash.media.StageVideoAvailability. StringСообщает о текущей доступности видео рабочей области.

Сообщает о текущей доступности видео рабочей области с использованием класса flash.media.StageVideoAvailability.

DatagramSocketDataEvent Объект DatagramSocketDataEvent отправляется после получения данных сокетом Datagram.flash.events:Event Объект DatagramSocketDataEvent отправляется после получения данных сокетом Datagram. Класс DatagramSocketdataflash.events:DatagramSocketDataEvent:DATAflash.events:DatagramSocketDataEventОтправляется объектом DatagramSocket при получении пакета UDP. flash.net.DatagramSocket.dataDatagramSocketDataEvent Создает объект Event, содержащий данные о событиях датаграмм.typeString Тип события. Возможные значения: DatagramSocketDataEvent.DATA bubblesBooleanfalse Определяет, участвует ли объект Event в фазе восходящей цепочки потока событий. cancelableBooleanfalseОпределяет, можно ли отменить объект Event. srcAddressStringIP-адрес компьютера, отправившего пакет. srcPortint0Порт на компьютере, отправившем пакет. dstAddressStringIP-адрес, которому адресован пакет. dstPortint0Порт, которому адресован пакет. dataflash.utils:ByteArraynullДанные пакета датаграммы. Создает объект Event, содержащий данные о событиях датаграмм. Объекты Event передаются прослушивателям событий в качестве параметров. clone Создает копию объекта DatagramSocketDataEvent и задает значение каждого свойства, совпадающее с оригиналом.Новый объект DatagramSocketDataEvent, значения свойств которого соответствуют значениям оригинала. flash.events:Event Создает копию объекта DatagramSocketDataEvent и задает значение каждого свойства, совпадающее с оригиналом. toString Возвращает строку, содержащую все свойства объекта DatagramSocketDataEvent.Строка, содержащая все свойства объекта ProgressEvent. String Возвращает строку, содержащую все свойства объекта DatagramSocketDataEvent. Строка имеет следующий формат:

[DatagramSocketDataEvent type=value bubbles=value cancelable=value srcAddress=value srcPort=value dstAddress=value dstPort=value data=value]

DATA Определяет значение свойства type объекта события data.dataStringОтправляется объектом DatagramSocket при получении пакета UDP. Определяет значение свойства type объекта события data. flash.net.DatagramSocket.datadata Данные пакета датаграммы.flash.utils:ByteArray Данные пакета датаграммы. dstAddress IP-адрес объекта DatagramSocket, отправившего это событие.String IP-адрес объекта DatagramSocket, отправившего это событие.

Примечание. Если сокет связан со специальным адресом 0.0.0.0, то это свойство возвращает 0.0.0.0. Чтобы узнать определенный IP-адрес, на который отправлена датаграмма, необходимо связать сокет с явным IP-адресом.

dstPort Порт объекта DatagramSocket, отправившего это событие.int Порт объекта DatagramSocket, отправившего это событие. srcAddress IP-адрес компьютера, отправившего пакет.String IP-адрес компьютера, отправившего пакет. srcPort Порт на компьютере, отправившем пакет.int Порт на компьютере, отправившем пакет.
DRMStatusEvent Объект NetStream отправляет объект DRMStatusEvent, когда содержимое, защищенное системой управления цифровыми правами (DRM), успешно начинает воспроизводиться (когда ваучер проверен и пользователь получает право на просмотр содержимого).Объекты Event объектов с защитой DRM. flash.events:Event Объект NetStream отправляет объект DRMStatusEvent, когда содержимое, защищенное системой управления цифровыми правами (DRM), успешно начинает воспроизводиться (когда ваучер проверен и пользователь получает право на просмотр содержимого). Объект DRMStatusEvent содержит информацию, связанную с ваучером, например, может ли содержимое предоставляться в автономном режиме, или когда истекает срок действия ваучера и просмотр содержимого будет запрещен. Приложение может использовать эти данные для информирования пользователя о состоянии его политик и прав доступа. flash.net.NetStreamDRMStatusEvent.DRM_STATUSflash.net.drm.DRMManagerflash.net.drm.DRMVoucherdrmStatusflash.events:DRMStatusEvent:DRM_STATUSflash.events:DRMStatusEventОтправляется объектом NetStream, когда начинается воспроизведение содержимого, защищенного с помощью DRM. DRMStatusEvent Создает объект Event, содержащий данные о событиях состояния DRM.typeStringunknown Тип события. Прослушиватели событий могут получать эту информацию через унаследованное свойство type. Существует только один тип события DRMAuthenticate: DRMAuthenticateEvent.DRM_AUTHENTICATE. bubblesBooleanfalseОпределяет, участвует ли объект Event в фазе восходящей цепочки потока событий. Прослушиватели событий могут получать эту информацию через унаследованное свойство bubbles. cancelableBooleanfalseОпределяет, можно ли отменить объект Event. Прослушиватели событий могут получать эту информацию через унаследованное свойство cancelable. inMetadataflash.net.drm:DRMContentDatanullПользовательский объект, содержащий пользовательские свойства DRM. inVoucherflash.net.drm:DRMVouchernullКонтекст события. inLocalBooleanfalseУказывает, может ли содержимое просматриваться в автономном режиме. Создает объект Event, содержащий данные о событиях состояния DRM. Объекты Event передаются прослушивателям событий в качестве параметров. clone Создает копию объекта DRMStatusEvent и задает значение каждого свойства, совпадающее с оригиналом.Новый объект DRMStatusEvent, значения свойств которого соответствуют значениям оригинала. flash.events:Event Создает копию объекта DRMStatusEvent и задает значение каждого свойства, совпадающее с оригиналом. toString Возвращает строку, содержащую все свойства объекта DRMStatusEvent.Строка, содержащая все свойства объекта DRMStatusEvent. String Возвращает строку, содержащую все свойства объекта DRMStatusEvent. DRM_STATUS Константа DRMStatusEvent.DRM_STATUS определяет значение свойства type объекта события drmStatus.drmStatusStringОтправляется объектом NetStream, когда начинается воспроизведение содержимого, защищенного с помощью DRM. Константа DRMStatusEvent.DRM_STATUS определяет значение свойства type объекта события drmStatus.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.detailСтрока, объясняющая контекст события состояния.isAnonymousУказывает, доступно ли содержимое с DRM-шифрованием без запроса учетных данных пользователя для проверки подлинности.isAvailableOfflineУказывает, доступно ли содержимое с DRM-шифрованием в автономном режиме.offlineLeasePeriodОставшееся число дней, в течение которых содержимое можно просматривать в автономном режиме.policiesПользовательский объект события состояния DRM.targetОбъект NetStream.voucherEndDateАбсолютная дата завершения срока действия ваучера, после которой содержимое становится недоступным для просмотра пользователямиcontentDataОбъект DRMContentData для содержимогоvoucherОбъект DRMVoucher для содержимого.isLocalУказывает на то, хранится ли содержимое в локальной файловой системе
contentData Объект DRMContentData, содержащий информацию, необходимую для получения ваучера на просмотр содержимого с защитой по технологии DRM.flash.net.drm:DRMContentData Объект DRMContentData, содержащий информацию, необходимую для получения ваучера на просмотр содержимого с защитой по технологии DRM. detail Строка, объясняющая контекст события состояния.String Строка, объясняющая контекст события состояния. isAnonymous Указывает, доступно ли содержимое с DRM-шифрованием без запроса учетных данных пользователя для проверки подлинности.Boolean Указывает, доступно ли содержимое с DRM-шифрованием без запроса учетных данных пользователя для проверки подлинности. Если оно доступно, то задается значение true. В противном случае значение — false, и пользователь должен предоставить имя пользователя и пароль, соответствующий тому, который известен поставщику содержимого и ожидается им. isAvailableOffline Указывает, доступно ли содержимое с DRM-шифрованием в автономном режиме.Boolean Указывает, доступно ли содержимое с DRM-шифрованием в автономном режиме. Если оно доступно, то задается значение true. В противном случае значение — false.

Чтобы содержимое с цифровой защитой было доступным в автономном режиме, его ваучер должен быть сохранен в кэше локального компьютера пользователя. (Приложение определяет место локального хранения содержимого, чтобы оно было доступным в автономном режиме.)

isLocal Указывает на то, записывается ли ваучер в кэш-память локального хранилища ваучеров.Boolean Указывает на то, записывается ли ваучер в кэш-память локального хранилища ваучеров. offlineLeasePeriod Оставшееся число дней, в течение которых содержимое можно просматривать в автономном режиме.uint Оставшееся число дней, в течение которых содержимое можно просматривать в автономном режиме. policies Пользовательский объект события состояния DRM.Object Пользовательский объект события состояния DRM. voucherEndDate Абсолютная дата завершения срока действия ваучера, после которой содержимое становится недоступным для просмотра пользователями.Date Абсолютная дата завершения срока действия ваучера, после которой содержимое становится недоступным для просмотра пользователями. voucher Объект DRMVoucher для содержимого.flash.net.drm:DRMVoucher Объект DRMVoucher для содержимого.
AsyncErrorEvent Объект отправляет событие AsyncErrorEvent, когда выдается исключение из собственного асинхронного кода, например из LocalConnection, NetConnection, SharedObject или NetStream.Объекты событий AsyncErrorEvent. flash.events:ErrorEvent Объект отправляет событие AsyncErrorEvent, когда выдается исключение из собственного асинхронного кода, например из LocalConnection, NetConnection, SharedObject или NetStream. Существует только один тип события асинхронной ошибки: ErrorEvent.ERROR. ASYNC_ERRORasyncErrorflash.events:AsyncErrorEvent:ASYNC_ERRORflash.events:AsyncErrorEventAsyncErrorEvent Создает объект AsyncErrorEvent, содержащий информацию о событиях asyncError.typeString Тип события. Прослушиватели событий могут получать эту информацию через унаследованное свойство type. Существует только один тип события ошибки: ErrorEvent.ERROR. bubblesBooleanfalseОпределяет, находится ли объект Event в фазе восходящей цепочки. Прослушиватели событий могут получать эту информацию через унаследованное свойство bubbles. cancelableBooleanfalseОпределяет, можно ли отменить объект Event. Прослушиватели событий могут получать эту информацию через унаследованное свойство cancelable. textStringТекст, отображаемый в качестве сообщения об ошибке. Прослушиватели событий могут получать эту информацию через свойство text. errorErrornullСозданное исключение. Если ошибка не имеет значение null, для свойства errorId события задается значение свойства errorId ошибки. Конструктор для объектов AsyncErrorEvent. Создает объект AsyncErrorEvent, содержащий информацию о событиях asyncError. Объекты AsyncErrorEvent передаются прослушивателям событий в качестве параметров. clone Создает копию объекта AsyncErrorEvent и задает значение каждого свойства, совпадающее с оригиналом.Новый объект AsyncErrorEvent, значения свойств которого соответствуют значениям оригинала. flash.events:Event Создает копию объекта AsyncErrorEvent и задает значение каждого свойства, совпадающее с оригиналом. toString Возвращает строку, содержащую все свойства объекта AsyncErrorEvent.Строка, содержащая все свойства объекта AsyncErrorEvent. String Возвращает строку, содержащую все свойства объекта AsyncErrorEvent. Строка имеет следующий формат:

[AsyncErrorEvent type=value bubbles=value cancelable=value ... error=value errorID=value] Свойство errorId доступно только в Adobe AIR.

ASYNC_ERROR Константа AsyncErrorEvent.ASYNC_ERROR определяет значение свойства type объекта события asyncError.asyncErrorString Константа AsyncErrorEvent.ASYNC_ERROR определяет значение свойства type объекта события asyncError.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено. currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий. targetОбъект, отправляющий событие.errorОшибка, запускаемая событием.
error Выброшенное исключение.Error Выброшенное исключение.
StatusEvent Объект отправляет объект StatusEvent, когда устройство (например, камера или микрофон) или объект (например, объект LocalConnection) сообщает о своем состоянии.Объекты событий StatusEvent. flash.events:Event Объект отправляет объект StatusEvent, когда устройство (например, камера или микрофон) или объект (например, объект LocalConnection) сообщает о своем состоянии. Существует только один тип события состояния: StatusEvent.STATUS. flash.media.Cameraflash.media.Microphoneflash.net.LocalConnectionflash.sensors.Accelerometerflash.sensors.Geolocationair.net.ServiceMonitorstatusflash.events:StatusEvent:STATUSflash.events:StatusEventflash.media.Camera.statusflash.media.Microphone.statusflash.net.LocalConnection.statusflash.net.NetStream.statusflash.sensors.Geolocation.statusflash.sensors.Accelerometer.statusStatusEvent Создает объект Event, содержащий информацию о событиях состояния.typeString Тип события. Прослушиватели событий могут получать эту информацию через унаследованное свойство type. Существует только один тип события состояния: StatusEvent.STATUS. bubblesBooleanfalseОпределяет, участвует ли объект Event в фазе восходящей цепочки потока событий. Прослушиватели событий могут получать эту информацию через унаследованное свойство bubbles. cancelableBooleanfalseОпределяет, можно ли отменить объект Event. Прослушиватели событий могут получать эту информацию через унаследованное свойство cancelable. codeStringОписание состояния объекта. Прослушиватели событий могут получать эту информацию через свойство code. levelStringКатегория сообщения, например status, warning или error. Прослушиватели событий могут получать эту информацию через свойство level. Конструктор для объектов StatusEvent. Создает объект Event, содержащий информацию о событиях состояния. Объекты Event передаются прослушивателям событий в качестве параметров. STATUSclone Создает копию объекта StatusEvent и задает значение каждого свойства, совпадающее с оригиналом.Новый объект StatusEvent, значения свойств которого соответствуют значениям оригинала. flash.events:Event Создает копию объекта StatusEvent и задает значение каждого свойства, совпадающее с оригиналом. toString Возвращает строку, содержащую все свойства объекта StatusEvent.Строка, содержащая все свойства объекта StatusEvent. String Возвращает строку, содержащую все свойства объекта StatusEvent. Строка имеет следующий формат:

[StatusEvent type=value bubbles=value cancelable=value code=value level=value]

STATUS Задает значение свойства type для объекта события Status.statusString Задает значение свойства type для объекта события status.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.codeОписание состояния объекта.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.levelКатегория сообщения, например, status, warning или error.targetОбъект, сообщающий свое состояние.
flash.media.Camera.statusflash.media.Microphone.statusflash.net.LocalConnection.statusflash.net.NetStream.statusflash.sensors.Geolocation.statusflash.sensors.Accelerometer.status
code Описание состояния объекта.String Описание состояния объекта. flash.media.Cameraflash.media.Microphoneflash.net.LocalConnectionlevel Категория сообщения, например status, warning или error.String Категория сообщения, например, status, warning или error. flash.media.Cameraflash.media.Microphoneflash.net.LocalConnection
DRMAuthenticationErrorEvent DRMManager отправляет объект DRMAuthenticationErrorEvent при сбое вызова метода authenticate() объекта DRMManager.flash.events:ErrorEvent DRMManager отправляет объект DRMAuthenticationErrorEvent при сбое вызова метода authenticate() объекта DRMManager. DRMAuthenticationErrorEvent Создает новый экземпляр объекта DRMAuthenticationErrorEvent.typeStringстрока типа события bubblesBooleanfalseвызывает ли событие показ списка отображения cancelableBooleanfalseможно ли отменить событие inDetailStringОписание ошибки inErrorIDint0Идентификатор ошибки общего типа inSubErrorIDint0Идентификатор конкретной ошибки этого типа inServerURLStringnullURL-адрес сервера, на который был выполнен вход inDomainStringnullпроверенный домен сервера, на который был выполнен вход Создает новый экземпляр объекта DRMAuthenticationErrorEvent. clone Создает копию объекта ErrorEvent и задает значение каждого свойства, совпадающее с оригиналом.Новый объект ErrorEvent, значения свойств которого соответствуют значениям оригинала. flash.events:Event Создает копию объекта ErrorEvent и задает значение каждого свойства, совпадающее с оригиналом. AUTHENTICATION_ERROR Строковая константа, используемая для события ошибки аутентификации в параметре type при добавлении и удалении прослушивателей событий.authenticationErrorString Строковая константа, используемая для события ошибки аутентификации в параметре type при добавлении и удалении прослушивателей событий. domain Домен содержимого сервера управления правами доступа.String Домен содержимого сервера управления правами доступа. В данном случае домен не является доменным именем в сети или Интернете. serverURL URL-адрес сервера управления правами доступа к содержимому, отклонившего попытку аутентификации.String URL-адрес сервера управления правами доступа к содержимому, отклонившего попытку аутентификации. subErrorID Более подробный код ошибки.int Более подробный код ошибки. HTMLUncaughtScriptExceptionEvent Объект HTMLLoader отправляет объект HTMLUncaughtScriptExceptionEvent при каждом выбросе исключения JavaScript, не обработанного инструкцией catch.flash.events:Event Объект HTMLLoader отправляет объект HTMLUncaughtScriptExceptionEvent при каждом выбросе исключения JavaScript, не обработанного инструкцией catch. HTMLLoaderuncaughtScriptExceptionflash.events:HTMLUncaughtScriptExceptionEvent:UNCAUGHT_SCRIPT_EXCEPTIONflash.events:HTMLUncaughtScriptExceptionEventHTMLUncaughtScriptExceptionEvent Создает объект HTMLUncaughtScriptExceptionEvent для передачи в качестве параметра прослушивателям событий.exceptionValueКогда процесс JavaScript выдает неперехваченное исключение, exceptionValue представляет собой результат оценки выражения в инструкции throw, полученной в результате неперехваченного исключения. Свойство exceptionValue может быть представлено примитивным значение, ссылкой на объект JavaScript или на объект ActionScript. Создает объект HTMLUncaughtScriptExceptionEvent для передачи в качестве параметра прослушивателям событий. clone Создает копию объекта HTMLUncaughtScriptExceptionEvent и задает значение каждого свойства, совпадающее с оригиналом.Копия объекта HTMLUncaughtScriptExceptionEvent. flash.events:Event Создает копию объекта HTMLUncaughtScriptExceptionEvent и задает значение каждого свойства, совпадающее с оригиналом. UNCAUGHT_SCRIPT_EXCEPTION Константа HTMLUncaughtScriptExceptionEvent.UNCAUGHT_SCRIPT_EXCEPTION определяет значение свойства type для объекта события uncaughtScriptException.uncaughtScriptException Константа HTMLUncaughtScriptExceptionEvent.UNCAUGHT_SCRIPT_EXCEPTION определяет значение свойства type для объекта события uncaughtScriptException.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.exceptionValueРезультат оценки выражения в инструкции throw, полученной в результате неперехваченного исключения.stackTraceМассив объектов, представляющих трассировку стека во время выполнения инструкции throw, полученной в результате неперехваченного исключения.targetОбъект HTMLLoader.
exceptionValue Результат оценки выражения в инструкции throw, полученной в результате неперехваченного исключения. Результат оценки выражения в инструкции throw, полученной в результате неперехваченного исключения. Свойство exceptionValue может быть представлено примитивным значение, ссылкой на объект JavaScript или на объект ActionScript. stackTrace Массив объектов, представляющих трассировку стека во время выполнения инструкции throw, полученной в результате неперехваченного исключения.Array Массив объектов, представляющих трассировку стека во время выполнения инструкции throw, полученной в результате неперехваченного исключения. Каждый объект в массиве имеет три свойства:
  • sourceURL (строка): URL-адрес сценария фрейма списка вызовов.
  • line (число): номер строки в ресурсе sourceURL фрейма списка вызовов.
  • functionName (строка): имя функции для фрейма списка вызовов.
SoftKeyboardEvent Объект SoftKeyboardEvent передается, когда виртуальная клавиатура активируется или деактивируется.SoftKeyboardEvent передается, когда программная клавиатура активируется или деактивируется. flash.events:Event Объект SoftKeyboardEvent передается, когда виртуальная клавиатура активируется или деактивируется.

Объекты SoftKeyboardEvent передаются объектами TextFields и InteractiveObjects, у которых для свойства needsSoftKeyboardзадано значение true.

flash.display. InteractiveObject.needsSoftKeyboardSoftKeyboardEvent Создает объект события, который содержит информацию о событиях активации и деактивации программной клавиатуры.typeString Тип события как устойчивое значение (например, SOFT_KEYBOARD_ACTIVATE). Прослушиватели событий могут получать эту информацию через унаследованное свойство type. bubblesBooleanОпределяет, участвует ли объект Event в фазе восходящей цепочки потока событий. Прослушиватели событий могут получать эту информацию через унаследованное свойство bubbles. cancelableBooleanОпределяет, можно ли отменить объект Event. Прослушиватели событий могут получать эту информацию через унаследованное свойство cancelable. relatedObjectValflash.display:InteractiveObjectСсылка на объект списка отображения, связанный с событием. triggerTypeValStringОбозначает, было ли событие клавиатуры вызвано программой или пользователем. Конструктор для объектов SoftKeyboardEvent. Создает объект события, который содержит информацию о событиях активации и деактивации программной клавиатуры. Объекты Event передаются прослушивателям событий в качестве параметров. clone Создает копию объекта SoftKeyboardEvent и задает значение каждого свойства, совпадающее с оригиналом.Новый объект SoftKeyboardEvent, значения свойств которого соответствуют значениям оригинала. flash.events:EventСоздает копию объекта SoftKeyboardEvent. Создает копию объекта SoftKeyboardEvent и задает значение каждого свойства, совпадающее с оригиналом. toString Возвращает строку, содержащую все свойства объекта SoftKeyboardEvent.Строка, содержащая все свойства объекта SoftKeyboardEvent. String Возвращает строку, содержащую все свойства объекта SoftKeyboardEvent. Используется следующий формат:

[Тип SoftKeyboardEvent =значение пузыри =значение отменяемый =значение relatedObjectVal =значение triggerTypeVal =значение активация =значение]

SOFT_KEYBOARD_ACTIVATE Константа SoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATE определяет значение свойства type объекта SoftKeyboardEvent, передаваемого, когда программная клавиатура выводится на экран.softKeyboardActivateStringПостоянное значение для события, передаваемое после отображения программной клавиатуры. Константа SoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATE определяет значение свойства type объекта SoftKeyboardEvent, передаваемого, когда отображается программная клавиатура.

Событие softKeyboardActivate передается после передачи события softKeyboardActivating и не может быть отменено. Чтобы не допустить отображения виртуальной клавиатуры, отмените событие softKeyboardActivating.

Это событие имеет следующие свойства:

СвойствоЗначениеtypeSOFT_KEYBOARD_ACTIVATEbubblestruecancelablefalse; слишком поздно для отмены.relatedObjectValСсылка на объект списка отображения, связанный с событием.triggerTypeValОбозначает, было ли событие клавиатуры вызвано программой или пользователем.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
SOFT_KEYBOARD_ACTIVATING Константа SoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATING определяет значение свойства type объекта SoftKeyboardEvent, передаваемого непосредственно перед отображением программной клавиатуры.softKeyboardActivatingStringПостоянное значение для события, передаваемое непосредственно перед отображением программной клавиатуры. Константа SoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATING определяет значение свойства type объекта SoftKeyboardEvent, передаваемого непосредственно перед отображением программной клавиатуры. При отмене посредством вызова preventDefault программная клавиатура не открывается.

Это событие имеет следующие свойства:

СвойствоЗначениеtypeSOFT_KEYBOARD_ACTIVATINGbubblestruecancelabletrue; отмена предотвращает открывание клавиатуры.relatedObjectValСсылка на объект списка отображения, связанный с событием.triggerTypeValОбозначает, было ли событие клавиатуры вызвано программой или пользователем.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
SOFT_KEYBOARD_DEACTIVATE Константа SoftKeyboardEvent.SOFT_KEYBOARD_DEACTIVATE определяет значение свойства type объекта SoftKeyboardEvent, передаваемого при переводе на задний план или скрытии программной клавиатуры.softKeyboardDeactivateStringУстойчивое значение для события, отправленного после мягкой клавиатуры, понижено или скрыто. Константа SoftKeyboardEvent.SOFT_KEYBOARD_DEACTIVATE определяет значение свойства type объекта SoftKeyboardEvent, передаваемого при переводе на задний план или скрытии программной клавиатуры.

Это событие имеет следующие свойства:

СвойствоЗначениеtypeSOFT_KEYBOARD_DEACTIVATEbubblestruecancelablefalse; отмена не разрешена.relatedObjectValСсылка на объект списка отображения, связанный с событием.triggerTypeValОбозначает, было ли событие клавиатуры вызвано программой или пользователем.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
relatedObject Ссылка на объект списка отображения, связанный с событием.flash.display:InteractiveObjectСсылка на объект списка отображения, связанный с событием. Ссылка на объект списка отображения, связанный с событием. triggerType Обозначает, было ли изменение в состоянии клавиатуры вызвано программой (например, с программным управлением используют requestSoftKeyboard ()), или пользователем (например, отбор текстового поля).StringИсточник изменения в состоянии клавиатуры. Обозначает, было ли изменение в состоянии клавиатуры вызвано программой (например, с программным управлением используют requestSoftKeyboard ()) или пользователем (например, отбор текстового поля). flash.events. SoftKeyboardTrigger
ProgressEvent Объект ProgressEvent отправляется, если началась операция загрузки или сокет получил данные.Объекты событий ProgressEvent. flash.events:Event Объект ProgressEvent отправляется, если началась операция загрузки или сокет получил данные. Эти события обычно генерируются, когда SWF-файлы, изображения или данные загружаются в приложение. Существует два типа событий прогресса: ProgressEvent.PROGRESS и ProgressEvent.SOCKET_DATA. Кроме того, в среде AIR объекты ProgressEvent отправляются, когда данные передаются или получаются дочерним процессом с помощью класса NativeProcess. В следующем примере используется класс ProgressEventExample, чтобы продемонстрировать использование различных прослушивателей событий при загрузке файла. Для этого выполняются следующие задачи:
  1. Создаются свойства downloadURL и fileName, указывающие местоположение и имя загружаемого файла.
  2. В конструкторе ProgressEventExample создается новый объект FileReference с именем file и передается методу configureListeners().
  3. Затем свойства downloadURL и fileName передаются методу file.download(), который указывает местоположение для загрузки файла.
  4. Метод configureListeners() добавляет семь прослушивателей событий со связанными методами подписчиков:
    1. cancel/cancelHandler() отправляется в случае отмены загрузки;
    2. complete/complereHandler() отправляется по окончании загрузки файла;
    3. ioError/ioErrorHandler() отправляется, если загружаемый файл недоступен.
    4. open/openHandler() отправляется после начала операции загрузки;
    5. progress/progressHandler() отправляется два раза: когда процесс загрузки начинается и когда заканчивается;
    6. securityError/securityErrorHandler отправляется, если параметр безопасности локального воспроизведения не соответствует типу доступа к данным для загружаемого файла (локальный/сетевой); см. примечания ниже;
    7. select/selectHandler() отправляется, когда выбирается загружаемый файл.

Примечания.

  • SWF-файл требуется откомпилировать с установленным для параметра «Безопасность локального воспроизведения» режимом «Доступ только к сетевым файлам».
  • Для реализации данного примера требуется файл с именем SomeFile.pdf.
  • Хотя в этом примере используются все события, доступные для объекта FileReference, в большинстве случаев требуется только та или иная подгруппа..

package { import flash.display.Sprite; import flash.events.*; import flash.net.FileReference; import flash.net.URLRequest; public class ProgressEventExample extends Sprite { private var downloadURL:String = "http://www.[yourDomain].com/SomeFile.pdf"; private var fileName:String = "SomeFile.pdf"; private var file:FileReference; public function ProgressEventExample() { var request:URLRequest = new URLRequest(downloadURL); file = new FileReference(); configureListeners(file); file.download(request, fileName); } private function configureListeners(dispatcher:IEventDispatcher):void { dispatcher.addEventListener(Event.CANCEL, cancelHandler); dispatcher.addEventListener(Event.COMPLETE, completeHandler); dispatcher.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler); dispatcher.addEventListener(Event.OPEN, openHandler); dispatcher.addEventListener(ProgressEvent.PROGRESS, progressHandler); dispatcher.addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler); dispatcher.addEventListener(Event.SELECT, selectHandler); } private function cancelHandler(event:Event):void { trace("cancelHandler: " + event); } private function completeHandler(event:Event):void { trace("completeHandler: " + event); } private function ioErrorHandler(event:IOErrorEvent):void { trace("ioErrorHandler: " + event); } private function openHandler(event:Event):void { trace("openHandler: " + event); } private function progressHandler(event:ProgressEvent):void { var file:FileReference = FileReference(event.target); trace("progressHandler: name=" + file.name + " bytesLoaded=" + event.bytesLoaded + " bytesTotal=" + event.bytesTotal); } private function securityErrorHandler(event:SecurityErrorEvent):void { trace("securityErrorHandler: " + event); } private function selectHandler(event:Event):void { var file:FileReference = FileReference(event.target); trace("selectHandler: name=" + file.name + " URL=" + downloadURL); } } }
Класс FileStreamКласс LoaderInfoКласс Socketprogressflash.events:ProgressEvent:PROGRESSflash.events:ProgressEventflash.display.LoaderInfo.progressflash.media.Sound.progressflash.net.FileReference.progressflash.net.URLLoader.progressflash.net.URLStream.progresssocketDataflash.events:ProgressEvent:SOCKET_DATAflash.events:ProgressEventflash.net.Socket.socketDataerrorDataflash.events:ProgressEvent:STANDARD_ERROR_DATAflash.events:ProgressEventflash.desktop.NativeProcess.standardErrorDataerrorDataflash.events:ProgressEvent:STANDARD_INPUT_PROGRESSflash.events:ProgressEventflash.desktop.NativeProcess.standardInputProgressoutputDataflash.events:ProgressEvent:STANDARD_OUTPUT_DATAflash.events:ProgressEventflash.desktop.NativeProcess.standardOutputDataProgressEvent Создает объект Event, содержащий данные о событиях в ходе работы.typeString Тип события. Возможные значения: ProgressEvent.PROGRESS, ProgressEvent.SOCKET_DATA, ProgressEvent.STANDARD_ERROR_DATA, ProgressEvent.STANDARD_INPUT_PROGRESS и ProgressEvent.STANDARD_OUTPUT_DATA. bubblesBooleanfalse Определяет, участвует ли объект Event в фазе восходящей цепочки потока событий. cancelableBooleanfalseОпределяет, можно ли отменить объект Event. bytesLoadedNumber0Число элементов или байтов, загруженных на момент обработки события прослушивателем. bytesTotalNumber0Общее число элементов или байтов, которые будут получены в случае успешного завершения загрузки. Конструктор для объектов ProgressEvent. Создает объект Event, содержащий данные о событиях в ходе работы. Объекты Event передаются прослушивателям событий в качестве параметров. clone Создает копию объекта ProgressEvent и задает значение каждого свойства, совпадающее с оригиналом.Новый объект ProgressEvent, значения свойств которого соответствуют значениям оригинала. flash.events:Event Создает копию объекта ProgressEvent и задает значение каждого свойства, совпадающее с оригиналом. toString Возвращает строку, содержащую все свойства объекта ProgressEvent.Строка, содержащая все свойства объекта ProgressEvent. String Возвращает строку, содержащую все свойства объекта ProgressEvent. Строка имеет следующий формат:

[ProgressEvent type=value bubbles=value cancelable=value bytesLoaded=value bytesTotal=value]

PROGRESS Задает значение свойства type для объекта события progress.progressString Задает значение свойства type для объекта события progress.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsebytesLoadedЧисло элементов или байтов, загруженных на момент обработки события прослушивателем.bytesTotalОбщее число элементов или байтов, которые в итоге будут получены в случае успешного завершения загрузки.cancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.targetОбъект, сообщающий сведения о прогрессе.
flash.display.LoaderInfo.progressflash.media.Sound.progressflash.net.FileReference.progressflash.net.URLLoader.progressflash.net.URLStream.progress
SOCKET_DATA Задает значение свойства type для объекта события socketData.socketDataString Задает значение свойства type для объекта события socketData.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий событие.bytesLoadedЧисло элементов или байтов, загруженных на момент обработки события прослушивателем.bytesTotal0; это свойство не используется объектами события socketData.targetСокет, сообщающий сведения о прогрессе.
flash.net.Socket.socketData
STANDARD_ERROR_DATA Задает значение свойства type для объекта события standardErrorData.standardErrorDataString Задает значение свойства type для объекта события standardErrorData.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий событие.bytesLoadedЧисло байт данных ошибок, сохраненных в буфере объектом NativeProcessObject.error в результате этого события.bytesTotal0; это свойство не используется объектами события standardErrorData.targetОбъект NativeProcess, сообщающий данные об ошибке.
flash.desktop.NativeProcess.standardErrorData
STANDARD_INPUT_PROGRESS Задает значение свойства type для объекта события standardInputProgress.standardInputProgressString Задает значение свойства type для объекта события standardInputProgress.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий событие.bytesLoadedЧисло байт данных ошибок, сохраненных в буфере объектом NativeProcessObject.error в результате этого события.bytesTotal0; это свойство не используется объектами события standardInputProgress.targetОбъект NativeProcess, сообщающий данные об ошибке.
flash.desktop.NativeProcess.standardInputProgress
STANDARD_OUTPUT_DATA Задает значение свойства type для объекта события standardOutputData.standardOutputDataString Задает значение свойства type для объекта события standardOutputData.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий событие.bytesLoadedЧисло байт данных вывода, сохраненных в буфере объектом NativeProcessObject.output в результате этого события.bytesTotal0; это свойство не используется объектами события standardOutputData.targetОбъект NativeProcess, сообщающий данные вывода.
flash.desktop.NativeProcess.standardOutputData
bytesLoaded Число элементов или байтов, загруженных на момент обработки события прослушивателем.Number Число элементов или байтов, загруженных на момент обработки события прослушивателем. bytesTotal Общее число элементов или байтов, которые будут получены в случае успешного завершения загрузки.Number Общее число элементов или байтов, которые будут получены в случае успешного завершения загрузки. Если событие прогресса отправляется/присоединяется к объекту Socket, свойство bytesTotal будет всегда иметь значение 0, если значение не задано в параметре bytesTotal конструктора. Фактическое число байт, отправляемых в обоих направлениях, не задано и определяется разработчиком приложения.
ShaderEvent Событие ShaderEvent отправляется после завершения выполнения операции затенения, вызванной объектом ShaderJob.flash.events:Event Событие ShaderEvent отправляется после завершения выполнения операции затенения, вызванной объектом ShaderJob. flash.display.ShaderJobcompleteflash.events:ShaderEvent:COMPLETEflash.events:ShaderEventflash.display.ShaderJob.completeShaderEvent Создает объект ShaderEvent для передачи прослушивателям событий.typeStringТип события, доступный в свойстве type. bubblesBooleanfalseОпределяет, участвует ли объект Event в фазе восходящей цепочки потока событий. Значение по умолчанию false. cancelableBooleanfalseОпределяет, можно ли отменить объект Event. Значение по умолчанию false. bitmapflash.display:BitmapDatanullОбъект BitmapData, содержащий результаты выполненной операции (или null, если целевым объектом не являлся объект BitmapData). arrayflash.utils:ByteArraynullОбъект ByteArray, содержащий результаты выполненной операции (или null, если целевым объектом не являлся объект ByteArray). vectornullЭкземпляр Vector.<Number>, содержащий результаты выполненной операции (или null, если целевым объектом не являлся экземпляр Vector.<Number>). Создает объект ShaderEvent для передачи прослушивателям событий. clone Создает копию объекта ShaderEvent и задает значение каждого свойства, совпадающее с оригиналом.Новый объект ShaderEvent, значения свойств которого соответствуют значениям оригинала. flash.events:Event Создает копию объекта ShaderEvent и задает значение каждого свойства, совпадающее с оригиналом. toString Возвращает строку, содержащую все свойства объекта ShaderEvent.Строка, содержащая все свойства объекта ShaderEvent. String Возвращает строку, содержащую все свойства объекта ShaderEvent. Строка имеет следующий формат:

[ShaderEvent type=value bubbles=value cancelable=value eventPhase=value bitmapData=value byteArray=value vector=value]

COMPLETE Задает значение свойства type для объекта события complete.completeString Задает значение свойства type для объекта события complete.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsebitmapDataОбъект BitmapData, содержащий результаты выполненной операции (или null, если целевым объектом не являлся объект BitmapData).byteArrayОбъект ByteArray, содержащий результаты выполненной операции (или null, если целевым объектом не являлся объект ByteArray).cancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.targetОбъект ShaderJob, сообщающий о завершении выполнения задачи.vectorЭкземпляр Vector.<Number>, содержащий результаты выполненной операции (или null, если целевым объектом не являлся экземпляр Vector.<Number>).
flash.display.ShaderJob.complete
bitmapData Объект BitmapData, переданный методу ShaderJob.start().flash.display:BitmapData Объект BitmapData, переданный методу ShaderJob.start(). Если экземпляр ByteArray или Vector.<Number> передан методу start(), это свойство имеет значение null. flash.display.ShaderJob.start()byteArray Объект ByteArray, переданный методу ShaderJob.start().flash.utils:ByteArray Объект ByteArray, переданный методу ShaderJob.start(). Если экземпляр BitmapData или Vector.<Number> передан методу start(), это свойство имеет значение null. flash.display.ShaderJob.start()vector Экземпляр Vector.&lt;Number&gt;, переданный методу ShaderJob.start(). Экземпляр Vector.<Number>, переданный методу ShaderJob.start(). Если объект BitmapData или ByteArray передан методу start(), это свойство имеет значение null. flash.display.ShaderJob.start()
DRMAuthenticationCompleteEvent DRMManager отправляет объект DRMAuthenticationCompleteEvent при успешном вызове метода authenticate() объекта DRMManager.flash.events:Event DRMManager отправляет объект DRMAuthenticationCompleteEvent при успешном вызове метода authenticate() объекта DRMManager. DRMAuthenticationCompleteEvent Создает новый экземпляр объекта DRMAuthenticationCompleteEvent.typeStringстрока типа события bubblesBooleanfalseвызывает ли событие показ списка отображения cancelableBooleanfalseможно ли отменить событие inServerURLStringnullURL-адрес сервера, на который был выполнен вход inDomainStringnullпроверенный домен сервера, на который был выполнен вход inTokenflash.utils:ByteArraynullмаркер аутентификации Создает новый экземпляр объекта DRMAuthenticationCompleteEvent. clone Создает дубликат экземпляра подкласса Event.Новый объект Event, идентичный исходному. flash.events:Event Создает дубликат экземпляра подкласса Event.

Возвращает новый объект Event, являющийся копией исходного экземпляра объекта Event. Обычно метод clone() не вызывается; класс EventDispatcher вызывает его автоматически при повторной отправке события, то есть, при вызове dispatchEvent(event) из обработчика события event.

Новый объект Event включает все свойства исходного.

При создании собственного пользовательского класса Event, необходимо переопределять наследуемый метод Event.clone(), чтобы дублировать свойства пользовательского класса. Если не задать все свойства, добавляемые в ваш подкласс Event, они могут иметь неправильные значения, когда прослушиватели будут обрабатывать повторно отправленное событие.

В данном примере PingEvent является подклассом класса Event и реализует собственную версию clone().

class PingEvent extends Event { var URL:String; public override function clone():Event { return new PingEvent(type, bubbles, cancelable, URL); } }
AUTHENTICATION_COMPLETE Строковая константа, используемая для события authentication complete в параметре type при добавлении и удалении прослушивателей событий.authenticationCompleteString Строковая константа, используемая для события authentication complete в параметре type при добавлении и удалении прослушивателей событий. domain Домен содержимого сервера управления правами доступа.String Домен содержимого сервера управления правами доступа. В данном случае домен не является доменным именем в сети или Интернете. serverURL URL-адрес сервера управления правами доступа к содержимому.String URL-адрес сервера управления правами доступа к содержимому. token Маркер аутентификации.flash.utils:ByteArray Маркер аутентификации.

Аутентификация автоматически добавляется в кэш сеанса DRMManager. Можно сохранить маркер и использовать его для последующей аутентификации пользователя. С помощью метода setAuthenticationToken() объекта DRMManager можно повторно использовать маркер. Срок действия маркера и другие свойства определяются сервером, создавшим маркер.

flash.net.drm.DRMManager.setAuthenticationToken()
AccelerometerEvent Класс Accelerometer отправляет объекты AccelerometerEvent, когда датчик акселерометра, установленный на устройстве, передает обновления ускорения.flash.events:Event Класс Accelerometer отправляет объекты AccelerometerEvent, когда датчик акселерометра, установленный на устройстве, передает обновления ускорения. flash.sensors.Accelerometerupdateflash.events:AccelerometerEvent:UPDATEflash.events:AccelerometerEventAccelerometerEvent Создает объект AccelerometerEvent, который содержит информацию об ускорении вдоль трехмерной оси.typeString Тип события. Прослушиватели событий могут получать эту информацию через унаследованное свойство type. Существует только один тип события обновления: AccelerometerEvent.UPDATE. bubblesBooleanfalseОпределяет, находится ли объект Event в фазе восходящей цепочки. Прослушиватели событий могут получать эту информацию через унаследованное свойство bubbles. cancelableBooleanfalseОпределяет, можно ли отменить объект Event. Прослушиватели событий могут получать эту информацию через унаследованное свойство cancelable. timestampNumber0Метка времени обновления объекта Accelerometer. accelerationXNumber0Значение ускорения в Галах (9,8 м/с2) по оси X. accelerationYNumber0Значение ускорения в Галах (9,8 м/с2) по оси Y. accelerationZNumber0Значение ускорения в Галах (9,8 м/с2) по оси Z. Конструктор для объектов AccelerometerEvent. Создает объект AccelerometerEvent, который содержит информацию об ускорении вдоль трехмерной оси. Объекты Event передаются прослушивателям событий в качестве параметров. clone Создает копию объекта AccelerometerEvent и задает значение каждого свойства, совпадающее с оригиналом.Новый объект AccelerometerEvent, значения свойств которого соответствуют значениям оригинала. flash.events:Event Создает копию объекта AccelerometerEvent и задает значение каждого свойства, совпадающее с оригиналом. toString Возвращает строку, содержащую все свойства объекта AccelerometerEvent.Строка, содержащая все свойства объекта AccelerometerEvent. String Возвращает строку, содержащую все свойства объекта AccelerometerEvent. Используется следующий формат:

[AccelerometerEvent type=value bubbles=value cancelable=value timestamp=value accelerationX=value accelerationY=value accelerationZ=value ]

UPDATE Задает значение свойства type для объекта события AccelerometerEvent.updateString Задает значение свойства type для объекта события AccelerometerEvent.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.timestampМетка времени обновления объекта Accelerometer.accelerationXЗначение ускорения в Галах (9,8 м/с2) по оси X.accelerationYЗначение ускорения в Галах (9,8 м/с2) по оси Y. accelerationZЗначение ускорения в Галах (9,8 м/с2) по оси Z.
accelerationX Ускорение вдоль оси X, измеряется в Галах (Г).Number Ускорение вдоль оси X, измеряется в Галах (Г). (1 Г составляет примерно 9,8 м/с/с.) Ось X направлена слева направо относительно устройства, когда оно находится в вертикальном положении. Ускорение имеет положительное значение, если устройство двигается вправо. accelerationY Ускорение вдоль оси X, измеряется в Галах (Г).Number Ускорение вдоль оси X, измеряется в Галах (Г). (1 Г составляет примерно 9,8 м/с/с.) Ось Y направлена снизу вверх относительно устройства, когда оно находится в вертикальном положении. Ускорение имеет положительное значение, если устройство перемещается вверх относительно этой оси. accelerationZ Ускорение вдоль оси X, измеряется в Галах (Г).Number Ускорение вдоль оси X, измеряется в Галах (Г). (1 Г составляет примерно 9,8 м/с/с.) Ось Z направлена перпендикулярно лицевой стороне устройства. Ускорение имеет положительное значение, если устройство перемещается выше. timestamp Число миллисекунд на момент события начиная с инициализации среды выполнения.Number Число миллисекунд на момент события начиная с инициализации среды выполнения. Например, если устройство захватывает данные акселерометра через 4 секунды после запуска программы, свойство timestamp события будет иметь значение 4000.
IMEEvent Объект IMEEvent отправляется при вводе пользователем текста с помощью редактора методов ввода (IME).Объекты событий IMEEvent. flash.events:TextEvent Объект IMEEvent отправляется при вводе пользователем текста с помощью редактора методов ввода (IME). Редакторы IME, как правило, используются для ввода текста на языках, использующих идеографы вместо букв, таких как японский, китайский и корейский. Существует два события IME: IMEEvent.IME_COMPOSITION и IMEEvent.IME_START_COMPOSITION. flash.system.IMEflash.events.IMEEvent.IME_COMPOSITIONflash.events.IMEEvent.IME_START_COMPOSITIONimeCompositionflash.events:IMEEvent:IME_COMPOSITIONflash.events:IMEEventflash.system.IME.imeCompositionimeCompositionflash.events:IMEEvent:IME_START_COMPOSITIONflash.events:IMEEventflash.system.IME.imeCompositionIMEEvent Создает объект Event со специфической информацией, имеющей отношение к событиям редактора IME.typeString Тип события. Прослушиватели событий могут получать эту информацию через унаследованное свойство type. Существует только одно событие IME: IMEEvent.IME_COMPOSITION. bubblesBooleanfalseОпределяет, участвует ли объект Event в фазе восходящей цепочки потока событий. Прослушиватели событий могут получать эту информацию через унаследованное свойство bubbles. cancelableBooleanfalseОпределяет, можно ли отменить объект Event. Прослушиватели событий могут получать эту информацию через унаследованное свойство cancelable. textStringСтрока считывания из IME. Это начальная строка, введенная пользователем до выбора кандидатов. Конечная строка композиции, переданная объекту, находящемуся в фокусе клавиатуры, в событии TextEvent.TEXT_INPUT. Прослушиватели событий могут получать эту информацию через свойство text. imeClientflash.text.ime:IIMEClientnullНабор обратных вызовов, используемых механизмом визуализации текста для обеспечения связи с IME. Полезно, если код имеет собственный механизм визуализации текста и выполняет визуализацию текста самостоятельно, а не с помощью объектов TextField или TextLayoutFramework. Конструктор для объектов IMEEvent. Создает объект Event со специфической информацией, имеющей отношение к событиям редактора IME. Объекты Event передаются прослушивателям событий в качестве параметров. flash.system.IMEflash.events.IMEEvent.IME_COMPOSITIONflash.events.IMEEvent.IME_START_COMPOSITIONclone Создает копию объекта IMEEvent и задает значение каждого свойства, совпадающее с оригиналом.Новый объект IMEEvent, значения свойств которого соответствуют значениям оригинала. flash.events:Event Создает копию объекта IMEEvent и задает значение каждого свойства, совпадающее с оригиналом. toString Возвращает строку, содержащую все свойства объекта IMEEvent.Строка, содержащая все свойства объекта IMEEvent. String Возвращает строку, содержащую все свойства объекта IMEEvent. Строка имеет следующий формат:

[IMEEvent type=value bubbles=value cancelable=value text=value]

IME_COMPOSITION Задает значение свойства type для объекта события imeComposition.imeCompositionString Задает значение свойства type для объекта события imeComposition.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.targetОбъект IME.
flash.system.IME.imeComposition
IME_START_COMPOSITION Чтобы обработать ввод текста с помощью IME, получатель должен задать для поля imeClient объект, который реализует интерфейс IIMEClient.imeStartCompositionString Чтобы обработать ввод текста с помощью IME, получатель должен задать для поля imeClient объект, который реализует интерфейс IIMEClient. Если для imeClient не задано значение, среда выполнения использует смещенную компоновку IME и отправляет конечную компоновку как событие TEXT_INPUT.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.targetОбъект IME.
flash.system.IME.imeComposition
imeClient Вставляет объект, реализующий интерфейс IMEClient.flash.text.ime:IIMEClient Вставляет объект, реализующий интерфейс IMEClient. Компоненты, основанные на пакете flash.text.engine, должны реализовывать этот интерфейс, чтобы обеспечить поддержку встроенного редактирования текста с помощью IME.
DataEvent Объект отправляет объект DataEvent при завершении загрузки необработанных данных.Объекты событий DataEvent. flash.events:TextEvent Объект отправляет объект DataEvent при завершении загрузки необработанных данных. Существует два типа события данных:
  • DataEvent.DATA: отправляется для отправленных или полученных данных;
  • DataEvent.UPLOAD_COMPLETE_DATA: отправляется, когда данные отправлены и ответил сервер.
В следующем примере создается объект XMLSocket и подключается к серверу сокетов с портом 8080 домена yourDomain. К объекту XMLSocket добавляется прослушиватель событий data, отправляемых при получении необработанных данных.

Примечания.

  • Чтобы генерировать событие securityError в данном примере, необходимо компилировать SWF-файл с настройкой «Безопасность локального воспроизведения» в значении «Доступ только к сети».
  • Потребуется сервер на домене [yourDomain], использующий порт 8080.

package { import flash.display.Sprite; import flash.events.DataEvent; import flash.net.XMLSocket; public class DataEventExample extends Sprite { private var hostName:String = "[yourDomain]"; private var port:uint = 8080; private var socket:XMLSocket; public function DataEventExample() { socket = new XMLSocket(); socket.addEventListener(DataEvent.DATA, dataHandler); socket.connect(hostName, port); } private function dataHandler(event:DataEvent):void { trace("dataHandler: " + event.data); } } }
flash.net.FileReferenceflash.net.XMLSocketdataflash.events:DataEvent:DATAflash.events:DataEventflash.net.XMLSocket.datauploadCompleteDataflash.events:DataEvent:UPLOAD_COMPLETE_DATAflash.events:DataEventflash.net.FileReference.uploadCompleteDataDataEvent Создает объект Event, содержащий информацию о событиях data.typeString Тип события. Прослушиватели событий могут получать эту информацию через унаследованное свойство type. Существует только один тип события данных: DataEvent.DATA. bubblesBooleanfalseОпределяет, участвует ли объект Event в фазе восходящей цепочки потока событий. Прослушиватели событий могут получать эту информацию через унаследованное свойство bubbles. cancelableBooleanfalseОпределяет, можно ли отменить объект Event. Прослушиватели событий могут получать эту информацию через унаследованное свойство cancelable. dataStringНеобработанные данные, загружаемые в Flash Player или Adobe AIR. Прослушиватели событий могут получать эту информацию через свойство data. Конструктор для объектов DataEvent. Создает объект Event, содержащий информацию о событиях data. Объекты Event передаются прослушивателям событий в качестве параметров. flash.net.XMLSocketDataEvent.DATAclone Создает копию объекта DataEvent и задает значение каждого свойства, совпадающее с оригиналом.Новый объект DataEvent, значения свойств которого соответствуют значениям оригинала. flash.events:Event Создает копию объекта DataEvent и задает значение каждого свойства, совпадающее с оригиналом. toString Возвращает строку, содержащую все свойства объекта DataEvent.Строка, содержащая все свойства объекта DataEvent. String Возвращает строку, содержащую все свойства объекта DataEvent. Строка имеет следующий формат:

[DataEvent type=value bubbles=value cancelable=value data=value]

DATA Определяет значение свойства type объекта события data.dataString Определяет значение свойства type объекта события data.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.dataНеобработанные данные, загружаемые в Flash Player или Adobe AIR.targetОбъект XMLSocket, получающий данные.
flash.net.XMLSocket.data
UPLOAD_COMPLETE_DATA Определяет значение свойства type объекта события uploadCompleteData.uploadCompleteDataString Определяет значение свойства type объекта события uploadCompleteData.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.dataНеобработанные данные, возвращенные сервером после успешной отправки файла.targetОбъект FileReference, получающий данные после успешной отправки.
flash.net.FileReference.uploadCompleteData
data Необработанные данные, загружаемые в Flash Player или Adobe AIR.String Необработанные данные, загружаемые в Flash Player или Adobe AIR.
SecurityErrorEvent Объект отправляет объект SecurityErrorEvent, чтобы сообщить об ошибке безопасности.Объекты событий SecurityErrorEvent. flash.events:ErrorEvent Объект отправляет объект SecurityErrorEvent, чтобы сообщить об ошибке безопасности. Ошибки безопасности, о которых сообщается с помощью этого класса, обычно происходят в результате выполнения асинхронных операций, таких как загрузка данных, при которых нарушения политики безопасности могут выявляться в некоторой задержкой. Прослушиватель событий может обратиться к свойству text объекта, чтобы определить, какая предпринималась операция, и вовлеченные URL. Если прослушивателей событий нет, отладочная версия Flash Player или приложение AIR Debug Launcher (ADL) автоматически отображает сообщение об ошибке с содержимым свойства text. Существует один тип события ошибки безопасности: SecurityErrorEvent.SECURITY_ERROR.

События ошибки безопасности — это окончательные события, отправляемые для целевого объекта. Это значит, что для целевого объекта, столкнувшегося с ошибкой безопасности, другие события, включая события общих ошибок, не отправляются.

В следующем примере используется класс SecurityErrorEventExample, чтобы продемонстрировать создание метода прослушивателя securityErrorHandler() и его использование для прослушивания отправляемых событий securityError. Это событие происходит, когда объект URLRequest находится не в том же домене, что и вызывающий SWF-файл, и запрашиваемому домену не предоставлено право доступа с помощью файла политики междоменного доступа.

Чтобы создать SecurityErrorEvent, замените http://www. [yourDomain].com путем, не авторизованным для междоменного доступа.

package { import flash.display.Sprite; import flash.net.URLLoader; import flash.net.URLRequest; import flash.events.SecurityErrorEvent; public class SecurityErrorEventExample extends Sprite { public function SecurityErrorEventExample() { var loader:URLLoader = new URLLoader(); loader.addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler); var request:URLRequest = new URLRequest("http://www.[yourDomain].com"); loader.load(request); } private function securityErrorHandler(event:SecurityErrorEvent):void { trace("securityErrorHandler: " + event); } } }
Класс SecuritySECURITY_ERRORsecurityErrorflash.events:SecurityErrorEvent:SECURITY_ERRORflash.events:SecurityErrorEventflash.net.FileReference.securityErrorflash.net.LocalConnection.securityErrorflash.net.NetConnection.securityErrorflash.net.Socket.securityErrorflash.net.URLLoader.securityErrorflash.net.URLStream.securityErrorflash.net.XMLSocket.securityErrorSecurityErrorEvent Создает объект Event, содержащий сведения о событиях ошибки безопасности.typeStringТип события. Прослушиватели событий могут получать эту информацию через унаследованное свойство type. Существует только один тип события ошибки: SecurityErrorEvent.SECURITY_ERROR. bubblesBooleanfalseОпределяет, участвует ли объект Event в фазе восходящей цепочки потока событий. Прослушиватели событий могут получать эту информацию через унаследованное свойство bubbles. cancelableBooleanfalseОпределяет, можно ли отменить объект Event. Прослушиватели событий могут получать эту информацию через унаследованное свойство cancelable. textStringТекст, отображаемый в качестве сообщения об ошибке. Прослушиватели событий могут получать эту информацию через свойство text. idint0Ссылочный номер, связываемый с конкретной ошибкой. Конструктор для объектов SecurityErrorEvent. Создает объект Event, содержащий сведения о событиях ошибки безопасности. Объекты Event передаются прослушивателям событий в качестве параметров. SECURITY_ERRORclone Создает копию объекта SecurityErrorEvent и задает значение каждого свойства, совпадающее с оригиналом.Новый объект securityErrorEvent, значения свойств которого соответствуют значениям оригинала. flash.events:Event Создает копию объекта SecurityErrorEvent и задает значение каждого свойства, совпадающее с оригиналом. toString Возвращает строку, содержащую все свойства объекта SecurityErrorEvent.Строка, содержащая все свойства объекта SecurityErrorEvent. String Возвращает строку, содержащую все свойства объекта SecurityErrorEvent. Строка имеет следующий формат:

[securityErrorEvent type= value bubbles= value cancelable= value text= value errorID= value ] Свойство errorId доступно только в Adobe AIR.

SECURITY_ERROR Константа SecurityErrorEvent.SECURITY_ERROR определяет значение свойства type для объекта события securityError.securityErrorString Константа SecurityErrorEvent.SECURITY_ERROR определяет значение свойства type для объекта события securityError.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.targetСетевой объект, сообщающий об ошибке безопасности.textТекст, отображаемый в качестве сообщения об ошибке.
flash.net.FileReference.securityErrorflash.net.LocalConnection.securityErrorflash.net.NetConnection.securityErrorflash.net.Socket.securityErrorflash.net.URLLoader.securityErrorflash.net.URLStream.securityErrorflash.net.XMLSocket.securityError
UncaughtErrorEvent Объект UncaughtErrorEvent отправляется экземпляром класса UncaughtErrorEvents при возникновении неперехваченных ошибок.flash.events:ErrorEvent Объект UncaughtErrorEvent отправляется экземпляром класса UncaughtErrorEvents при возникновении неперехваченных ошибок. Неперехваченные ошибки возникают, когда ошибка выдается за пределами блока try..catch или когда отправляется объект ErrorEvent, для которого не зарегистрирован прослушиватель. Функция обработки событий неперехваченных ошибок часто описывается как глобальный обработчик ошибок.

Объект UncaughtErrorEvents, который отправляет событие, связан или с объектом LoaderInfo или с объектом Loader. Используйте следующие свойства, чтобы получить доступ к экземпляру UncaughtErrorEvents.

  • LoaderInfo.uncaughtErrorEvents позволяет обнаружить неперехваченные ошибки в коде, определенном в том же SWF-файле.
  • Loader.uncaughtErrorEvents позволяет обнаружить неперехваченные ошибки в коде, определенном в SWF-файле, который загружен в объекте Loader.

Когда отправляется событие uncaughtError даже в случае обработки события, исключение не сохраняется в стеке вызова, вызвавшем ошибку. Если ошибка является синхронной, оставшийся код функции, в которой возникла ошибка, не выполняется. Следовательно, существует вероятность, что в случае возникновения неперехваченной ошибки приложение будет находиться в нестабильном состоянии. Так как существует много причин возникновения неперехваченных ошибок, невозможно предсказать доступность той или иной функции. Например, приложение может иметь возможность выполнять сетевые операции или операции с файлами. Однако эти операции могут быть недоступными.

Когда один SWF-файл загружает другой, события uncaughtError опускаются по нисходящей цепочке, а затем снова поднимаются по иерархии LoaderInfo. Предположим, что файл A.swf загружает файл B.swf с помощью экземпляра Loader. Если в файле B.swf возникает неперехваченная ошибка, отправляется событие uncaughtError объектам LoaderInfo и Loader в следующей последовательности:

  1. (Фаза захвата) объект LoaderInfo файла A.swf
  2. (Фаза захвата) объект Loader в файле A.swf
  3. (Фаза цели) объект LoaderInfo файла B.swf
  4. (Фаза восходящей цепочки) Loader в файле A.swf
  5. (Фаза восходящей цепочки) объект LoaderInfo файла A.swf

Свойство uncaughtErrorEvents объекта Loader никогда не отправляет события uncaughtErrorEvent в фазе цели. Оно только отправляет события в фазах захвата и восхождения по цепочке.

Как и при восхождении других событий, вызов метода stopPropagation() или stopImmediatePropagation() препятствует отправке события другим прослушивателям, но с одним важным различием. Событие UncaughtErrorEvents объекта Loader рассматривается как пара события LoaderInfo.uncaughtErrorEvents загруженного SWF-файла с целью распространения событий. Если прослушиватель, зарегистрированный для одного из этих событий, вызывает метод stopPropagation(), события все равно отправляются другим прослушивателям, зарегистрированным для этого объекта UncaughtErrorEvents, и для его парного объекта UncaughtErrorEvents, до завершения распространения события. Метод stopImmediatePropagation() все же предотвращает отправку событий всем дополнительным прослушивателям.

Когда содержимое выполняется в отладочной версии среды выполнения, например в отладочной версии Flash Player или AIR Debug Launcher (ADL), при обнаружении неперехваченной ошибки появляется соответствующее диалоговое окно. Для таких сред выполнения диалоговое окно ошибки появляется, даже когда зарегистрирован прослушиватель для события uncaughtError. Чтобы диалоговое окно не появлялось в такой ситуации, нужно вызвать метод preventDefault() объекта UncaughtErrorEvent.

Если содержимое, загруженное объектом Loader, является SWF-файлом версии AVM1 (ActionScript 2), неперехваченные ошибки в этом файле не приводят к отправке события uncaughtError. Кроме того, ошибки JavaScript в HTML-содержимом, загруженном в объекте HTMLLoader (включая элемент управления HTML во Flex), не приводят к отправке события uncaughtError.

Следующий пример демонстрирует использование обработчика для обнаружения неперехваченных ошибок в проекте ActionScript. В примере определяется обработчик событий uncaughtError для обнаружения неперехваченных ошибок. В нем используется кнопка, при нажатии которой выдается ошибка, регистрируемая обработчиком неперехваченных ошибок.

В конструкторе код регистрирует прослушиватель события uncaughtError, отправляемого свойством uncaughtErrorEvents объекта LoaderInfo.

В методе uncaughtErrorHandler() код проверяет тип данных свойства error и реагирует соответствующим образом.

package { import flash.display.Sprite; import flash.events.ErrorEvent; import flash.events.MouseEvent; import flash.events.UncaughtErrorEvent; public class UncaughtErrorEventExample extends Sprite { public function UncaughtErrorEventExample() { loaderInfo.uncaughtErrorEvents.addEventListener(UncaughtErrorEvent.UNCAUGHT_ERROR, uncaughtErrorHandler); drawUI(); } private function uncaughtErrorHandler(event:UncaughtErrorEvent):void { if (event.error is Error) { var error:Error = event.error as Error; // do something with the error } else if (event.error is ErrorEvent) { var errorEvent:ErrorEvent = event.error as ErrorEvent; // do something with the error } else { // a non-Error, non-ErrorEvent type was thrown and uncaught } } private function drawUI():void { var btn:Sprite = new Sprite(); btn.graphics.clear(); btn.graphics.beginFill(0xFFCC00); btn.graphics.drawRect(0, 0, 100, 50); btn.graphics.endFill(); addChild(btn); btn.addEventListener(MouseEvent.CLICK, clickHandler); } private function clickHandler(event:MouseEvent):void { throw new Error("Gak!"); } } }
Ниже приводится такой же пример для Flex, где в качестве корневого содержимого вместо класса ActionScript используется документ MXML. <?xml version="1.0" encoding="utf-8"?> <s:WindowedApplication xmlns:fx="http://ns.adobe.com/mxml/2009" xmlns:s="library://ns.adobe.com/flex/spark" xmlns:mx="library://ns.adobe.com/flex/halo" applicationComplete="applicationCompleteHandler();"> <fx:Script> <![CDATA[ import flash.events.ErrorEvent; import flash.events.MouseEvent; import flash.events.UncaughtErrorEvent; private function applicationCompleteHandler():void { loaderInfo.uncaughtErrorEvents.addEventListener(UncaughtErrorEvent.UNCAUGHT_ERROR, uncaughtErrorHandler); } private function uncaughtErrorHandler(event:UncaughtErrorEvent):void { if (event.error is Error) { var error:Error = event.error as Error; // do something with the error } else if (event.error is ErrorEvent) { var errorEvent:ErrorEvent = event.error as ErrorEvent; // do something with the error } else { // a non-Error, non-ErrorEvent type was thrown and uncaught } } private function clickHandler(event:MouseEvent):void { throw new Error("Gak!"); } ]]> </fx:Script> <s:Button label="Cause Error" click="clickHandler(event);"/> </s:WindowedApplication> Следующий пример демонстрирует использование обработчика для обнаружения неперехваченных ошибок в загруженном SWF-файле. В примере определяется обработчик событий uncaughtError для обнаружения неперехваченных ошибок.

В конструкторе код создает объект Loader и регистрирует прослушиватель события uncaughtError, отправляемого свойством uncaughtErrorEvents объекта Loader.

В методе uncaughtErrorHandler() код проверяет тип данных свойства error и реагирует соответствующим образом.

package { import flash.display.Loader; import flash.display.Sprite; import flash.events.ErrorEvent; import flash.events.UncaughtErrorEvent; import flash.net.URLRequest; public class LoaderUncaughtErrorEventExample extends Sprite { private var ldr:Loader; public function LoaderUncaughtErrorEventExample() { ldr = new Loader(); ldr.load(new URLRequest("child.swf")); ldr.uncaughtErrorEvents.addEventListener(UncaughtErrorEvent.UNCAUGHT_ERROR, uncaughtErrorHandler); } private function uncaughtErrorHandler(event:UncaughtErrorEvent):void { if (event.error is Error) { var error:Error = event.error as Error; // do something with the error } else if (event.error is ErrorEvent) { var errorEvent:ErrorEvent = event.error as ErrorEvent; // do something with the error } else { // a non-Error, non-ErrorEvent type was thrown and uncaught } } } }
LoaderInfo.uncaughtErrorEventsLoader.uncaughtErrorEventsUncaughtErrorEventsuncaughtErrorflash.events:UncaughtErrorEvent:UNCAUGHT_ERRORflash.events:UncaughtErrorEventUncaughtErrorEvent Создает объект UncaughtErrorEvent, который содержит информацию о событии uncaughtError.typeStringunknownТип события. bubblesBooleantrueОпределяет, участвует ли объект Event в фазе восходящей цепочки потока событий. Прослушиватели событий могут получать эту информацию через унаследованное свойство bubbles. cancelableBooleantrueОпределяет, можно ли отменить объект Event. Прослушиватели событий могут получать эту информацию через унаследованное свойство cancelable. error_innullОбъект, связанный с неперехваченной или необработанной ошибкой (при нормальных обстоятельствах это объект Error или ErrorEvent). Конструктор для объектов UncaughtErrorEvent. Создает объект UncaughtErrorEvent, который содержит информацию о событии uncaughtError. clone Создает копию объекта UncaughtErrorEvent и задает значение каждого свойства, совпадающее с оригиналом.Новый объект UncaughtErrorEvent, значения свойств которого соответствуют значениям оригинала. flash.events:Event Создает копию объекта UncaughtErrorEvent и задает значение каждого свойства, совпадающее с оригиналом. toString Возвращает строку, содержащую все свойства объекта UncaughtErrorEvent.Возвращает строку, содержащую все свойства объекта UncaughtErrorEvent. String Возвращает строку, содержащую все свойства объекта UncaughtErrorEvent. UNCAUGHT_ERROR Определяет значение свойства type объекта события uncaughtError.uncaughtErrorString Определяет значение свойства type объекта события uncaughtError.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblestruecancelableимеет значение true; отмена события предотвращает появление диалогового окна о неперехваченной ошибке в отладочных версиях среды выполнения.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.errorНеперехваченная ошибка.targetОбъект LoaderInfo, связанный с SWF-файлом, в котором возникла ошибка.textТекстовое сообщение об ошибке.
error Объект ошибки, связанный с неперехваченной ошибкой. Объект ошибки, связанный с неперехваченной ошибкой. Как правило, этот объект имеет один из следующих типов данных:
  • экземпляр Error (или одного из подклассов), если неперехваченная ошибка является синхронной и создана инструкцией throw, например ошибка, которую можно перехватить с использованием блока try..catch
  • экземпляр ErrorEvent (или одного подклассов), если неперехваченная ошибка является асинхронной и отправляет событие ошибки при возникновении.

Однако свойство error потенциально может быть объектом любого типа данных. ActionScript не требует, чтобы инструкция throw использовалась только с объектами Error. Например, следующий код является верным и во время компиляции и время выполнения.

throw new Sprite()

Если эта инструкция throw не перехватывается блоком try..catch, то инструкция throw отправляет событие uncaughtError. В таком случае свойство error отправляемого объекта UncaughtErrorEvent является объектом Sprite, созданным в инструкции throw.

Следовательно, прослушиватель события uncaughtError должен проверять тип данных свойства error. Следующий пример иллюстрирует такую проверку.

function uncaughtErrorHandler(event:UncaughtErrorEvent):void { var message:String; if (event.error is Error) { message = Error(event.error).message; } else if (event.error is ErrorEvent) { message = ErrorEvent(event.error).text; } else { message = event.error.toString(); } }

Если свойство error содержит экземпляр Error (или подкласса Error), доступная информация об ошибке варьируется в зависимости от версии среды выполнения. Следующая функция доступна, только когда содержимое работает в отладочной версии среды выполнения, например в отладочной версии Flash Player или в AIR Debug Launcher (ADL):

  • метод Error.getStackTrace() служит для получения стека вызова, который стал причиной ошибки. Во всех версиях среды выполнения, кроме отладочных, этот метод возвращает значение null. Обратите внимание, что информация о стеке вызова не бывает доступной, когда свойство error является экземпляром ErrorEvent.
  • Полный текст Error.message. Во всех версиях среды выполнения, кроме отладочных, это свойство содержит короткую версию сообщения об ошибке, которая часто является комбинацией свойств Error.errorID и Error.name.

Все остальные свойства и методы класса Error доступны во всех версиях среды выполнения.

InvokeEvent Объект NativeApplication приложения AIR отправляет событие invoke при вызове приложения.Отправляется объектом NativeApplication, когда приложение AIR вызывается через операционную систему. flash.events:Event Объект NativeApplication приложения AIR отправляет событие invoke при вызове приложения.

Объект NativeApplication всегда отправляет событие invoke при запуске приложения, но событие может отправляться и в других случаях. Например, работающее приложение отправляет дополнительное событие InvokeEvent, когда пользователь активирует файл, связанный с приложением.

Может быть запущен только один экземпляр данного приложения. Последующие попытки запустить приложение приведут к отправке новых событий invoke объекта NativeApplication работающего экземпляра. Приложение отвечает за обработку данного события и выполнение соответствующего действия, например открытия нового окна приложения для отображения данных файла.

Объекты InvokeEvent отправляются объектом NativeApplication (NativeApplication.nativeApplication). Для получения событий invoke необходимо вызвать метод addEventListener() объекта NativeApplication. Когда регистрируется прослушиватель события invoke, он также получает все события invoke, отправленные до регистрации. Эти предшествующие события отправлены после возврата вызова addEventListener(), но не обязательно перед новым событием invoke, которое может быть отправлено после регистрации. Поэтому не следует полагаться на порядок отправки.

flash.events.BrowserInvokeEventflash.desktop.NativeApplicationinvokeflash.events:InvokeEvent:INVOKEflash.events:InvokeEventКонстанта, обозначающая тип, для событий flash.events.InvokeEvent. flash.desktop.NativeApplicationflash.desktop.InvokeEventReasonInvokeEvent Функция конструктора для класса InvokeEvent.typeStringТип события, представленный в виде Event.type. bubblesBooleanfalseИмеет значение false для объекта InvokeEvent. cancelableBooleanfalseИмеет значение false для объекта InvokeEvent. dirflash.filesystem:FilenullКаталог, который должен использоваться для разрешения относительных путей в массиве arguments. argvArraynullМассив аргументов (строк), передаваемых приложению. reasonStringstandardпричиной события является либо InvokeEventReason.LOGIN либо InvokeEventReason.STANDARD. (Этот параметр доступен как в версии AIR 1.5.1.) Функция конструктора для класса InvokeEvent. flash.desktop.InvokeEventReasonclone Создает новую копию данного события.Копия события. flash.events:Event Создает новую копию данного события. INVOKE Константа InvokeEvent.INVOKE определяет значение свойства typeм объекта InvokeEvent.invokeStringКонстанта, обозначающая тип, для событий flash.events.InvokeEvent. Константа InvokeEvent.INVOKE определяет значение свойства type объекта InvokeEvent.

Объект InvokeEvent имеет следующие свойства.

СвойстваЗначенияargumentsМассив строковых аргументов, передаваемых в ходе данного вызова.currentDirectoryОбъект File, представляющий каталог, который должен использоваться для разрешения относительных путей в массиве arguments.reasonКод, обозначающий, было ли отправлено событие вызова из-за автоматического запуска при входе в систему (InvokeEventReason.LOGIN) или по другой причине (InvokeEventReason.STANDARD). Доступно как в версии AIR 1.5.1.bubblesfalse.cancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект InvokeEvent с помощью прослушивателя событий.targetВсегда объект NativeApplication.
flash.desktop.NativeApplicationflash.desktop.InvokeEventReason
arguments Массив строковых аргументов, передаваемых в ходе данного вызова.Array Массив строковых аргументов, передаваемых в ходе данного вызова. Если это вызов из командной строки, массив содержит аргументы командной строки (за исключением имени процесса).

Примечание. Когда несколько файлов выделяются и открываются в Mac® OS X, AIR отправляет одно событие invoke, содержащее имена всех выбранных файлов в массивеarguments. В Windows® и Linux, однако, AIR отправляет отдельное событие invoke для каждого выделенного файла, содержащее только имя этого файла в массиве arguments.

currentDirectory Каталог, который должен использоваться для разрешения относительных путей в массиве arguments.flash.filesystem:File Каталог, который должен использоваться для разрешения относительных путей в массиве arguments.

Если приложение запускается из командной строки, для этого свойства обычно задается текущий рабочий каталог оболочки командной строки, из которой запущено приложение. Если приложение запускается из оболочки графического пользовательского интерфейса, как правило, задается корневой каталог файловой системы.

reason Причина данного InvokeEvent.String Причина данного InvokeEvent. Данное свойство указывает на способ запуска приложения: вручную пользователем или автоматически при входе в систему. Возможные значения перечислены в виде констант в классе InvokeEventReason. Константа InvokeEventReasonЗначениеLOGINАвтоматический запуск при входе в систему.STANDARDЗапуск по какой-либо другой причине. flash.desktop.InvokeEventReason
ScreenMouseEvent Объект SystemTrayIcon отправляет события типа ScreenMouseEvent в ответ на поведение мыши.Объект событий ScreenMouseEvent. flash.events:MouseEvent Объект SystemTrayIcon отправляет события типа ScreenMouseEvent в ответ на поведение мыши.

Объект ScreenMouseEvent расширяет класс MouseEvent, чтобы передать два дополнительных свойства (screenX и screenY), сообщающих координаты мыши относительно главного экрана рабочего стола, а не окна приложения или рабочей области.

flash.desktop.SystemTrayIconflash.display.Screenclickflash.events:ScreenMouseEvent:CLICKflash.events:ScreenMouseEventОтправляется объектом SystemTrayIcon при нажатии значка. mouseDownflash.events:ScreenMouseEvent:MOUSE_DOWNflash.events:ScreenMouseEventmouseUpflash.events:ScreenMouseEvent:MOUSE_UPflash.events:ScreenMouseEventrightClickflash.events:ScreenMouseEvent:RIGHT_CLICKflash.events:ScreenMouseEventrightMouseDownflash.events:ScreenMouseEvent:RIGHT_MOUSE_DOWNflash.events:ScreenMouseEventrightMouseUpflash.events:ScreenMouseEvent:RIGHT_MOUSE_UPflash.events:ScreenMouseEventScreenMouseEvent Создает объект ScreenMouseEvent, содержащий местоположение мыши в системе координат экрана.typeString Тип события. Прослушиватели событий могут получать эту информацию через унаследованное свойство type. bubblesBooleanfalseПоложение по оси Х щелчка мыши в системе координат экрана. cancelableBooleanfalseПоложение по оси Y щелчка мыши в системе координат экрана. screenXNumberunknownИмеет значение false, так как экранные события мыши не имеют фазы восходящей цепочки. screenYNumberunknownИмеет значение false, так как нет поведения по умолчанию для отмены. ctrlKeyBooleanfalseВ Windows или Linux указывает, была ли нажата клавиша Ctrl, когда произошло это событие. В Mac указывает, была нажата клавиша Ctrl или Command. altKeyBooleanfalseИмеет значение true, чтобы показать, что была нажата клавиша Alt, когда произошло событие. shiftKeyBooleanfalseИмеет значение true, чтобы показать, что была нажата клавиша Shift, когда произошло событие. buttonDownBooleanfalseИмеет значение true, чтобы показать, что была нажата кнопка мыши, когда произошло событие. commandKeyBooleanfalseУказывает, была ли нажата клавиша Command (только в Mac). controlKeyBooleanfalseУказывает, была ли нажата клавиша Ctrl или Control. Конструктор для объектов ScreenMouseEvent. Создает объект ScreenMouseEvent, содержащий местоположение мыши в системе координат экрана. flash.events.MouseEventflash.display.Screenclone Создает копию объекта ScreenMouseEvent и задает значение каждого свойства, совпадающее с оригиналом.Новый объект ScreenMouseEvent, значения свойств которого соответствуют значениям оригинала. flash.events:Event Создает копию объекта ScreenMouseEvent и задает значение каждого свойства, совпадающее с оригиналом. toString Возвращает строку, содержащую все свойства объекта ScreenMouseEvent.Строка, содержащая все свойства объекта ScreenMouseEvent. String Возвращает строку, содержащую все свойства объекта ScreenMouseEvent. Строка имеет следующий формат:

[ScreenMouseEvent type=value bubbles=value cancelable=value status=value]

CLICK Константа ScreenMouseEvent.CLICK определяет значение свойства type объекта события click.clickStringОтправляется объектом SystemTrayIcon при нажатии значка. Константа ScreenMouseEvent.CLICK определяет значение свойства type объекта события click.

Данное событие имеет следующие свойства:

СвойствоЗначениеbuttonDowntrue, если нажата основная кнопка мыши; иначе — false.ctrlKeytrue в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.shiftKeytrue, если клавиша Shift активна; иначе — false.commandKeytrue в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows.controlKeytrue, если клавиша Ctrl или Control активна; false, если неактивна.screenXГоризонтальная координата события в координатах экрана.screenYВертикальная координата события в координатах экрана.targetОбъект SystemTrayIcon, находящийся под указывающим устройством.
MOUSE_DOWN Константа ScreenMouseEvent.MOUSE_DOWN определяет значение свойства type объекта события mouseDown.mouseDownString Константа ScreenMouseEvent.MOUSE_DOWN определяет значение свойства type объекта события mouseDown.

Данное событие имеет следующие свойства:

СвойствоЗначениеbuttonDowntrue, если нажата основная кнопка мыши; иначе — false.ctrlKeytrue в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.shiftKeytrue, если клавиша Shift активна; иначе — false.commandKeytrue в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows.controlKeytrue, если клавиша Ctrl или Control активна; false, если неактивна.screenXГоризонтальная координата события в координатах экрана.screenYВертикальная координата события в координатах экрана.targetОбъект SystemTrayIcon, находящийся под указывающим устройством.
MOUSE_UP Константа ScreenMouseEvent.MOUSE_UP определяет значение свойства type объекта события mouseUp.mouseUpString Константа ScreenMouseEvent.MOUSE_UP определяет значение свойства type объекта события mouseUp.

Данное событие имеет следующие свойства:

СвойствоЗначениеbuttonDowntrue, если нажата основная кнопка мыши; иначе — false.ctrlKeytrue в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.shiftKeytrue, если клавиша Shift активна; иначе — false.commandKeytrue в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows.controlKeytrue, если клавиша Ctrl или Control активна; false, если неактивна.screenXГоризонтальная координата события в координатах экрана.screenYВертикальная координата события в координатах экрана.targetОбъект SystemTrayIcon, находящийся под указывающим устройством.
RIGHT_CLICK Константа ScreenMouseEvent.RIGHT_CLICK определяет значение свойства type объекта события rightClick.rightClickString Константа ScreenMouseEvent.RIGHT_CLICK определяет значение свойства type объекта события rightClick.

Данное событие имеет следующие свойства:

СвойствоЗначениеbuttonDowntrue, если нажата основная кнопка мыши; иначе — false.ctrlKeytrue в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.shiftKeytrue, если клавиша Shift активна; иначе — false.commandKeytrue в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows.controlKeytrue, если клавиша Ctrl или Control активна; false, если неактивна.screenXГоризонтальная координата события в координатах экрана.screenYВертикальная координата события в координатах экрана.targetОбъект SystemTrayIcon, находящийся под указывающим устройством.
RIGHT_MOUSE_DOWN Константа ScreenMouseEvent.RIGHT_MOUSE_DOWN определяет значение свойства type объекта события rightMouseDown.rightMouseDownString Константа ScreenMouseEvent.RIGHT_MOUSE_DOWN определяет значение свойства type объекта события rightMouseDown.

Данное событие имеет следующие свойства:

СвойствоЗначениеbuttonDowntrue, если нажата основная кнопка мыши; иначе — false.ctrlKeytrue в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.shiftKeytrue, если клавиша Shift активна; иначе — false.commandKeytrue в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows.controlKeytrue, если клавиша Ctrl или Control активна; false, если неактивна.screenXГоризонтальная координата события в координатах экрана.screenYВертикальная координата события в координатах экрана.targetОбъект SystemTrayIcon, находящийся под указывающим устройством.
RIGHT_MOUSE_UP Константа ScreenMouseEvent.RIGHT_MOUSE_UP определяет значение свойства type объекта события rightMouseUp.rightMouseUpString Константа ScreenMouseEvent.RIGHT_MOUSE_UP определяет значение свойства type объекта события rightMouseUp.

Данное событие имеет следующие свойства:

СвойствоЗначениеbuttonDowntrue, если нажата основная кнопка мыши; иначе — false.ctrlKeytrue в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.shiftKeytrue, если клавиша Shift активна; иначе — false.commandKeytrue в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows.controlKeytrue, если клавиша Ctrl или Control активна; false, если неактивна.screenXГоризонтальная координата события в координатах экрана.screenYВертикальная координата события в координатах экрана.targetОбъект SystemTrayIcon, находящийся под указывающим устройством.
screenX Положение по оси Х щелчка мыши в системе координат экрана.Number Положение по оси Х щелчка мыши в системе координат экрана. screenY Положение по оси Y щелчка мыши в системе координат экрана.Number Положение по оси Y щелчка мыши в системе координат экрана.
ContextMenuEvent Объект InteractiveObject отправляет объект ContextMenuEvent, когда пользователь открывает контекстное меню или взаимодействует с ним.Объекты событий ContextMenuEvent. flash.events:Event Объект InteractiveObject отправляет объект ContextMenuEvent, когда пользователь открывает контекстное меню или взаимодействует с ним. Существует два типа объекта ContextMenuEvent:
  • ContextMenuEvent.MENU_ITEM_SELECT
  • ContextMenuEvent.MENU_SELECT
В следующем примере используется класс ContextMenuEventExample для удаления элементов контекстного меню по умолчанию из рабочей области и добавления нового элемента меню, изменяющего свет квадрата в рабочей области. Для этого выполняются следующие задачи:
  1. Объявляется свойство myContextMenu, которое затем назначается новому объекту ContextMenu, и свойство redRectangle (типа Sprite).
  2. Вызывается метод removeDefaultItems(). Этот метод удаляет все встройнные элементы контекстного меню, кроме «Печать».
  3. Вызывается метод addCustomMenuItems(). Этот метод помещает элемент меню Противоположные цвета в массиве defaultItems с помощью метода push() объекта Array. Для объекта ContextMenuItem добавляется прослушиватель событий menuItemSelect и вызывается соответствующий метод menuItemSelectHandler(). Этот метод печатает несколько выписок trace() при каждом выборе позиции «Противоположные цвета» из контекстного меню. Помимо этого, красный квадрат становится черным, а черный текст - красным.
  4. В конструкторе добавляется прослушиватель событий menuSelect и соответствующий метод menuSelectHandler(), который просто распечатывает три выписки trace() при каждом выборе элемента в контекстном меню.
  5. Конструктор вызывает метод addChildren(), который рисует красный квадрат и добавляет его в список отображения, который сразу показывает квадрат.
  6. В завершение, myContextMenu назначается контекстному меню свойства redRectangle, чтобы пользовательское контекстное меню отображалось, только когда указатель мыши находится над квадратом.
package { import flash.ui.ContextMenu; import flash.ui.ContextMenuItem; import flash.ui.ContextMenuBuiltInItems; import flash.events.ContextMenuEvent; import flash.display.Sprite; import flash.display.Shape; import flash.text.TextField; public class ContextMenuEventExample extends Sprite { private var myContextMenu:ContextMenu; private var menuLabel:String = "Reverse Colors"; private var textLabel:String = "Right Click"; private var redRectangle:Sprite; private var label:TextField; private var size:uint = 100; private var black:uint = 0x000000; private var red:uint = 0xFF0000; public function ContextMenuEventExample() { myContextMenu = new ContextMenu(); removeDefaultItems(); addCustomMenuItems(); myContextMenu.addEventListener(ContextMenuEvent.MENU_SELECT, menuSelectHandler); addChildren(); redRectangle.contextMenu = myContextMenu; } private function addChildren():void { redRectangle = new Sprite(); redRectangle.graphics.beginFill(red); redRectangle.graphics.drawRect(0, 0, size, size); addChild(redRectangle); redRectangle.x = size; redRectangle.y = size; label = createLabel(); redRectangle.addChild(label); } private function removeDefaultItems():void { myContextMenu.hideBuiltInItems(); var defaultItems:ContextMenuBuiltInItems = myContextMenu.builtInItems; defaultItems.print = true; } private function addCustomMenuItems():void { var item:ContextMenuItem = new ContextMenuItem(menuLabel); myContextMenu.customItems.push(item); item.addEventListener(ContextMenuEvent.MENU_ITEM_SELECT, menuItemSelectHandler); } private function menuSelectHandler(event:ContextMenuEvent):void { trace("menuSelectHandler: " + event); } private function menuItemSelectHandler(event:ContextMenuEvent):void { trace("menuItemSelectHandler: " + event); var textColor:uint = (label.textColor == black) ? red : black; var bgColor:uint = (label.textColor == black) ? black : red; redRectangle.graphics.clear(); redRectangle.graphics.beginFill(bgColor); redRectangle.graphics.drawRect(0, 0, size, size); label.textColor = textColor; } private function createLabel():TextField { var txtField:TextField = new TextField(); txtField.text = textLabel; return txtField; } } }
Класс ContextMenuКласс ContextMenuItemmenuItemSelectflash.events:ContextMenuEvent:MENU_ITEM_SELECTflash.events:ContextMenuEventflash.ui.ContextMenuItem.menuItemSelectmenuSelectflash.events:ContextMenuEvent:MENU_SELECTflash.events:ContextMenuEventflash.ui.ContextMenu.menuSelectContextMenuEvent Создает объект Event, содержащий данные о событиях меню.typeString Тип события. Возможные значения:
  • ContextMenuEvent.MENU_ITEM_SELECT
  • ContextMenuEvent.MENU_SELECT
bubblesBooleanfalse Определяет, участвует ли объект Event в фазе восходящей цепочки потока событий. Прослушиватели событий могут получать эту информацию через унаследованное свойство bubbles. cancelableBooleanfalseОпределяет, можно ли отменить объект Event. Прослушиватели событий могут получать эту информацию через унаследованное свойство cancelable. mouseTargetflash.display:InteractiveObjectnullОбъект списка отображения, который пользователь щелкает правой кнопкой мыши для отображения контекстного меню. Это может быть contextMenuOwner или один из его нижестоящих элементов в списке отображения. contextMenuOwnerflash.display:InteractiveObjectnullОбъект списка отображения, к которому присоединено меню. Это может быть mouseTarget или один из его предков в списке отображения. Конструктор для объектов ContextMenuEvent.
Создает объект Event, содержащий данные о событиях меню. Объекты Event передаются прослушивателям событий в качестве параметров.
ContextMenuEvent.MENU_ITEM_SELECTContextMenuEvent.MENU_SELECT
clone Создает копию объекта ContextMenuEvent и задает значение каждого свойства, совпадающее с оригиналом.Новый объект ContextMenuEvent, значения свойств которого соответствуют значениям оригинала. flash.events:Event Создает копию объекта ContextMenuEvent и задает значение каждого свойства, совпадающее с оригиналом. toString Возвращает строку, содержащую все свойства объекта ContextMenuEvent.Строка, содержащая все свойства объекта ContextMenuEvent. String Возвращает строку, содержащую все свойства объекта ContextMenuEvent. Строка имеет следующий формат:

[ContextMenuEvent type=value bubbles=value cancelable=value ... contextMenuOwner=value]

MENU_ITEM_SELECT Определяет значение свойства type объекта события «menuItemSelect».menuItemSelectString Определяет значение свойства type объекта события menuItemSelect.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.contextMenuOwnerОбъект списка отображения, к которому присоединено меню.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.mouseTargetОбъект списка отображения, который пользователь щелкает правой кнопкой мыши для отображения контекстного меню.targetВыбранный объект ContextMenuItem. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент.
flash.ui.ContextMenuItem.menuItemSelect
MENU_SELECT Определяет значение свойства type объекта события menuSelect.menuSelectString Определяет значение свойства type объекта события menuSelect.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.contextMenuOwnerОбъект списка отображения, к которому присоединено меню.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.mouseTargetОбъект списка отображения, который пользователь щелкает правой кнопкой мыши для отображения контекстного меню.targetОбъект ContextMenu, который сейчас будет отображаться. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент.
flash.ui.ContextMenu.menuSelect
contextMenuOwner Объект списка отображения, к которому присоединено меню.flash.display:InteractiveObject Объект списка отображения, к которому присоединено меню. Это может быть цель мыши (mouseTarget) или один из его предков в списке отображения. isMouseTargetInaccessible Указывает на то, было ли свойству mouseTarget присвоено значение null по соображениям безопасности.Boolean Указывает на то, было ли свойству mouseTarget присвоено значение null по соображениям безопасности. Если номинальным значением свойства menuTarget является ссылка на объект DisplayObject в другой изолированной программной среде, свойство menuTarget принимает значение null, пока не будут заданы двусторонние права в границах данной изолированной среды. Права задаются путем вызова метода Security.allowDomain() из SWF-файла или путем указания файла политики на сервере файла изображения и установки флага LoaderContext.checkPolicyFile при загрузке изображения. ContextMenuEvent.mouseTargetSecurity.allowDomain()LoaderContext.checkPolicyFilemouseTarget Объект списка отображения, который пользователь щелкает правой кнопкой мыши для отображения контекстного меню.flash.display:InteractiveObject Объект списка отображения, который пользователь щелкает правой кнопкой мыши для отображения контекстного меню. Это может быть объект списка отображения, к которому прикреплено меню (contextMenuOwner), или один из его потомков в списке отображения.

Это свойство может принимать значение null по двум причинам: отсутствует целевой объект для мыши (например, курсор мыши находится над объектом фона) или существует целевой объект для мыши, но он находится в изолированной среде безопасности, доступ к которой запрещен. Используйте свойство isMouseTargetInaccessible() для определения причины.

ContextMenuEvent.isMouseTargetInaccessible
DRMAuthenticateEvent Объект NetStream отправляет объект DRMAuthenticateEvent при попытке воспроизвести содержимое, зашифрованное с использованием управления цифровыми правами (DRM) и требующее ввода учетных данных пользователя для проверки подлинности.Объекты Event объектов с защитой DRM. flash.events:Event Объект NetStream отправляет объект DRMAuthenticateEvent при попытке воспроизвести содержимое, зашифрованное с использованием управления цифровыми правами (DRM) и требующее ввода учетных данных пользователя для проверки подлинности.

Обработчик DRMAuthenticateEvent отвечает за сбор необходимых учетных данных (имени пользователя, пароля, типа) и передачу значений методу NetStream.setDRMAuthenticationCredentials() для проверки подлинности. Каждое приложение AIR должно предусматривать механизм получения учетных данных пользователя. Например, приложение может открывать простой пользовательский интерфейс для ввода имени пользователя и пароля и, по необходимости, типа.

При неудачной проверке подлинности пользователя приложение попытается проверить подлинность повторно и отправит новое событие DRMAuthenticateEvent для объекта NetStream.

package { import flash.display.Sprite; import flash.events.AsyncErrorEvent; import flash.events.NetStatusEvent; import flash.events.DRMAuthenticateEvent; import flash.media.Video; import flash.net.NetConnection; import flash.net.NetStream; public class DRMAuthenticateEventExample extends Sprite { var videoURL:String = "Video.flv"; var videoConnection:NetConnection; var videoStream:NetStream; var video:Video = new Video(); public function DRMAuthenticateEventExample() { videoConnection = new NetConnection(); videoConnection.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler); videoConnection.connect(null); } private function connectStream():void { videoStream = new NetStream(videoConnection); videoStream.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler); videoStream.addEventListener(AsyncErrorEvent.ASYNC_ERROR, asyncErrorHandler); videoStream.addEventListener(DRMAuthenticateEvent.DRM_AUTHENTICATE, drmAuthenticateEventHandler); video.attachNetStream(videoStream); videoStream.play(videoURL); addChild(video); } private function netStatusHandler(event:NetStatusEvent):void { switch (event.info.code) { case "NetConnection.Connect.Success": connectStream(); break; case "NetStream.Play.StreamNotFound": trace("Unable to locate video: " + videoURL); break; } } private function asyncErrorHandler(event:AsyncErrorEvent):void { // ignore AsyncErrorEvent events. } private function drmAuthenticateEventHandler(event:DRMAuthenticateEvent):void { videoStream.setDRMAuthenticationCredentials("User", "password", "drm"); } } }
DRMAuthenticateEvent.DRM_AUTHENTICATEflash.net.drm.DRMManagerdrmAuthenticateflash.events:DRMAuthenticateEvent:AUTHENTICATION_TYPE_DRMflash.events:DRMAuthenticateEventflash.net.NetStream.drmAuthenticateDRMAuthenticateEvent.authenticationTypedrmAuthenticateflash.events:DRMAuthenticateEvent:AUTHENTICATION_TYPE_PROXYflash.events:DRMAuthenticateEventflash.net.NetStream.drmAuthenticateDRMAuthenticateEvent.authenticationTypedrmAuthenticateflash.events:DRMAuthenticateEvent:DRM_AUTHENTICATEflash.events:DRMAuthenticateEventflash.net.NetStream.drmAuthenticateDRMAuthenticateEvent Создает объект Event, содержащий данные о событиях проверки подлинности DRM.typeString Тип события. Прослушиватели событий могут получать эту информацию через унаследованное свойство type. Существует только один тип события DRMAuthenticate: DRMAuthenticateEvent.DRM_AUTHENTICATE. bubblesBooleanfalseОпределяет, участвует ли объект Event в фазе восходящей цепочки потока событий. Прослушиватели событий могут получать эту информацию через унаследованное свойство bubbles. cancelableBooleanfalseОпределяет, можно ли отменить объект Event. Прослушиватели событий могут получать эту информацию через унаследованное свойство cancelable. headerStringЗаголовок файла с зашифрованным содержимым, передаваемый сервером. userPromptString Запрос имени пользователя, передаваемый сервером. passPromptStringЗапрос пароля пользователя, передаваемый сервером. urlPromptStringЗапрос URL-адреса для отображения, передаваемый сервером. authenticationTypeStringУказывает, должны ли предоставленные учетные данные проверяться сервером Flash Media Rights Management Server (FMRMS) или прокси-сервером. netstreamflash.net:NetStreamnullОбъект NetStream, инициировавший событие. Создает объект Event, содержащий данные о событиях проверки подлинности DRM. Объекты Event передаются прослушивателям событий в качестве параметров. clone Создает копию объекта DRMAuthenticateEvent и задает значение каждого свойства, совпадающее с оригиналом.Новый объект DRMAuthenticateEvent, значения свойств которого соответствуют значениям оригинала. flash.events:Event Создает копию объекта DRMAuthenticateEvent и задает значение каждого свойства, совпадающее с оригиналом. toString Возвращает строку, содержащую все свойства объекта DRMAuthenticateEvent.Строка, содержащая все свойства объекта DRMAuthenticateEvent. String Возвращает строку, содержащую все свойства объекта DRMAuthenticateEvent. Строка имеет следующий формат:

[DRMAuthenticateEvent type=value bubbles=value cancelable=value eventPhase=value header=value usernamePrompt=value passwordPrompt=value urlPrompt=value] authenticationType=value

AUTHENTICATION_TYPE_DRM Константа DRMAuthenticateEvent.AUTHENTICATION_TYPE_DRM определяет значение свойства authenticationType объекта DRMAuthenticateEvent.drmString Константа DRMAuthenticateEvent.AUTHENTICATION_TYPE_DRM определяет значение свойства authenticationType объекта DRMAuthenticateEvent.

Это событие имеет следующие свойства:

СвойствоЗначениеauthenticationTypeУказывает, должны ли предоставленные учетные данные проверяться сервером Flash Media Rights Management Server (FMRMS) или прокси-сервером.bubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.headerЗаголовок файла с зашифрованным содержимым, передаваемый сервером.netstreamОбъект NetStream, инициировавший событие.passwordPromptЗапрос пароля пользователя, передаваемый сервером.targetОбъект NetStream.urlPromptЗапрос URL-адреса для отображения, передаваемый сервером.usernamePromptЗапрос имени пользователя, передаваемый сервером.
flash.net.NetStream.drmAuthenticateDRMAuthenticateEvent.authenticationType
AUTHENTICATION_TYPE_PROXY Константа DRMAuthenticateEvent.AUTHENTICATION_TYPE_PROXY определяет значение свойства authenticationType объекта DRMAuthenticateEvent.proxyString Константа DRMAuthenticateEvent.AUTHENTICATION_TYPE_PROXY определяет значение свойства authenticationType объекта DRMAuthenticateEvent.

Это событие имеет следующие свойства:

СвойствоЗначениеauthenticationTypeУказывает, должны ли предоставленные учетные данные проверяться сервером Flash Media Rights Management Server (FMRMS) или прокси-сервером.bubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.headerЗаголовок файла с зашифрованным содержимым, передаваемый сервером.netstreamОбъект NetStream, инициировавший событие.passwordPromptЗапрос пароля пользователя, передаваемый сервером.targetОбъект NetStream.urlPromptЗапрос URL-адреса для отображения, передаваемый сервером.usernamePromptЗапрос имени пользователя, передаваемый сервером.
flash.net.NetStream.drmAuthenticateDRMAuthenticateEvent.authenticationType
DRM_AUTHENTICATE Константа DRMAuthenticateEvent.DRM_AUTHENTICATE определяет значение свойства type объекта DRMAuthenticateEvent.drmAuthenticateString Константа DRMAuthenticateEvent.DRM_AUTHENTICATE определяет значение свойства type объекта DRMAuthenticateEvent.

Это событие имеет следующие свойства:

СвойствоЗначениеauthenticationTypeУказывает, должны ли предоставленные учетные данные проверяться сервером Flash Media Rights Management Server (FMRMS) или прокси-сервером.bubblesfalsecancelablefalse; нет поведения по умолчанию для отмены.headerЗаголовок файла с зашифрованным содержимым, передаваемый сервером.netstreamОбъект NetStream, инициировавший событие.passwordPromptЗапрос пароля пользователя, передаваемый сервером.targetОбъект NetStream.urlPromptЗапрос URL-адреса для отображения, передаваемый сервером.usernamePromptЗапрос имени пользователя, передаваемый сервером.
flash.net.NetStream.drmAuthenticate
authenticationType Указывает, должны ли предоставленные учетные данные проверяться сервером Flash Media Rights Management Server (FMRMS) или прокси-сервером.String Указывает, должны ли предоставленные учетные данные проверяться сервером Flash Media Rights Management Server (FMRMS) или прокси-сервером. Например, вариант proxy позволяет приложению выполнять проверку подлинности на прокси-сервере, если организация требует от пользователя выполнения этого шага перед выходом в Интернет. Если не используется анонимная проверка подлинности, то после проверки подлинности на прокси-сервере пользователю все равно нужно пройти авторизацию FMRMS, чтобы получить ваучер и воспроизвести содержимое. Метод setDRMAuthenticationcredentials() можно использовать во второй раз с параметром drm для проверки подлинности FMRMS. header Заголовок файла с зашифрованным содержимым, передаваемый сервером.String Заголовок файла с зашифрованным содержимым, передаваемый сервером. Содержит информацию о контексте зашифрованного содержимого. netstream Объект NetStream, инициировавший событие.flash.net:NetStream Объект NetStream, инициировавший событие. passwordPrompt Запрос пароля пользователя, передаваемый сервером.String Запрос пароля пользователя, передаваемый сервером. Строка может содержать инструкции для типа запрашиваемого пароля. urlPrompt Запрос строки URL-адреса, представленного сервером.String Запрос строки URL-адреса, предоставленного сервером. В строке может указываться местоположение, куда будут отправлены имя пользователя и пароль. usernamePrompt Запрос имени пользователя, передаваемый сервером.String Запрос имени пользователя, передаваемый сервером. Строка может содержать инструкции для типа запрашиваемого имени пользователя. Например, поставщик содержимого может запросить в качестве имени пользователя электронный адрес.
StorageVolumeChangeEvent Объект StorageVolumeInfo.storageVolumeInfo отправляет объект StorageVolumeChangeEvent, когда устанавливается или извлекается том хранения.flash.events:Event Объект StorageVolumeInfo.storageVolumeInfo отправляет объект StorageVolumeChangeEvent, когда устанавливается или извлекается том хранения. Существует два типа события StorageVolumeChangeEvent: storageVolumeMount и storageVolumeUnmount.

В ОС Linux объект StorageVolumeInfo отправляет события storageVolumeMount и storageVolumeUnmount только для физических устройств. Он не отправляет события, когда пользователь устанавливает или извлекает сетевые тома.

Некоторые устройства, например некоторые цифровые камеры и телефоны, отображаются в массиве StorageVolumeInfo.getStorageVolumes(), но не отправляют объекты StorageVolumeChangeEvent при установке или извлечении.

flash.filesystem.StorageVolumeInfostorageVolumeMountflash.events:StorageVolumeChangeEvent:STORAGE_VOLUME_MOUNTflash.events:StorageVolumeChangeEventflash.filesystem.StorageVolumeInfostorageVolumeUnountflash.events:StorageVolumeChangeEvent:STORAGE_VOLUME_UNMOUNTflash.events:StorageVolumeChangeEventflash.filesystem.StorageVolumeInfoStorageVolumeChangeEvent Создает объект StorageVolumeChangeEvent для передачи в качестве аргумента прослушивателям событий.typeString Тип события, доступный в свойстве type. Класс StorageVolumeChangeEvent определяет два типа событий: событие storageVolumeMount, представленное константой StorageVolumeChangeEvent.STORAGE_VOLUME_MOUNT, и событие storageVolumeUnmount, представленное константой StorageVolumeChangeEvent.STORAGE_VOLUME_UNMOUNT. bubblesBooleanfalse Определяет, участвует ли объект Event в фазе восходящей цепочки потока событий. Значение по умолчанию false. cancelableBooleanfalseОпределяет, может ли объект Event быть отменен. Значение по умолчанию false. pathflash.filesystem:FilenullИмя тома хранения. volumeflash.filesystem:StorageVolumenullОбъект File, представляющий том хранения. Используется для создания нового объекта StorageVolumeChangeEvent. Создает объект StorageVolumeChangeEvent для передачи в качестве аргумента прослушивателям событий. flash.errors.SQLErrorflash.events.ErrorEvent.ERRORclone Создает дубликат экземпляра подкласса Event.Новый объект Event, идентичный исходному. flash.events:Event Создает дубликат экземпляра подкласса Event.

Возвращает новый объект Event, являющийся копией исходного экземпляра объекта Event. Обычно метод clone() не вызывается; класс EventDispatcher вызывает его автоматически при повторной отправке события, то есть, при вызове dispatchEvent(event) из обработчика события event.

Новый объект Event включает все свойства исходного.

При создании собственного пользовательского класса Event, необходимо переопределять наследуемый метод Event.clone(), чтобы дублировать свойства пользовательского класса. Если не задать все свойства, добавляемые в ваш подкласс Event, они могут иметь неправильные значения, когда прослушиватели будут обрабатывать повторно отправленное событие.

В данном примере PingEvent является подклассом класса Event и реализует собственную версию clone().

class PingEvent extends Event { var URL:String; public override function clone():Event { return new PingEvent(type, bubbles, cancelable, URL); } }
toString Возвращает строку, содержащую все свойства объекта Event.Строка, содержащая все свойства объекта Event. String Возвращает строку, содержащую все свойства объекта Event. Строка имеет следующий формат:

[Event type=value bubbles=value cancelable=value]

STORAGE_VOLUME_MOUNT Константа StorageVolumeChangeEvent.VOLUME_MOUNT определяет значение свойства type объекта StorageVolumeChangeEvent при установке тома хранения.storageVolumeMountString Константа StorageVolumeChangeEvent.VOLUME_MOUNT определяет значение свойства type объекта StorageVolumeChangeEvent при установке тома хранения.

Объект события имеет следующие свойства.

СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект StorageVolumeChangeEvent.fileОбъект File, представляющий том хранения.nameИмя тома хранения.targetОбъект StorageVolumeChangeEvent.type"storageVolumeMount"
flash.filesystem.StorageVolumeInfo
STORAGE_VOLUME_UNMOUNT Константа StorageVolumeChangeEvent.VOLUME_MOUNT определяет значение свойства type объекта StorageVolumeChangeEvent при извлечении тома хранения.storageVolumeUnmountString Константа StorageVolumeChangeEvent.VOLUME_MOUNT определяет значение свойства type объекта StorageVolumeChangeEvent при извлечении тома хранения.

Объект события имеет следующие свойства.

СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект StorageVolumeChangeEvent.fileОбъект File, представляющий том хранения.nameИмя тома хранения.targetОбъект StorageVolumeChangeEvent.type"storageVolumeUnmount"
flash.filesystem.StorageVolumeInfo
rootDirectory Объект File, соответствующий корневому каталогу установленного тома.flash.filesystem:File Объект File, соответствующий корневому каталогу установленного тома. Если том извлечен (если событие имеет тип storageVolumeUnmount), это свойство имеет значение null. flash.filesystem.FilestorageVolume Объект StorageVolume, содержащий информацию об установленном томе.flash.filesystem:StorageVolume Объект StorageVolume, содержащий информацию об установленном томе. Это свойство имеет значение null в случае извлечения тома (для события storageVolumeUnmount). flash.filesystem.StorageVolume
SQLEvent Adobe AIR отправляет объекты SQLEvent, когда успешно завершается одна из операций, выполняемая экземпляром SQLConnection или SQLStatement.flash.events:Event Adobe AIR отправляет объекты SQLEvent, когда успешно завершается одна из операций, выполняемая экземпляром SQLConnection или SQLStatement. flash.data.SQLConnectionflash.data.SQLStatementanalyzeflash.events:SQLEvent:ANALYZEflash.events:SQLEventflash.data.SQLConnection.analyze()attachflash.events:SQLEvent:ATTACHflash.events:SQLEventflash.data.SQLConnection.attach()beginflash.events:SQLEvent:BEGINflash.events:SQLEventflash.data.SQLConnection.begin()cancelflash.events:SQLEvent:CANCELflash.events:SQLEventflash.data.SQLConnection.cancel()closeflash.events:SQLEvent:CLOSEflash.events:SQLEventflash.data.SQLConnection.close()commitflash.events:SQLEvent:COMMITflash.events:SQLEventflash.data.SQLConnection.commit()compactflash.events:SQLEvent:COMPACTflash.events:SQLEventflash.data.SQLConnection.compact()deanalyzeflash.events:SQLEvent:DEANALYZEflash.events:SQLEventflash.data.SQLConnection.deanalyze()detachflash.events:SQLEvent:DETACHflash.events:SQLEventflash.data.SQLConnection.detach()openflash.events:SQLEvent:OPENflash.events:SQLEventflash.data.SQLConnection.open()flash.data.SQLConnection.openAsync()reencryptflash.events:SQLEvent:REENCRYPTflash.events:SQLEventflash.data.SQLConnection.reencrypt()releaseSavepointflash.events:SQLEvent:RELEASE_SAVEPOINTflash.events:SQLEventflash.data.SQLConnection.releaseSavepoint()resultflash.events:SQLEvent:RESULTflash.events:SQLEventflash.data.SQLStatement.execute()flash.data.SQLStatement.next()flash.data.SQLStatement.getResult()rollbackToSavepointflash.events:SQLEvent:ROLLBACK_TO_SAVEPOINTflash.events:SQLEventflash.data.SQLConnection.rollbackToSavepoint()rollbackflash.events:SQLEvent:ROLLBACKflash.events:SQLEventflash.data.SQLConnection.rollback()schemaflash.events:SQLEvent:SCHEMAflash.events:SQLEventflash.data.SQLConnection.loadSchema()setSavepointflash.events:SQLEvent:SET_SAVEPOINTflash.events:SQLEventflash.data.SQLConnection.setSavepoint()SQLEvent Создает объект SQLEvent для передачи в качестве параметра прослушивателям событий.typeString Тип события, доступный в свойстве type. bubblesBooleanfalse Определяет, участвует ли объект Event в фазе восходящей цепочки потока событий. Значение по умолчанию false. cancelableBooleanfalseОпределяет, можно ли отменить объект Event. Значение по умолчанию false. Используется для создания нового объекта SQLEvent. Создает объект SQLEvent для передачи в качестве параметра прослушивателям событий. clone Создает копию объекта SQLEvent и задает значение каждого свойства, совпадающее с оригиналом.Новый объект SQLEvent, значения свойств которого соответствуют значениям оригинала. flash.events:Event Создает копию объекта SQLEvent и задает значение каждого свойства, совпадающее с оригиналом. ANALYZE Константа SQLEvent.ANALYZE определяет значение свойства type объекта события analyze.analyzeString Константа SQLEvent.ANALYZE определяет значение свойства type объекта события analyze. Этот тип события отправляется, когда успешно завершается выполнение метода SQLConnection.analyze(). Объект события analyze имеет следующие свойства: СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.targetОбъект SQLConnection, выполнивший операцию. flash.data.SQLConnection.analyze()ATTACH Константа SQLEvent.ATTACH определяет значение свойства type объекта события Attach.attachString Константа SQLEvent.ATTACH определяет значение свойства type объекта события attach. Этот тип события отправляется, когда успешно завершается выполнение метода SQLConnection.attach(). Объект события attach имеет следующие свойства. СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.targetОбъект SQLConnection, выполнивший операцию. flash.data.SQLConnection.attach()BEGIN Константа SQLEvent.BEGIN определяет значение свойства type объекта события begin.beginString Константа SQLEvent.BEGIN определяет значение свойства type объекта события begin. Этот тип события отправляется, когда успешно завершается выполнение метода SQLConnection.begin(). Объект события begin имеет следующие свойства. СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.targetОбъект SQLConnection, выполнивший операцию. flash.data.SQLConnection.begin()CANCEL Константа SQLEvent.CANCEL определяет значение свойства type объекта события cancel.cancelString Константа SQLEvent.CANCEL определяет значение свойства type объекта события cancel. Этот тип события отправляется, когда успешно завершается выполнение метода SQLConnection.cancel(). Объект события cancel имеет следующие свойства. СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.targetОбъект SQLConnection или SQLStatement, выполнивший операцию. flash.data.SQLConnection.cancel()CLOSE Константа SQLEvent.CLOSE определяет значение свойства type объекта события close.closeString Константа SQLEvent.CLOSE определяет значение свойства type объекта события close. Этот тип события отправляется, когда успешно завершается выполнение метода SQLConnection.close(). Объект события close имеет следующие свойства. СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.targetОбъект SQLConnection, выполнивший операцию. flash.data.SQLConnection.close()COMMIT Константа SQLEvent.COMMIT определяет значение свойства type объекта события commit.commitString Константа SQLEvent.COMMIT определяет значение свойства type объекта события commit. Этот тип события отправляется, когда успешно завершается выполнение метода SQLConnection.commit(). Объект события commit имеет следующие свойства. СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.targetОбъект SQLConnection, выполнивший операцию. flash.data.SQLConnection.commit()COMPACT Константа SQLEvent.COMPACT определяет значение свойства type объекта события compact.compactString Константа SQLEvent.COMPACT определяет значение свойства type объекта события compact. Этот тип события отправляется, когда успешно завершается выполнение метода SQLConnection.compact(). Объект события compact имеет следующие свойства. СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.targetОбъект SQLConnection, выполнивший операцию. flash.data.SQLConnection.compact()DEANALYZE Константа SQLEvent.DEANALYZE определяет значение свойства type объекта события deanalyze.deanalyzeString Константа SQLEvent.DEANALYZE определяет значение свойства type объекта события deanalyze. Этот тип события отправляется, когда успешно завершается выполнение метода SQLConnection.deanalyze(). Объект события deanalyze имеет следующие свойства. СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.targetОбъект SQLConnection, выполнивший операцию. flash.data.SQLConnection.deanalyze()DETACH Константа SQLEvent.DETACH определяет значение свойства type объекта события detach.detachString Константа SQLEvent.DETACH определяет значение свойства type объекта события detach. Этот тип события отправляется, когда успешно завершается выполнение метода SQLConnection.detach(). СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.targetОбъект SQLConnection, выполнивший операцию. flash.data.SQLConnection.detach()OPEN Константа SQLEvent.OPEN определяет значение свойства type объекта события open.openString Константа SQLEvent.OPEN определяет значение свойства type объекта события open. Этот тип события отправляется, когда успешно завершается выполнение метода SQLConnection.open() или SQLConnection.openAsync() Объект события open имеет следующие свойства. СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.targetОбъект SQLConnection, выполнивший операцию. flash.data.SQLConnection.open()flash.data.SQLConnection.openAsync()REENCRYPT Константа SQLEvent.REENCRYPT определяет значение свойства type объекта события reencrypt.reencryptString Константа SQLEvent.REENCRYPT определяет значение свойства type объекта события reencrypt. Событие этого типа отправляется при успешном завершении вызова метода SQLConnection.reencrypt(). Событие reencrypt имеет следующие свойства: СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.targetОбъект SQLConnection, выполнивший операцию. flash.data.SQLConnection.reencrypt()RELEASE_SAVEPOINT Константа SQLEvent.RELEASE_SAVEPOINT определяет значение свойства type объекта события releaseSavepoint.releaseSavepointString Константа SQLEvent.RELEASE_SAVEPOINT определяет значение свойства type объекта события releaseSavepoint. Этот тип события отправляется, когда успешно завершается выполнение метода SQLConnection.releaseSavepoint(). Объект события releaseSavepoint имеет следующие свойства. СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.targetОбъект SQLConnection, выполнивший операцию. flash.data.SQLConnection.releaseSavepoint()RESULT Константа SQLEvent.RESULT определяет значение свойства type объекта события result.resultString Константа SQLEvent.RESULT определяет значение свойства type объекта события result. Отправляется, когда успешно завершается выполнение метода SQLStatement.execute() или SQLStatement.next() После отправки события SQLEvent.RESULT можно вызвать метод SQLStatement.getResult() для просмотра результатов. Объект события result имеет следующие свойства. СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.targetОбъект SQLStatement, выполнивший операцию. flash.data.SQLStatement.execute()flash.data.SQLStatement.next()flash.data.SQLStatement.getResult()ROLLBACK_TO_SAVEPOINT Константа SQLEvent.ROLLBACK_TO_SAVEPOINT определяет значение свойства type объекта события rollbackToSavepoint.rollbackToSavepointString Константа SQLEvent.ROLLBACK_TO_SAVEPOINT определяет значение свойства type объекта события rollbackToSavepoint. Этот тип события отправляется, когда успешно завершается выполнение метода SQLConnection.rollbackToSavepoint(). Объект события rollbackToSavepoint имеет следующие свойства. СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.targetОбъект SQLConnection, выполнивший операцию. flash.data.SQLConnection.rollbackToSavepoint()ROLLBACK Константа SQLEvent.ROLLBACK определяет значение свойства type объекта события rollback.rollbackString Константа SQLEvent.ROLLBACK определяет значение свойства type объекта события rollback. Этот тип события отправляется, когда успешно завершается выполнение метода SQLConnection.rollback(). Объект события rollback имеет следующие свойства. СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.targetОбъект SQLConnection, выполнивший операцию. flash.data.SQLConnection.rollback()SCHEMA Константа SQLEvent.SCHEMA определяет значение свойства type объекта события schema.schemaString Константа SQLEvent.SCHEMA определяет значение свойства type объекта события schema. Отправляется, когда успешно завершается выполнение метода SQLConnection.loadSchema(). После отправки события SQLEvent.SCHEMA можно вызвать метод SQLConnection.getSchemaResult() для получения данных схемы. Объект события schema имеет следующие свойства: СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.targetОбъект SQLConnection, выполнивший операцию. flash.data.SQLConnection.loadSchema()SET_SAVEPOINT Константа SQLEvent.SET_SAVEPOINT определяет значение свойства type объекта события setSavepoint.setSavepointString Константа SQLEvent.SET_SAVEPOINT определяет значение свойства type объекта события setSavepoint. Этот тип события отправляется, когда успешно завершается выполнение метода SQLConnection.setSavepoint(). Объект события setSavepoint имеет следующие свойства. СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.targetОбъект SQLConnection, выполнивший операцию. flash.data.SQLConnection.setSavepoint()DRMErrorEvent Класс DRMErrorEvent предоставляет информацию об ошибках, которые происходят при воспроизведении файлов, защищенных DRM-шифрованием.Объекты Event объектов с защитой DRM. flash.events:ErrorEvent Класс DRMErrorEvent предоставляет информацию об ошибках, которые происходят при воспроизведении файлов, защищенных DRM-шифрованием.

Среда выполнения отправляет объект DRMErrorEvent, когда объект NetStream пытается воспроизвести файл с DRM-шифрованием и сталкивается с ошибкой, связанной с управлением цифровыми правами (DRM). Например, объект DRMErrorEvent отправляется, когда поставщик содержимого не поддерживает приложение для просмотра или когда пользователь не может пройти авторизацию, возможно, потому что не приобрел права доступа к содержимому.

Если используются недействительные учетные данные пользователя, объект DRMAuthenticateEvent обрабатывает ошибку путем многократной отправки события, пока пользователь не введет правильные учетные данные или пока приложение не отклонит последующие попытки. Приложение должно прослушивать все остальные события ошибок DRM, чтобы выявлять, распознавать и обрабатывать ошибки, имеющие отношения к DRM.

Этот класс содержит свойства, содержащие объект, выдавший исключение, код ошибки и, если применимо, дополнительный код ошибки, а также текстовое сообщение, содержащее информацию об ошибке. Описание кодов ошибок, связанных с DRM, см. в разделе Коды ошибок во время выполнения. Коды ошибок, связанных с DRM, начинаются с ошибки 3300.

package { import flash.display.Sprite; import flash.events.AsyncErrorEvent; import flash.events.NetStatusEvent; import flash.events.DRMErrorEvent; import flash.media.Video; import flash.net.NetConnection; import flash.net.NetStream; public class DRMVideoExample extends Sprite { var videoURL:String = "Video.flv"; var videoConnection:NetConnection; var videoStream:NetStream; var video:Video = new Video(); public function DRMVideoExample() { videoConnection = new NetConnection(); videoConnection.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler); videoConnection.connect(null); } private function connectStream():void { videoStream = new NetStream(videoConnection); videoStream.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler); videoStream.addEventListener(AsyncErrorEvent.ASYNC_ERROR, asyncErrorHandler); videoStream.addEventListener(DRMErrorEvent.DRM_ERROR, drmErrorEventHandler); video.attachNetStream(videoStream); videoStream.play(videoURL); addChild(video); } private function netStatusHandler(event:NetStatusEvent):void { switch (event.info.code) { case "NetConnection.Connect.Success": connectStream(); break; case "NetStream.Play.StreamNotFound": trace("Unable to locate video: " + videoURL); break; } } private function asyncErrorHandler(event:AsyncErrorEvent):void { // ignore AsyncErrorEvent events. } private function drmErrorEventHandler(event:DRMErrorEvent):void { trace(event.toString()); } } }
flash.net.NetStreamDRMErrorEvent.DRM_ERRORКоды ошибок во время выполненияdrmErrorflash.events:DRMErrorEvent:DRM_ERRORflash.events:DRMErrorEventflash.net.NetStream.drmErrorDRMErrorEvent Создает объект Event, содержащий данные о событиях ошибок DRM.typeStringunknown Тип события. Прослушиватели событий могут получать эту информацию через унаследованное свойство type. Существует только один тип события DRMAuthenticate: DRMAuthenticateEvent.DRM_AUTHENTICATE. bubblesBooleanfalseОпределяет, участвует ли объект Event в фазе восходящей цепочки потока событий. Прослушиватели событий могут получать эту информацию через унаследованное свойство bubbles. cancelableBooleanfalseОпределяет, можно ли отменить объект Event. Прослушиватели событий могут получать эту информацию через унаследованное свойство cancelable. inErrorDetailStringКонкретные синтаксические сведения об ошибке, если это применимо. inErrorCodeint0Основной код ошибки. insubErrorIDint0Второстепенный идентификатор ошибки. inMetadataflash.net.drm:DRMContentDatanullinSystemUpdateNeededBooleanfalseinDrmUpdateNeededBooleanfalse Создает объект Event, содержащий данные о событиях ошибок DRM. Объекты Event передаются прослушивателям событий в качестве параметров. clone Создает копию объекта DRMErrorEvent и задает значение каждого свойства, совпадающее с оригиналом.Новый объект DRMErrorEvent, значения свойств которого соответствуют значениям оригинала. flash.events:Event Создает копию объекта DRMErrorEvent и задает значение каждого свойства, совпадающее с оригиналом. toString Возвращает строку, содержащую все свойства объекта DRMErrorEvent.Строка, содержащая все свойства объекта DRMErrorEvent. String Возвращает строку, содержащую все свойства объекта DRMErrorEvent. Строка имеет следующий формат:

[DRMErrorEvent type=value bubbles=value cancelable=value eventPhase=value errroID=value subErrorID=value text=value

DRM_ERROR Константа DRMErrorEvent.DRM_ERROR определяет значение свойства type для объекта события drmError.drmErrorString Константа DRMErrorEvent.DRM_ERROR определяет значение свойства type для объекта события drmError.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.errorIDЧисловой код ошибки, присвоенный проблеме.subErrorIDКод ошибки, содержащий более подробную информацию о возникшей проблеме.targetОбъект NetStream.
flash.net.NetStream.drmError
contentData Объект DRMContentData для медиафайла.flash.net.drm:DRMContentData Объект DRMContentData для медиафайла.

С помощью объекта, на который ссылается свойство contentData, можно получить соответствующий ваучер DRM из кэша ваучеров DRMManager. Свойства ваучера описывают лицензию, доступную для пользователя, и могут указать причину, по которой запрещен просмотр содержимого с защитой по технологии DRM.

drmUpdateNeeded Указывает, что для воспроизведения содержимого с DRM-шифрованием требуется обновить DRM.Boolean Указывает, что для воспроизведения содержимого с DRM-шифрованием требуется обновить DRM. subErrorID Идентификатор ошибки, сообщающий более подробную информацию о вызывавшей ее проблеме.int Идентификатор ошибки, сообщающий более подробную информацию о вызывавшей ее проблеме. systemUpdateNeeded Указывает, что для воспроизведения содержимого с DRM-шифрованием требуется обновить систему.Boolean Указывает, что для воспроизведения содержимого с DRM-шифрованием требуется обновить систему.
EventPhase Класс EventPhase передает значения для свойства eventPhase класса Event.Object Класс EventPhase передает значения для свойства eventPhase класса Event. Класс EventКласс EventDispatcherAT_TARGET Фаза назначения, вторая фаза потока событий.2uint Фаза назначения, вторая фаза потока событий. BUBBLING_PHASE Фаза восходящей цепочки, третья фаза потока событий.3uint Фаза восходящей цепочки, третья фаза потока событий. CAPTURING_PHASE Фаза захвата, первая фаза потока событий.1uint Фаза захвата, первая фаза потока событий. FocusEvent Объект передает объект FocusEvent, когда пользователь переносит фокус с одного объекта в списке отображения на другой объект.Объекты событий Focus. flash.events:Event Объект передает объект FocusEvent, когда пользователь переносит фокус с одного объекта в списке отображения на другой объект. Существует четыре типа событий фокуса:
  • FocusEvent.FOCUS_IN
  • FocusEvent.FOCUS_OUT
  • FocusEvent.KEY_FOCUS_CHANGE
  • FocusEvent.MOUSE_FOCUS_CHANGE
В следующем примере используются классы FocusEventExample и CustomSprite, чтобы продемонстрировать, как фокус можно использовать вместе с элементами, нарисованными в рабочей области, для захвата и печати информации. Этот код выполняет следующие задачи.
  1. Объявляются свойства child (типа Sprite) и childCount (типа uint).
  2. Цикл for создает пять голубых квадратов в точке с координатами (0,0). Сначала свойство child назначается новому экземпляру CustomSprite. При создании каждого объекта CustomSprite происходит следующее.
    • Свойству size типа uint задается значение 50 (в пикселях), а для bgColor задается голубой цвет.
    • В конструкторе свойствам класса Sprite buttonMode и useHandCursor задается значение true.
    • Регистрируется прослушиватель событий типа click вместе со связанным подписчиком clickHandler(). Метод подписчика создает локальную переменную target типа Sprite и присваивает ее полю, получившему щелчок. После этого фокус монтажного стола переводится на target.
    • Вызывается метод draw(), создающий квадрат 50 x 50 пикселей путем вызова методов beginFill(), drawRect() и endFill() класса Graphics и свойств экземпляра.
  3. В цикле for вызывается метод configureListeners(), создающий три пары прослушивателей событий и подписчиков:
    • focusIn/focusInHandler() отправляется после события click для любого объекта списка отображения (поля) получившего щелчок.
    • focusOut/focusOutHandler() отправляется, когда щелчок получает другое поле или когда фокус покидает монтажный стол (например, при щелчке за пределами Flash Player).
    • keyFocusChange/keyFocusChangeHandler() отправляется, если для выбора объекта списка отображения используется клавиша Tab или клавиши со стрелками влево или вправо. Однако метод keyFocusChangeHandler() перехватывает клавиши со стрелками влево и вправо и отключает их, вызвав метод preventDefault().
  4. В цикле for каждый квадрат добавляется в список отображения и показывается с помощью метода addChild() (все в одной и той же области).
  5. Конструктор вызывает метод refreshLayout(), располагающий оранжевые квадраты по верхнему краю экрана (y = 0) на расстоянии 5 пикселов друг от друга.
package { import flash.display.Sprite; import flash.display.DisplayObject; import flash.events.FocusEvent; import flash.events.IEventDispatcher; public class FocusEventExample extends Sprite { private var gutter:uint = 5; private var childCount:uint = 5; public function FocusEventExample() { var child:Sprite; for(var i:uint; i < childCount; i++) { child = new CustomSprite(); configureListeners(child); addChild(child); } refreshLayout(); } private function configureListeners(dispatcher:IEventDispatcher):void { dispatcher.addEventListener(FocusEvent.FOCUS_IN, focusInHandler); dispatcher.addEventListener(FocusEvent.FOCUS_OUT, focusOutHandler); dispatcher.addEventListener(FocusEvent.KEY_FOCUS_CHANGE, keyFocusChangeHandler); dispatcher.addEventListener(FocusEvent.MOUSE_FOCUS_CHANGE, mouseFocusChangeHandler); } private function refreshLayout():void { var ln:uint = numChildren; var child:DisplayObject = getChildAt(0); var lastChild:DisplayObject = child; for(var i:uint = 1; i < ln; i++) { child = getChildAt(i); child.x = lastChild.x + lastChild.width + gutter; lastChild = child; } } private function focusInHandler(event:FocusEvent):void { var target:CustomSprite = CustomSprite(event.target); trace("focusInHandler: " + target.name); } private function focusOutHandler(event:FocusEvent):void { var target:CustomSprite = CustomSprite(event.target); trace("focusOutHandler: " + target.name); } private function keyFocusChangeHandler(event:FocusEvent):void { if(event.keyCode == 39 || event.keyCode == 37){ event.preventDefault() } var target:CustomSprite = CustomSprite(event.target); trace("keyFocusChangeHandler: " + target.name); } private function mouseFocusChangeHandler(event:FocusEvent):void { var target:CustomSprite = CustomSprite(event.target); trace("mouseFocusChangeHandler: " + target.name); } } } import flash.display.Sprite; import flash.events.MouseEvent; class CustomSprite extends Sprite { private var size:uint = 50; private var bgColor:uint = 0x00CCFF; public function CustomSprite() { buttonMode = true; useHandCursor = true; addEventListener(MouseEvent.CLICK, clickHandler); draw(size, size); } private function draw(w:uint, h:uint):void { graphics.beginFill(bgColor); graphics.drawRect(0, 0, w, h); graphics.endFill(); } private function clickHandler(event:MouseEvent):void { var target:Sprite = Sprite(event.target); trace("clickHandler: " + target.name); stage.focus = target; } }
focusInflash.events:FocusEvent:FOCUS_INflash.events:FocusEventflash.display.InteractiveObject.focusInfocusOutflash.events:FocusEvent:FOCUS_OUTflash.events:FocusEventflash.display.InteractiveObject.focusOutkeyFocusChangeflash.events:FocusEvent:KEY_FOCUS_CHANGEflash.events:FocusEventflash.display.InteractiveObject.keyFocusChangemouseFocusChangeflash.events:FocusEvent:MOUSE_FOCUS_CHANGEflash.events:FocusEventflash.display.InteractiveObject.mouseFocusChangeFocusEvent Создает объект Event со специфической информацией, имеющей отношение к событиям фокуса.typeString Тип события. Возможные значения: FocusEvent.FOCUS_IN, FocusEvent.FOCUS_OUT, FocusEvent.KEY_FOCUS_CHANGE и FocusEvent.MOUSE_FOCUS_CHANGE. bubblesBooleantrue Определяет, участвует ли объект Event в фазе восходящей цепочки потока событий. cancelableBooleanfalseОпределяет, можно ли отменить объект Event. relatedObjectflash.display:InteractiveObjectnullСсылка на дополняющий экземпляр InteractiveObject, на который влияет смена фокуса. Например, когда происходит событие focusIn, relatedObject представляет InteractiveObject, потерявший фокус. shiftKeyBooleanfalseУказывает, активирован ли модификатор клавиши Shift. keyCodeuint0Значение кода клавиши, нажатой для запуска события keyFocusChange. directionStringnoneУказывает направление активации целевого интерактивного объекта. Имеет значение FocusDirection.NONE (по умолчанию) для всех событий, кроме focusIn. Конструктор для объектов FocusEvent. Создает объект Event со специфической информацией, имеющей отношение к событиям фокуса. Объекты Event передаются прослушивателям событий в качестве параметров. FOCUS_INFOCUS_OUTKEY_FOCUS_CHANGEMOUSE_FOCUS_CHANGEflash.display.FocusDirectionclone Создает копию объекта FocusEvent и задает значение каждого свойства, совпадающее с оригиналом.Новый объект FocusEvent, значения свойств которого соответствуют значениям оригинала. flash.events:Event Создает копию объекта FocusEvent и задает значение каждого свойства, совпадающее с оригиналом. toString Возвращает строку, содержащую все свойства объекта FocusEvent.Строка, содержащая все свойства объекта FocusEvent. String Возвращает строку, содержащую все свойства объекта FocusEvent. Строка имеет следующий формат:

[FocusEvent type=value bubbles=value cancelable=value relatedObject=value shiftKey=value] keyCode=value]

FOCUS_IN Задает значение свойства type для объекта события focusIn.focusInString Задает значение свойства type для объекта события focusIn.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblestruecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.keyCode0; применяется только к событиям keyFocusChange.relatedObjectДополняющий экземпляр InteractiveObject, на который влияет смена фокуса.shiftKeyfalse; применяется только к событиям keyFocusChange.targetЭкземпляр InteractiveObject, только что получивший фокус. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент. directionНаправление, по которому был получен фокус. Это свойство сообщает значение параметра direction метода assignFocus() рабочей области. Если фокус изменился другим способом, значение всегда будет FocusDirection.NONE. Применяется только к событиям focusIn. Для всех других событий фокуса значение будет FocusDirection.NONE.
flash.display.InteractiveObject.focusIn
FOCUS_OUT Задает значение свойства type для объекта события focusOut.focusOutString Задает значение свойства type для объекта события focusOut.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblestruecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.keyCode0; применяется только к событиям keyFocusChange.relatedObjectДополняющий экземпляр InteractiveObject, на который влияет смена фокуса.shiftKeyfalse; применяется только к событиям keyFocusChange.targetЭкземпляр InteractiveObject, только что потерявший фокус. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент.
flash.display.InteractiveObject.focusOut
KEY_FOCUS_CHANGE Задает значение свойства type для объекта события keyFocusChange.keyFocusChangeString Задает значение свойства type для объекта события keyFocusChange.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblestruecancelabletrue; вызовите метод preventDefault() для отмены поведения по умолчанию.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.keyCodeЗначение кода клавиши, нажатой для запуска события keyFocusChange.relatedObjectДополняющий экземпляр InteractiveObject, на который влияет смена фокуса.shiftKeytrue, если активирована клавиша Shift; иначе — false.targetОбъект InteractiveObject, который в данный момент находится в фокусе. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент.
flash.display.InteractiveObject.keyFocusChange
MOUSE_FOCUS_CHANGE Задает значение свойства type для объекта события mouseFocusChange.mouseFocusChangeString Задает значение свойства type для объекта события mouseFocusChange.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblestruecancelabletrue; вызовите метод preventDefault() для отмены поведения по умолчанию.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.keyCode0; применяется только к событиям keyFocusChange.relatedObjectДополняющий экземпляр InteractiveObject, на который влияет смена фокуса.shiftKeyfalse; применяется только к событиям keyFocusChange.targetОбъект InteractiveObject, который в данный момент находится в фокусе. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент.
flash.display.InteractiveObject.mouseFocusChange
direction Указывает направление фокуса для события focusIn.String Указывает направление фокуса для события focusIn. flash.display.FocusDirectionflash.display.Stage.assignFocus()isRelatedObjectInaccessible Если принимает значение true, свойство relatedObject принимает значение null по причинам, связанным с изолированными средами безопасности.Boolean Если принимает значение true, свойство relatedObject принимает значение null по причинам, связанным с изолированными средами безопасности. Если номинальным значением свойства relatedObject является ссылка на объект DisplayObject в другой изолированной среде, свойство relatedObject принимает значение null, пока не будут заданы двусторонние права в границах данной изолированной среды. Права задаются путем вызова метода Security.allowDomain() из SWF-файла или указания файла политик на сервере файла изображений и задания свойства LoaderContext.checkPolicyFile при загрузке изображения. FocusEvent.relatedObjectSecurity.allowDomain()LoaderContext.checkPolicyFilekeyCode Значение кода клавиши, нажатой для запуска события keyFocusChange.uint Значение кода клавиши, нажатой для запуска события keyFocusChange. relatedObject Ссылка на дополняющий экземпляр InteractiveObject, на который влияет смена фокуса.flash.display:InteractiveObject Ссылка на дополняющий экземпляр InteractiveObject, на который влияет смена фокуса. Например, когда происходит событие focusOut, relatedObject представляет InteractiveObject, получивший фокус.

Это свойство может принимать значение null по двум причинам: связанный объект отсутствует или связанный объект существует, но находится в изолированной программной среде безопасности, доступ к которой запрещен. Используйте свойство isRelatedObjectInaccessible() для определения причины.

FocusEvent.isRelatedObjectInaccessible
shiftKey Определяет, активирован ли модификатор клавиши Shift. Если да, то параметр имеет значение true.Boolean Определяет, активирован ли модификатор клавиши Shift. Если да, то параметр имеет значение true. В противном случае значение — false. Это свойство используется, только если FocusEvent относится к типу keyFocusChange.
GesturePhase Класс GesturePhase представляет собой класс перечисления констант для использования вместе с классами GestureEvent, PressAndTapGestureEvent и TransformGestureEvent.Object Класс GesturePhase представляет собой класс перечисления констант для использования вместе с классами GestureEvent, PressAndTapGestureEvent и TransformGestureEvent. Используйте эти значения для отслеживания начала, хода выполнения и завершения сенсорного жеста (такого как перемещение нескольких пальцев по сенсорному экрану), чтобы программа могла реагировать на определенные фазы пользовательского контакта. У некоторых жестов (таких как выделение и нажатие двумя пальцами) есть только одна фаза, и свойство phase объекта события всегда имеет значение all. Следующий пример демонстрирует обработку событий GESTURE_ROTATE. Когда пользователь выполняет жест поворота на устройстве с сенсорным экраном, объект mySprite поворачивается, и в текстовом поле myTextField отображается текущая фаза. Multitouch.inputMode = MultitouchInputMode.GESTURE; var mySprite = new Sprite(); mySprite.addEventListener(TransformGestureEvent.GESTURE_ROTATE , onRotate ); mySprite.graphics.beginFill(0x336699); mySprite.graphics.drawRect(0, 0, 100, 80); var myTextField = new TextField(); myTextField.y = 200; addChild(mySprite); addChild(myTextField); function onRotate(evt:TransformGestureEvent):void { evt.target.rotation -= 45; if (evt.phase==GesturePhase.BEGIN) { myTextField.text = "Begin"; } if (evt.phase==GesturePhase.UPDATE) { myTextField.text = "Update"; } if (evt.phase==GesturePhase.END) { myTextField.text = "End"; } } flash.events.GestureEventflash.events.TransformGestureEventflash.events.PressAndTapGestureEventALL Одно значение, которое описывает все фазы простых жестов, таких как нажатие двумя пальцами или выделение.allString Одно значение, которое описывает все фазы простых жестов, таких как нажатие двумя пальцами или выделение. Для жестов, которые задают свойству phase значение all (такие как выделение и нажатие двумя пальцами), при отправке события значение свойства phase всегда равно all. flash.events.GestureEventflash.events.TransformGestureEventflash.events.PressAndTapGestureEventBEGIN Начало нового жеста (например, касание пальцем сенсорного экрана).beginString Начало нового жеста (например, касание пальцем сенсорного экрана). flash.events.GestureEventflash.events.TransformGestureEventflash.events.PressAndTapGestureEventEND Завершение действия (например, подъем пальца с сенсорного экрана).endString Завершение действия (например, подъем пальца с сенсорного экрана). flash.events.GestureEventflash.events.TransformGestureEventflash.events.PressAndTapGestureEventUPDATE Ход выполнения действия (например, перемещение пальца по сенсорному экрану).updateString Ход выполнения действия (например, перемещение пальца по сенсорному экрану). flash.events.GestureEventflash.events.TransformGestureEventflash.events.PressAndTapGestureEventBrowserInvokeEvent Объект NativeApplication приложения AIR отправляет событие browserInvoke при вызове приложения, когда SWF-файл в браузере использует функцию вызова браузера.Отправляется объектом NativeApplication, когда приложение AIR вызывается через веб-браузер. flash.events:Event Объект NativeApplication приложения AIR отправляет событие browserInvoke при вызове приложения, когда SWF-файл в браузере использует функцию вызова браузера. Объект NativeApplication также отправляет событие browserInvoke, когда пользователь инициирует функцию бесшовной установки в браузере и SWF-файл в браузере передает массив параметру arguments метода launchApplication() файла air.swf. (Подробные сведения см. в разделе «Распределение, установка и запуск приложений AIR» в руководстве по разработке AIR.)

Вызов обозревателя разрешается, только если приложение указывает следующие данные в файле дескриптора приложения.

<allowBrowserInvocation>true</allowBrowserInvocation>

Если приложение не запущено, объект NativeApplication отправляет и объект InvokeEvent и событие browserInvoke при запуске из браузера. А если приложение уже запущено, то при запуске из браузера объект NativeApplication отправляет только событие browserInvoke.

Если приложение запущено в результате бесшовной установки из браузера (когда пользователь выбирает запуск после установки), объект NativeApplication отправляет событие BrowserInvoke, только если были переданы аргументы (SWF-файл в браузере должен передать массив параметру arguments метода installApplication() файла air.swf). Подробные сведения см. в разделе «Распределение, установка и запуск приложений AIR» в руководстве по разработке AIR.

Как и события invokeEvent, события browserInvokeEvent отправляются объектом NativeApplication (NativeApplication.nativeApplication). Для получения событий browserInvoke необходимо вызвать метод addEventListener() объекта NativeApplication. Когда регистрируется прослушиватель события browserInvoke, он также получает все события browserInvoke, отправленные до регистрации. Эти события отправлены после возврата вызова addEventListener(), но не обязательно перед другими событиями browserInvoke, которые могут быть получены после регистрации. Это позволяет обрабатывать события browserInvoke, которые произошли до выполнения кода инициализации (например, если приложение было сначала вызвано из браузера). Следует учитывать, что если прослушиватель событий добавляется позже при выполнении (после инициализации приложения), он все равно получает все события browserInvoke, отправленные с момента запуска.

flash.events.InvokeEventflash.desktop.NativeApplicationinvokeflash.events:BrowserInvokeEvent:BROWSER_INVOKEflash.events:BrowserInvokeEventflash.desktop.NativeApplicationBrowserInvokeEvent Функция конструктора для класса BrowserInvokeEvent.typeStringТип события, представленный в виде Event.type. bubblesBooleanИмеет значение false для объекта BrowserInvokeEvent. cancelableBooleanИмеет значение false для объекта BrowserInvokeEvent. argumentsArrayМассив аргументов (строк), передаваемых приложению. sandboxTypeStringТип изолированной программной среды для содержимого в обозревателе. securityDomainStringДомен защиты для содержимого в обозревателе. isHTTPSBooleanУказывает, использует ли содержимое в браузере безопасный URL-адрес (HTTPS). isUserEventBooleanУказывает, был ли вызов из браузера результатом события пользователя. Функция конструктора для класса BrowserInvokeEvent. Как правило, разработчики не вызывают конструктор BrowserInvokeEvent() напрямую. Объект BrowserInvokeEvent должен создаваться только во время выполнения. clone Создает новую копию данного события.Копия события. flash.events:Event Создает новую копию данного события. BROWSER_INVOKE Константа BrowserInvokeEvent.BROWSER_INVOKE определяет значение свойства type объекта BrowserInvokeEvent.browserInvokeString Константа BrowserInvokeEvent.BROWSER_INVOKE определяет значение свойства type объекта BrowserInvokeEvent.

Объект BrowserInvokeEvent имеет следующие свойства.

СвойстваЗначенияargumentsМассив строковых аргументов, передаваемых в ходе данного вызова.sandBoxTypeСтрока, представляющая тип изолированной программной среды содержимого в браузере (Security.APPLICATION, Security.LOCAL_TRUSTED, Security.LOCAL_WITH_FILE, Security.LOCAL_LOCAL_WITH_NETWORK или Security.REMOTE).securityDomainСтрока, представляющая домен защиты для содержимого в браузере (например, www.example.com).isHTTPSУказывает, использует ли содержимое в браузере URL-адрес с HTTPS (true) или нет (false)isUserEventУказывает, выполнен ли вызов из обозревателя в результате события пользователя (всегда true в AIR 1.0).bubblesНет.cancelablefalse; нет поведения по умолчанию для отмены.currentTargetОбъект, активно обрабатывающий объект InvokeEvent с помощью прослушивателя событий.targetВсегда объект NativeApplication.
flash.desktop.NativeApplication
arguments Массив аргументов (строк), передаваемых приложению.Array Массив аргументов (строк), передаваемых приложению. isHTTPS Указывает, использует ли содержимое в браузере URL-адрес с HTTPS (true) или нет (false).Boolean Указывает, использует ли содержимое в браузере URL-адреса с HTTPS (true) или нет (false). isUserEvent Указывает, выполнен ли вызов из браузера в результате события пользователя (например, щелчка мыши).Boolean Указывает, выполнен ли вызов из браузера в результате события пользователя (например, щелчка мыши). В AIR 1.0 всегда имеет значение true; в AIR требуется, чтобы пользователь инициировал вызов функции вызова приложения из браузера. sandboxType Тип изолированной программной среды для содержимого в обозревателе.String Тип изолированной программной среды для содержимого в браузере. Может иметь одно из следующих значений.
  • Security.APPLICATION — содержимое находится в изолированной программной среде безопасности приложения.
  • Security.LOCAL_TRUSTED — содержимое находится в изолированной программной среде безопасности, надежной для локальной системы.
  • Security.LOCAL_WITH_FILE — содержимое находится в изолированной программной среде безопасности, локальной для файловой системы.
  • Security.LOCAL_WITH_NETWORK — содержимое находится в изолированной программной среде безопасности, локальной для сети.
  • Security.REMOTE — содержимое находится в удаленном (сетевом) домене.
flash.system.Security.sandboxType
securityDomain Домен защиты для содержимого в браузере, например www.adobe.com или www.example.org.String Домен защиты для содержимого в браузере, например www.adobe.com или www.example.org. Это свойство задается только для содержимого в удаленной изолированной программной среде безопасности (для содержимого из сетевого домена), а не для содержимого в локальной среде или среде приложения.
OutputProgressEvent Объект FileStream отправляет объекты OutputProgressEvent при выполнении незавершенных асинхронных операций записи файлов.Объекты событий прогресса вывода (для асинхронных операций записи файла). flash.events:Event Объект FileStream отправляет объекты OutputProgressEvent при выполнении незавершенных асинхронных операций записи файлов. Существует один тип события прогресса вывода: OutputProgressEvent.OUTPUT_PROGRESS. flash.filesystem.FileStreamoutputProgressflash.events:OutputProgressEvent:OUTPUT_PROGRESSflash.events:OutputProgressEventflash.filesystem.FileStreamOutputProgressEvent Создает объект Event, содержащий данные о событиях прогресса вывода.typeString Тип события. Существует только один тип события ошибки: OutputProgressEvent.OUTPUT_PROGRESS. bubblesBooleanfalse Определяет, участвует ли объект Event в фазе восходящей цепочки потока событий. cancelableBooleanfalseОпределяет, можно ли отменить объект Event. bytesPendingNumber0Число еще не записанных байт. bytesTotalNumber0Общее число байт, записанных или ожидающих записи. Конструктор для объектов OutputProgressEvent. Создает объект Event, содержащий данные о событиях прогресса вывода. Объекты Event передаются прослушивателям событий в качестве параметров. clone Создает копию объекта OutputProgressEvent и задает значение каждого свойства, совпадающее с оригиналом.Новый объект OutputProgressEvent, значения свойств которого соответствуют значениям оригинала. flash.events:Event Создает копию объекта OutputProgressEvent и задает значение каждого свойства, совпадающее с оригиналом. toString Возвращает строку, содержащую все свойства объекта OutputProgressEvent.Строка, содержащая все свойства объекта OutputProgressEvent. String Возвращает строку, содержащую все свойства объекта OutputProgressEvent. Строка имеет следующий формат:

[OutputProgressEvent type=value bubbles=value cancelable=value eventPhase=value bytesPending=value bytesTotal=value]

OUTPUT_PROGRESS Задает значение свойства type для объекта события outputProgress.outputProgressString Задает значение свойства type для объекта события outputProgress.

Это событие имеет следующие свойства:

СвойствоЗначениеbubblesfalsebytesPendingЧисло байт, которые остается записать на момент обработки события прослушивателем.bytesTotalОбщее число элементов или байт, которые в итоге будут записаны в случае успешного завершения записи.cancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.targetОбъект FileStream, сообщающий сведения о прогрессе.
flash.filesystem.FileStream
bytesPending Число байт, еще не записанных на момент обработки события прослушивателем.Number Число байт, еще не записанных на момент обработки события прослушивателем. bytesTotal Общее число записанных на данный момент байт плюс число байт, ожидающих записи.Number Общее число записанных на данный момент байт плюс число байт, ожидающих записи.
StageOrientationEvent Объект Stage отправляет объект StageOrientationEvent, если меняется ориентация рабочей области.flash.events:Event Объект Stage отправляет объект StageOrientationEvent, если меняется ориентация рабочей области. Это может иметь место, когда устройство вращается, когда пользователь открывает клавиатуру слайда, или когда setAspectRatio () метод Рабочей область вызывается.

Есть два типа события StageOrientationEvent: orientationChanging (StageOrientationEvent. ORIENTATION_CHANGING), отправлен прежде, чем экран изменяется на новую ориентацию. Вызов preventDefault () метод объекта event, отправленного для orientationChanging, препятствует тому, чтобы рабочая область изменила ориентацию. orientationChange (StageOrientationEvent. ORIENTATION_CHANGE), отправлен после того, как экран изменяется на новую ориентацию.

Примечание. Если для свойства autoOrients установлено значение false, ориентация рабочей области не изменяется при повороте устройства. Таким образом, события StageOrientationEvents отправляются при повороте устройства, только когда для свойства autoOrients установлено значение true.

Stage.deviceOrientationStage.autoOrientsorientationChangeflash.events:StageOrientationEvent:ORIENTATION_CHANGEflash.events:StageOrientationEventflash.display.StagedeviceOrientationStageOrientationEvent Создает объект StageOrientationEvent со специфической информацией, имеющей отношение к событиям ориентации рабочей области.typeString Тип события: StageOrientationEvent.ORIENTATION_CHANGE bubblesBooleanfalse Указывает, участвует ли объект Event в фазе восходящей цепочки потока событий. cancelableBooleanfalseУказывает, можно ли отменить объект Event. beforeOrientationStringnullОбозначает ориентацию перед изменением. afterOrientationStringnullОбозначает ориентацию после изменения. Создает объект StageOrientationEvent со специфической информацией, имеющей отношение к событиям ориентации рабочей области. Объекты Event передаются прослушивателям событий в качестве параметров. Как правило, это событие не требуется создавать с помощью функции-конструктора. Вместо этого нужно добавить прослушиватель событий для объекта Stage, чтобы регистрировать эти события по ходу их появления. clone Создает копию объекта StageOrientationEvent и задает значение каждого свойства, совпадающее с оригиналом.Новый объект StageOrientationEvent, значения свойств которого соответствуют значениям оригинала. flash.events:Event Создает копию объекта StageOrientationEvent и задает значение каждого свойства, совпадающее с оригиналом. toString Возвращает строку, содержащую все свойства объекта StageOrientationEvent.Строка, содержащая все свойства объекта StageOrientationEvent. String Возвращает строку, содержащую все свойства объекта StageOrientationEvent. Строка имеет следующий формат:

[StageOrientationEvent type=value bubbles=value cancelable=value beforeDisplayState=value afterDisplayState=value]

ORIENTATION_CHANGE Константа ORIENTATION_CHANGE определяет значение свойства type объекта события orientationChange.orientationChangeString Константа ORIENTATION_CHANGE определяет значение свойства type объекта события orientationChange. Это событие имеет следующие свойства: СвойстваЗначенияafterOrientationНовая ориентация рабочей области.beforeOrientationСтарая ориентация рабочей области.targetОбъект Stage, отправивший изменение ориентации. bubblestruecurrentTargetУказывает объект, активно обрабатывающий объект Event с помощью прослушивателя событий.cancelablefalse; он должен слишком поздно отменить изменение. flash.display.StagedeviceOrientationORIENTATION_CHANGING Константа ORIENTATION_CHANGING определяет значение свойства type объекта события orientationChanging.orientationChangingString Константа ORIENTATION_CHANGING определяет значение свойства type объекта события orientationChanging.

Важный: События ORIENTATION_CHANGING не отправлены на устройствах Андроида.

Это событие имеет следующие свойства: СвойстваЗначенияafterOrientationНовая ориентация рабочей области.beforeOrientationСтарая ориентация рабочей области.targetОбъект Stage, отправивший изменение ориентации. bubblestruecurrentTargetУказывает объект, активно обрабатывающий объект Event с помощью прослушивателя событий.cancelabletrue.
afterOrientation Ориентация рабочей области после ожидаемого изменения.String Ориентация рабочей области после ожидаемого изменения. beforeOrientation Ориентация рабочей области до ожидаемого изменения.String Ориентация рабочей области до ожидаемого изменения.
ActivityEvent Объект Camera или Microphone передает объект ActivityEvent каждый раз при получении сообщения от камеры или микрофона о переходе в активное или неактивное состояние.Объекты событий ActivityEvent. flash.events:Event Объект Camera или Microphone передает объект ActivityEvent каждый раз при получении сообщения от камеры или микрофона о переходе в активное или неактивное состояние. Существует только один тип события активности: ActivityEvent.ACTIVITY. В следующем примере демонстрируется использование класса ActivityEvent путем добавления метода прослушивателя событий activityHandler() к микрофону и генерации текстовой информации при каждой отправке события activity. package { import flash.display.Sprite; import flash.events.ActivityEvent; import flash.media.Microphone; public class ActivityEventExample extends Sprite { public function ActivityEventExample() { var mic:Microphone = Microphone.getMicrophone(); mic.addEventListener(ActivityEvent.ACTIVITY, activityHandler); } private function activityHandler(event:ActivityEvent):void { trace("event: " + event); trace("event.activating: " + event.activating); } } } ActivityEvent.ACTIVITYactivityflash.events:ActivityEvent:ACTIVITYflash.events:ActivityEventflash.media.Camera.activityflash.media.Microphone.activityActivityEvent Создает объект события, содержащий информацию о событиях активности.typeString Тип события. Прослушиватели событий могут получать эту информацию через унаследованное свойство type. Существует только один тип события активности: ActivityEvent.ACTIVITY. bubblesBooleanfalseОпределяет, участвует ли объект Event в фазе восходящей цепочки потока событий. Прослушиватели событий могут получать эту информацию через унаследованное свойство bubbles. cancelableBooleanfalseОпределяет, можно ли отменить объект Event. Прослушиватели событий могут получать эту информацию через унаследованное свойство cancelable. activatingBooleanfalseПоказывает состояние, в которое переходит устройство: активное (true) или неактивное (false). Прослушиватели событий могут получать эту информацию через свойство activating. Конструктор для объектов ActivityEvent. Создает объект события, содержащий информацию о событиях активности. Объекты Event передаются прослушивателям событий в качестве параметров. ActivityEvent.ACTIVITYclone Создает копию объекта ActivityEvent и задает значение каждого свойства, совпадающее с оригиналом.Новый объект ActivityEvent, значения свойств которого соответствуют значениям оригинала. flash.events:Event Создает копию объекта ActivityEvent и задает значение каждого свойства, совпадающее с оригиналом. toString Возвращает строку, содержащую все свойства объекта ActivityEvent.Строка, содержащая все свойства объекта ActivityEvent. String Возвращает строку, содержащую все свойства объекта ActivityEvent. Используется следующий формат:

[ActivityEvent type=value bubbles=value cancelable=value activating=value]

ACTIVITY Константа ActivityEvent.ACTIVITY определяет значение свойства type объекта события activity.activityString Константа ActivityEvent.ACTIVITY определяет значение свойства type объекта события activity.

Это событие имеет следующие свойства:

СвойствоЗначениеactivatingtrue, если устройство активируется, илиfalse, если деактивируется.bubblesfalsecancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.targetОбъект, начинающий или завершающий сеанс, например объект Camera или Microphone.
flash.media.Camera.activityflash.media.Microphone.activity
activating Показывает состояние, в которое переходит устройство: активное (true) или неактивное (false).Boolean Показывает состояние, в которое переходит устройство: активное (true) или неактивное (false).