| Пакет | flash.events |
| Класс | public class GestureEvent |
| Наследование | GestureEvent  Event Object |
| Подклассы | PressAndTapGestureEvent, TransformGestureEvent |
| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Класс Multitouch служит для определения поддержки сенсорного взаимодействия в текущей среде и для управления этой поддержкой, если она имеется.
Примечание. Когда объекты вложены в список отображения, события сенсорного экрана нацеливаются на самый глубокий из видимых вложенных объектов. Этот объект называется целевым узлом. Чтобы родительский элемент целевого узла (объект, содержащий целевой узел в списке отображения) получил уведомление о событии сенсорного экрана, вызовите метод EventDispatcher.addEventListener() для родительского элемента, задав в качестве параметра type конкретное событие, которое требуется отслеживать.
Связанные элементы API
flash.events.TouchEvent
flash.events.TransformGestureEvent
flash.events.PressAndTapGestureEvent
flash.events.MouseEvent
flash.events.EventDispatcher.addEventListener()
Скрыть унаследованные общедоступные свойства
Показать унаследованные общедоступные свойства| Свойство | Определено | ||
|---|---|---|---|
| altKey : Boolean
Показывает активность клавиши Alt: true — активна, false — неактивна. | GestureEvent | ||
 | bubbles : Boolean [только для чтения]
Определяет, является ли событие событием восходящей цепочки. | Event | |
| cancelable : Boolean [только для чтения]
Указывает, можно ли предотвратить поведение, связанное с событием. | Event | |
| commandKey : Boolean
Указывает, активирована ли клавиша Command (только для Mac). | GestureEvent | ||
| constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | |
| controlKey : Boolean
Указывает, активирована ли клавиша Control в Mac или клавиша Ctrl в Windows или Linux. | GestureEvent | ||
| ctrlKey : Boolean
В Windows или Linux указывает на то, активирована ли клавиша Ctrl (true) или нет (false). | GestureEvent | ||
| currentTarget : Object [только для чтения]
Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. | Event | |
| eventPhase : uint [только для чтения]
Текущая фаза в потоке событий. | Event | |
| localX : Number
Горизонтальная координата события относительно спрайта-контейнера. | GestureEvent | ||
| localY : Number
Вертикальная координата события относительно спрайта-контейнера. | GestureEvent | ||
| phase : String
Значение класса GesturePhase, обозначающее ход выполнения сенсорного жеста (начало, обновление, завершение или все). | GestureEvent | ||
| shiftKey : Boolean
Показывает активность клавиши Shift: true — активна, false — неактивна. | GestureEvent | ||
| stageX : Number [только для чтения]
Горизонтальная координата события в глобальных координатах рабочей области. | GestureEvent | ||
| stageY : Number [только для чтения]
Вертикальная координата события в глобальных координатах рабочей области. | GestureEvent | ||
| target : Object [только для чтения]
Целевой объект события. | Event | |
| type : String [только для чтения]
Тип события. | Event | |
| Метод | Определено | ||
|---|---|---|---|
GestureEvent(type:String, bubbles:Boolean = true, cancelable:Boolean = false, phase:String = null, localX:Number = 0, localY:Number = 0, ctrlKey:Boolean = false, altKey:Boolean = false, shiftKey:Boolean = false, commandKey:Boolean = false, controlKey:Boolean = false)
Создает объект Event, который содержит информацию о мультисенсорных событиях (например, пользователь касается сенсорного экрана сразу двумя пальцами). | GestureEvent | ||
[переопределить]
Создает копию объекта GestureEvent и задает значение каждого свойства, совпадающее с оригиналом. | GestureEvent | ||
|
Служебная функция для реализации метода toString() в пользовательских классах ActionScript 3.0 Event. | Event | |
|
Показывает, определено ли заданное свойство для объекта. | Object | |
|
Проверяет, выполнялся ли для события вызова метода preventDefault(). | Event | |
|
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | |
|
Отменяет поведение по умолчанию для события, если такое поведение можно отменить. | Event | |
|
Показывает наличие заданного свойства и его перечисляемость. | Object | |
|
Задает доступность динамического свойства для операций цикла. | Object | |
|
Отменяет обработку прослушивателей событий в текущем узле, а также во всех узлах, которые следуют в потоке событий за текущим узлом. | Event | |
|
Отменяет обработку прослушивателей событий в узлах, которые следуют в потоке событий за текущим узлом. | Event | |
|
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | |
[переопределить]
Возвращает строку, содержащую все свойства объекта GestureEvent. | GestureEvent | ||
Обновляет дисплей среды выполнения Flash после обработки события жеста, если список отображения был изменен обработчиком событий. | GestureEvent | ||
|
Возвращает элементарное значение заданного объекта. | Object | |
| Константа | Определено | ||
|---|---|---|---|
| GESTURE_TWO_FINGER_TAP : String = "gestureTwoFingerTap" [статические]
Определяет значение свойства type объекта события жеста GESTURE_TWO_FINGER_TAP. | GestureEvent | ||
altKey | свойство |
altKey:Boolean| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2 |
Показывает активность клавиши Alt: true — активна, false — неактивна. Поддерживается только в операционных системах Windows и Linux.
Реализация
public function get altKey():Boolean public function set altKey(value:Boolean):void commandKey | свойство |
commandKey:Boolean| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 2 |
Указывает, активирована ли клавиша Command (только для Mac).
В ОС Mac OS свойство commandKey имеет то же значение, что и свойство ctrlKey. Это свойство всегда имеет значение false в ОС Windows или Linux.
Реализация
public function get commandKey():Boolean public function set commandKey(value:Boolean):voidcontrolKey | свойство |
ctrlKey | свойство |
ctrlKey:Boolean| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2 |
В Windows или Linux указывает на то, активирована ли клавиша Ctrl (true) или нет (false). В Macintosh указывает на то, активирована ли клавиша Control или Command.
Реализация
public function get ctrlKey():Boolean public function set ctrlKey(value:Boolean):voidlocalX | свойство |
localY | свойство |
phase | свойство |
phase:String| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Значение класса GesturePhase, обозначающее ход выполнения сенсорного жеста (начало, обновление, завершение или все). Для большинства жестов фаза имеет значение begin, update или end. Для событий выделения и нажатия двумя пальцами фаза всегда имеет значение all при отправке события. Используйте это значение, чтобы определить, когда обработчик событий должен реагировать на сложное взаимодействие пользователя. Также можно определить, должен ли он по-разному реагировать в зависимости от текущей фазы мультисенсорного жеста (например, выполняется раскрытие, перемещение и перетаскивание, когда пользователь касается экранного объекта и перетаскивает его по экрану).
Реализация
public function get phase():String public function set phase(value:String):voidСвязанные элементы API
shiftKey | свойство |
stageX | свойство |
stageX:Number [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Горизонтальная координата события в глобальных координатах рабочей области. Это свойство вычисляется, когда задано свойство localX.
Реализация
public function get stageX():NumberstageY | свойство |
stageY:Number [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Вертикальная координата события в глобальных координатах рабочей области. Это свойство вычисляется, когда задано свойство localY.
Реализация
public function get stageY():NumberGestureEvent | () | Конструктор |
public function GestureEvent(type:String, bubbles:Boolean = true, cancelable:Boolean = false, phase:String = null, localX:Number = 0, localY:Number = 0, ctrlKey:Boolean = false, altKey:Boolean = false, shiftKey:Boolean = false, commandKey:Boolean = false, controlKey:Boolean = false)| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Создает объект Event, который содержит информацию о мультисенсорных событиях (например, пользователь касается сенсорного экрана сразу двумя пальцами). Объекты Event передаются прослушивателям событий в качестве параметров.
Параметрыtype:String — Тип события. Поддерживаемое значение: GestureEvent.GESTURE_TWO_FINGER_TAP.
| |
bubbles:Boolean (default = true) | |
cancelable:Boolean (default = false) | |
phase:String (default = null) | |
localX:Number (default = 0) | |
localY:Number (default = 0) | |
ctrlKey:Boolean (default = false) | |
altKey:Boolean (default = false) | |
shiftKey:Boolean (default = false) | |
commandKey:Boolean (default = false) | |
controlKey:Boolean (default = false) |
Связанные элементы API
clone | () | метод |
override public function clone():Event| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Создает копию объекта GestureEvent и задает значение каждого свойства, совпадающее с оригиналом.
ВозвращаетEvent — Новый объект GestureEvent, значения свойств которого соответствуют значениям оригинала.
|
toString | () | метод |
override public function toString():String| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Возвращает строку, содержащую все свойства объекта GestureEvent. Строка имеет следующий формат:
[GestureEvent type=value bubbles=value cancelable=value ... ]
String — Строка, содержащая все свойства объекта GestureEvent.
|
updateAfterEvent | () | метод |
public function updateAfterEvent():void| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Обновляет дисплей среды выполнения Flash после обработки события жеста, если список отображения был изменен обработчиком событий.
GESTURE_TWO_FINGER_TAP | Константа |
public static const GESTURE_TWO_FINGER_TAP:String = "gestureTwoFingerTap"| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Определяет значение свойства type объекта события жеста GESTURE_TWO_FINGER_TAP.
Объект GestureEvent имеет следующие свойства.
| Свойство | Значение |
|---|---|
altKey | true, если клавиша Alt активна (Windows или Linux). |
bubbles | true |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
commandKey | (только в AIR) 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. |
isRelatedObjectInaccessible | Имеет значение true, если свойству relatedObject задано значение null в соответствии с правилами изолированной среды безопасности. |
localX | Горизонтальная координата события относительно спрайта-контейнера. |
localY | Вертикальная координата события относительно спрайта-контейнера. |
shiftKey | true, если клавиша Shift активна; иначе — false. |
target | Экземпляр InteractiveObject под указывающим устройством. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент. |
Связанные элементы API
GESTURE_TWO_FINGER_TAP. Когда пользователь выполняет жест нажатия двумя пальцами, mySprite поворачивается, а в текстовом поле myTextField отображается фаза all, которая является единственной фазой для событий нажатия двумя пальцами. Другие жесты класса TransformGestureEvent поддерживают фазы начала, обновления и завершения.
Multitouch.inputMode = MultitouchInputMode.GESTURE;
var mySprite = new Sprite();
mySprite.addEventListener(GestureEvent.GESTURE_TWO_FINGER_TAP , onTwoFingerTap );
mySprite.graphics.beginFill(0x336699);
mySprite.graphics.drawRect(0, 0, 100, 80);
var myTextField = new TextField();
myTextField.y = 200;
addChild(mySprite);
addChild(myTextField);
function onTwoFingerTap(evt:GestureEvent):void {
evt.target.rotation -= 45;
myTextField.text = evt.phase; //"all"
}
Tue Jun 12 2018, 11:34 AM Z