Справочник по ActionScript® 3.0 для платформы Adobe® Flash®
Домашняя страница  |  Скрыть список пакетов и классов |  Пакеты  |  Классы  |  Что нового  |  Указатель  |  Приложения  |  Почему по-английски?
Фильтры: Получение данных с сервера...
Получение данных с сервера...
flash.events 

TransformGestureEvent  - AS3

Пакетflash.events
Классpublic class TransformGestureEvent
НаследованиеTransformGestureEvent Inheritance GestureEvent Inheritance Event Inheritance Object

Язык версии: ActionScript 3.0
Версии среды выполнения: Flash Player 10.1, AIR 2, Flash Lite 4

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

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

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

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

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

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

Посмотреть примеры

Связанные элементы API



Общедоступные свойства
 СвойствоОпределено
 InheritedaltKey : Boolean
Показывает активность клавиши Alt: true — активна, false — неактивна.
GestureEvent
 Inheritedbubbles : Boolean
[только для чтения] Определяет, является ли событие событием восходящей цепочки.
Event
 Inheritedcancelable : Boolean
[только для чтения] Указывает, можно ли предотвратить поведение, связанное с событием.
Event
 Inherited    commandKey : Boolean
Указывает, активирована ли клавиша Command (только для Mac).
GestureEvent
 Inheritedconstructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.
Object
 InheritedcontrolKey : Boolean
Указывает, активирована ли клавиша Control в Mac или клавиша Ctrl в Windows или Linux.
GestureEvent
 InheritedctrlKey : Boolean
В Windows или Linux указывает на то, активирована ли клавиша Ctrl (true) или нет (false).
GestureEvent
 InheritedcurrentTarget : Object
[только для чтения] Объект, активно обрабатывающий объект Event с помощью прослушивателя событий.
Event
 InheritedeventPhase : uint
[только для чтения] Текущая фаза в потоке событий.
Event
 InheritedlocalX : Number
Горизонтальная координата события относительно спрайта-контейнера.
GestureEvent
 InheritedlocalY : Number
Вертикальная координата события относительно спрайта-контейнера.
GestureEvent
  offsetX : Number
Перемещение экранного объекта по горизонтали с момента предыдущего события жеста.
TransformGestureEvent
  offsetY : Number
Перемещение экранного объекта по вертикали с момента предыдущего события жеста.
TransformGestureEvent
 Inheritedphase : String
Значение класса GesturePhase, обозначающее ход выполнения сенсорного жеста (начало, обновление, завершение или все).
GestureEvent
  rotation : Number
Текущий угол поворота экранного объекта относительно оси z с момента предыдущего события жеста.
TransformGestureEvent
  scaleX : Number
Масштабирование экранного объекта по горизонтали с момента предыдущего события жеста.
TransformGestureEvent
  scaleY : Number
Масштабирование экранного объекта по вертикали с момента предыдущего события жеста.
TransformGestureEvent
 InheritedshiftKey : Boolean
Показывает активность клавиши Shift: true — активна, false — неактивна.
GestureEvent
 InheritedstageX : Number
[только для чтения] Горизонтальная координата события в глобальных координатах рабочей области.
GestureEvent
 InheritedstageY : Number
[только для чтения] Вертикальная координата события в глобальных координатах рабочей области.
GestureEvent
 Inheritedtarget : Object
[только для чтения] Целевой объект события.
Event
 Inheritedtype : 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
 Inherited
formatToString(className:String, ... arguments):String
Служебная функция для реализации метода toString() в пользовательских классах ActionScript 3.0 Event.
Event
 Inherited
Показывает, определено ли заданное свойство для объекта.
Object
 Inherited
Проверяет, выполнялся ли для события вызова метода preventDefault().
Event
 Inherited
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.
Object
 Inherited
Отменяет поведение по умолчанию для события, если такое поведение можно отменить.
Event
 Inherited
Показывает наличие заданного свойства и его перечисляемость.
Object
 Inherited
Задает доступность динамического свойства для операций цикла.
Object
 Inherited
Отменяет обработку прослушивателей событий в текущем узле, а также во всех узлах, которые следуют в потоке событий за текущим узлом.
Event
 Inherited
Отменяет обработку прослушивателей событий в узлах, которые следуют в потоке событий за текущим узлом.
Event
 Inherited
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали.
Object
  
[переопределить] Возвращает строку, содержащую все свойства объекта TransformGestureEvent.
TransformGestureEvent
 Inherited
Обновляет дисплей среды выполнения Flash после обработки события жеста, если список отображения был изменен обработчиком событий.
GestureEvent
 Inherited
Возвращает элементарное значение заданного объекта.
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

свойство
offsetX:Number

Язык версии: ActionScript 3.0
Версии среды выполнения: Flash Player 10.1, AIR 2, Flash Lite 4

Перемещение экранного объекта по горизонтали с момента предыдущего события жеста.



Реализация
    public function get offsetX():Number
    public function set offsetX(value:Number):void

offsetY

свойство 
offsetY:Number

Язык версии: ActionScript 3.0
Версии среды выполнения: Flash Player 10.1, AIR 2, Flash Lite 4

Перемещение экранного объекта по вертикали с момента предыдущего события жеста.



Реализация
    public function get offsetY():Number
    public function set offsetY(value:Number):void

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):void

scaleX

свойство 
scaleX:Number

Язык версии: ActionScript 3.0
Версии среды выполнения: Flash Player 10.1, AIR 2, Flash Lite 4

Масштабирование экранного объекта по горизонтали с момента предыдущего события жеста.



Реализация
    public function get scaleX():Number
    public function set scaleX(value:Number):void

scaleY

свойство 
scaleY:Number

Язык версии: ActionScript 3.0
Версии среды выполнения: Flash Player 10.1, AIR 2, Flash Lite 4

Масштабирование экранного объекта по вертикали с момента предыдущего события жеста.



Реализация
    public function get scaleY():Number
    public function set scaleY(value:Number):void

velocity

свойство 
velocity:Number

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 24, Flash Lite 4

Скорость события жеста преобразования (в пикселях в секунду).



Реализация
    public function get velocity():Number
    public function set velocity(value:Number):void
Сведения о конструкторе

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 имеет следующие свойства.

СвойствоЗначение
altKeytrue, если клавиша Alt активна (Windows или Linux).
bubblestrue
cancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.
commandKeytrue в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows.
controlKeytrue, если клавиша Ctrl или Control активна; false, если неактивна.
ctrlKeytrue в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
phaseТекущая фаза в потоке событий. При отправке событий выделения всегда используется значение all, что соответствует значению GesturePhase.ALL.
localXГоризонтальная координата, в которой произошло событие, относительно контейнера-спрайта. Для направленных жестов касания это значение соответствует центру экрана.
localYВертикальная координата, в которой произошло событие, относительно контейнера-спрайта. Для направленных жестов касания это значение соответствует центру экрана.
scaleXМасштабирование экранного объекта по горизонтали. Для направленных жестов касания это значение 1
scaleYМасштабирование экранного объекта по вертикали. Для направленных жестов касания это значение 1
rotationТекущий угол поворота экранного объекта относительно оси z (в градусах). Для направленных жестов касания это значение 0
offsetXОбозначает горизонтальное направление: 1 — вправо, -1 — влево.
offsetYОбозначает вертикальное направление: 1 — вниз, -1 — вверх.
velocityУказывает скорость жеста смахивания в пикселях в секунду (только для AIR).
shiftKeytrue, если клавиша 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 имеет следующие свойства.

СвойствоЗначение
altKeytrue, если клавиша Alt активна (Windows или Linux).
bubblestrue
cancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.
commandKeytrue в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows.
controlKeytrue, если клавиша Ctrl или Control активна; false, если неактивна.
ctrlKeytrue в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
phaseТекущая фаза в потоке событий, значение представляет собой экземпляр класса GesturePhase.
localXГоризонтальная координата события относительно экранного объекта-контейнера.
localYВертикальная координата события относительно экранного объекта-контейнера.
scaleXМасштабирование экранного объекта по горизонтали с момента предыдущего события жеста. Для жестов панорамирования задается значение 1.
scaleYМасштабирование экранного объекта по вертикали с момента предыдущего события жеста. Для жестов панорамирования задается значение 1.
rotationТекущий угол поворота экранного объекта относительно оси z с момента предыдущего события жеста. Для жестов панорамирования задается значение 0.
offsetXПеремещение экранного объекта по горизонтали относительно предыдущего события жеста.
offsetYПеремещение экранного объекта по вертикали относительно предыдущего события жеста.
velocityСкорость события жеста в пикселях в секунду (только для AIR). Для жеста панорамирования это значение 0.
shiftKeytrue, если клавиша 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 имеет следующие свойства.

СвойствоЗначение
altKeytrue, если клавиша Alt активна (Windows или Linux).
bubblestrue
cancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.
commandKeytrue в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows.
controlKeytrue, если клавиша Ctrl или Control активна; false, если неактивна.
ctrlKeytrue в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
phaseТекущая фаза в потоке событий, значение представляет собой экземпляр класса GesturePhase.
localXГоризонтальная координата события относительно экранного объекта-контейнера.
localYВертикальная координата события относительно экранного объекта-контейнера.
scaleXМасштабирование экранного объекта по горизонтали с момента предыдущего события жеста.
scaleYМасштабирование экранного объекта по вертикали с момента предыдущего события жеста.
rotationТекущий угол поворота экранного объекта относительно оси z с момента предыдущего события жеста.
offsetXПеремещение экранного объекта по горизонтали относительно предыдущего события жеста.
offsetYПеремещение экранного объекта по вертикали относительно предыдущего события жеста.
velocityСкорость события жеста в пикселях в секунду (только для AIR). Для жеста поворота это значение 0
shiftKeytrue, если клавиша 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 имеет следующие свойства.

СвойствоЗначение
altKeytrue, если клавиша Alt активна (Windows или Linux).
bubblestrue
cancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.
commandKeytrue в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows.
controlKeytrue, если клавиша Ctrl или Control активна; false, если неактивна.
ctrlKeytrue в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
phaseТекущая фаза в потоке событий. При отправке событий выделения всегда используется значение all, что соответствует значению GesturePhase.ALL.
localXГоризонтальная координата события относительно спрайта-контейнера.
localYВертикальная координата события относительно спрайта-контейнера.
scaleXМасштабирование экранного объекта по горизонтали. Для жестов выделения задается значение 1
scaleYМасштабирование экранного объекта по вертикали. Для жестов выделения задается значение 1
rotationТекущий угол поворота экранного объекта относительно оси z (в градусах). Для жестов выделения задается значение 0
offsetXОбозначает горизонтальное направление: 1 — вправо, -1 — влево.
offsetYОбозначает вертикальное направление: 1 — вниз, -1 — вверх.
velocityУказывает скорость жеста смахивания в пикселях в секунду (только для AIR). Для остальных это значение 0
shiftKeytrue, если клавиша 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 имеет следующие свойства.

СвойствоЗначение
altKeytrue, если клавиша Alt активна (Windows или Linux).
bubblestrue
cancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.
commandKeytrue в Mac, если клавиша Command активна; false, если неактивна. Всегда false в Windows.
controlKeytrue, если клавиша Ctrl или Control активна; false, если неактивна.
ctrlKeytrue в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
phaseТекущая фаза в потоке событий, значение представляет собой экземпляр класса GesturePhase.
localXГоризонтальная координата события относительно экранного объекта-контейнера.
localYВертикальная координата события относительно экранного объекта-контейнера.
scaleXМасштабирование экранного объекта по горизонтали с момента предыдущего события жеста.
scaleYМасштабирование экранного объекта по вертикали с момента предыдущего события жеста.
rotationТекущий угол поворота экранного объекта относительно оси z с момента предыдущего события жеста.
offsetXПеремещение экранного объекта по горизонтали относительно предыдущего события жеста.
offsetYПеремещение экранного объекта по вертикали относительно предыдущего события жеста.
velocityСкорость события жеста в пикселях в секунду (только для AIR). Для жеста изменения масштаба это значение 0
shiftKeytrue, если клавиша 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";
    }
}
TransformGestureEventExample.as

Следующий пример демонстрирует обработку событий 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";
    }
}
TransformGestureExample2.as

Следующий пример демонстрирует обработку событий жестов преобразования. Предполагается, в локальной системе есть изображение с именем african_elephant.jpg, которое находится в том же каталоге, что и класс TransformGestureExample2. Этот пример предоставлен Кристианом Кантреллом (Christian Cantrell), более подробное объявление приводится в его руководстве по быстрому началу работы: Multi-touch and gesture support on the Flash Platform (Поддержка технологии Multi-Touch и жестов на платформе Flash Platform).
 package
{
    import flash.display.Bitmap;
    import flash.display.Sprite;
    import flash.events.TransformGestureEvent;
    import flash.text.TextField;
    import flash.text.TextFormat;
    import flash.ui.Multitouch;
    import flash.ui.MultitouchInputMode;
    
    [SWF(width=320, height=460, frameRate=24, backgroundColor=0x000000)]
    public class TransformGestureExample2 extends Sprite
    {
        [Embed(source="african_elephant.jpg")]
        public var ElephantImage:Class;
        public var scaleDebug:TextField;
        public var rotateDebug:TextField;

        public function TransformGestureExample2()
        {
            // Debug
            var tf:TextFormat = new TextFormat();
            tf.color = 0xffffff;
            tf.font = "Helvetica";
            tf.size = 11;
            this.scaleDebug = new TextField();
            this.scaleDebug.width = 310;
            this.scaleDebug.defaultTextFormat = tf;
            this.scaleDebug.x = 2;
            this.scaleDebug.y = 2;
            this.stage.addChild(this.scaleDebug);
            this.rotateDebug = new TextField();
            this.rotateDebug.width = 310;
            this.rotateDebug.defaultTextFormat = tf;
            this.rotateDebug.x = 2;
            this.rotateDebug.y = 15;
            this.stage.addChild(this.rotateDebug);

            var elephantBitmap:Bitmap = new ElephantImage();
            var elephant:Sprite = new Sprite();
            
            elephant.addChild(elephantBitmap);
            
            elephant.x = 160;
            elephant.y = 230;
            
            elephantBitmap.x = (300 - (elephantBitmap.bitmapData.width / 2)) * -1;
            elephantBitmap.y = (400 - (elephantBitmap.bitmapData.height / 2)) *-1;
            
            this.addChild(elephant);

            Multitouch.inputMode = MultitouchInputMode.GESTURE;
            elephant.addEventListener(TransformGestureEvent.GESTURE_ZOOM, onZoom);
            elephant.addEventListener(TransformGestureEvent.GESTURE_ROTATE, onRotate);
        }
        
        private function onZoom(e:TransformGestureEvent):void
        {
            this.scaleDebug.text = (e.scaleX + ", " + e.scaleY);
            var elephant:Sprite = e.target as Sprite;
            elephant.scaleX *= e.scaleX;
            elephant.scaleY *= e.scaleY;
        }
        
        private function onRotate(e:TransformGestureEvent):void
        {
            var elephant:Sprite = e.target as Sprite;
            this.rotateDebug.text = String(e.rotation);
            elephant.rotation += e.rotation;
        }
    }
}




[ X ]Почему по-английски?
Содержимое Справочника ActionScript 3.0 отображается на английском языке

Не все части Справочника ActionScript 3.0 переводятся на все языки. Если какой-то текстовый элемент не переведен, он отображается на английском языке. Например, компонент ga.controls.HelpBox не переведен ни на один из языков. Это значит, что в русской версии справки компонент ga.controls.HelpBox будет отображаться на английском языке.