| Пакет | flash.events |
| Класс | public class TransformGestureEvent |
| Наследование | TransformGestureEvent GestureEvent Event Object |
| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Устройство или операционная система интерпретируют ввод с помощью жеста. Так, у разных устройств или операционных систем есть свои требования к отдельным типам жестов. Для выделения содержимого на разных устройствах могут потребоваться различные движения ввода. Сведения о том, как устройство или операционная система интерпретирует прикосновение в качестве того или иного жеста, см. в документации производителя.
Класс Multitouch служит для определения поддержки сенсорного взаимодействия в текущей среде и для управления этой поддержкой, если она имеется.
Примечание. Когда объекты вложены в список отображения, события сенсорного экрана нацеливаются на самый глубокий из видимых вложенных объектов. Этот объект называется целевым узлом. Чтобы родительский элемент целевого узла (объект, содержащий целевой узел в списке отображения) получил уведомление о событии сенсорного экрана, вызовите метод EventDispatcher.addEventListener() для родительского элемента, задав в качестве параметра type конкретное событие, которое требуется отслеживать.
В процессе взаимодействия пользователя с сенсорным экраном свойства scale, rotation и offset объекта TransformGestureEvent рассматриваются как инкрементные значения с точки зрения предшествующего события жеста. Например, когда жест увеличивает размер экранного объекта, значения масштабирования могут изменяться в последовательности 1.03, 1.01, 1.01, 1.02, то есть к окончанию жеста экранный объект будет увеличен в 1.0717 раз по отношению к исходному размеру.
Для объектов TransformGestureEvent свойства, не измененные текущим жестом, сохраняют те же значения. Например, при жесте панорамирования не происходит поворота или преобразования масштаба, поэтому свойство rotation события имеет значение 0, а свойства scaleX и scaleY — значение 1.
Связанные элементы API
flash.events.TouchEvent
flash.events.GestureEvent
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 | |
| offsetX : Number
Перемещение экранного объекта по горизонтали с момента предыдущего события жеста. | TransformGestureEvent | ||
| offsetY : Number
Перемещение экранного объекта по вертикали с момента предыдущего события жеста. | TransformGestureEvent | ||
![]() | phase : String
Значение класса GesturePhase, обозначающее ход выполнения сенсорного жеста (начало, обновление, завершение или все). | GestureEvent | |
| rotation : Number
Текущий угол поворота экранного объекта относительно оси z с момента предыдущего события жеста. | TransformGestureEvent | ||
| scaleX : Number
Масштабирование экранного объекта по горизонтали с момента предыдущего события жеста. | TransformGestureEvent | ||
| scaleY : Number
Масштабирование экранного объекта по вертикали с момента предыдущего события жеста. | TransformGestureEvent | ||
![]() | shiftKey : Boolean
Показывает активность клавиши Shift: true — активна, false — неактивна. | GestureEvent | |
![]() | stageX : Number [только для чтения]
Горизонтальная координата события в глобальных координатах рабочей области. | GestureEvent | |
![]() | stageY : Number [только для чтения]
Вертикальная координата события в глобальных координатах рабочей области. | GestureEvent | |
![]() | target : Object [только для чтения]
Целевой объект события. | Event | |
![]() | type : String [только для чтения]
Тип события. | Event | |
| velocity : Number
Скорость события жеста преобразования (в пикселях в секунду). | TransformGestureEvent | ||
| Метод | Определено | ||
|---|---|---|---|
TransformGestureEvent(type:String, bubbles:Boolean = true, cancelable:Boolean = false, phase:String = null, localX:Number = 0, localY:Number = 0, scaleX:Number = 1.0, scaleY:Number = 1.0, rotation:Number = 0, offsetX:Number = 0, offsetY:Number = 0, ctrlKey:Boolean = false, altKey:Boolean = false, shiftKey:Boolean = false, commandKey:Boolean = false, controlKey:Boolean = false, velocity:Number = 0)
Создает объект Event, который содержит информацию о сложных мультисенсорных событиях, например, когда пользователь проводит пальцем по экрану. | TransformGestureEvent | ||
[переопределить]
Создает копию объекта TransformGestureEvent и задает значение каждого свойства, совпадающее с оригиналом. | TransformGestureEvent | ||
![]() |
Служебная функция для реализации метода toString() в пользовательских классах ActionScript 3.0 Event. | Event | |
![]() |
Показывает, определено ли заданное свойство для объекта. | Object | |
![]() |
Проверяет, выполнялся ли для события вызова метода preventDefault(). | Event | |
![]() |
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | |
![]() |
Отменяет поведение по умолчанию для события, если такое поведение можно отменить. | Event | |
![]() |
Показывает наличие заданного свойства и его перечисляемость. | Object | |
![]() |
Задает доступность динамического свойства для операций цикла. | Object | |
![]() |
Отменяет обработку прослушивателей событий в текущем узле, а также во всех узлах, которые следуют в потоке событий за текущим узлом. | Event | |
![]() |
Отменяет обработку прослушивателей событий в узлах, которые следуют в потоке событий за текущим узлом. | Event | |
![]() |
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | |
[переопределить]
Возвращает строку, содержащую все свойства объекта TransformGestureEvent. | TransformGestureEvent | ||
![]() |
Обновляет дисплей среды выполнения Flash после обработки события жеста, если список отображения был изменен обработчиком событий. | GestureEvent | |
![]() |
Возвращает элементарное значение заданного объекта. | Object | |
| Константа | Определено | ||
|---|---|---|---|
| GESTURE_DIRECTIONAL_TAP : String = "gestureDirectionalTap" [статические]
Определяет значение свойства type объекта события сенсорного экрана GESTURE_DIRECTIONAL_TAP. | TransformGestureEvent | ||
| GESTURE_PAN : String = "gesturePan" [статические]
Определяет значение свойства type объекта события сенсорного экрана GESTURE_PAN. | TransformGestureEvent | ||
| GESTURE_ROTATE : String = "gestureRotate" [статические]
Определяет значение свойства type объекта события сенсорного экрана GESTURE_ROTATE. | TransformGestureEvent | ||
| GESTURE_SWIPE : String = "gestureSwipe" [статические]
Определяет значение свойства type объекта события сенсорного экрана GESTURE_SWIPE. | TransformGestureEvent | ||
| GESTURE_ZOOM : String = "gestureZoom" [статические]
Определяет значение свойства type объекта события сенсорного экрана GESTURE_ZOOM. | TransformGestureEvent | ||
offsetX | свойство |
offsetY | свойство |
rotation | свойство |
rotation:Number| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Текущий угол поворота экранного объекта относительно оси z с момента предыдущего события жеста.
Реализация
public function get rotation():Number public function set rotation(value:Number):voidscaleX | свойство |
scaleY | свойство |
velocity | свойство |
TransformGestureEvent | () | Конструктор |
public function TransformGestureEvent(type:String, bubbles:Boolean = true, cancelable:Boolean = false, phase:String = null, localX:Number = 0, localY:Number = 0, scaleX:Number = 1.0, scaleY:Number = 1.0, rotation:Number = 0, offsetX:Number = 0, offsetY:Number = 0, ctrlKey:Boolean = false, altKey:Boolean = false, shiftKey:Boolean = false, commandKey:Boolean = false, controlKey:Boolean = false, velocity:Number = 0)| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Создает объект Event, который содержит информацию о сложных мультисенсорных событиях, например, когда пользователь проводит пальцем по экрану. Объекты Event передаются прослушивателям событий в качестве параметров.
Параметрыtype:String — Тип события. Возможные значения: TransformGestureEvent.GESTURE_PAN, TransformGestureEvent.GESTURE_ROTATE, TransformGestureEvent.GESTURE_SWIPE и TransformGestureEvent.GESTURE_ZOOM.
| |
bubbles:Boolean (default = true) — Определяет, участвует ли объект Event в фазе восходящей цепочки потока событий.
| |
cancelable:Boolean (default = false) — Определяет, можно ли отменить объект Event.
| |
phase:String (default = null) — Эти значения отслеживает начало, ход выполнения, и конец жеста. Возможные значения: GesturePhase.BEGIN, GesturePhase.END и GesturePhase.UPDATE.
| |
localX:Number (default = 0) — Горизонтальная координата события относительно экранного объекта-контейнера.
| |
localY:Number (default = 0) — Вертикальная координата события относительно экранного объекта-контейнера.
| |
scaleX:Number (default = 1.0) — Масштабирование экранного объекта по горизонтали.
| |
scaleY:Number (default = 1.0) — Масштабирование экранного объекта по вертикали.
| |
rotation:Number (default = 0) — Текущий угол поворота экранного объекта относительно оси z (в градусах).
| |
offsetX:Number (default = 0) — Перемещение экранного объекта по горизонтали относительно исходной позиции.
| |
offsetY:Number (default = 0) — Перемещение экранного объекта по вертикали относительно исходной позиции.
| |
ctrlKey:Boolean (default = false) — (Только для AIR) Скорость жеста преобразования (пикселей в секунду).
| |
altKey:Boolean (default = false) — В Windows или Linux указывает на то, активирована ли клавиша Ctrl. В Mac указывает на то, активирована ли клавиша Ctrl или Command.
| |
shiftKey:Boolean (default = false) — Указывает на то, активирована ли клавиша Alt (только для Windows или Linux).
| |
commandKey:Boolean (default = false) — Указывает, активирована ли клавиша Shift.
| |
controlKey:Boolean (default = false) — (Только для AIR) Указывает, активирована ли клавиша Command (только для Mac). Этот параметр только для Adobe AIR; не устанавливать его для содержимого Flash Player.
| |
velocity:Number (default = 0) — (Только для AIR)Указывает активирована ли клавиша Control или Ctrl. Этот параметр только для Adobe AIR; не устанавливать его для содержимого Flash Player.
|
Связанные элементы API
clone | () | метод |
override public function clone():Event| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Создает копию объекта TransformGestureEvent и задает значение каждого свойства, совпадающее с оригиналом.
ВозвращаетEvent — Новый объект TransformGestureEvent, значения свойств которого соответствуют значениям оригинала.
|
toString | () | метод |
override public function toString():String| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Возвращает строку, содержащую все свойства объекта TransformGestureEvent. Строка имеет следующий формат:
[TransformGestureEvent type=value bubbles=value cancelable=value ... ]
String — Строка, содержащая все свойства объекта TransformGestureEvent.
|
GESTURE_DIRECTIONAL_TAP | Константа |
public static const GESTURE_DIRECTIONAL_TAP:String = "gestureDirectionalTap"| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 24, Flash Lite 4 |
Определяет значение свойства 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
GESTURE_PAN | Константа |
public static const GESTURE_PAN:String = "gesturePan"| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Определяет значение свойства 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 для обращения к объекту в списке отображения, обрабатывающему событие в данный момент. |
Связанные элементы API
Пример ( Использование этого примера )
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";
}
}
GESTURE_ROTATE | Константа |
public static const GESTURE_ROTATE:String = "gestureRotate"| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Определяет значение свойства 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 для обращения к объекту в списке отображения, обрабатывающему событие в данный момент. |
Связанные элементы API
Пример ( Использование этого примера )
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";
}
}
GESTURE_SWIPE | Константа |
public static const GESTURE_SWIPE:String = "gestureSwipe"| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Определяет значение свойства 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 для обращения к объекту в списке отображения, обрабатывающему событие в данный момент. |
Связанные элементы API
Пример ( Использование этого примера )
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;
}
GESTURE_ZOOM | Константа |
public static const GESTURE_ZOOM:String = "gestureZoom"| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Определяет значение свойства 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 для обращения к объекту в списке отображения, обрабатывающему событие в данный момент. |
Связанные элементы API
Пример ( Использование этого примера )
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";
}
}
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";
}
}
package
{
import flash.display.Bitmap;
import flash.display.Sprite;
import flash.events.TransformGestureEvent;
import flash.text.TextField;
import flash.text.TextFormat;
import flash.ui.Multitouch;
import flash.ui.MultitouchInputMode;
[SWF(width=320, height=460, frameRate=24, backgroundColor=0x000000)]
public class TransformGestureExample2 extends Sprite
{
[Embed(source="african_elephant.jpg")]
public var ElephantImage:Class;
public var scaleDebug:TextField;
public var rotateDebug:TextField;
public function TransformGestureExample2()
{
// Debug
var tf:TextFormat = new TextFormat();
tf.color = 0xffffff;
tf.font = "Helvetica";
tf.size = 11;
this.scaleDebug = new TextField();
this.scaleDebug.width = 310;
this.scaleDebug.defaultTextFormat = tf;
this.scaleDebug.x = 2;
this.scaleDebug.y = 2;
this.stage.addChild(this.scaleDebug);
this.rotateDebug = new TextField();
this.rotateDebug.width = 310;
this.rotateDebug.defaultTextFormat = tf;
this.rotateDebug.x = 2;
this.rotateDebug.y = 15;
this.stage.addChild(this.rotateDebug);
var elephantBitmap:Bitmap = new ElephantImage();
var elephant:Sprite = new Sprite();
elephant.addChild(elephantBitmap);
elephant.x = 160;
elephant.y = 230;
elephantBitmap.x = (300 - (elephantBitmap.bitmapData.width / 2)) * -1;
elephantBitmap.y = (400 - (elephantBitmap.bitmapData.height / 2)) *-1;
this.addChild(elephant);
Multitouch.inputMode = MultitouchInputMode.GESTURE;
elephant.addEventListener(TransformGestureEvent.GESTURE_ZOOM, onZoom);
elephant.addEventListener(TransformGestureEvent.GESTURE_ROTATE, onRotate);
}
private function onZoom(e:TransformGestureEvent):void
{
this.scaleDebug.text = (e.scaleX + ", " + e.scaleY);
var elephant:Sprite = e.target as Sprite;
elephant.scaleX *= e.scaleX;
elephant.scaleY *= e.scaleY;
}
private function onRotate(e:TransformGestureEvent):void
{
var elephant:Sprite = e.target as Sprite;
this.rotateDebug.text = String(e.rotation);
elephant.rotation += e.rotation;
}
}
}
Tue Jun 12 2018, 11:34 AM Z
Скрыть унаследованные общедоступные свойства
Показать унаследованные общедоступные свойства