| Пакет | flash.display |
| Класс | public class InteractiveObject |
| Наследование | InteractiveObject  DisplayObject EventDispatcher Object |
| Подклассы | DisplayObjectContainer, SimpleButton, TextField |
| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Нельзя создать экземпляры класса InteractiveObject напрямую. Вызов конструктора new InteractiveObject() выдает исключение ArgumentError.
Сам класс InteractiveObject не содержит API-интерфейсов для визуализации содержимого на экране Чтобы создать пользовательский подкласс класса InteractiveObject, расширьте один из подклассов, у которых имеется API для визуализации содержимого на экране, например классы Sprite, SimpleButton, TextField или MovieClip.
Скрыть унаследованные общедоступные свойства
Показать унаследованные общедоступные свойства| Свойство | Определено | ||
|---|---|---|---|
| accessibilityImplementation : AccessibilityImplementation
Текущая реализация специальных возможностей (AccessibilityImplementation) для данного экземпляра InteractiveObject. | InteractiveObject | ||
 | accessibilityProperties : AccessibilityProperties
Текущие параметры специальных возможностей для данного экранного объекта. | DisplayObject | |
| alpha : Number
Указывает значение альфа-прозрачности заданного объекта. | DisplayObject | |
| blendMode : String
Значение класса BlendMode, задающее режим наложения. | DisplayObject | |
| blendShader : Shader [только для записи]
Задает затенение, используемое при наложении переднего плана на фон. | DisplayObject | |
| cacheAsBitmap : Boolean
При значении true среда выполнения Flash кэширует внутреннее растровое представление экранного объекта. | DisplayObject | |
| cacheAsBitmapMatrix : Matrix
Если задано ненулевое значение, данный объект Matrix определяет способ визуализации экранного объекта, когда свойство cacheAsBitmap имеет значение true. | DisplayObject | |
| constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | |
| contextMenu : NativeMenu
Определяет контекстное меню, связанное с данным объектом. | InteractiveObject | ||
| doubleClickEnabled : Boolean
Определяет, получает ли объект события doubleClick. | InteractiveObject | ||
| filters : Array
Индексированный массив, который содержит все объекты filter, связанные в настоящий момент с экранным объектом. | DisplayObject | |
| focusRect : Object
Задает отображение прямоугольной рамки индикатора фокуса для данного объекта. | InteractiveObject | ||
| height : Number
Указывает высоту экранного объекта в пикселях. | DisplayObject | |
| loaderInfo : LoaderInfo [только для чтения]
Возвращает объект LoaderInfo, содержащий сведения о загрузке файла, к которому принадлежит этот экранный объект. | DisplayObject | |
| mask : DisplayObject
Вызывающий экранный объект маскируется заданным объектом mask. | DisplayObject | |
| metaData : Object
Получает объект метаданных экземпляра DisplayObject, если метаданные хранились вместе с экземпляром этого DisplayObject в SWF-файле через тег PlaceObject4. | DisplayObject | |
| mouseEnabled : Boolean
Определяет, получает ли этот объект события мыши или другого пользовательского ввода. | InteractiveObject | ||
| mouseX : Number [только для чтения]
Указывает координату x мыши или курсора пользовательского ввода (в пикселях). | DisplayObject | |
| mouseY : Number [только для чтения]
Указывает координату y мыши или курсора пользовательского ввода (в пикселях). | DisplayObject | |
| name : String
Указывает имя экземпляра DisplayObject. | DisplayObject | |
| needsSoftKeyboard : Boolean
Определяет, должна ли отображаться виртуальная клавиатура (программная экранная клавиатура), когда этот экземпляр InteractiveObject получает фокус. | InteractiveObject | ||
| opaqueBackground : Object
Определяет, является ли экранный объект непрозрачным с определенным цветом фона. | DisplayObject | |
| parent : DisplayObjectContainer [только для чтения]
Указывает объект DisplayObjectContainer, содержащий данный экранный объект. | DisplayObject | |
| root : DisplayObject [только для чтения]
В случае с экранным объектом в загруженном SWF-файле свойством root является самый верхний экранный объект в части структуры дерева списка отображения, представленной этим SWF-файлом. | DisplayObject | |
| rotation : Number
Указывает поворот экземпляра DisplayObject относительно его исходной ориентации (в градусах). | DisplayObject | |
| rotationX : Number
Обозначает поворот в градусах по оси x экземпляра DisplayObject относительно исходной ориентации по трехмерному вышестоящему контейнеру. | DisplayObject | |
| rotationY : Number
Обозначает угол поворота в градусах по оси у экземпляра DisplayObject относительно исходной ориентации по трехмерному родительскому контейнеру. | DisplayObject | |
| rotationZ : Number
Обозначает поворот в градусах по оси z экземпляра DisplayObject от исходной ориентации относительно трехмерного родительского контейнера. | DisplayObject | |
| scale9Grid : Rectangle
Текущая активная сетка масштабирования. | DisplayObject | |
| scaleX : Number
Указывает горизонтальное масштабирование объекта от точки регистрации (в процентах). | DisplayObject | |
| scaleY : Number
Указывает вертикальное масштабирование объекта от точки регистрации (в процентах). | DisplayObject | |
| scaleZ : Number
Указывает глубину масштабирования объекта (в процентах) относительно точки регистрации этого объекта. | DisplayObject | |
| scrollRect : Rectangle
Прямоугольная область прокрутки экранного объекта. | DisplayObject | |
| softKeyboard : String
Управляет внешним видом программной клавиатуры. | InteractiveObject | ||
| softKeyboardInputAreaOfInterest : Rectangle
Определяет область, которая должна оставаться на экране при отображении программной клавиатуры (недоступна в iOS). | InteractiveObject | ||
| stage : Stage [только для чтения]
Класс Stage экранного объекта. | DisplayObject | |
| tabEnabled : Boolean
Определяет, включен ли переход к этому объекту с помощью клавиши Tab. | InteractiveObject | ||
| tabIndex : int
Задает последовательность перехода между объектами в SWF-файле. | InteractiveObject | ||
| transform : flash.geom:Transform
Объект со свойствами, относящимися к матрице, преобразованию цвета и пиксельным границам экранного объекта. | DisplayObject | |
| visible : Boolean
Определяет видимость экранного объекта. | DisplayObject | |
| width : Number
Указывает ширину экранного объекта в пикселях. | DisplayObject | |
| x : Number
Указывает координату x экземпляра DisplayObject, связанную с локальными координатами родительского DisplayObjectContainer. | DisplayObject | |
| y : Number
Указывает координату y экземпляра DisplayObject, связанную с локальными координатами родительского DisplayObjectContainer. | DisplayObject | |
| z : Number
Указывает положение по оси z экземпляра DisplayObject относительно трехмерного родительского контейнера. | DisplayObject | |
| Метод | Определено | ||
|---|---|---|---|
При вызове конструктора new InteractiveObject() выдается исключение ArgumentError. | InteractiveObject | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии. | EventDispatcher | |
|
Посылает событие в поток событий. | EventDispatcher | |
|
Возвращает прямоугольник, определяющий область объекта отображения, которая относится к системе координат объекта targetCoordinateSpace. | DisplayObject | |
|
Возвращает прямоугольник, определяющий границу объекта отображения по системе координат, определенной параметром targetCoordinateSpace за исключением линий фигур. | DisplayObject | |
|
Преобразует объект Point из координат рабочей области (глобальных) в координаты отображаемого объекта (локальные). | DisplayObject | |
|
Преобразует двумерный объект Point из координат рабочей области (глобальных) в координаты экранного трехмерного объекта (локальные). | DisplayObject | |
|
Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события. | EventDispatcher | |
|
Показывает, определено ли заданное свойство для объекта. | Object | |
|
Вычисляет ограничительную рамку экранного объекта, чтобы определить, не перекрывает и не пересекает ли она ограничительную рамку экранного объекта obj. | DisplayObject | |
|
Вычисляет экранный объект, чтобы определить, перекрывает ли он точку, заданную координатами x и y, или пересекает ее. | DisplayObject | |
|
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | |
|
Преобразует трехмерный объект point из координат трехмерного экранного объекта (локальных) в двухмерный объект point с координатами рабочей области (глобальными). | DisplayObject | |
|
Преобразует объект Point из координат экранного объекта (локальных) в координаты рабочей области (глобальные). | DisplayObject | |
|
Показывает наличие заданного свойства и его перечисляемость. | Object | |
|
Удаляет прослушиватель из объекта EventDispatcher. | EventDispatcher | |
Вызывает виртуальную клавиатуру. | InteractiveObject | ||
|
Задает доступность динамического свойства для операций цикла. | Object | |
|
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | |
|
Возвращает строковое представление заданного объекта. | Object | |
|
Возвращает элементарное значение заданного объекта. | Object | |
|
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником. | EventDispatcher | |
| Событие | Сводка | Определено | ||
|---|---|---|---|---|
| [многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR перемещается в фокус операционной системы и становится активным. | EventDispatcher | ||
| Отправляется, когда экранный объект добавляется в список отображения. | DisplayObject | ||
| Отправляется, когда экранный объект добавляется к списку отображения на монтажном столе либо непосредственно, либо путем добавления поддерева, содержащего экранный объект. | DisplayObject | ||
| Отправляется, когда пользователь выбирает команду «Удалить» из контекстного меню текста. | InteractiveObject | |||
| Отправляется, когда пользователь нажимает и отпускает главную кнопку на указывающем устройстве над одним и тем же объектом InteractiveObject. | InteractiveObject | |||
| Отправляется, когда жест пользователя вызывает контекстное меню, связанное с данным интерактивным объектом в приложении AIR. | InteractiveObject | |||
| Отправляется, когда пользователь активирует комбинацию клавиш быстрого вызова, используемую на данной платформе для операции «Копировать», или выбирает команду «Копировать» из контекстного меню. | InteractiveObject | |||
| Отправляется, когда пользователь активирует комбинацию клавиш быстрого вызова, используемую на данной платформе для операции «Вырезать», или выбирает команду «Вырезать» из контекстного меню. | InteractiveObject | |||
| [многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR теряет фокус системы и становится неактивным. | EventDispatcher | ||
| Отправляется, когда пользователь дважды нажимает и отпускает главную кнопку на указывающем устройстве над одним и тем же объектом InteractiveObject, а флаг doubleClickEnabled для этого объекта имеет значение true. | InteractiveObject | |||
| [многоадресное событие] Отправляется, когда точка воспроизведения переходит в новый кадр. | DisplayObject | ||
| [многоадресное событие] Отправляется, когда точка воспроизведения покидает текущий кадр. | DisplayObject | ||
| Отправляется после того, как экранный объект перемещается в фокус. | InteractiveObject | |||
| Отправляется после того, как экранный объект теряет фокус. | InteractiveObject | |||
| [многоадресное событие] Отправляется после завершения работы конструкторов экранных объектов кадра до выполнения сценариев кадра. | DisplayObject | ||
| Отправляется, когда пользователь создает точку контакта вдоль края сенсорной поверхности с помощью экземпляра InteractiveObject (например, нажатие по краю сенсорной поверхности на пульте Siri Remote для Apple TV). Некоторые устройства также могут интерпретировать этот контакт как комбинацию нескольких событий касания. | InteractiveObject | |||
| Отправляется, когда пользователь наживает две точки контакта над одним экземпляром InteractiveObject на устройстве с сенсорным экраном (например, двумя пальцами нажимает точки над экранным объектом и отпускает их при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). | InteractiveObject | |||
| Отправляется, когда пользователь перемещает точку контакта с экземпляром InteractiveObject на устройстве с сенсорным экраном (например, касается пальцем и проводит им слева направо над экранным объектом при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). | InteractiveObject | |||
| Отправляется, когда пользователь выполняет жест поворота в точке контакта с экземпляром InteractiveObject (например, касание двумя пальцами и их вращение над экранным объектом при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). | InteractiveObject | |||
| Отправляется, когда пользователь выполняет жест выделения в точке контакта с экземпляром InteractiveObject (например, касание экрана тремя пальцами и их параллельное перемещение над экранным объектом при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). | InteractiveObject | |||
| Отправляется, когда пользователь создает точку контакта с экземпляром InteractiveObject, а затем касается сенсорного экрана (например, касается экранного объекта несколькими пальцами, чтобы открыть меню, а затем касается одним пальцем для выбора нужного элемента меню при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). | InteractiveObject | |||
| Отправляется, когда пользователь выполняет жест увеличения в точке контакта с экземпляром InteractiveObject (например, касание экрана двумя пальцами и их быстрое разведение в стороны над экранным объектом при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). | InteractiveObject | |||
| Это событие отправляется любой клиентской программе, которая поддерживает линейный ввод с помощью IME. | InteractiveObject | |||
| Отправляется, когда пользователь нажимает клавишу. | InteractiveObject | |||
| Отправляется, когда пользователь пытается изменить фокус с помощью клавиатуры. | InteractiveObject | |||
| Отправляется, когда пользователь отпускает клавишу. | InteractiveObject | |||
| Отправляется, когда пользователь нажимает и отпускает среднюю кнопку указывающего устройства над одним и тем же объектом InteractiveObject. | InteractiveObject | |||
| Отправляется, когда пользователь нажимает среднюю кнопку указывающего устройства над экземпляром InteractiveObject. | InteractiveObject | |||
| Отправляется, когда пользователь отпускает кнопку указывающего устройства над экземпляром InteractiveObject. | InteractiveObject | |||
| Отправляется, когда пользователь нажимает кнопку указывающего устройства над экземпляром InteractiveObject. | InteractiveObject | |||
| Отправляется, когда пользователь пытается изменить фокус с помощью указывающего устройства. | InteractiveObject | |||
| Отправляется, когда пользователь перемещает указывающее устройство в момент, когда курсор находится над объектом InteractiveObject. | InteractiveObject | |||
| Отправляется, когда пользователь перемещает указатель с экземпляра InteractiveObject. | InteractiveObject | |||
| Отправляется, когда пользователь наводит указывающее устройство на экземпляр InteractiveObject. | InteractiveObject | |||
| Отправляется, когда пользователь отпускает кнопку указывающего устройства над экземпляром InteractiveObject. | InteractiveObject | |||
| Отправляется при прокрутке колеса мыши над экземпляром InteractiveObject. | InteractiveObject | |||
| Отправляется инициатором перетаскивания InteractiveObject, когда пользователь завершает жест перетаскивания. | InteractiveObject | |||
| Отправляется целевым объектом InteractiveObject при принятии перетаскиваемого объекта вызовом метода DragManager.acceptDragDrop(). | InteractiveObject | |||
| Отправляется объектом InteractiveObject, когда жест перетаскивания входит в его границы. | InteractiveObject | |||
| Отправляется объектом InteractiveObject, когда жест перетаскивания выходит за границы этого объекта. | InteractiveObject | |||
| Постоянно отправляется объектом InteractiveObject, пока жест перетаскивания остается в пределах его границ. | InteractiveObject | |||
| Отправляется в начале операции перетаскивания объектом InteractiveObject, заданным в качестве инициатора перетаскивания в вызове метода DragManager.doDrag(). | InteractiveObject | |||
| Отправляется во время операции перетаскивания объектом InteractiveObject, заданным в качестве инициатора перетаскивания в вызове метода DragManager.doDrag(). | InteractiveObject | |||
| Отправляется, когда пользователь активирует комбинацию клавиш ускорения, используемую на данной платформе для операции «Вставить», или выбирает команду «Вставить» из контекстного меню. | InteractiveObject | |||
| Отправляется, когда пользователь опускает активное перо ниже установленного для экрана порога обнаружения приближения. | InteractiveObject | |||
| Отправляется, когда пользователь поднимает активное перо, превышая установленный для экрана порог обнаружения приближения. | InteractiveObject | |||
| Отправляется, когда пользователь наводит активное перо на экран, не превышая установленный для экрана порог обнаружения приближения. | InteractiveObject | |||
| Отправляется, когда пользователь переводит активное перо от этого объекта InteractiveObject, не превышая установленный для экрана порог обнаружения приближения. | InteractiveObject | |||
| Отправляется, когда пользователь наводит активное перо непосредственно на этот объект InteractiveObject, не превышая установленный для экрана порог обнаружения приближения. | InteractiveObject | |||
| Отправляется, когда пользователь перемещает активное перо от этого объекта InteractiveObject и любого из его дочерних объектов, не превышая установленный для экрана порог обнаружения приближения. | InteractiveObject | |||
| Отправляется, когда пользователь переводит активное перо на этот объект InteractiveObject из внешней части дерева потомков в списке отображения (не превышая установленный для экрана порог обнаружения близости). | InteractiveObject | |||
| Отправляется, когда пользователь отпускает кнопку позиционирующего устройства после ее нажатия над экземпляром InteractiveObject и последующего перемещения позиционирующего устройства с экземпляра InteractiveObject. | InteractiveObject | |||
| Отправляется перед удалением экранного объекта из списка отображения. | DisplayObject | ||
| Отправляется перед удалением экранного объекта из списка отображения либо напрямую, либо путем удаления поддерева, содержащего экранный объект. | DisplayObject | ||
| [многоадресное событие] Отправляется перед обновлением и визуализацией списка отображения. | DisplayObject | ||
| Отправляется, когда пользователь нажимает и отпускает правую кнопку указывающего устройства над одним и тем же объектом InteractiveObject. | InteractiveObject | |||
| Отправляется, когда пользователь нажимает кнопку указывающего устройства над экземпляром InteractiveObject. | InteractiveObject | |||
| Отправляется, когда пользователь отпускает кнопку указывающего устройства над экземпляром InteractiveObject. | InteractiveObject | |||
| Отправляется, когда пользователь перемещает указатель с экземпляра InteractiveObject. | InteractiveObject | |||
| Отправляется, когда пользователь наводит указывающее устройство на экземпляр InteractiveObject. | InteractiveObject | |||
| Отправляется, когда пользователь активирует комбинацию клавиш ускорения, используемую на данной платформе для операции «Выделить все», или выбирает команду «Выделить все» из контекстного меню. | InteractiveObject | |||
| Отправляется сразу после того, как программная клавиатура вызывается. | InteractiveObject | |||
| Передается немедленно перед тем, как программная клавиатура появляется на экране. | InteractiveObject | |||
| Передается немедленно после того, как программная клавиатура убирается с экрана. | InteractiveObject | |||
| Отправляется, когда изменяется значение свойства tabChildren объекта. | InteractiveObject | |||
| Отправляется при изменении флага tabEnabled объекта. | InteractiveObject | |||
| Отправляется, когда изменяется значение свойства tabIndex объекта. | InteractiveObject | |||
| Передается, если пользователь вводит один или несколько символов текста. | InteractiveObject | |||
| Отправляется, когда пользователь впервые создает точку контакта с сенсорным экраном устройства (например, касается сенсорного экрана мобильного телефона или планшетного компьютера). | InteractiveObject | |||
| Отправляется, когда пользователь убирает точку контакта с сенсорным экраном устройства (например, поднимает палец с сенсорного экрана мобильного телефона или планшетного компьютера). | InteractiveObject | |||
| Отправляется, когда пользователь касается устройства, и продолжает отправляться до тех пор, пока точка контакта не будет удалена. | InteractiveObject | |||
| Отправляется, когда пользователь перемещает точку контакта от экземпляра InteractiveObject на устройстве с сенсорным экраном (например, перетаскивает палец с одного экранного объекта на другой при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). | InteractiveObject | |||
| Отправляется, когда пользователь перемещает точку контакта над экземпляром InteractiveObject на устройстве с сенсорным экраном (например, перетаскивает палец с точки за пределами экранного объекта в точку над ним при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). | InteractiveObject | |||
| Отправляется, когда пользователь удаляет точку контакта из экземпляра InteractiveObject на сенсорном устройстве (например, переводит палец из положения над экранным объектом в точку за пределами экранного объекта на мобильном телефоне или планшете с сенсорным экраном). | InteractiveObject | |||
| Отправляется, когда пользователь перемещает точку контакта над экземпляром InteractiveObject на устройстве с сенсорным экраном (например, перетаскивает палец с точки за пределами экранного объекта в точку над ним при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). | InteractiveObject | |||
| Отправляется, когда пользователь поднимает точку контакта над тем же экземпляром InteractiveObject, с которым был установлен первичный контакт на сенсорном экране (например, нажимает точку на экранном объекте и поднимает палец с той же точки при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). | InteractiveObject | |||
accessibilityImplementation | свойство |
accessibilityImplementation:AccessibilityImplementation| Язык версии: | ActionScript 3.0 |
Текущая реализация специальных возможностей (AccessibilityImplementation) для данного экземпляра InteractiveObject.
Реализация
public function get accessibilityImplementation():AccessibilityImplementation public function set accessibilityImplementation(value:AccessibilityImplementation):voidСвязанные элементы API
contextMenu | свойство |
contextMenu:NativeMenu| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Определяет контекстное меню, связанное с данным объектом.
Для содержимого, запущенного в проигрывателе Flash Player, это свойство является объектом ContextMenu. В среде выполнения AIR класс ContextMenu расширяет класс NativeMenu, однако Flash Player поддерживает только класс ContextMenu, но не класс NativeMenu.
Примечание. Объекты TextField всегда содержат меню буфера обмена в контекстном меню. Меню буфера обмена включает команды «Вырезать», «Копировать», «Вставить» и «Выбрать все». Удалить эти команды из контекстного меню для объектов TextField невозможно. Для объектов TextField выбор этих команд (или сочетаний клавиш, эквивалентных элементу меню) не приводит к генерации событий clear, copy, cut, paste или selectAll.
Реализация
public function get contextMenu():NativeMenu public function set contextMenu(value:NativeMenu):voidПример ( Использование этого примера )
var red_cmi:ContextMenuItem = new ContextMenuItem("red");
red_cmi.addEventListener(ContextMenuEvent.MENU_ITEM_SELECT, cmi_menuItemSelect);
var cm:ContextMenu = new ContextMenu();
cm.customItems.push(red_cmi);
cm.hideBuiltInItems();
var spr:Sprite = new Sprite();
spr.contextMenu = cm;
spr.graphics.beginFill(0x000000);
spr.graphics.drawRect(0, 0, 120, 90);
spr.graphics.endFill();
spr.x = 10;
spr.y = 10;
addChild(spr);
function cmi_menuItemSelect(evt:ContextMenuEvent):void {
spr.graphics.clear();
spr.graphics.beginFill(0xFF0000);
spr.graphics.drawRect(0, 0, 120, 90);
spr.graphics.endFill();
}
doubleClickEnabled | свойство |
doubleClickEnabled:Boolean| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Определяет, получает ли объект события doubleClick. Значение по умолчанию — false: по умолчанию экземпляр InteractiveObject не получает событий doubleClick. Если свойству doubleClickEnabled задано значение true, экземпляр получает события doubleClick в своих границах. Свойство mouseEnabled экземпляра InteractiveObject должно иметь значение true, чтобы объект мог получать события doubleClick.
При настройке данного свойства события не отправляются. Чтобы добавить прослушиватель события doubleClick, необходимо использовать метод addEventListener().
Реализация
public function get doubleClickEnabled():Boolean public function set doubleClickEnabled(value:Boolean):voidСвязанные элементы API
focusRect | свойство |
focusRect:Object| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Задает отображение прямоугольной рамки индикатора фокуса для данного объекта. Может принимать одно из трех значений true, false или null. Значения true и false дают ожидаемые результаты, определяя, будет ли появляться прямоугольник в фокусе. Значение null указывает, что данный объект подчиняется свойству stageFocusRect рабочей области.
Реализация
public function get focusRect():Object public function set focusRect(value:Object):voidmouseEnabled | свойство |
mouseEnabled:Boolean| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Определяет, получает ли этот объект события мыши или другого пользовательского ввода. Значение по умолчанию — true, которое указывает, что по умолчанию любой экземпляр InteractiveObject в списке отображения получает события мыши или других устройств пользовательского ввода. Если свойство mouseEnabled имеет значение false, экземпляр не получает событий мыши (или события другого пользовательского ввода, например клавиатуры). Эта настройка не затрагивает дочерние элементы данного экземпляра в списке отображения. Чтобы изменить поведение mouseEnabled для всех дочерних элементов объекта в списке отображения, используйте flash.display.DisplayObjectContainer.mouseChildren.
При настройке данного свойства события не отправляются. Чтобы создать интерактивные функции, необходимо использовать метод addEventListener().
Реализация
public function get mouseEnabled():Boolean public function set mouseEnabled(value:Boolean):voidСвязанные элементы API
needsSoftKeyboard | свойство |
needsSoftKeyboard:Boolean| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10.2, AIR 2.6 |
Определяет, должна ли отображаться виртуальная клавиатура (программная экранная клавиатура), когда этот экземпляр InteractiveObject получает фокус.
По умолчанию задано значение false. Когда экземпляр InteractiveObject получает фокус, программная клавиатура не отображается. Если для свойства needsSoftKeyboard задано значение true, то во время выполнения отображается программная клавиатура, когда экземпляр InteractiveObject готов принять ввод данных пользователем. Экземпляр InteractiveObject готов принять ввод данных пользователем после программного вызова для задания свойства focus рабочей области свойства или действий пользователя, например «касания». Если в клиентской системе есть аппаратная клавиатура или она не поддерживает виртуальные клавиатуры, то программная клавиатура не отображается.
Экземпляр InteractiveObject передает события softKeyboardActivating, softKeyboardActivate и softKeyboardDeactivate при отображении и переводе на задний план программной клавиатуры.
Примечание. Это свойство не поддерживается в приложениях AIR для iOS.
Реализация
public function get needsSoftKeyboard():Boolean public function set needsSoftKeyboard(value:Boolean):voidСвязанные элементы API
softKeyboard | свойство |
softKeyboard:String| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 21.0 |
Управляет внешним видом программной клавиатуры.
Устройства с программной клавиатурой могут настраивать кнопки клавиатуры в соответствии с типом ожидаемого ввода. Например, если ожидается ввод числовых данных, на устройстве может использоваться SoftKeyboardType.NUMBER для отображения только цифр для программной клавиатуры. Допустимые значения определены в виде констант в классе SoftKeyboardType:
- "default"
- "punctuation"
- "url"
- "number"
- "contact"
- "email"
- "phone"
- "decimalpad"
Эти значения служат подсказками, помогающим устройству отобразить наиболее подходящую клавиатуру для текущей операции.
Значением по умолчанию является SoftKeyboardType.DEFAULT.
Реализация
public function get softKeyboard():String public function set softKeyboard(value:String):voidВыдает
ArgumentError — Если задано значение, не являющееся элементом класса SoftKeyboardType
|
Связанные элементы API
softKeyboardInputAreaOfInterest | свойство |
softKeyboardInputAreaOfInterest:Rectangle| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10.2, AIR 2.6 |
Определяет область, которая должна оставаться на экране при отображении программной клавиатуры (недоступна в iOS).
Если для свойства needsSoftKeyboard этого объекта InteractiveObject задано значение true, то среда выполнения корректирует отображение, чтобы объект оставался в области отображения, когда пользователь вводит данные. Обычно среда выполнения использует границы объекта, полученные из метода DisplayObject.getBounds(). Можно указать другую область, используя свойство softKeyboardInputAreaOfInterest.
Укажите softKeyboardInputAreaOfInterest в координатах рабочей области.
Примечание. В ОС Android softKeyboardInputAreaOfInterest не учитывается с альбомной ориентацией.
Примечание. softKeyboardInputAreaOfInterest не поддерживается в iOS.
Реализация
public function get softKeyboardInputAreaOfInterest():Rectangle public function set softKeyboardInputAreaOfInterest(value:Rectangle):voidСвязанные элементы API
tabEnabled | свойство |
tabEnabled:Boolean| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Определяет, включен ли переход к этому объекту с помощью клавиши Tab. Если объект включен в последовательность перехода с помощью клавиши Tab, значение — true; в противном случае — false. По умолчанию используется значение false, за исключением следующих случаев.
- Для объекта SimpleButton используется значение
true. - Для объекта TextField с
type = "input"используется значениеtrue. - Для объекта Sprite или MovieClip с
buttonMode = trueиспользуется значениеtrue.
Реализация
public function get tabEnabled():Boolean public function set tabEnabled(value:Boolean):voidtabIndex | свойство |
tabIndex:int| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Задает последовательность перехода между объектами в SWF-файле. Свойство tabIndex по умолчанию имеет значение -1, то есть для объекта не задан индекс при переходе с помощью клавиши Tab.
Если какой-либо отображаемый в данный момент объект в SWF-файле имеет свойство tabIndex, автоматическая последовательность перехода с помощью клавиши Tab отключается, и последовательность перехода вычисляется по свойствам tabIndex объектов SWF-файла. Пользовательская последовательность перехода с помощью клавиши Tab включает только объекты, имеющие свойство tabIndex.
Свойство tabIndex может быть выражено неотрицательным числом. Последовательность перехода определяется в соответствии со свойствами tabIndex объектов в восходящем порядке. Объект со значением 1 свойства tabIndex предшествует объекту со значением 2 свойства tabIndex. Нельзя использовать одинаковое значение tabIndex для нескольких объектов.
Пользовательская последовательность перехода с помощью клавиши Tab, определяемая свойством tabIndex, является линейной. Это значит, что иерархические отношения объектов в SWF-файле не учитываются. Все объекты в SWF-файле со свойствами tabIndex помещаются в последовательность перехода с помощью клавиши Tab, которая определяется последовательностью значений tabIndex.
Примечание. Чтобы установить порядок табуляции для экземпляров TLFTextField, передайте дочерний объект экранного объекта TLFTextField как InteractiveObject, затем задайте свойство tabIndex. Например:
InteractiveObject(tlfInstance.getChildAt(1)).tabIndex = 3;Чтобы изменить порядок табуляции по умолчанию на обратный для трех экземпляров объекта TLFTextField (
tlfInstance1, tlfInstance2 и tlfInstance3), используйте:
InteractiveObject(tlfInstance1.getChildAt(1)).tabIndex = 3; InteractiveObject(tlfInstance2.getChildAt(1)).tabIndex = 2; InteractiveObject(tlfInstance3.getChildAt(1)).tabIndex = 1;
Реализация
public function get tabIndex():int public function set tabIndex(value:int):voidInteractiveObject | () | Конструктор |
public function InteractiveObject()| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
При вызове конструктора new InteractiveObject() выдается исключение ArgumentError. Однако можно вызывать конструкторы для следующих подклассов InteractiveObject:
new SimpleButton()new TextField()new Loader()new Sprite()new MovieClip()
requestSoftKeyboard | () | метод |
public function requestSoftKeyboard():Boolean| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10.2, AIR 2.6 |
Вызывает виртуальную клавиатуру.
Вызов этого метода наводит фокус на экземпляр InteractiveObject и вызывает программную клавиатуру, если необходимо. Значение needsSoftKeyboard должно равняться true. Клавиатура не вызывается, если доступна аппаратная клавиатура или если система клиента не поддерживает виртуальные клавиатуры.
Примечание. Этот метод не поддерживается в приложениях AIR для iOS.
ВозвращаетBoolean — Значение true означает передачу запроса программной клавиатуры, а false — программная клавиатура не вызывалась.
|
Связанные элементы API
clear | Событие |
flash.events.Eventсвойство Event.type =
flash.events.Event.CLEAR| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Отправляется, когда пользователь выбирает команду «Удалить» из контекстного меню текста. Это событие отправляется объекту, который в данный момент находится в фокусе. Если объектом, находящимся в фокусе, является экземпляр TextField, событием по умолчанию является удаление выделенного в данный момент текстового поля.
КонстантаEvent.CLEAR определяет значение свойства type объекта события clear.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
bubbles | false |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
target | Любой экземпляр DisplayObject, для которого зарегистрирован прослушиватель события clear. |
Примечание. Объектами TextField не отправляются события clear, copy, cut, paste или selectAll. Объекты TextField в контекстном меню всегда включают команды «Вырезать», «Скопировать», «Вставить» и «Выбрать все». Удалить эти команды из контекстного меню для объектов TextField невозможно. Для объектов TextField выбор этих команд (или сочетаний клавиш, эквивалентных элементу меню) не приводит к генерации событий clear, copy, cut, paste или selectAll. Однако другие классы, которые распространяют класс InteractiveObject, включая компоненты, построенные, используя текстовую Службу Flash (FTE), отправят эти события в ответ на операции пользователя, например, комбинации клавиш и контекстные меню.
click | Событие |
flash.events.MouseEventсвойство MouseEvent.type =
flash.events.MouseEvent.CLICK| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Отправляется, когда пользователь нажимает и отпускает главную кнопку на указывающем устройстве над одним и тем же объектом InteractiveObject. Чтобы произошло событие «click», оно должно следовать за данной последовательностью событий, перечисленных в порядке появления: событие mouseDown, а затем mouseUp. Оба эти события должны иметь ту же цель, иначе событие click не произойдет. Между событиями mouseDown или mouseUp может произойти любое количество других событий мыши; событие click все равно происходит.
type для объекта события click.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
altKey | true, если клавиша Alt активна (Windows). |
bubbles | true |
buttonDown | Для событий щелчка всегда используется значение false. |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
commandKey | true в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows. |
controlKey | true, если клавиша Ctrl или Control активна; false, если неактивна. |
ctrlKey | true в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
localX | Горизонтальная координата, в которой произошло событие, относительно спрайта-контейнера, если блокировка мыши отключена. |
localY | Вертикальная координата, в которой произошло событие, относительно спрайта-контейнера, если блокировка мыши отключена. |
movementX | Изменение горизонтальных координат положения мыши с последнего события мыши, если блокировка мыши включена. |
movementY | Изменение вертикальных координат положения мыши с последнего события мыши, если блокировка мыши включена. |
shiftKey | true, если клавиша Shift активна; иначе — false. |
stageX | Горизонтальная координата события в глобальных координатах рабочей области. |
stageY | Вертикальная координата события в глобальных координатах рабочей области. |
target | Объект InteractiveObject под указателем. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент. |
contextMenu | Событие |
flash.events.MouseEventсвойство MouseEvent.type =
flash.events.MouseEvent.CONTEXT_MENU| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
Отправляется, когда жест пользователя вызывает контекстное меню, связанное с данным интерактивным объектом в приложении AIR.
КонстантаMouseEvent.CONTEXT_MENU определяет значение свойства type объекта события contextMenu.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
altKey | true, если клавиша Alt активна (Windows). |
bubbles | true |
buttonDown | true, если правая кнопка мыши нажата; иначе —false. |
cancelable | false; поведение по умолчанию отменить невозможно. |
commandKey | true в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows. |
controlKey | true, если клавиша Ctrl или Control активна; false, если неактивна. |
ctrlKey | true в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
localX | Горизонтальная координата, в которой произошло событие, относительно спрайта-контейнера, если блокировка мыши отключена. |
localY | Вертикальная координата, в которой произошло событие, относительно спрайта-контейнера, если блокировка мыши отключена. |
movementX | Изменение горизонтальных координат положения мыши с последнего события мыши, если блокировка мыши включена. |
movementY | Изменение вертикальных координат положения мыши с последнего события мыши, если блокировка мыши включена. |
shiftKey | true, если клавиша Shift активна; иначе — false. |
clickCount | Число нажатий мышью, указывающее на то, является ли событие частью последовательности множественных нажатий мышью. |
stageX | Горизонтальная координата события в глобальных координатах рабочей области. |
stageY | Вертикальная координата события в глобальных координатах рабочей области. |
target | Объект InteractiveObject под указателем. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент. |
Связанные элементы API
copy | Событие |
flash.events.Eventсвойство Event.type =
flash.events.Event.COPY| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Отправляется, когда пользователь активирует комбинацию клавиш быстрого вызова, используемую на данной платформе для операции «Копировать», или выбирает команду «Копировать» из контекстного меню. Это событие отправляется объекту, который в данный момент находится в фокусе. Если объектом, находящимся в фокусе, является экземпляр TextField, событием по умолчанию является копирование в буфер обмена выделенного в данный момент текстового поля.
Задает значение свойстваtype для объекта события copy.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
bubbles | false |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
target | Любой экземпляр InteractiveObject, для которого зарегистрирован прослушиватель события copy. |
Примечание. Объектами TextField не отправляются события clear, copy, cut, paste или selectAll. Объекты TextField в контекстном меню всегда включают команды «Вырезать», «Скопировать», «Вставить» и «Выбрать все». Удалить эти команды из контекстного меню для объектов TextField невозможно. Для объектов TextField выбор этих команд (или сочетаний клавиш, эквивалентных элементу меню) не приводит к генерации событий clear, copy, cut, paste или selectAll. Однако другие классы, которые распространяют класс InteractiveObject, включая компоненты, построенные, используя текстовую Службу Flash (FTE), отправят эти события в ответ на операции пользователя, например, комбинации клавиш и контекстные меню.
cut | Событие |
flash.events.Eventсвойство Event.type =
flash.events.Event.CUT| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Отправляется, когда пользователь активирует комбинацию клавиш быстрого вызова, используемую на данной платформе для операции «Вырезать», или выбирает команду «Вырезать» из контекстного меню. Это событие отправляется объекту, который в данный момент находится в фокусе. Если объектом, находящимся в фокусе, является экземпляр TextField, событием по умолчанию является вырезание и сохранение в буфере обмена выделенного в данный момент текстового поля.
Задает значение свойстваtype для объекта события cut.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
bubbles | false |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
target | Любой экземпляр InteractiveObject, для которого зарегистрирован прослушиватель события cut. |
Примечание. Объектами TextField не отправляются события clear, copy, cut, paste или selectAll. Объекты TextField в контекстном меню всегда включают команды «Вырезать», «Скопировать», «Вставить» и «Выбрать все». Удалить эти команды из контекстного меню для объектов TextField невозможно. Для объектов TextField выбор этих команд (или сочетаний клавиш, эквивалентных элементу меню) не приводит к генерации событий clear, copy, cut, paste или selectAll. Однако другие классы, которые распространяют класс InteractiveObject, включая компоненты, построенные, используя текстовую Службу Flash (FTE), отправят эти события в ответ на операции пользователя, например, комбинации клавиш и контекстные меню.
doubleClick | Событие |
flash.events.MouseEventсвойство MouseEvent.type =
flash.events.MouseEvent.DOUBLE_CLICK| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Отправляется, когда пользователь дважды нажимает и отпускает главную кнопку на указывающем устройстве над одним и тем же объектом InteractiveObject, а флаг doubleClickEnabled для этого объекта имеет значение true. Чтобы произошло событие doubleClick, оно должно следовать непосредственно за этими последовательностями событий: mouseDown, mouseUp, click, mouseDown, mouseUp. У всех этих событий должна быть та же цель, что и у события doubleClick. Второй щелчок, представленный событиями mouseDown и mouseUp, должен произойти в пределах заданного периода времени после события click. Допустимая продолжительность этого периода варьируется в зависимости от операционной системы и может настраиваться пользователем. Если цель — выбираемое текстовое поле, действие по умолчанию — выделение слова, находящегося под указателем. Если у целевого объекта InteractiveObject флаг doubleClickEnabled имеет значение true, он получает два события click.
По умолчанию свойство doubleClickEnabled имеет значение false.
Выделение текста двойным щелчком как поведение объекта TextField не связано с событием doubleClick. Используйте TextField.doubleClickEnabled для управления выделением TextField.
type для объекта события doubleClick. Свойство doubleClickEnabled должно иметь значение true, чтобы объект мог генерировать событие doubleClick.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
altKey | true, если клавиша Alt активна (Windows). |
bubbles | true |
buttonDown | Для событий двойного щелчка всегда используется значение false. |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
commandKey | true в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows. |
controlKey | true, если клавиша Ctrl или Control активна; false, если неактивна. |
ctrlKey | true в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
localX | Горизонтальная координата, в которой произошло событие, относительно спрайта-контейнера, если блокировка мыши отключена. |
localY | Вертикальная координата, в которой произошло событие, относительно спрайта-контейнера, если блокировка мыши отключена. |
movementX | Изменение горизонтальных координат положения мыши с последнего события мыши, если блокировка мыши включена. |
movementY | Изменение вертикальных координат положения мыши с последнего события мыши, если блокировка мыши включена. |
shiftKey | true, если клавиша Shift активна; иначе — false. |
stageX | Горизонтальная координата события в глобальных координатах рабочей области. |
stageY | Вертикальная координата события в глобальных координатах рабочей области. |
target | Объект InteractiveObject под указателем. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент. |
Связанные элементы API
focusIn | Событие |
flash.events.FocusEventсвойство FocusEvent.type =
flash.events.FocusEvent.FOCUS_IN| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Отправляется после того, как экранный объект перемещается в фокус. Это происходит, когда пользователь выделяет объект с помощью указателя или клавиатуры. Получатель фокуса называется целевым объектом события, а соответствующий экземпляр InteractiveObject, потерявший фокус в результате данного изменения, называется связанным объектом. Ссылка на связанный объект сохраняется в свойстве relatedObject получающего объекта. Свойство shiftKey не используется. Это событие следует после отправки события focusOut предыдущего объекта.
type для объекта события focusIn.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
bubbles | true |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
keyCode | 0; применяется только к событиям keyFocusChange. |
relatedObject | Дополняющий экземпляр InteractiveObject, на который влияет смена фокуса. |
shiftKey | false; применяется только к событиям keyFocusChange. |
target | Экземпляр InteractiveObject, только что получивший фокус. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент.
|
direction | Направление, по которому был получен фокус. Это свойство сообщает значение параметра direction метода assignFocus() рабочей области. Если фокус изменился другим способом, значение всегда будет FocusDirection.NONE. Применяется только к событиям focusIn. Для всех других событий фокуса значение будет FocusDirection.NONE. |
focusOut | Событие |
flash.events.FocusEventсвойство FocusEvent.type =
flash.events.FocusEvent.FOCUS_OUT| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Отправляется после того, как экранный объект теряет фокус. Это происходит, когда пользователь выделяет другой объект с помощью указателя или клавиатуры. Объект, теряющий фокус, называется целевым объектом события, а соответствующий экземпляр InteractiveObject, получающий фокус, называется связанным объектом. Ссылка на связанный объект сохраняется в свойстве relatedObject целевого объекта. Свойство shiftKey не используется. Это событие предшествует отправке события focusIn связанным объектом.
type для объекта события focusOut.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
bubbles | true |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
keyCode | 0; применяется только к событиям keyFocusChange. |
relatedObject | Дополняющий экземпляр InteractiveObject, на который влияет смена фокуса. |
shiftKey | false; применяется только к событиям keyFocusChange. |
target | Экземпляр InteractiveObject, только что потерявший фокус. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент.
|
gestureDirectionalTap | Событие |
flash.events.TransformGestureEventсвойство TransformGestureEvent.type =
flash.events.TransformGestureEvent.GESTURE_DIRECTIONAL_TAP| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 24, Flash Lite 4 |
Отправляется, когда пользователь создает точку контакта вдоль края сенсорной поверхности с помощью экземпляра InteractiveObject (например, нажатие по краю сенсорной поверхности на пульте Siri Remote для Apple TV). Некоторые устройства также могут интерпретировать этот контакт как комбинацию нескольких событий касания.
В частности, если пользователь ставит палец на объект InteractiveObject, а затем сдвигает его, экземпляр InteractiveObject может отправить события touchBegin и touchEnd (помимо прочих), а также событие gestureDirectionalTap либо все события, если это поддерживается текущей средой. Выберите способ обработки взаимодействия с пользователем. Используйте класс flash.ui.Multitouch для управления обработкой событий (включите обработку событий сложных жестов, событий простых точечных касаний или выключите события касания, чтобы отправлялись только события мыши). Если задана обработка события touchBegin, один и тот же обработчик события будет использоваться для устройств с сенсорным экраном. Однако, если требуется обрабатывать событие gestureDirectionalTap, обработчик можно создать таким образом, чтобы он удовлетворял конкретные потребности устройств с сенсорным экраном и предоставлял пользователям расширенные возможности управления с помощью жестов. Также можно обрабатывать оба события по отдельности, чтобы обеспечить разную реакцию на события жеста и прикосновения. Но класс flash.ui.Multitouch определяет, какое событие будет отправлено: прикосновения или жеста.
При обработке свойств объекта Event необходимо учитывать, что в качестве значений свойств localX и localY используются координаты первой точки контакта (для Apple TV это центр экрана). Свойства offsetX и offsetY соответствуют направлению жеста.
Примечание. Данный API-интерфейс поддерживает только направленные прикосновения одним пальцем.
Определяет значение свойстваtype объекта события сенсорного экрана GESTURE_DIRECTIONAL_TAP.
Объект TransformGestureEvent имеет следующие свойства.
| Свойство | Значение |
|---|---|
altKey | true, если клавиша Alt активна (Windows или Linux). |
bubbles | true |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
commandKey | true в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows. |
controlKey | true, если клавиша Ctrl или Control активна; false, если неактивна. |
ctrlKey | true в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
phase | Текущая фаза в потоке событий. При отправке событий выделения всегда используется значение all, что соответствует значению GesturePhase.ALL. |
localX | Горизонтальная координата, в которой произошло событие, относительно контейнера-спрайта. Для направленных жестов касания это значение соответствует центру экрана. |
localY | Вертикальная координата, в которой произошло событие, относительно контейнера-спрайта. Для направленных жестов касания это значение соответствует центру экрана. |
scaleX | Масштабирование экранного объекта по горизонтали. Для направленных жестов касания это значение 1 |
scaleY | Масштабирование экранного объекта по вертикали. Для направленных жестов касания это значение 1 |
rotation | Текущий угол поворота экранного объекта относительно оси z (в градусах). Для направленных жестов касания это значение 0 |
offsetX | Обозначает горизонтальное направление: 1 — вправо, -1 — влево. |
offsetY | Обозначает вертикальное направление: 1 — вниз, -1 — вверх. |
velocity | Указывает скорость жеста смахивания в пикселях в секунду (только для AIR). |
shiftKey | true, если клавиша Shift активна; иначе — false. |
target | Экземпляр InteractiveObject под указывающим устройством. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент. |
Связанные элементы API
gestureLongPress | Событие |
flash.events.TapGestureEventсвойство TapGestureEvent.type =
flash.events.GestureEvent.GESTURE_LONG_PRESS| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Отправляется, когда пользователь наживает две точки контакта над одним экземпляром InteractiveObject на устройстве с сенсорным экраном (например, двумя пальцами нажимает точки над экранным объектом и отпускает их при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). Некоторые устройства также могут интерпретировать этот контакт как событие doubleClick.
В частности, если пользователь касается двумя пальцами объекта InteractiveObject, то экземпляр InteractiveObject может отправить события doubleClick или gestureTwoFingerTap, либо оба сразу, если это поддерживается текущей средой. Выберите способ обработки взаимодействия с пользователем. Используйте класс flash.ui.Multitouch для управления обработкой событий (включите обработку событий сложных жестов, событий простых точечных касаний или выключите события касания, чтобы отправлялись только события мыши). Если задана обработка события doubleClick, то один и тот же обработчик события будет использоваться для устройств с сенсорным экраном и для устройств с мышью. Однако если требуется обрабатывать событие gestureTwoFingerTap, обработчик можно создать таким образом, чтобы он реагировал на конкретные события устройства с сенсорным экраном и предоставлял пользователям расширенные возможности управления с помощью жестов. Также можно обрабатывать оба события по отдельности, чтобы обеспечить разную реакцию на события прикосновения и мыши.
Примечание. Сведения о совместимости сред см. в описании класса Multitouch.
Связанные элементы API
gesturePan | Событие |
flash.events.TransformGestureEventсвойство TransformGestureEvent.type =
flash.events.TransformGestureEvent.GESTURE_PAN| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Отправляется, когда пользователь перемещает точку контакта с экземпляром InteractiveObject на устройстве с сенсорным экраном (например, касается пальцем и проводит им слева направо над экранным объектом при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). Некоторые устройства также могут интерпретировать этот контакт как событие mouseOver и touchOver.
В частности, если пользователь проводит пальцем над объектом InteractiveObject, то вдобавок к событию gesturePan экземпляр InteractiveObject может отправить события mouseOver или touchOver либо все события сразу, если это поддерживается текущей средой. Выберите способ обработки взаимодействия с пользователем. Используйте класс flash.ui.Multitouch для управления обработкой событий (включите обработку событий сложных жестов, событий простых точечных касаний или выключите события касания, чтобы отправлялись только события мыши). Если задана обработка события mouseOver, то один и тот же обработчик события будет использоваться для устройств с сенсорным экраном и для устройств с мышью. Однако если требуется обрабатывать событие gesturePan, обработчик можно создать таким образом, чтобы он удовлетворял конкретные потребности устройств с сенсорным экраном и предоставлял пользователям расширенные возможности управления с помощью жестов. Также можно обрабатывать оба события по отдельности, чтобы обеспечить разную реакцию на события прикосновения и мыши.
Примечание. Сведения о совместимости сред см. в описании класса Multitouch.
Определяет значение свойстваtype объекта события сенсорного экрана GESTURE_PAN.
Объект TransformGestureEvent имеет следующие свойства.
| Свойство | Значение |
|---|---|
altKey | true, если клавиша Alt активна (Windows или Linux). |
bubbles | true |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
commandKey | true в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows. |
controlKey | true, если клавиша Ctrl или Control активна; false, если неактивна. |
ctrlKey | true в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
phase | Текущая фаза в потоке событий, значение представляет собой экземпляр класса GesturePhase. |
localX | Горизонтальная координата события относительно экранного объекта-контейнера. |
localY | Вертикальная координата события относительно экранного объекта-контейнера. |
scaleX | Масштабирование экранного объекта по горизонтали с момента предыдущего события жеста. Для жестов панорамирования задается значение 1. |
scaleY | Масштабирование экранного объекта по вертикали с момента предыдущего события жеста. Для жестов панорамирования задается значение 1. |
rotation | Текущий угол поворота экранного объекта относительно оси z с момента предыдущего события жеста. Для жестов панорамирования задается значение 0. |
offsetX | Перемещение экранного объекта по горизонтали относительно предыдущего события жеста. |
offsetY | Перемещение экранного объекта по вертикали относительно предыдущего события жеста. |
velocity | Скорость события жеста в пикселях в секунду (только для AIR). Для жеста панорамирования это значение 0. |
shiftKey | true, если клавиша 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";
}
}
Связанные элементы API
gestureRotate | Событие |
flash.events.TransformGestureEventсвойство TransformGestureEvent.type =
flash.events.TransformGestureEvent.GESTURE_ROTATE| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Отправляется, когда пользователь выполняет жест поворота в точке контакта с экземпляром InteractiveObject (например, касание двумя пальцами и их вращение над экранным объектом при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). Вращение двумя пальцами является распространенным жестом поворота, но в каждом устройстве и операционной системе могут быть собственные требования к жестам поворота. Некоторые устройства также могут интерпретировать такой жест как комбинацию из нескольких событий мыши.
В частности, если пользователь проводит пальцем над объектом InteractiveObject, то вдобавок к событию gestureRotate экземпляр InteractiveObject может отправить события mouseOver и click (помимо прочих), либо все события, если это поддерживается текущей средой. Выберите способ обработки взаимодействия с пользователем. Используйте класс flash.ui.Multitouch для управления обработкой событий (включите обработку событий сложных жестов, событий простых точечных касаний или выключите события касания, чтобы отправлялись только события мыши). Если задана обработка события mouseOver, то один и тот же обработчик события будет использоваться для устройств с сенсорным экраном и для устройств с мышью. Однако если требуется обрабатывать событие gestureRotate, обработчик можно создать таким образом, чтобы он удовлетворял конкретные потребности устройств с сенсорным экраном и предоставлял пользователям расширенные возможности управления с помощью жестов. Также можно обрабатывать оба события по отдельности, чтобы обеспечить разную реакцию на события прикосновения и мыши.
При обработке свойств объекта Event необходимо учитывать, что в качестве значений свойств localX и localY используются координаты первой точки контакта. Свойства offsetX и offsetY указывают расстояние до точки контакта, в которой завершился жест поворота.
Примечание. Сведения о совместимости сред см. в описании класса Multitouch.
Определяет значение свойстваtype объекта события сенсорного экрана GESTURE_ROTATE.
Во время этого события свойство rotation содержит угол поворота. Возможны следующие значения поворота:
- от 0 до 180 градусов указывают направление по часовой стрелке
- от - 180 до 0 градусов указывают направление против часовой стрелки
Объект TransformGestureEvent имеет следующие свойства.
| Свойство | Значение |
|---|---|
altKey | true, если клавиша Alt активна (Windows или Linux). |
bubbles | true |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
commandKey | true в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows. |
controlKey | true, если клавиша Ctrl или Control активна; false, если неактивна. |
ctrlKey | true в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
phase | Текущая фаза в потоке событий, значение представляет собой экземпляр класса GesturePhase. |
localX | Горизонтальная координата события относительно экранного объекта-контейнера. |
localY | Вертикальная координата события относительно экранного объекта-контейнера. |
scaleX | Масштабирование экранного объекта по горизонтали с момента предыдущего события жеста. |
scaleY | Масштабирование экранного объекта по вертикали с момента предыдущего события жеста. |
rotation | Текущий угол поворота экранного объекта относительно оси z с момента предыдущего события жеста. |
offsetX | Перемещение экранного объекта по горизонтали относительно предыдущего события жеста. |
offsetY | Перемещение экранного объекта по вертикали относительно предыдущего события жеста. |
velocity | Скорость события жеста в пикселях в секунду (только для AIR). Для жеста поворота это значение 0 |
shiftKey | true, если клавиша 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";
}
}
Связанные элементы API
gestureSwipe | Событие |
flash.events.TransformGestureEventсвойство TransformGestureEvent.type =
flash.events.TransformGestureEvent.GESTURE_SWIPE| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Отправляется, когда пользователь выполняет жест выделения в точке контакта с экземпляром InteractiveObject (например, касание экрана тремя пальцами и их параллельное перемещение над экранным объектом при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). Параллельное движение пальцами является распространенным жестом выделения, но в разных устройствах и операционных системах могут предъявляться различные требования к этому движению. Некоторые устройства также могут интерпретировать такой жест как комбинацию из нескольких событий мыши.
В частности, если пользователь ставит пальцы на объект InteractiveObject, а затем перемещает их параллельно, то вдобавок к событию gestureSwipe экземпляр InteractiveObject может отправить события rollOver и rollOut (помимо прочих), либо все события, если это поддерживается текущей средой. Выберите способ обработки взаимодействия с пользователем. Если задана обработка события rollOver, то один и тот же обработчик события будет использоваться для устройств с сенсорным экраном и для устройств с мышью. Однако если требуется обрабатывать событие gestureSwipe, обработчик можно создать таким образом, чтобы он удовлетворял конкретные потребности устройств с сенсорным экраном и предоставлял пользователям расширенные возможности управления с помощью жестов. Также можно обрабатывать оба события по отдельности, чтобы обеспечить разную реакцию на события прикосновения и мыши.
При обработке свойств объекта Event необходимо учитывать, что в качестве значений свойств localX и localY используются координаты первой точки контакта. Свойства offsetX и offsetY указывают расстояние до точки контакта, в которой завершился жест выделения.
Примечание. Хотя некоторые устройства с ОС Mac OS могут интерпретировать жест выделения четырьмя пальцами, данный API поддерживает только выделение тремя пальцами.
Определяет значение свойстваtype объекта события сенсорного экрана GESTURE_SWIPE.
Объект TransformGestureEvent имеет следующие свойства.
| Свойство | Значение |
|---|---|
altKey | true, если клавиша Alt активна (Windows или Linux). |
bubbles | true |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
commandKey | true в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows. |
controlKey | true, если клавиша Ctrl или Control активна; false, если неактивна. |
ctrlKey | true в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
phase | Текущая фаза в потоке событий. При отправке событий выделения всегда используется значение all, что соответствует значению GesturePhase.ALL. |
localX | Горизонтальная координата события относительно спрайта-контейнера. |
localY | Вертикальная координата события относительно спрайта-контейнера. |
scaleX | Масштабирование экранного объекта по горизонтали. Для жестов выделения задается значение 1 |
scaleY | Масштабирование экранного объекта по вертикали. Для жестов выделения задается значение 1 |
rotation | Текущий угол поворота экранного объекта относительно оси z (в градусах). Для жестов выделения задается значение 0 |
offsetX | Обозначает горизонтальное направление: 1 — вправо, -1 — влево. |
offsetY | Обозначает вертикальное направление: 1 — вниз, -1 — вверх. |
velocity | Указывает скорость жеста смахивания в пикселях в секунду (только для AIR). Для остальных это значение 0 |
shiftKey | true, если клавиша 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;
}
Связанные элементы API
gestureTap | Событие |
flash.events.TapGestureEventсвойство TapGestureEvent.type =
flash.events.PressAndTapGestureEvent.GESTURE_TAP| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Отправляется, когда пользователь создает точку контакта с экземпляром InteractiveObject, а затем касается сенсорного экрана (например, касается экранного объекта несколькими пальцами, чтобы открыть меню, а затем касается одним пальцем для выбора нужного элемента меню при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). Некоторые устройства также могут интерпретировать такой жест как комбинацию из нескольких событий мыши.
В частности, если пользователь наводит палец на объект InteractiveObject, а затем делает второе касание, то вдобавок к событию gesturePressAndTap экземпляр InteractiveObject может отправить события mouseOver и click (помимо прочих), либо все события, если это поддерживается текущей средой. Выберите способ обработки взаимодействия с пользователем. Используйте класс flash.ui.Multitouch для управления обработкой событий (включите обработку событий сложных жестов, событий простых точечных касаний или выключите события касания, чтобы отправлялись только события мыши). Если задана обработка события mouseOver, то один и тот же обработчик события будет использоваться для устройств с сенсорным экраном и для устройств с мышью. Однако если требуется обрабатывать событие gesturePressAndTap, обработчик можно создать таким образом, чтобы он реагировал на конкретные события устройства с сенсорным экраном и предоставлял пользователям расширенные возможности управления с помощью жестов. Также можно обрабатывать оба события по отдельности, чтобы обеспечить разную реакцию на события прикосновения и мыши.
При обработке свойств объекта Event необходимо учитывать, что в качестве значений свойств localX и localY используются координаты точки первичного контакта (нажатия). Свойства offsetX и offsetY указывают расстояние до точки вторичного контакта (касания).
Связанные элементы API
gestureZoom | Событие |
flash.events.TransformGestureEventсвойство TransformGestureEvent.type =
flash.events.TransformGestureEvent.GESTURE_ZOOM| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Отправляется, когда пользователь выполняет жест увеличения в точке контакта с экземпляром InteractiveObject (например, касание экрана двумя пальцами и их быстрое разведение в стороны над экранным объектом при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). Разведение пальцев является распространенным жестом увеличения, но в каждом устройстве и операционной системе могут быть собственные требования к жестам масштабирования. Некоторые устройства также могут интерпретировать такой жест как комбинацию из нескольких событий мыши.
В частности, если пользователь наводит палец на объект InteractiveObject, а затем разводит пальцы в стороны, то вдобавок к событию gestureZoom экземпляр InteractiveObject может отправить события mouseOver и click (помимо прочих), либо все события, если это поддерживается текущей средой. Выберите способ обработки взаимодействия с пользователем. Используйте класс flash.ui.Multitouch для управления обработкой событий (включите обработку событий сложных жестов, событий простых точечных касаний или выключите события касания, чтобы отправлялись только события мыши). Если задана обработка события mouseOver, то один и тот же обработчик события будет использоваться для устройств с сенсорным экраном и для устройств с мышью. Однако если требуется обрабатывать событие gestureZoom, обработчик можно создать таким образом, чтобы он удовлетворял конкретные потребности устройств с сенсорным экраном и предоставлял пользователям расширенные возможности управления с помощью жестов. Также можно обрабатывать оба события по отдельности, чтобы обеспечить разную реакцию на события прикосновения и мыши.
При обработке свойств объекта Event необходимо учитывать, что в качестве значений свойств localX и localY используются координаты первой точки контакта. Свойства offsetX и offsetY указывают расстояние до точки контакта, в которой завершился жест увеличения.
Примечание. Сведения о совместимости сред см. в описании класса Multitouch.
Определяет значение свойстваtype объекта события сенсорного экрана GESTURE_ZOOM.
Объект TransformGestureEvent имеет следующие свойства.
| Свойство | Значение |
|---|---|
altKey | true, если клавиша Alt активна (Windows или Linux). |
bubbles | true |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
commandKey | true в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows. |
controlKey | true, если клавиша Ctrl или Control активна; false, если неактивна. |
ctrlKey | true в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
phase | Текущая фаза в потоке событий, значение представляет собой экземпляр класса GesturePhase. |
localX | Горизонтальная координата события относительно экранного объекта-контейнера. |
localY | Вертикальная координата события относительно экранного объекта-контейнера. |
scaleX | Масштабирование экранного объекта по горизонтали с момента предыдущего события жеста. |
scaleY | Масштабирование экранного объекта по вертикали с момента предыдущего события жеста. |
rotation | Текущий угол поворота экранного объекта относительно оси z с момента предыдущего события жеста. |
offsetX | Перемещение экранного объекта по горизонтали относительно предыдущего события жеста. |
offsetY | Перемещение экранного объекта по вертикали относительно предыдущего события жеста. |
velocity | Скорость события жеста в пикселях в секунду (только для AIR). Для жеста изменения масштаба это значение 0 |
shiftKey | true, если клавиша 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";
}
}
Связанные элементы API
imeStartComposition | Событие |
flash.events.IMEEvent| Версии среды выполнения: | Flash Lite 4 |
Это событие отправляется любой клиентской программе, которая поддерживает линейный ввод с помощью IME.
keyDown | Событие |
flash.events.KeyboardEventсвойство KeyboardEvent.type =
flash.events.KeyboardEvent.KEY_DOWN| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Отправляется, когда пользователь нажимает клавишу. Соответствие клавиш и конкретных символов варьируется в зависимости от устройства и операционной системы. Этот тип событий создается после возникновения такого соответствия, но перед его обработкой редактором метода ввода IME. Редакторы IME используются для ввода таких символов, как китайские идеограммы, для чего малопригодна стандартная клавиатура QWERTY. Это событие происходит перед событием keyUp.
Отмена этого события в программе AIR предотвращает ввод этого символа в текстовое поле.
КонстантаKeyboardEvent.KEY_DOWN определяет значение свойства type объекта события keyDown.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
bubbles | true |
cancelable | true в AIR, false в Flash Player. Отмена этого события в AIR предотвращает ввод этого символа в текстовое поле. |
charCode | Значение кода символа для нажатой или отпущенной клавиши. |
commandKey | true в Mac, если клавиша Command активна. В противном случае false |
controlKey | true в Windows и Linux, если клавиша Ctrl активна. true в Mac, если клавиша Control активна. В противном случае false |
ctrlKey | true в Windows и Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
keyCode | Значение кода клавиши для нажатой или отпущенной клавиши. |
keyLocation | Расположение клавиши на клавиатуре. |
shiftKey | true, если клавиша Shift активна; иначе — false. |
target | Экземпляр InteractiveObject, находящийся в фокусе. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент. |
keyFocusChange | Событие |
flash.events.FocusEventсвойство FocusEvent.type =
flash.events.FocusEvent.KEY_FOCUS_CHANGE| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Отправляется, когда пользователь пытается изменить фокус с помощью клавиатуры. По умолчанию это событие изменяет фокус и отправляет соответствующие события focusIn и focusOut.
Это событие отправляется объекту, который в данный момент находится в фокусе. Связанным объектом этого события является экземпляр InteractiveObject, попадающий в фокус, если не изменить поведение по умолчанию. Чтобы предотвратить изменение фокуса, можно вызвать метод preventDefault() в прослушивателе событий, соответствующим образом зарегистрированном для целевого объекта. Фокус меняется, и события focusIn и focusOut отправляются по умолчанию.
type для объекта события keyFocusChange.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
bubbles | true |
cancelable | true; вызовите метод preventDefault() для отмены поведения по умолчанию. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
keyCode | Значение кода клавиши, нажатой для запуска события keyFocusChange. |
relatedObject | Дополняющий экземпляр InteractiveObject, на который влияет смена фокуса. |
shiftKey | true, если активирована клавиша Shift; иначе — false. |
target | Объект InteractiveObject, который в данный момент находится в фокусе. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент.
|
keyUp | Событие |
flash.events.KeyboardEventсвойство KeyboardEvent.type =
flash.events.KeyboardEvent.KEY_UP| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Отправляется, когда пользователь отпускает клавишу. Соответствие клавиш и конкретных символов варьируется в зависимости от устройства и операционной системы. Этот тип событий создается после возникновения такого соответствия, но перед его обработкой редактором метода ввода IME. Редакторы IME используются для ввода таких символов, как китайские идеограммы, для чего малопригодна стандартная клавиатура QWERTY. Это событие происходит после события keyDown и имеет следующие характеристики:
KeyboardEvent.KEY_UP определяет значение свойства type объекта события keyUp.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
bubbles | true |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
charCode | Содержит значение кода символа для нажатой или отпущенной клавиши. |
commandKey | true в Mac, если клавиша Command активна. В противном случае false |
controlKey | true в Windows и Linux, если клавиша Ctrl активна. true в Mac, если клавиша Control активна. В противном случае false |
ctrlKey | true в Windows, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
keyCode | Значение кода клавиши для нажатой или отпущенной клавиши. |
keyLocation | Расположение клавиши на клавиатуре. |
shiftKey | true, если клавиша Shift активна; иначе — false. |
target | Экземпляр InteractiveObject, находящийся в фокусе. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент. |
middleClick | Событие |
flash.events.MouseEventсвойство MouseEvent.type =
flash.events.MouseEvent.MIDDLE_CLICK| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0, Flash Lite 4 |
Отправляется, когда пользователь нажимает и отпускает среднюю кнопку указывающего устройства над одним и тем же объектом InteractiveObject. Чтобы произошло событие middleClick, оно должно следовать за данной последовательностью событий, перечисленных в порядке появления: событие middleMouseDown, затем событие middleMouseUp. Оба эти события должны иметь ту же цель, иначе событие middleClick не произойдет. Между событиями middleMouseDown или middleMouseUp может произойти любое количество других событий мыши; событие middleClick все равно происходит.
type объекта события middleClick.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
altKey | true, если клавиша Alt активна (Windows). |
bubbles | true |
buttonDown | Для событий промежуточного щелчка всегда используется значение false. |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
commandKey | true в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows. |
controlKey | true, если клавиша Ctrl или Control активна; false, если неактивна. |
ctrlKey | true в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
localX | Горизонтальная координата, в которой произошло событие, относительно спрайта-контейнера, если блокировка мыши отключена. |
localY | Вертикальная координата, в которой произошло событие, относительно спрайта-контейнера, если блокировка мыши отключена. |
movementX | Изменение горизонтальных координат положения мыши с последнего события мыши, если блокировка мыши включена. |
movementY | Изменение вертикальных координат положения мыши с последнего события мыши, если блокировка мыши включена. |
shiftKey | true, если клавиша Shift активна; иначе — false. |
stageX | Горизонтальная координата события в глобальных координатах рабочей области. |
stageY | Вертикальная координата события в глобальных координатах рабочей области. |
target | Объект InteractiveObject под указателем. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент. |
middleMouseDown | Событие |
flash.events.MouseEventсвойство MouseEvent.type =
flash.events.MouseEvent.MIDDLE_MOUSE_DOWN| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0, Flash Lite 4 |
Отправляется, когда пользователь нажимает среднюю кнопку указывающего устройства над экземпляром InteractiveObject.
Определяет значение свойстваtype объекта события middleMouseDown.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
altKey | true, если клавиша Alt активна (Windows). |
bubbles | true |
buttonDown | true, если нажата средняя кнопка мыши; иначе — false. |
cancelable | false; поведение по умолчанию отменить невозможно. |
commandKey | true в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows. |
controlKey | true, если клавиша Ctrl или Control активна; false, если неактивна. |
ctrlKey | true в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
localX | Горизонтальная координата, в которой произошло событие, относительно спрайта-контейнера, если блокировка мыши отключена. |
localY | Вертикальная координата, в которой произошло событие, относительно спрайта-контейнера, если блокировка мыши отключена. |
movementX | Изменение горизонтальных координат положения мыши с последнего события мыши, если блокировка мыши включена. |
movementY | Изменение вертикальных координат положения мыши с последнего события мыши, если блокировка мыши включена. |
shiftKey | true, если клавиша Shift активна; иначе — false. |
clickCount | Число нажатий мышью, указывающее на то, является ли событие частью последовательности множественных нажатий мышью. |
stageX | Горизонтальная координата события в глобальных координатах рабочей области. |
stageY | Вертикальная координата события в глобальных координатах рабочей области. |
target | Объект InteractiveObject под указателем. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент. |
middleMouseUp | Событие |
flash.events.MouseEventсвойство MouseEvent.type =
flash.events.MouseEvent.MIDDLE_MOUSE_UP| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0, Flash Lite 4 |
Отправляется, когда пользователь отпускает кнопку указывающего устройства над экземпляром InteractiveObject.
Определяет значение свойстваtype объекта события middleMouseUp.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
altKey | true, если клавиша Alt активна (Windows). |
bubbles | true |
buttonDown | true, если нажата средняя кнопка мыши; иначе — false. |
cancelable | false; поведение по умолчанию отменить невозможно. |
commandKey | true в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows. |
controlKey | true, если клавиша Ctrl или Control активна; false, если неактивна. |
ctrlKey | true в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
localX | Горизонтальная координата, в которой произошло событие, относительно спрайта-контейнера, если блокировка мыши отключена. |
localY | Вертикальная координата, в которой произошло событие, относительно спрайта-контейнера, если блокировка мыши отключена. |
movementX | Изменение горизонтальных координат положения мыши с последнего события мыши, если блокировка мыши включена. |
movementY | Изменение вертикальных координат положения мыши с последнего события мыши, если блокировка мыши включена. |
shiftKey | true, если клавиша Shift активна; иначе — false. |
clickCount | Число нажатий мышью, указывающее на то, является ли событие частью последовательности множественных нажатий мышью. |
stageX | Горизонтальная координата события в глобальных координатах рабочей области. |
stageY | Вертикальная координата события в глобальных координатах рабочей области. |
target | Объект InteractiveObject под указателем. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент. |
mouseDown | Событие |
flash.events.MouseEventсвойство MouseEvent.type =
flash.events.MouseEvent.MOUSE_DOWN| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Отправляется, когда пользователь нажимает кнопку указывающего устройства над экземпляром InteractiveObject. Если цель — экземпляр SimpleButton, кнопка по умолчанию отображает экранный объект downState. Если цель — выбираемое текстовое поле, то действие по умолчанию — начало выбора текстового поля.
type для объекта события mouseDown.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
altKey | true, если клавиша Alt активна (Windows). |
bubbles | true |
buttonDown | true, если нажата основная кнопка мыши; иначе — false. |
cancelable | false; поведение по умолчанию отменить невозможно. |
commandKey | true в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows. |
controlKey | true, если клавиша Ctrl или Control активна; false, если неактивна. |
ctrlKey | true в Windows и Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
localX | Горизонтальная координата, в которой произошло событие, относительно спрайта-контейнера, если блокировка мыши отключена. |
localY | Вертикальная координата, в которой произошло событие, относительно спрайта-контейнера, если блокировка мыши отключена. |
movementX | Изменение горизонтальных координат положения мыши с последнего события мыши, если блокировка мыши включена. |
movementY | Изменение вертикальных координат положения мыши с последнего события мыши, если блокировка мыши включена. |
shiftKey | true, если клавиша Shift активна; иначе — false. |
clickCount | Число нажатий мышью, указывающее на то, является ли событие частью последовательности множественных нажатий мышью. |
stageX | Горизонтальная координата события в глобальных координатах рабочей области. |
stageY | Вертикальная координата события в глобальных координатах рабочей области. |
target | Объект InteractiveObject под указателем. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент. |
mouseFocusChange | Событие |
flash.events.FocusEventсвойство FocusEvent.type =
flash.events.FocusEvent.MOUSE_FOCUS_CHANGE| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Отправляется, когда пользователь пытается изменить фокус с помощью указывающего устройства. По умолчанию это событие изменяет фокус и отправляет соответствующие события focusIn и focusOut.
Это событие отправляется объекту, который в данный момент находится в фокусе. Связанным объектом этого события является экземпляр InteractiveObject, попадающий в фокус, если не изменить поведение по умолчанию. Чтобы предотвратить изменение фокуса, можно вызвать метод preventDefault() в прослушивателе событий, соответствующим образом зарегистрированном для целевого объекта. Свойство shiftKey не используется. Фокус меняется, и события focusIn и focusOut отправляются по умолчанию.
type для объекта события mouseFocusChange.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
bubbles | true |
cancelable | true; вызовите метод preventDefault() для отмены поведения по умолчанию. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
keyCode | 0; применяется только к событиям keyFocusChange. |
relatedObject | Дополняющий экземпляр InteractiveObject, на который влияет смена фокуса. |
shiftKey | false; применяется только к событиям keyFocusChange. |
target | Объект InteractiveObject, который в данный момент находится в фокусе. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент.
|
mouseMove | Событие |
flash.events.MouseEventсвойство MouseEvent.type =
flash.events.MouseEvent.MOUSE_MOVE| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Отправляется, когда пользователь перемещает указывающее устройство в момент, когда курсор находится над объектом InteractiveObject. Если цель — текстовое поле, которое выбирает пользователь, действие по умолчанию — обновление выбора.
Задает значение свойстваtype для объекта события mouseMove.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
altKey | true, если клавиша Alt активна (Windows). |
bubbles | true |
buttonDown | true, если нажата основная кнопка мыши; иначе — false. |
cancelable | false; поведение по умолчанию отменить невозможно. |
commandKey | true в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows. |
controlKey | true, если клавиша Ctrl или Control активна; false, если неактивна. |
ctrlKey | true в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
localX | Горизонтальная координата, в которой произошло событие, относительно спрайта-контейнера, если блокировка мыши отключена. |
localY | Вертикальная координата, в которой произошло событие, относительно спрайта-контейнера, если блокировка мыши отключена. |
movementX | Изменение горизонтальных координат положения мыши с последнего события мыши, если блокировка мыши включена. |
movementY | Изменение вертикальных координат положения мыши с последнего события мыши, если блокировка мыши включена. |
shiftKey | true, если клавиша Shift активна; иначе — false. |
stageX | Горизонтальная координата события в глобальных координатах рабочей области. |
stageY | Вертикальная координата события в глобальных координатах рабочей области. |
target | Объект InteractiveObject под указателем. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент. |
mouseOut | Событие |
flash.events.MouseEventсвойство MouseEvent.type =
flash.events.MouseEvent.MOUSE_OUT| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Отправляется, когда пользователь перемещает указатель с экземпляра InteractiveObject. Целью события является объект, на который до этого был наведен указатель. relatedObject — это объект, на который перемещен указатель. Если целью является экземпляр SimpleButton, кнопка по умолчанию отображает экранный объект upState.
Событие mouseOut отправляется каждый раз при перемещении курсора мыши из области дочернего объекта контейнера экранных объектов, даже если был выполнен переход к другому дочернему объекту. Это событие имеет иную цель, в отличие от события rollOut, которое служит для упрощения кодировки поведений ролловера для контейнеров экранных объектов с дочерними элементами. Когда мышь покидает область экранного объекта или его дочерних элементов и переходит к объекту, не являющемуся его дочерним элементом, экранный объект отправляет событие rollOut. События rollOut отправляются последовательно вверх по восходящей цепочке, начиная с объекта и заканчивая объектом верхнего уровня, который не является корнем или предшественником объекта relatedObject.
type для объекта события mouseOut.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
altKey | true, если клавиша Alt активна (Windows). |
bubbles | true |
buttonDown | true, если нажата основная кнопка мыши; иначе — false. |
cancelable | false; поведение по умолчанию отменить невозможно. |
commandKey | true в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows. |
controlKey | true, если клавиша Ctrl или Control активна; false, если неактивна. |
ctrlKey | true в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
relatedObject | Объект списка отображения, на который сейчас указывает мышь. |
localX | Горизонтальная координата, в которой произошло событие, относительно спрайта-контейнера, если блокировка мыши отключена. |
localY | Вертикальная координата, в которой произошло событие, относительно спрайта-контейнера, если блокировка мыши отключена. |
movementX | Изменение горизонтальных координат положения мыши с последнего события мыши, если блокировка мыши включена. |
movementY | Изменение вертикальных координат положения мыши с последнего события мыши, если блокировка мыши включена. |
shiftKey | true, если клавиша Shift активна; иначе — false. |
stageX | Горизонтальная координата события в глобальных координатах рабочей области. |
stageY | Вертикальная координата события в глобальных координатах рабочей области. |
target | Объект InteractiveObject под указателем. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент. |
mouseOver | Событие |
flash.events.MouseEventсвойство MouseEvent.type =
flash.events.MouseEvent.MOUSE_OVER| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Отправляется, когда пользователь наводит указывающее устройство на экземпляр InteractiveObject. relatedObject — это объект, на который до этого был наведен указатель. Если цель — экземпляр SimpleButton, объект по умолчанию отображает объект отображения overState или upState в зависимости от того, нажата ли кнопка мыши.
Событие mouseOver отправляется каждый раз при перемещении курсора мыши в область дочернего объекта контейнера объектов отображения, даже при переходе с другого дочернего объекта контейнера объектов отображения. Это событие имеет иную цель, в отличие от события rollOver, которое служит для упрощения кодировки поведений отката для контейнеров объектов отображения с дочерними элементами. Когда мышь переходит в область экранного объекта или его дочерних элементов от объекта, не являющегося дочерним по отношению к данному объекту, экранный объект отправляет событие rollOver. События rollOver отправляются последовательно вниз по родительской цепочке объекта, начиная с элемента самого высокого уровня, не являющегося корневым элементом или предшествующим элементом relatedObject, и заканчивая самим объектом.
type для объекта события mouseOver.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
altKey | true, если клавиша Alt активна (Windows). |
bubbles | true |
buttonDown | true, если нажата основная кнопка мыши; иначе — false. |
cancelable | false; поведение по умолчанию отменить невозможно. |
commandKey | true в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows. |
controlKey | true, если клавиша Ctrl или Control активна; false, если неактивна. |
ctrlKey | true в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
relatedObject | Объект списка отображения, на который указывала мышь. |
localX | Горизонтальная координата, в которой произошло событие, относительно спрайта-контейнера, если блокировка мыши отключена. |
localY | Вертикальная координата, в которой произошло событие, относительно спрайта-контейнера, если блокировка мыши отключена. |
movementX | Изменение горизонтальных координат положения мыши с последнего события мыши, если блокировка мыши включена. |
movementY | Изменение вертикальных координат положения мыши с последнего события мыши, если блокировка мыши включена. |
shiftKey | true, если клавиша Shift активна; иначе — false. |
stageX | Горизонтальная координата события в глобальных координатах рабочей области. |
stageY | Вертикальная координата события в глобальных координатах рабочей области. |
target | Объект InteractiveObject под указателем. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент. |
mouseUp | Событие |
flash.events.MouseEventсвойство MouseEvent.type =
flash.events.MouseEvent.MOUSE_UP| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Отправляется, когда пользователь отпускает кнопку указывающего устройства над экземпляром InteractiveObject. Если целью является экземпляр SimpleButton, объект отображает экранный объект upState. Если целью является выбираемое текстовое поле, то действие по умолчанию — завершение выбора текстового поля.
type объекта события mouseUp.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
altKey | true, если клавиша Alt активна (Windows). |
bubbles | true |
buttonDown | true, если нажата основная кнопка мыши; иначе — false. |
cancelable | false; поведение по умолчанию отменить невозможно. |
commandKey | true в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows. |
controlKey | true, если клавиша Ctrl или Control активна; false, если неактивна. |
ctrlKey | true в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
localX | Горизонтальная координата, в которой произошло событие, относительно спрайта-контейнера, если блокировка мыши отключена. |
localY | Вертикальная координата, в которой произошло событие, относительно спрайта-контейнера, если блокировка мыши отключена. |
movementX | Изменение горизонтальных координат положения мыши с последнего события мыши, если блокировка мыши включена. |
movementY | Изменение вертикальных координат положения мыши с последнего события мыши, если блокировка мыши включена. |
shiftKey | true, если клавиша Shift активна; иначе — false. |
clickCount | Число нажатий мышью, указывающее на то, является ли событие частью последовательности множественных нажатий мышью. |
stageX | Горизонтальная координата события в глобальных координатах рабочей области. |
stageY | Вертикальная координата события в глобальных координатах рабочей области. |
target | Объект InteractiveObject под указателем. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент. |
mouseWheel | Событие |
flash.events.MouseEventсвойство MouseEvent.type =
flash.events.MouseEvent.MOUSE_WHEEL| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Отправляется при прокрутке колеса мыши над экземпляром InteractiveObject. Если цель — текстовое поле, то действие по умолчанию — прокрутка текста. Доступно только в операционных системах Microsoft Windows.
Задает значение свойстваtype для объекта события mouseWheel.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
altKey | true, если клавиша Alt активна (Windows). |
bubbles | true |
buttonDown | true, если нажата основная кнопка мыши; иначе — false. |
cancelable | false; поведение по умолчанию отменить невозможно. |
commandKey | true в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows. |
controlKey | true, если клавиша Ctrl или Control активна; false, если неактивна. |
ctrlKey | true в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
delta | Число строк за каждую прокрутку колесика мышки. |
localX | Горизонтальная координата, в которой произошло событие, относительно спрайта-контейнера, если блокировка мыши отключена. |
localY | Вертикальная координата, в которой произошло событие, относительно спрайта-контейнера, если блокировка мыши отключена. |
movementX | Изменение горизонтальных координат положения мыши с последнего события мыши, если блокировка мыши включена. |
movementY | Изменение вертикальных координат положения мыши с последнего события мыши, если блокировка мыши включена. |
shiftKey | true, если клавиша Shift активна; иначе — false. |
stageX | Горизонтальная координата события в глобальных координатах рабочей области. |
stageY | Вертикальная координата события в глобальных координатах рабочей области. |
target | Объект InteractiveObject под указателем. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент. |
nativeDragComplete | Событие |
flash.events.NativeDragEventсвойство NativeDragEvent.type =
flash.events.NativeDragEvent.NATIVE_DRAG_COMPLETE| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0, Flash Lite 4 |
Отправляется инициатором перетаскивания InteractiveObject, когда пользователь завершает жест перетаскивания.
Свойство dropAction события указывает действие, заданное целевым объектом перетаскивания; значение none (DragActions.NONE) указывает на то, что «сброс» перетаскиваемых данных был отменен или не был принят.
С помощью обработчика событий nativeDragComplete можно обновить состояние инициирующего объекта отображения, например удалив элемент из списка (при операции перетаскивания move) или изменив визуальные свойства.
type объекта события nativeDragComplete.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
allowedActions | Объект NativeDragOptions, указывающий действия, имеющие отношение к данной операции перетаскивания. |
bubbles | true |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
clipboard | Объект Clipboard, содержащий перетаскиваемые данные. |
dropAction | Действие, выбранное целью опускания (или none, если действие не было задано). |
nativeDragDrop | Событие |
flash.events.NativeDragEventсвойство NativeDragEvent.type =
flash.events.NativeDragEvent.NATIVE_DRAG_DROP| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0, Flash Lite 4 |
Отправляется целевым объектом InteractiveObject при принятии перетаскиваемого объекта вызовом метода DragManager.acceptDragDrop().
Доступ к перенесенным данным можно получить с помощью свойства clipboard объекта события.
Обработчик этого события должен установить свойство DragManager.dropAction, чтобы сообщить объекту-инициатору о том, какое действие перетаскивания было выполнено. Если значение не задано, DragManager выберет в списке допустимых действий значение по умолчанию.
type объекта события nativeDragDrop.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
allowedActions | Объект NativeDragOptions, указывающий действия, имеющие отношение к данной операции перетаскивания. |
bubbles | true |
cancelable | true; отмена данного события отменяет операцию перетаскивания. |
clipboard | Объект Clipboard, содержащий перетаскиваемые данные. Буфер обмена может считываться даже если объект, отправивший данное событие находится не в том же домене защиты, что и инициатор. |
dropAction | Действие, выбранное целью опускания (или none, если действие не было задано). |
nativeDragEnter | Событие |
flash.events.NativeDragEventсвойство NativeDragEvent.type =
flash.events.NativeDragEvent.NATIVE_DRAG_ENTER| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0, Flash Lite 4 |
Отправляется объектом InteractiveObject, когда жест перетаскивания входит в его границы.
Чтобы экранный объект мог стать целевым объектом перетаскивания, необходимо обрабатывать либо события nativeDragEnter, либо события nativeDragOver.
Чтобы определить, может ли отправляющий объект принять перетаскиваемые данные, проверьте приемлемость данных в свойстве clipboard объекта события, и допустимые действия перетаскивания в свойстве allowedActions.
type объекта события nativeDragEnter.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
allowedActions | Объект NativeDragOptions, указывающий действия, имеющие отношение к данной операции перетаскивания. |
bubbles | true |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
clipboard | Объект Clipboard, содержащий перетаскиваемые данные. Буфер обмена может считываться только если объект, отправивший данное событие находится том же домене защиты, что и инициатор. |
dropAction | Действие, выбранное целью опускания (или none, если действие не было задано). |
nativeDragExit | Событие |
flash.events.NativeDragEventсвойство NativeDragEvent.type =
flash.events.NativeDragEvent.NATIVE_DRAG_EXIT| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0, Flash Lite 4 |
Отправляется объектом InteractiveObject, когда жест перетаскивания выходит за границы этого объекта.
NativeDragEvent.NATIVE_DRAG_EXIT определяет значение свойстваtype объекта события nativeDragExit.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
allowedActions | Объект NativeDragOptions, указывающий действия, имеющие отношение к данной операции перетаскивания. |
bubbles | true |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
clipboard | Объект Clipboard, содержащий перетаскиваемые данные. Буфер обмена может считываться только если объект, отправивший данное событие находится том же домене защиты, что и инициатор. |
dropAction | Действие, выбранное целью опускания (или none, если действие не было задано). |
nativeDragOver | Событие |
flash.events.NativeDragEventсвойство NativeDragEvent.type =
flash.events.NativeDragEvent.NATIVE_DRAG_OVER| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0, Flash Lite 4 |
Постоянно отправляется объектом InteractiveObject, пока жест перетаскивания остается в пределах его границ.
События nativeDragOver отправляются при каждом движении мыши. В Windows и Mac эти события также отправляются при коротком интервале таймера даже при отсутствии движения мыши.
Чтобы экранный объект мог стать целевым объектом перетаскивания, необходимо обрабатывать либо события nativeDragOver, либо события nativeDragEnter.
Чтобы определить, может ли отправляющий объект принять перетаскиваемые данные, проверьте приемлемость данных в свойстве clipboard объекта события, и допустимые действия перетаскивания в свойстве allowedActions.
type объекта события nativeDragOver.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
allowedActions | Объект NativeDragOptions, указывающий действия, имеющие отношение к данной операции перетаскивания. |
bubbles | true |
cancelable | true; отмена данного события отменяет операцию перетаскивания. |
clipboard | Объект Clipboard, содержащий перетаскиваемые данные. Буфер обмена может считываться только если объект, отправивший данное событие находится том же домене защиты, что и инициатор. |
dropAction | Действие, выбранное целью опускания (или none, если действие не было задано). |
nativeDragStart | Событие |
flash.events.NativeDragEventсвойство NativeDragEvent.type =
flash.events.NativeDragEvent.NATIVE_DRAG_START| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0, Flash Lite 4 |
Отправляется в начале операции перетаскивания объектом InteractiveObject, заданным в качестве инициатора перетаскивания в вызове метода DragManager.doDrag().
NativeDragEvent.NATIVE_DRAG_START определяет значение свойстваtype объекта события nativeDragStart.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
allowedActions | Объект NativeDragOptions, указывающий действия, имеющие отношение к данной операции перетаскивания. |
bubbles | true |
cancelable | true; отмена данного события отменяет операцию перетаскивания. |
clipboard | Объект Clipboard, содержащий перетаскиваемые данные. |
dropAction | Действие, выбранное целью опускания (или none, если действие не было задано). |
nativeDragUpdate | Событие |
flash.events.NativeDragEventсвойство NativeDragEvent.type =
flash.events.NativeDragEvent.NATIVE_DRAG_UPDATE| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0, Flash Lite 4 |
Отправляется во время операции перетаскивания объектом InteractiveObject, заданным в качестве инициатора перетаскивания в вызове метода DragManager.doDrag().
События nativeDragUpdate не отправляются в Linux.
type объекта события nativeDragUpdate.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
allowedActions | Объект NativeDragOptions, указывающий действия, имеющие отношение к данной операции перетаскивания. |
bubbles | true |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
clipboard | Объект Clipboard, содержащий перетаскиваемые данные. |
dropAction | Действие, выбранное целью опускания (или none, если действие не было задано). |
paste | Событие |
flash.events.Eventсвойство Event.type =
flash.events.Event.PASTE| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Отправляется, когда пользователь активирует комбинацию клавиш ускорения, используемую на данной платформе для операции «Вставить», или выбирает команду «Вставить» из контекстного меню. Это событие отправляется объекту, который в данный момент находится в фокусе. Если объект, находящийся в фокусе, является экземпляром TextField, по умолчанию содержимое буфера обмена вставляется в текстовое поле в текущей точке вставки, заменяя выделенный текст в поле.
КонстантаEvent.PASTE определяет значение свойства type объекта события paste.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
bubbles | значение true ( |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
target | Любой экземпляр InteractiveObject, для которого зарегистрирован прослушиватель события paste. |
Примечание. Объектами TextField не отправляются события clear, copy, cut, paste или selectAll. Объекты TextField в контекстном меню всегда включают команды «Вырезать», «Скопировать», «Вставить» и «Выбрать все». Удалить эти команды из контекстного меню для объектов TextField невозможно. Для объектов TextField выбор этих команд (или сочетаний клавиш, эквивалентных элементу меню) не приводит к генерации событий clear, copy, cut, paste или selectAll. Однако другие классы, которые распространяют класс InteractiveObject, включая компоненты, построенные, используя текстовую Службу Flash (FTE), отправят эти события в ответ на операции пользователя, например, комбинации клавиш и контекстные меню.
proximityBegin | Событие |
flash.events.TouchEventсвойство TouchEvent.type =
flash.events.TouchEvent.PROXIMITY_BEGIN| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 3 |
Отправляется, когда пользователь опускает активное перо ниже установленного для экрана порога обнаружения приближения.
Типичная последовательность событий, происходящих, когда пользователь опускает перо на экран, перемещает его по экрану и поднимает его:
- proximityBegin
- proximityMove
- touchBegin
- touchMove
- touchEnd
- proximityMove
- proximityEnd
Примечание. Сведения о совместимости сред см. в описании класса Multitouch.
Определяет значение свойстваtype объекта события прикосновения PROXIMITY_BEGIN.
Объект TouchEvent имеет следующие свойства.
| Свойство | Значение |
|---|---|
altKey | true, если клавиша Alt активна (Windows или Linux). |
bubbles | true |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
commandKey | true в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows. |
controlKey | true, если клавиша Ctrl или Control активна; false, если неактивна. |
ctrlKey | true в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
eventPhase | Текущая фаза в потоке событий. |
isRelatedObjectInaccessible | Имеет значение true, если свойству relatedObject задано значение null в соответствии с правилами изолированной среды безопасности. |
localX | Горизонтальная координата события относительно спрайта-контейнера. |
localY | Вертикальная координата события относительно спрайта-контейнера. |
pressure | Значение в диапазоне 0.0 — 1.0, определяющее интенсивность контакта с устройством. Если устройство не поддерживает определение давления, используется значение 1.0. |
relatedObject | Ссылка на объект списка отображения, связанный с событием. |
shiftKey | true, если клавиша Shift активна; иначе — false. |
sizeX | Ширина области контакта. |
sizeY | Высота области контакта. |
stageX | Горизонтальная координата события в глобальных координатах рабочей области. |
stageY | Вертикальная координата события в глобальных координатах рабочей области. |
target | Экземпляр InteractiveObject под указывающим устройством. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент. |
touchPointID | Уникальный идентификационный номер (целое число), присвоенный точке касания. |
timestamp | (только в среде AIR) Метка времени события в миллисекундах относительно времени запуска приложения. |
touchIntent | (только в среде AIR) Значение, полученное из класса TouchEventIntent. |
isTouchPointCanceled | (только в среде AIR) Значение true, если событие прикосновения отменено из-за логики отклонения прикосновения устройства. |
Связанные элементы API
proximityEnd | Событие |
flash.events.TouchEventсвойство TouchEvent.type =
flash.events.TouchEvent.PROXIMITY_END| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 3 |
Отправляется, когда пользователь поднимает активное перо, превышая установленный для экрана порог обнаружения приближения.
Событие proximityEnd не отправляется, когда перо касается экрана.
Типичная последовательность событий, происходящих, когда пользователь опускает перо на экран, перемещает его по экрану и поднимает его:
- proximityBegin
- proximityMove
- touchBegin
- touchMove
- touchEnd
- proximityMove
- proximityEnd
Примечание. Сведения о совместимости сред см. в описании класса Multitouch.
Определяет значение свойстваtype объекта события прикосновения PROXIMITY_END.
Объект TouchEvent имеет следующие свойства.
| Свойство | Значение |
|---|---|
altKey | true, если клавиша Alt активна (Windows или Linux). |
bubbles | true |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
commandKey | true в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows. |
controlKey | true, если клавиша Ctrl или Control активна; false, если неактивна. |
ctrlKey | true в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
eventPhase | Текущая фаза в потоке событий. |
isRelatedObjectInaccessible | Имеет значение true, если свойству relatedObject задано значение null в соответствии с правилами изолированной среды безопасности. |
localX | Горизонтальная координата события относительно спрайта-контейнера. |
localY | Вертикальная координата события относительно спрайта-контейнера. |
pressure | Значение в диапазоне 0.0 — 1.0, определяющее интенсивность контакта с устройством. Если устройство не поддерживает определение давления, используется значение 1.0. |
relatedObject | Ссылка на объект списка отображения, связанный с событием. |
shiftKey | true, если клавиша Shift активна; иначе — false. |
sizeX | Ширина области контакта. |
sizeY | Высота области контакта. |
stageX | Горизонтальная координата события в глобальных координатах рабочей области. |
stageY | Вертикальная координата события в глобальных координатах рабочей области. |
target | Экземпляр InteractiveObject под указывающим устройством. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент. |
touchPointID | Уникальный идентификационный номер (целое число), присвоенный точке касания. |
timestamp | (только в среде AIR) Метка времени события в миллисекундах относительно времени запуска приложения. |
touchIntent | (только в среде AIR) Значение, полученное из класса TouchEventIntent. |
isTouchPointCanceled | (только в среде AIR) Значение true, если событие прикосновения отменено из-за логики отклонения прикосновения устройства. |
Связанные элементы API
proximityMove | Событие |
flash.events.TouchEventсвойство TouchEvent.type =
flash.events.TouchEvent.PROXIMITY_MOVE| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 3 |
Отправляется, когда пользователь наводит активное перо на экран, не превышая установленный для экрана порог обнаружения приближения.
Типичная последовательность событий, происходящих, когда пользователь опускает перо на экран, перемещает его по экрану и поднимает его:
- proximityBegin
- proximityMove
- touchBegin
- touchMove
- touchEnd
- proximityMove
- proximityEnd
Примечание. Сведения о совместимости сред см. в описании класса Multitouch.
Определяет значение свойстваtype объекта события прикосновения PROXIMITY_MOVE.
Объект TouchEvent имеет следующие свойства.
| Свойство | Значение |
|---|---|
altKey | true, если клавиша Alt активна (Windows или Linux). |
bubbles | true |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
commandKey | true в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows. |
controlKey | true, если клавиша Ctrl или Control активна; false, если неактивна. |
ctrlKey | true в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
eventPhase | Текущая фаза в потоке событий. |
isRelatedObjectInaccessible | Имеет значение true, если свойству relatedObject задано значение null в соответствии с правилами изолированной среды безопасности. |
localX | Горизонтальная координата события относительно спрайта-контейнера. |
localY | Вертикальная координата события относительно спрайта-контейнера. |
pressure | Значение в диапазоне 0.0 — 1.0, определяющее интенсивность контакта с устройством. Если устройство не поддерживает определение давления, используется значение 1.0. |
relatedObject | Ссылка на объект списка отображения, связанный с событием. |
shiftKey | true, если клавиша Shift активна; иначе — false. |
sizeX | Ширина области контакта. |
sizeY | Высота области контакта. |
stageX | Горизонтальная координата события в глобальных координатах рабочей области. |
stageY | Вертикальная координата события в глобальных координатах рабочей области. |
target | Экземпляр InteractiveObject под указывающим устройством. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент. |
touchPointID | Уникальный идентификационный номер (целое число), присвоенный точке касания. |
timestamp | (только в среде AIR) Метка времени события в миллисекундах относительно времени запуска приложения. |
touchIntent | (только в среде AIR) Значение, полученное из класса TouchEventIntent. |
isTouchPointCanceled | (только в среде AIR) Значение true, если событие прикосновения отменено из-за логики отклонения прикосновения устройства. |
Связанные элементы API
proximityOut | Событие |
flash.events.TouchEventсвойство TouchEvent.type =
flash.events.TouchEvent.PROXIMITY_OUT| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 3 |
Отправляется, когда пользователь переводит активное перо от этого объекта InteractiveObject, не превышая установленный для экрана порог обнаружения приближения.
Примечание. Сведения о совместимости сред см. в описании класса Multitouch.
Определяет значение свойстваtype объекта события прикосновения PROXIMITY_OUT.
Объект TouchEvent имеет следующие свойства.
| Свойство | Значение |
|---|---|
altKey | true, если клавиша Alt активна (Windows или Linux). |
bubbles | true |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
commandKey | true в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows. |
controlKey | true, если клавиша Ctrl или Control активна; false, если неактивна. |
ctrlKey | true в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
eventPhase | Текущая фаза в потоке событий. |
isRelatedObjectInaccessible | Имеет значение true, если свойству relatedObject задано значение null в соответствии с правилами изолированной среды безопасности. |
localX | Горизонтальная координата события относительно спрайта-контейнера. |
localY | Вертикальная координата события относительно спрайта-контейнера. |
pressure | Значение в диапазоне 0.0 — 1.0, определяющее интенсивность контакта с устройством. Если устройство не поддерживает определение давления, используется значение 1.0. |
relatedObject | Ссылка на объект списка отображения, связанный с событием. |
shiftKey | true, если клавиша Shift активна; иначе — false. |
sizeX | Ширина области контакта. |
sizeY | Высота области контакта. |
stageX | Горизонтальная координата события в глобальных координатах рабочей области. |
stageY | Вертикальная координата события в глобальных координатах рабочей области. |
target | Экземпляр InteractiveObject под указывающим устройством. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент. |
touchPointID | Уникальный идентификационный номер (целое число), присвоенный точке касания. |
timestamp | (только в среде AIR) Метка времени события в миллисекундах относительно времени запуска приложения. |
touchIntent | (только в среде AIR) Значение, полученное из класса TouchEventIntent. |
isTouchPointCanceled | (только в среде AIR) Значение true, если событие прикосновения отменено из-за логики отклонения прикосновения устройства. |
Связанные элементы API
proximityOver | Событие |
flash.events.TouchEventсвойство TouchEvent.type =
flash.events.TouchEvent.PROXIMITY_OVER| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 3 |
Отправляется, когда пользователь наводит активное перо непосредственно на этот объект InteractiveObject, не превышая установленный для экрана порог обнаружения приближения.
Примечание. Сведения о совместимости сред см. в описании класса Multitouch.
Определяет значение свойстваtype объекта события прикосновения PROXIMITY_OVER.
Объект TouchEvent имеет следующие свойства.
| Свойство | Значение |
|---|---|
altKey | true, если клавиша Alt активна (Windows или Linux). |
bubbles | true |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
commandKey | true в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows. |
controlKey | true, если клавиша Ctrl или Control активна; false, если неактивна. |
ctrlKey | true в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
eventPhase | Текущая фаза в потоке событий. |
isRelatedObjectInaccessible | Имеет значение true, если свойству relatedObject задано значение null в соответствии с правилами изолированной среды безопасности. |
localX | Горизонтальная координата события относительно спрайта-контейнера. |
localY | Вертикальная координата события относительно спрайта-контейнера. |
pressure | Значение в диапазоне 0.0 — 1.0, определяющее интенсивность контакта с устройством. Если устройство не поддерживает определение давления, используется значение 1.0. |
relatedObject | Ссылка на объект списка отображения, связанный с событием. |
shiftKey | true, если клавиша Shift активна; иначе — false. |
sizeX | Ширина области контакта. |
sizeY | Высота области контакта. |
stageX | Горизонтальная координата события в глобальных координатах рабочей области. |
stageY | Вертикальная координата события в глобальных координатах рабочей области. |
target | Экземпляр InteractiveObject под указывающим устройством. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент. |
touchPointID | Уникальный идентификационный номер (целое число), присвоенный точке касания. |
timestamp | (только в среде AIR) Метка времени события в миллисекундах относительно времени запуска приложения. |
touchIntent | (только в среде AIR) Значение, полученное из класса TouchEventIntent. |
isTouchPointCanceled | (только в среде AIR) Значение true, если событие прикосновения отменено из-за логики отклонения прикосновения устройства. |
Связанные элементы API
proximityRollOut | Событие |
flash.events.TouchEventсвойство TouchEvent.type =
flash.events.TouchEvent.PROXIMITY_ROLL_OUT| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 3 |
Отправляется, когда пользователь перемещает активное перо от этого объекта InteractiveObject и любого из его дочерних объектов, не превышая установленный для экрана порог обнаружения приближения.
Цель этого события — объект, который ранее находился под пером, или родительский объект. relatedObject — это объект, на который наведено перо. События proximityRollOut отправляются последовательно по родительской цепочке по восходящей от объекта, начиная с объекта и заканчивая самым верхним родительским элементом, не являющимся корнем или предшественником для объекта relatedObject.
Цель события proximityRollOut — упростить кодировку событий наведения для контейнеров экранных объектов с дочерними элементами. При выходе пера из области экранного объекта или области любого из его дочерних элементов для перехода к объекту, не являющемуся одним из его дочерних элементов, экранный объект отправляет событие proximityRollOut. Это поведение отличается от поведения события proximityOut, которое отправляется каждый раз при перемещении курсора мыши из области дочернего объекта контейнера экранных объектов, даже если он находится на другом дочернем объекте контейнера экранных объектов.
Примечание. Сведения о совместимости сред см. в описании класса Multitouch.
Определяет значение свойстваtype объекта события прикосновения PROXIMITY_ROLL_OUT.
Объект TouchEvent имеет следующие свойства.
| Свойство | Значение |
|---|---|
altKey | true, если клавиша Alt активна (Windows или Linux). |
bubbles | true |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
commandKey | true в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows. |
controlKey | true, если клавиша Ctrl или Control активна; false, если неактивна. |
ctrlKey | true в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
eventPhase | Текущая фаза в потоке событий. |
isRelatedObjectInaccessible | Имеет значение true, если свойству relatedObject задано значение null в соответствии с правилами изолированной среды безопасности. |
localX | Горизонтальная координата события относительно спрайта-контейнера. |
localY | Вертикальная координата события относительно спрайта-контейнера. |
pressure | Значение в диапазоне 0.0 — 1.0, определяющее интенсивность контакта с устройством. Если устройство не поддерживает определение давления, используется значение 1.0. |
relatedObject | Ссылка на объект списка отображения, связанный с событием. |
shiftKey | true, если клавиша Shift активна; иначе — false. |
sizeX | Ширина области контакта. |
sizeY | Высота области контакта. |
stageX | Горизонтальная координата события в глобальных координатах рабочей области. |
stageY | Вертикальная координата события в глобальных координатах рабочей области. |
target | Экземпляр InteractiveObject под указывающим устройством. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент. |
touchPointID | Уникальный идентификационный номер (целое число), присвоенный точке касания. |
timestamp | (только в среде AIR) Метка времени события в миллисекундах относительно времени запуска приложения. |
touchIntent | (только в среде AIR) Значение, полученное из класса TouchEventIntent. |
isTouchPointCanceled | (только в среде AIR) Значение true, если событие прикосновения отменено из-за логики отклонения прикосновения устройства. |
Связанные элементы API
proximityRollOver | Событие |
flash.events.TouchEventсвойство TouchEvent.type =
flash.events.TouchEvent.PROXIMITY_ROLL_OVER| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 3 |
Отправляется, когда пользователь переводит активное перо на этот объект InteractiveObject из внешней части дерева потомков в списке отображения (не превышая установленный для экрана порог обнаружения близости).
Цель этого события — объект, находящийся под пером, или родительский объект. relatedObject — это объект, на который до этого было наведено перо. События proximityRollOver отправляются последовательно вниз по родительской цепочке объекта, начиная с элемента самого высокого уровня, не являющегося корневым элементом или предшествующим элементом relatedObject, и заканчивая самим объектом.
Цель события proximityRollOver — упростить кодировку поведений отката для контейнеров экранных объектов с дочерними элементами. Когда перо переходит в область над экранным объектом или его дочерними элементами от объекта, не являющегося дочерним по отношению к данному объекту, экранный объект отправляет событие proximityRollOver. Это поведение отличается от события proximityOver, которое отправляется каждый раз при переходе мыши в область любого дочернего объекта контейнера экранных объектов, даже если она переместилась туда с другого дочернего объекта контейнера.
Примечание. Сведения о совместимости сред см. в описании класса Multitouch.
Определяет значение свойстваtype объекта события прикосновения PROXIMITY_ROLL_OVER.
Объект TouchEvent имеет следующие свойства.
| Свойство | Значение |
|---|---|
altKey | true, если клавиша Alt активна (Windows или Linux). |
bubbles | true |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
commandKey | true в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows. |
controlKey | true, если клавиша Ctrl или Control активна; false, если неактивна. |
ctrlKey | true в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
eventPhase | Текущая фаза в потоке событий. |
isRelatedObjectInaccessible | Имеет значение true, если свойству relatedObject задано значение null в соответствии с правилами изолированной среды безопасности. |
localX | Горизонтальная координата события относительно спрайта-контейнера. |
localY | Вертикальная координата события относительно спрайта-контейнера. |
pressure | Значение в диапазоне 0.0 — 1.0, определяющее интенсивность контакта с устройством. Если устройство не поддерживает определение давления, используется значение 1.0. |
relatedObject | Ссылка на объект списка отображения, связанный с событием. |
shiftKey | true, если клавиша Shift активна; иначе — false. |
sizeX | Ширина области контакта. |
sizeY | Высота области контакта. |
stageX | Горизонтальная координата события в глобальных координатах рабочей области. |
stageY | Вертикальная координата события в глобальных координатах рабочей области. |
target | Экземпляр InteractiveObject под указывающим устройством. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент. |
touchPointID | Уникальный идентификационный номер (целое число), присвоенный точке касания. |
timestamp | (только в среде AIR) Метка времени события в миллисекундах относительно времени запуска приложения. |
touchIntent | (только в среде AIR) Значение, полученное из класса TouchEventIntent. |
isTouchPointCanceled | (только в среде AIR) Значение true, если событие прикосновения отменено из-за логики отклонения прикосновения устройства. |
Связанные элементы API
releaseOutside | Событие |
flash.events.MouseEventсвойство MouseEvent.type =
flash.events.MouseEvent.RELEASE_OUTSIDE| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 3.3, Flash Player 11.3 |
Отправляется, когда пользователь отпускает кнопку позиционирующего устройства после ее нажатия над экземпляром InteractiveObject и последующего перемещения позиционирующего устройства с экземпляра InteractiveObject. Если целью является экземпляр SimpleButton, объект отображает экранный объект upState. Если целью является выбираемое текстовое поле, то действие по умолчанию — завершение выбора текстового поля.
type для объекта события releaseOutside.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
altKey | true, если клавиша Alt активна (Windows). |
bubbles | true |
buttonDown | false |
cancelable | false; поведение по умолчанию отменить невозможно. |
commandKey | true в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows. |
controlKey | true, если клавиша Ctrl или Control активна; false, если неактивна. |
ctrlKey | true в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
localX | Горизонтальная координата, в которой произошло событие, относительно спрайта-контейнера, если блокировка мыши отключена. |
localY | Вертикальная координата, в которой произошло событие, относительно спрайта-контейнера, если блокировка мыши отключена. |
shiftKey | true, если клавиша Shift активна; иначе — false. |
clickCount | Число нажатий мышью, указывающее на то, является ли событие частью последовательности множественных нажатий мышью. |
stageX | Горизонтальная координата события в глобальных координатах рабочей области. |
stageY | Вертикальная координата события в глобальных координатах рабочей области. |
target | Объект InteractiveObject, над которым была нажата кнопка позиционирующего устройства (после чего устройство было переведено с экземпляра, а кнопка отпущена). Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент. |
rightClick | Событие |
flash.events.MouseEventсвойство MouseEvent.type =
flash.events.MouseEvent.RIGHT_CLICK| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0, Flash Lite 4 |
Отправляется, когда пользователь нажимает и отпускает правую кнопку указывающего устройства над одним и тем же объектом InteractiveObject. Чтобы произошло событие rightClick, оно должно следовать за данной последовательностью событий, перечисленных в порядке появления: событие rightMouseDown, затем событие rightMouseUp. Оба эти события должны иметь ту же цель, иначе событие rightClick не произойдет. Между событиями rightMouseDown или rightMouseUp может произойти любое количество других событий мыши; событие rightClick все равно происходит.
type объекта события rightClick.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
altKey | true, если клавиша Alt активна (Windows). |
bubbles | true |
buttonDown | Для событий щелчка правой кнопкой мыши всегда используется значение false. |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
commandKey | true в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows. |
controlKey | true, если клавиша Ctrl или Control активна; false, если неактивна. |
ctrlKey | true в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
localX | Горизонтальная координата, в которой произошло событие, относительно спрайта-контейнера, если блокировка мыши отключена. |
localY | Вертикальная координата, в которой произошло событие, относительно спрайта-контейнера, если блокировка мыши отключена. |
movementX | Изменение горизонтальных координат положения мыши с последнего события мыши, если блокировка мыши включена. |
movementY | Изменение вертикальных координат положения мыши с последнего события мыши, если блокировка мыши включена. |
shiftKey | true, если клавиша Shift активна; иначе — false. |
stageX | Горизонтальная координата события в глобальных координатах рабочей области. |
stageY | Вертикальная координата события в глобальных координатах рабочей области. |
target | Объект InteractiveObject под указателем. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент. |
rightMouseDown | Событие |
flash.events.MouseEventсвойство MouseEvent.type =
flash.events.MouseEvent.RIGHT_MOUSE_DOWN| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0, Flash Lite 4 |
Отправляется, когда пользователь нажимает кнопку указывающего устройства над экземпляром InteractiveObject.
Определяет значение свойстваtype объекта события rightMouseDown.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
altKey | true, если клавиша Alt активна (Windows). |
bubbles | true |
buttonDown | Для событий щелчка правой кнопкой мыши всегда используется значение true. |
cancelable | false; поведение по умолчанию отменить невозможно. |
commandKey | true в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows. |
controlKey | true, если клавиша Ctrl или Control активна; false, если неактивна. |
ctrlKey | true в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
localX | Горизонтальная координата, в которой произошло событие, относительно спрайта-контейнера, если блокировка мыши отключена. |
localY | Вертикальная координата, в которой произошло событие, относительно спрайта-контейнера, если блокировка мыши отключена. |
movementX | Изменение горизонтальных координат положения мыши с последнего события мыши, если блокировка мыши включена. |
movementY | Изменение вертикальных координат положения мыши с последнего события мыши, если блокировка мыши включена. |
shiftKey | true, если клавиша Shift активна; иначе — false. |
clickCount | Число нажатий мышью, указывающее на то, является ли событие частью последовательности множественных нажатий мышью. |
stageX | Горизонтальная координата события в глобальных координатах рабочей области. |
stageY | Вертикальная координата события в глобальных координатах рабочей области. |
target | Объект InteractiveObject под указателем. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент. |
rightMouseUp | Событие |
flash.events.MouseEventсвойство MouseEvent.type =
flash.events.MouseEvent.RIGHT_MOUSE_UP| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0, Flash Lite 4 |
Отправляется, когда пользователь отпускает кнопку указывающего устройства над экземпляром InteractiveObject.
Определяет значение свойстваtype объекта события rightMouseUp.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
altKey | true, если клавиша Alt активна (Windows). |
bubbles | true |
buttonDown | true, если правая кнопка мыши нажата; иначе —false. |
cancelable | false; поведение по умолчанию отменить невозможно. |
commandKey | true в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows. |
controlKey | true, если клавиша Ctrl или Control активна; false, если неактивна. |
ctrlKey | true в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
localX | Горизонтальная координата, в которой произошло событие, относительно спрайта-контейнера, если блокировка мыши отключена. |
localY | Вертикальная координата, в которой произошло событие, относительно спрайта-контейнера, если блокировка мыши отключена. |
movementX | Изменение горизонтальных координат положения мыши с последнего события мыши, если блокировка мыши включена. |
movementY | Изменение вертикальных координат положения мыши с последнего события мыши, если блокировка мыши включена. |
shiftKey | true, если клавиша Shift активна; иначе — false. |
clickCount | Число нажатий мышью, указывающее на то, является ли событие частью последовательности множественных нажатий мышью. |
stageX | Горизонтальная координата события в глобальных координатах рабочей области. |
stageY | Вертикальная координата события в глобальных координатах рабочей области. |
target | Объект InteractiveObject под указателем. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент. |
rollOut | Событие |
flash.events.MouseEventсвойство MouseEvent.type =
flash.events.MouseEvent.ROLL_OUT| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Отправляется, когда пользователь перемещает указатель с экземпляра InteractiveObject. Цель этого события — объект, который раньше находился под указателем, или его родительский объект. relatedObject — это объект, на который перемещен указатель. События rollOut отправляются последовательно по восходящей от объекта, начиная с объекта и заканчивая самым родительским элементом, не являющимся корнем или предшественником для объекта relatedObject.
Цель события rollOut — упростить кодировку событий наведения для контейнеров отображаемых объектов с дочерними элементами. При выходе курсора мыши из области объекта отображения или области его дочерних элементов для перехода к объекту, не являющемуся одним из его дочерних элементов, объект отображения отправляет событие rollOut. Это поведение отличается от поведения события mouseOut, которое отправляется каждый раз при перемещении курсора мыши из области дочернего объекта контейнера объектов отображения, даже если он находится на другом дочернем объекте контейнера объектов отображения.
type для объекта события rollOut.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
altKey | true, если клавиша Alt активна (Windows). |
bubbles | false |
buttonDown | true, если нажата основная кнопка мыши; иначе — false. |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
commandKey | true в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows. |
controlKey | true, если клавиша Ctrl или Control активна; false, если неактивна. |
ctrlKey | true в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
relatedObject | Объект списка отображения, на который сейчас указывает мышь. |
localX | Горизонтальная координата, в которой произошло событие, относительно спрайта-контейнера, если блокировка мыши отключена. |
localY | Вертикальная координата, в которой произошло событие, относительно спрайта-контейнера, если блокировка мыши отключена. |
movementX | Изменение горизонтальных координат положения мыши с последнего события мыши, если блокировка мыши включена. |
movementY | Изменение вертикальных координат положения мыши с последнего события мыши, если блокировка мыши включена. |
shiftKey | true, если клавиша Shift активна; иначе — false. |
stageX | Горизонтальная координата события в глобальных координатах рабочей области. |
stageY | Вертикальная координата события в глобальных координатах рабочей области. |
target | Объект InteractiveObject под указателем. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент. |
rollOver | Событие |
flash.events.MouseEventсвойство MouseEvent.type =
flash.events.MouseEvent.ROLL_OVER| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Отправляется, когда пользователь наводит указывающее устройство на экземпляр InteractiveObject. Цель этого события — объект, находящийся под указателем, или родительский объект. relatedObject — это объект, на который до этого был наведен указатель. События rollOver отправляются последовательно вниз по родительской цепочке объекта, начиная с элемента самого высокого уровня, не являющегося корневым элементом или предшествующим элементом relatedObject, и заканчивая самим объектом.
Цель события rollOver — упростить кодировку поведений отката для контейнеров экранных объектов с дочерними элементами. Когда мышь переходит в область экранного объекта или его дочерних элементов от объекта, не являющегося дочерним по отношению к данному объекту, экранный объект отправляет событие rollOver. Это поведение отличается от события mouseOver, которое отправляется каждый раз при переходе мыши в область дочернего объекта контейнера экранных объектов, даже если она переместилась туда с другого дочернего объекта контейнера.
type для объекта события rollOver.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
altKey | true, если клавиша Alt активна (Windows). |
bubbles | false |
buttonDown | true, если нажата основная кнопка мыши; иначе — false. |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
commandKey | true в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows. |
controlKey | true, если клавиша Ctrl или Control активна; false, если неактивна. |
ctrlKey | true в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
relatedObject | Объект списка отображения, на который указывала мышь. |
localX | Горизонтальная координата, в которой произошло событие, относительно спрайта-контейнера, если блокировка мыши отключена. |
localY | Вертикальная координата, в которой произошло событие, относительно спрайта-контейнера, если блокировка мыши отключена. |
movementX | Изменение горизонтальных координат положения мыши с последнего события мыши, если блокировка мыши включена. |
movementY | Изменение вертикальных координат положения мыши с последнего события мыши, если блокировка мыши включена. |
shiftKey | true, если клавиша Shift активна; иначе — false. |
stageX | Горизонтальная координата события в глобальных координатах рабочей области. |
stageY | Вертикальная координата события в глобальных координатах рабочей области. |
target | Объект InteractiveObject под указателем. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент. |
selectAll | Событие |
flash.events.Eventсвойство Event.type =
flash.events.Event.SELECT_ALL| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Отправляется, когда пользователь активирует комбинацию клавиш ускорения, используемую на данной платформе для операции «Выделить все», или выбирает команду «Выделить все» из контекстного меню. Это событие отправляется объекту, который в данный момент находится в фокусе. Если объект, находящийся в фокусе, является экземпляром TextField, действием по умолчанию этого события является выделение всего содержимого текстового поля.
КонстантаEvent.SELECT_ALL определяет значение свойства type объекта события selectAll.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
bubbles | false |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
target | Любой экземпляр InteractiveObject, для которого зарегистрирован прослушиватель события selectAll. |
Примечание. Объектами TextField не отправляются события clear, copy, cut, paste или selectAll. Объекты TextField в контекстном меню всегда включают команды «Вырезать», «Скопировать», «Вставить» и «Выбрать все». Удалить эти команды из контекстного меню для объектов TextField невозможно. Для объектов TextField выбор этих команд (или сочетаний клавиш, эквивалентных элементу меню) не приводит к генерации событий clear, copy, cut, paste или selectAll. Однако другие классы, которые распространяют класс InteractiveObject, включая компоненты, построенные, используя текстовую Службу Flash (FTE), отправят эти события в ответ на операции пользователя, например, комбинации клавиш и контекстные меню.
softKeyboardActivate | Событие |
flash.events.SoftKeyboardEventсвойство SoftKeyboardEvent.type =
flash.events.SoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATE| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10.2, AIR 2.6 |
Отправляется сразу после того, как программная клавиатура вызывается.
КонстантаSoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATE определяет значение type объекта SoftKeyboardEvent, когда программная клавиатура выводится на экран. Для этого события cancellable = false.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
type | SOFT_KEYBOARD_ACTIVATE |
bubbles | true |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
relatedObjectVal | Ссылка на объект списка отображения, связанный с событием. |
triggerTypeVal | Обозначает, было ли событие клавиатуры вызвано программой или пользователем. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
Связанные элементы API
softKeyboardActivating | Событие |
flash.events.SoftKeyboardEventсвойство SoftKeyboardEvent.type =
flash.events.SoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATING| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10.2, AIR 2.6 |
Передается немедленно перед тем, как программная клавиатура появляется на экране.
КонстантаSoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATING определяет значение свойства type объекта SoftKeyboardEvent сразу перед выводом программной клавиатуры на экран. Для этого события cancellable = true.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
type | SOFT_KEYBOARD_ACTIVATING |
bubbles | true |
cancelable | true, если объект StageText не отправляет событие. Для объектов StageText отменить событие невозможно. |
relatedObjectVal | Ссылка на объект списка отображения, связанный с событием. |
triggerTypeVal | Обозначает, было ли событие клавиатуры вызвано программой или пользователем. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
Связанные элементы API
softKeyboardDeactivate | Событие |
flash.events.SoftKeyboardEventсвойство SoftKeyboardEvent.type =
flash.events.SoftKeyboardEvent.SOFT_KEYBOARD_DEACTIVATE| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10.2, AIR 2.6 |
Передается немедленно после того, как программная клавиатура убирается с экрана.
КонстантаSoftKeyboardEvent.SOFT_KEYBOARD_DEACTIVATE определяет значение свойства type объекта SoftKeyboardEvent, когда программная клавиатура опускается или скрывается. Для этого события, cancellable = false.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
type | SOFT_KEYBOARD_DEACTIVATE |
bubbles | true |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
relatedObjectVal | Ссылка на объект списка отображения, связанный с событием. |
triggerTypeVal | Обозначает, было ли событие клавиатуры вызвано программой или пользователем. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
Связанные элементы API
tabChildrenChange | Событие |
flash.events.Eventсвойство Event.type =
flash.events.Event.TAB_CHILDREN_CHANGE| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Отправляется, когда изменяется значение свойства tabChildren объекта.
Event.TAB_CHILDREN_CHANGE определяет значение свойства type объекта события tabChildrenChange.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
bubbles | true |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
target | Объект, для которого изменен флаг tabChildren. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент. |
tabEnabledChange | Событие |
flash.events.Eventсвойство Event.type =
flash.events.Event.TAB_ENABLED_CHANGE| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Отправляется при изменении флага tabEnabled объекта.
Event.TAB_ENABLED_CHANGE определяет значение свойства type объекта события tabEnabledChange.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
bubbles | true |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
target | Объект InteractiveObject, для которого изменен флаг tabEnabled. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент. |
tabIndexChange | Событие |
flash.events.Eventсвойство Event.type =
flash.events.Event.TAB_INDEX_CHANGE| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Отправляется, когда изменяется значение свойства tabIndex объекта.
Event.TAB_INDEX_CHANGE определяет значение свойства type объекта события tabIndexChange.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
bubbles | true |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
target | Объект, для которого изменилось свойство tabIndex. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент. |
textInput | Событие |
flash.events.TextEventсвойство TextEvent.type =
flash.events.TextEvent.TEXT_INPUT| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Передается, если пользователь вводит один или несколько символов текста. Это событие может генерироваться различными методами ввода текста, включая стандартную клавиатуру, редакторы ввода текста (IME), системы распознавания голоса и речи и даже просто вставкой обычного текста без форматирования или информации о стилях.
Задает значение свойстваtype для объекта события textInput.
Примечание. Это событие не отправляется для клавиш Delete или Backspace.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
bubbles | true |
cancelable | true; вызовите метод preventDefault() для отмены поведения по умолчанию. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
target | Текстовое поле, в которое вводятся символы. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент. |
text | Символ или последовательность символов, введенных пользователем. |
touchBegin | Событие |
flash.events.TouchEventсвойство TouchEvent.type =
flash.events.TouchEvent.TOUCH_BEGIN| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Отправляется, когда пользователь впервые создает точку контакта с сенсорным экраном устройства (например, касается сенсорного экрана мобильного телефона или планшетного компьютера). Некоторые устройства также могут интерпретировать этот контакт как событие mouseDown.
В частности, если пользователь прикасается пальцем к сенсорному экрану, то экземпляр InteractiveObject может отправить события mouseDown или touchBegin, либо оба сразу, если это поддерживается текущей средой. Выберите способ обработки взаимодействия с пользователем. Используйте класс flash.ui.Multitouch для управления обработкой событий (включите обработку событий сложных жестов, событий простых точечных касаний или выключите события касания, чтобы отправлялись только события мыши). Если задана обработка события mouseDown, то один и тот же обработчик события будет использоваться для устройств с сенсорным экраном и для устройств с мышью. Однако если требуется обрабатывать событие touchBegin, обработчик можно создать таким образом, чтобы он удовлетворял конкретные потребности устройств с сенсорным экраном и предоставлял пользователям расширенные возможности управления с помощью жестов. Также можно обрабатывать оба события по отдельности, чтобы обеспечить разную реакцию на события прикосновения и мыши.
Примечание. Сведения о совместимости сред см. в описании класса Multitouch.
Определяет значение свойстваtype объекта события касания TOUCH_BEGIN.
Объект TouchEvent имеет следующие свойства.
| Свойство | Значение |
|---|---|
altKey | true, если клавиша Alt активна (Windows или Linux). |
bubbles | true |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
commandKey | true в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows. |
controlKey | true, если клавиша Ctrl или Control активна; false, если неактивна. |
ctrlKey | true в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
eventPhase | Текущая фаза в потоке событий. |
isRelatedObjectInaccessible | Имеет значение true, если свойству relatedObject задано значение null в соответствии с правилами изолированной среды безопасности. |
localX | Горизонтальная координата события относительно спрайта-контейнера. |
localY | Вертикальная координата события относительно спрайта-контейнера. |
pressure | Значение в диапазоне 0.0 — 1.0, определяющее интенсивность контакта с устройством. Если устройство не поддерживает определение давления, используется значение 1.0. |
relatedObject | Ссылка на объект списка отображения, связанный с событием. |
shiftKey | true, если клавиша Shift активна; иначе — false. |
sizeX | Ширина области контакта. |
sizeY | Высота области контакта. |
stageX | Горизонтальная координата события в глобальных координатах рабочей области. |
stageY | Вертикальная координата события в глобальных координатах рабочей области. |
target | Экземпляр InteractiveObject под указывающим устройством. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент. |
touchPointID | Уникальный идентификационный номер (целое число), присвоенный точке касания. |
Пример ( Использование этого примера )
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");
}
Связанные элементы API
touchEnd | Событие |
flash.events.TouchEventсвойство TouchEvent.type =
flash.events.TouchEvent.TOUCH_END| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Отправляется, когда пользователь убирает точку контакта с сенсорным экраном устройства (например, поднимает палец с сенсорного экрана мобильного телефона или планшетного компьютера). Некоторые устройства также могут интерпретировать этот контакт как событие mouseUp.
В частности, если пользователь поднимает палец с сенсорного экрана, то экземпляр InteractiveObject может отправить события mouseUp или touchEnd, либо оба сразу, если это поддерживается текущей средой. Выберите способ обработки взаимодействия с пользователем. Используйте класс flash.ui.Multitouch для управления обработкой событий (включите обработку событий сложных жестов, событий простых точечных касаний или выключите события касания, чтобы отправлялись только события мыши). Если задана обработка события mouseUp, то один и тот же обработчик события будет использоваться для устройств с сенсорным экраном и для устройств с мышью. Однако если требуется обрабатывать событие touchEnd, обработчик можно создать таким образом, чтобы он удовлетворял конкретные потребности устройств с сенсорным экраном и предоставлял пользователям расширенные возможности управления с помощью жестов. Также можно обрабатывать оба события по отдельности, чтобы обеспечить разную реакцию на события прикосновения и мыши.
Примечание. Сведения о совместимости сред см. в описании класса Multitouch.
Определяет значение свойстваtype объекта события касания TOUCH_END.
Объект TouchEvent имеет следующие свойства.
| Свойство | Значение |
|---|---|
altKey | true, если клавиша Alt активна (Windows или Linux). |
bubbles | true |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
commandKey | true в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows. |
controlKey | true, если клавиша Ctrl или Control активна; false, если неактивна. |
ctrlKey | true в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
eventPhase | Текущая фаза в потоке событий. |
isRelatedObjectInaccessible | Имеет значение true, если свойству relatedObject задано значение null в соответствии с правилами изолированной среды безопасности. |
localX | Горизонтальная координата события относительно спрайта-контейнера. |
localY | Вертикальная координата события относительно спрайта-контейнера. |
pressure | Значение в диапазоне 0.0 — 1.0, определяющее интенсивность контакта с устройством. Если устройство не поддерживает определение давления, используется значение 1.0. |
relatedObject | Ссылка на объект списка отображения, связанный с событием. |
shiftKey | true, если клавиша Shift активна; иначе — false. |
sizeX | Ширина области контакта. |
sizeY | Высота области контакта. |
stageX | Горизонтальная координата события в глобальных координатах рабочей области. |
stageY | Вертикальная координата события в глобальных координатах рабочей области. |
target | Экземпляр InteractiveObject под указывающим устройством. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент. |
touchPointID | Уникальный идентификационный номер (целое число), присвоенный точке касания. |
Пример ( Использование этого примера )
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");
}
Связанные элементы API
touchMove | Событие |
flash.events.TouchEventсвойство TouchEvent.type =
flash.events.TouchEvent.TOUCH_MOVE| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Отправляется, когда пользователь касается устройства, и продолжает отправляться до тех пор, пока точка контакта не будет удалена. Обратите внимание, что для этого события не требуется отправки фактического перемещения точки контакта.
Некоторые устройства могут интерпретировать этот контакт как событие mouseMove. В частности, если пользователь проводит пальцем через весь сенсорный экран, то экземпляр InteractiveObject может отправить события mouseMove или touchMove, либо оба сразу, если это поддерживается текущей средой. Выберите способ обработки взаимодействия с пользователем. Используйте класс flash.ui.Multitouch для управления обработкой событий (включите обработку событий сложных жестов, событий простых точечных касаний или выключите события касания, чтобы отправлялись только события мыши). Если задана обработка события mouseMove, то один и тот же обработчик события будет использоваться для устройств с сенсорным экраном и для устройств с мышью. Однако если требуется обрабатывать событие touchMove, обработчик можно создать таким образом, чтобы он удовлетворял конкретные потребности устройств с сенсорным экраном и предоставлял пользователям расширенные возможности управления с помощью жестов. Также можно обрабатывать оба события по отдельности, чтобы обеспечить разную реакцию на события прикосновения и мыши.
Примечание. Сведения о совместимости сред см. в описании класса Multitouch.
Определяет значение свойстваtype объекта события касания TOUCH_MOVE.
Объект TouchEvent имеет следующие свойства.
| Свойство | Значение |
|---|---|
altKey | true, если клавиша Alt активна (Windows или Linux). |
bubbles | true |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
commandKey | true в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows. |
controlKey | true, если клавиша Ctrl или Control активна; false, если неактивна. |
ctrlKey | true в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
eventPhase | Текущая фаза в потоке событий. |
isRelatedObjectInaccessible | Имеет значение true, если свойству relatedObject задано значение null в соответствии с правилами изолированной среды безопасности. |
localX | Горизонтальная координата события относительно спрайта-контейнера. |
localY | Вертикальная координата события относительно спрайта-контейнера. |
pressure | Значение в диапазоне 0.0 — 1.0, определяющее интенсивность контакта с устройством. Если устройство не поддерживает определение давления, используется значение 1.0. |
relatedObject | Ссылка на объект списка отображения, связанный с событием. |
shiftKey | true, если клавиша Shift активна; иначе — false. |
sizeX | Ширина области контакта. |
sizeY | Высота области контакта. |
stageX | Горизонтальная координата события в глобальных координатах рабочей области. |
stageY | Вертикальная координата события в глобальных координатах рабочей области. |
target | Экземпляр InteractiveObject под указывающим устройством. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент. |
touchPointID | Уникальный идентификационный номер (целое число), присвоенный точке касания. |
Пример ( Использование этого примера )
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");
}
Связанные элементы API
touchOut | Событие |
flash.events.TouchEventсвойство TouchEvent.type =
flash.events.TouchEvent.TOUCH_OUT| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Отправляется, когда пользователь перемещает точку контакта от экземпляра InteractiveObject на устройстве с сенсорным экраном (например, перетаскивает палец с одного экранного объекта на другой при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). Некоторые устройства также могут интерпретировать этот контакт как событие mouseOut.
В частности, если пользователь проводит пальцем через весь сенсорный экран, то экземпляр InteractiveObject может отправить события mouseOut или touchOut, либо оба сразу, если это поддерживается текущей средой. Выберите способ обработки взаимодействия с пользователем. Используйте класс flash.ui.Multitouch для управления обработкой событий (включите обработку событий сложных жестов, событий простых точечных касаний или выключите события касания, чтобы отправлялись только события мыши). Если задана обработка события mouseOut, то один и тот же обработчик события будет использоваться для устройств с сенсорным экраном и для устройств с мышью. Однако если требуется обрабатывать событие touchOut, обработчик можно создать таким образом, чтобы он удовлетворял конкретные потребности устройств с сенсорным экраном и предоставлял пользователям расширенные возможности управления с помощью жестов. Также можно обрабатывать оба события по отдельности, чтобы обеспечить разную реакцию на события прикосновения и мыши.
Примечание. Сведения о совместимости сред см. в описании класса Multitouch.
Определяет значение свойстваtype объекта события касания TOUCH_OUT.
Объект TouchEvent имеет следующие свойства.
| Свойство | Значение |
|---|---|
altKey | true, если клавиша Alt активна (Windows или Linux). |
bubbles | true |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
commandKey | true в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows. |
controlKey | true, если клавиша Ctrl или Control активна; false, если неактивна. |
ctrlKey | true в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
eventPhase | Текущая фаза в потоке событий. |
isRelatedObjectInaccessible | Имеет значение true, если свойству relatedObject задано значение null в соответствии с правилами изолированной среды безопасности. |
localX | Горизонтальная координата события относительно спрайта-контейнера. |
localY | Вертикальная координата события относительно спрайта-контейнера. |
pressure | Значение в диапазоне 0.0 — 1.0, определяющее интенсивность контакта с устройством. Если устройство не поддерживает определение давления, используется значение 1.0. |
relatedObject | Ссылка на объект списка отображения, связанный с событием. |
shiftKey | true, если клавиша Shift активна; иначе — false. |
sizeX | Ширина области контакта. |
sizeY | Высота области контакта. |
stageX | Горизонтальная координата события в глобальных координатах рабочей области. |
stageY | Вертикальная координата события в глобальных координатах рабочей области. |
target | Экземпляр InteractiveObject под указывающим устройством. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент. |
touchPointID | Уникальный идентификационный номер (целое число), присвоенный точке касания. |
Связанные элементы API
touchOver | Событие |
flash.events.TouchEventсвойство TouchEvent.type =
flash.events.TouchEvent.TOUCH_OVER| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Отправляется, когда пользователь перемещает точку контакта над экземпляром InteractiveObject на устройстве с сенсорным экраном (например, перетаскивает палец с точки за пределами экранного объекта в точку над ним при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). Некоторые устройства также могут интерпретировать этот контакт как событие mouseOver.
В частности, если пользователь проводит пальцем над объектом InteractiveObject, то экземпляр InteractiveObject может отправить события mouseOver или touchOver, либо оба сразу, если это поддерживается текущей средой. Выберите способ обработки взаимодействия с пользователем. Используйте класс flash.ui.Multitouch для управления обработкой событий (включите обработку событий сложных жестов, событий простых точечных касаний или выключите события касания, чтобы отправлялись только события мыши). Если задана обработка события mouseOver, то один и тот же обработчик события будет использоваться для устройств с сенсорным экраном и для устройств с мышью. Однако, если требуется обрабатывать событие touchOver, обработчик можно создать таким образом, чтобы он удовлетворял конкретные потребности устройств с сенсорным экраном и предоставлял пользователям расширенные возможности управления с помощью жестов. Также можно обрабатывать оба события по отдельности, чтобы обеспечить разную реакцию на события прикосновения и мыши.
Примечание. Сведения о совместимости сред см. в описании класса Multitouch.
Определяет значение свойстваtype объекта события касания TOUCH_OVER.
Объект TouchEvent имеет следующие свойства.
| Свойство | Значение |
|---|---|
altKey | true, если клавиша Alt активна (Windows или Linux). |
bubbles | true |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
commandKey | true в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows. |
controlKey | true, если клавиша Ctrl или Control активна; false, если неактивна. |
ctrlKey | true в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
eventPhase | Текущая фаза в потоке событий. |
isRelatedObjectInaccessible | Имеет значение true, если свойству relatedObject задано значение null в соответствии с правилами изолированной среды безопасности. |
localX | Горизонтальная координата события относительно спрайта-контейнера. |
localY | Вертикальная координата события относительно спрайта-контейнера. |
pressure | Значение в диапазоне 0.0 — 1.0, определяющее интенсивность контакта с устройством. Если устройство не поддерживает определение давления, используется значение 1.0. |
relatedObject | Ссылка на объект списка отображения, связанный с событием. |
shiftKey | true, если клавиша Shift активна; иначе — false. |
sizeX | Ширина области контакта. |
sizeY | Высота области контакта. |
stageX | Горизонтальная координата события в глобальных координатах рабочей области. |
stageY | Вертикальная координата события в глобальных координатах рабочей области. |
target | Экземпляр InteractiveObject под указывающим устройством. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент. |
touchPointID | Уникальный идентификационный номер (целое число), присвоенный точке касания. |
Связанные элементы API
touchRollOut | Событие |
flash.events.TouchEventсвойство TouchEvent.type =
flash.events.TouchEvent.TOUCH_ROLL_OUT| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Отправляется, когда пользователь удаляет точку контакта из экземпляра InteractiveObject на сенсорном устройстве (например, переводит палец из положения над экранным объектом в точку за пределами экранного объекта на мобильном телефоне или планшете с сенсорным экраном). Некоторые устройства также могут интерпретировать этот контакт как событие rollOut.
В частности, если пользователь проводит пальцем над объектом InteractiveObject, то экземпляр InteractiveObject может отправить события rollOut или touchRollOut, либо оба сразу, если это поддерживается текущей средой. Выберите способ обработки взаимодействия с пользователем. Используйте класс flash.ui.Multitouch для управления обработкой событий (включите обработку событий сложных жестов, событий простых точечных касаний или выключите события касания, чтобы отправлялись только события мыши). Если задана обработка события rollOut, то один и тот же обработчик события будет использоваться для устройств с сенсорным экраном и для устройств с мышью. Однако если требуется обрабатывать событие touchRollOut, обработчик можно создать таким образом, чтобы он удовлетворял конкретные потребности устройств с сенсорным экраном и предоставлял пользователям расширенные возможности управления с помощью жестов. Также можно обрабатывать оба события по отдельности, чтобы обеспечить разную реакцию на события прикосновения и мыши.
Примечание. Сведения о совместимости сред см. в описании класса Multitouch.
Определяет значение свойстваtype объекта события касания TOUCH_ROLL_OUT.
Объект TouchEvent имеет следующие свойства.
| Свойство | Значение |
|---|---|
altKey | true, если клавиша Alt активна (Windows или Linux). |
bubbles | true |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
commandKey | true в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows. |
controlKey | true, если клавиша Ctrl или Control активна; false, если неактивна. |
ctrlKey | true в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
eventPhase | Текущая фаза в потоке событий. |
isRelatedObjectInaccessible | Имеет значение true, если свойству relatedObject задано значение null в соответствии с правилами изолированной среды безопасности. |
localX | Горизонтальная координата события относительно спрайта-контейнера. |
localY | Вертикальная координата события относительно спрайта-контейнера. |
pressure | Значение в диапазоне 0.0 — 1.0, определяющее интенсивность контакта с устройством. Если устройство не поддерживает определение давления, используется значение 1.0. |
relatedObject | Ссылка на объект списка отображения, связанный с событием. |
shiftKey | true, если клавиша Shift активна; иначе — false. |
sizeX | Ширина области контакта. |
sizeY | Высота области контакта. |
stageX | Горизонтальная координата события в глобальных координатах рабочей области. |
stageY | Вертикальная координата события в глобальных координатах рабочей области. |
target | Экземпляр InteractiveObject под указывающим устройством. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент. |
touchPointID | Уникальный идентификационный номер (целое число), присвоенный точке касания. |
Связанные элементы API
touchRollOver | Событие |
flash.events.TouchEventсвойство TouchEvent.type =
flash.events.TouchEvent.TOUCH_ROLL_OVER| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Отправляется, когда пользователь перемещает точку контакта над экземпляром InteractiveObject на устройстве с сенсорным экраном (например, перетаскивает палец с точки за пределами экранного объекта в точку над ним при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). Некоторые устройства также могут интерпретировать этот контакт как событие rollOver.
В частности, если пользователь проводит пальцем над объектом InteractiveObject, то экземпляр InteractiveObject может отправить события rollOver или touchRollOver, либо оба сразу, если это поддерживается текущей средой. Выберите способ обработки взаимодействия с пользователем. Используйте класс flash.ui.Multitouch для управления обработкой событий (включите обработку событий сложных жестов, событий простых точечных касаний или выключите события касания, чтобы отправлялись только события мыши). Если задана обработка события rollOver, то один и тот же обработчик события будет использоваться для устройств с сенсорным экраном и для устройств с мышью. Однако если требуется обрабатывать событие touchRollOver, обработчик можно создать таким образом, чтобы он удовлетворял конкретные потребности устройств с сенсорным экраном и предоставлял пользователям расширенные возможности управления с помощью жестов. Также можно обрабатывать оба события по отдельности, чтобы обеспечить разную реакцию на события прикосновения и мыши.
Примечание. Сведения о совместимости сред см. в описании класса Multitouch.
Определяет значение свойстваtype объекта события касания TOUCH_ROLL_OVER.
Объект TouchEvent имеет следующие свойства.
| Свойство | Значение |
|---|---|
altKey | true, если клавиша Alt активна (Windows или Linux). |
bubbles | true |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
commandKey | true в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows. |
controlKey | true, если клавиша Ctrl или Control активна; false, если неактивна. |
ctrlKey | true в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
eventPhase | Текущая фаза в потоке событий. |
isRelatedObjectInaccessible | Имеет значение true, если свойству relatedObject задано значение null в соответствии с правилами изолированной среды безопасности. |
localX | Горизонтальная координата события относительно спрайта-контейнера. |
localY | Вертикальная координата события относительно спрайта-контейнера. |
pressure | Значение в диапазоне 0.0 — 1.0, определяющее интенсивность контакта с устройством. Если устройство не поддерживает определение давления, используется значение 1.0. |
relatedObject | Ссылка на объект списка отображения, связанный с событием. |
shiftKey | true, если клавиша Shift активна; иначе — false. |
sizeX | Ширина области контакта. |
sizeY | Высота области контакта. |
stageX | Горизонтальная координата события в глобальных координатах рабочей области. |
stageY | Вертикальная координата события в глобальных координатах рабочей области. |
target | Экземпляр InteractiveObject под указывающим устройством. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент. |
touchPointID | Уникальный идентификационный номер (целое число), присвоенный точке касания. |
Связанные элементы API
touchTap | Событие |
flash.events.TouchEventсвойство TouchEvent.type =
flash.events.TouchEvent.TOUCH_TAP| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Отправляется, когда пользователь поднимает точку контакта над тем же экземпляром InteractiveObject, с которым был установлен первичный контакт на сенсорном экране (например, нажимает точку на экранном объекте и поднимает палец с той же точки при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). Некоторые устройства также могут интерпретировать этот контакт как событие click.
В частности, если пользователь касается пальцем объекта InteractiveObject, то экземпляр InteractiveObject может отправить события click или touchTap, либо оба сразу, если это поддерживается текущей средой. Выберите способ обработки взаимодействия с пользователем. Используйте класс flash.ui.Multitouch для управления обработкой событий (включите обработку событий сложных жестов, событий простых точечных касаний или выключите события касания, чтобы отправлялись только события мыши). Если задана обработка события click, то один и тот же обработчик события будет использоваться для устройств с сенсорным экраном и для устройств с мышью. Однако если требуется обрабатывать событие touchTap, обработчик можно создать таким образом, чтобы он удовлетворял конкретные потребности устройств с сенсорным экраном и предоставлял пользователям расширенные возможности управления с помощью жестов. Также можно обрабатывать оба события по отдельности, чтобы обеспечить разную реакцию на события прикосновения и мыши.
Примечание. Сведения о совместимости сред см. в описании класса Multitouch.
Определяет значение свойстваtype объекта события касания TOUCH_TAP.
Объект TouchEvent имеет следующие свойства.
| Свойство | Значение |
|---|---|
altKey | true, если клавиша Alt активна (Windows или Linux). |
bubbles | true |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
commandKey | true в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows. |
controlKey | true, если клавиша Ctrl или Control активна; false, если неактивна. |
ctrlKey | true в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
eventPhase | Текущая фаза в потоке событий. |
isRelatedObjectInaccessible | Имеет значение true, если свойству relatedObject задано значение null в соответствии с правилами изолированной среды безопасности. |
localX | Горизонтальная координата события относительно спрайта-контейнера. |
localY | Вертикальная координата события относительно спрайта-контейнера. |
pressure | Значение в диапазоне 0.0 — 1.0, определяющее интенсивность контакта с устройством. Если устройство не поддерживает определение давления, используется значение 1.0. |
relatedObject | Ссылка на объект списка отображения, связанный с событием. |
shiftKey | true, если клавиша Shift активна; иначе — false. |
sizeX | Ширина области контакта. |
sizeY | Высота области контакта. |
stageX | Горизонтальная координата события в глобальных координатах рабочей области. |
stageY | Вертикальная координата события в глобальных координатах рабочей области. |
target | Экземпляр InteractiveObject под указывающим устройством. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент. |
touchPointID | Уникальный идентификационный номер (целое число), присвоенный точке касания. |
Пример ( Использование этого примера )
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);
}
Связанные элементы API
InteractiveObjectExample, который в свою очередь использует класс ChildSprite для рисования прямоугольника, а затем выполнения манипуляций с ним на базе различных событий мыши. Это можно сделать, выполнив следующие действия.
- В конструкторе
InteractiveObjectExampleсоздается новый объект ChildSprite тип Sprite с именемchild, который вызывает метод конструктора ChildSprite для рисования фигуры и добавляет для нее события мыши (как описывается далее). Объектchildдобавляется в начало списка отображения в точку с координатами x = 0, y = 0. - В классе
ChildSpriteобъявите свойстваsizeиoverSize, которые будут использоваться позже в методеdraw()и методах MouseEvent. - Объявите свойства, задающие оранжевый цвет фона, темно-желтый цвет при наведении мыши и голубой при нажатии мыши.
- В конструкторе
ChildSpriteрисуется оранжевый квадрат с помощью методов класса Graphics и методаdraw(). - Конструктор добавляет четыре метода прослушивателя событий MouseEvent:
mouseOverHandler: перерисовывает квадрат большего размера (60 на 60 пикселей) темно-желтого цвета в точке с исходными координатами.mouseOutHandler: возвращает квадрату исходный размер и цвет.mouseDownHandler: перерисовывает квадрат большего размера (60 на 60 пикселей) голубого цвета в точке с исходными координатами.mouseUpHandler: то же, чтоmouseOverHandler.
package {
import flash.display.Sprite;
public class InteractiveObjectExample extends Sprite {
public function InteractiveObjectExample() {
var child:Sprite = 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() {
buttonMode = true;
draw(size, size, backgroundColor);
addEventListener(MouseEvent.MOUSE_OVER, mouseOverHandler);
addEventListener(MouseEvent.MOUSE_OUT, mouseOutHandler);
addEventListener(MouseEvent.MOUSE_DOWN, mouseDownHandler);
addEventListener(MouseEvent.MOUSE_UP, mouseUpHandler);
}
private function draw(w:uint, h:uint, bgColor:uint):void {
graphics.clear();
graphics.beginFill(bgColor);
graphics.drawRect(0, 0, w, h);
graphics.endFill();
}
public function mouseOverHandler(event:MouseEvent):void {
trace("mouseOverHandler");
draw(overSize, overSize, overColor);
}
public function mouseOutHandler(event:MouseEvent):void {
trace("mouseOutHandler");
draw(size, size, backgroundColor);
}
public function mouseDownHandler(event:MouseEvent):void {
trace("mouseDownHandler");
draw(overSize, overSize, downColor);
}
public function mouseUpHandler(event:MouseEvent):void {
trace("mouseUpHandler");
draw(overSize, overSize, overColor);
}
}
Tue Jun 12 2018, 11:34 AM Z