GestureEvent

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

Язык версии:

ActionScript 3.0

Версии среды выполнения:

Flash Player 10.1, AIR 2, Flash Lite 4

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

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

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

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

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

flash.ui.Multitouch
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
		clone():Event [переопределить] Создает копию объекта GestureEvent и задает значение каждого свойства, совпадающее с оригиналом.	GestureEvent
		formatToString(className:String, ... arguments):String Служебная функция для реализации метода toString() в пользовательских классах ActionScript 3.0 Event.	Event
		hasOwnProperty(name:String):Boolean Показывает, определено ли заданное свойство для объекта.	Object
		isDefaultPrevented():Boolean Проверяет, выполнялся ли для события вызова метода preventDefault().	Event
		isPrototypeOf(theClass:Object):Boolean Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.	Object
		preventDefault():void Отменяет поведение по умолчанию для события, если такое поведение можно отменить.	Event
		propertyIsEnumerable(name:String):Boolean Показывает наличие заданного свойства и его перечисляемость.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Задает доступность динамического свойства для операций цикла.	Object
		stopImmediatePropagation():void Отменяет обработку прослушивателей событий в текущем узле, а также во всех узлах, которые следуют в потоке событий за текущим узлом.	Event
		stopPropagation():void Отменяет обработку прослушивателей событий в узлах, которые следуют в потоке событий за текущим узлом.	Event
		toLocaleString():String Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали.	Object
		toString():String [переопределить] Возвращает строку, содержащую все свойства объекта GestureEvent.	GestureEvent
		updateAfterEvent():void Обновляет дисплей среды выполнения Flash после обработки события жеста, если список отображения был изменен обработчиком событий.	GestureEvent
		valueOf():Object Возвращает элементарное значение заданного объекта.	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):void

controlKey

свойство

controlKey:Boolean

Язык версии:

ActionScript 3.0

Версии среды выполнения:

Flash Player 10.1, AIR 2

Указывает, активирована ли клавиша Control в Mac или клавиша Ctrl в Windows или Linux.

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

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

localX

свойство

localX:Number

Язык версии:

ActionScript 3.0

Версии среды выполнения:

Flash Player 10.1, AIR 2, Flash Lite 4

Горизонтальная координата события относительно спрайта-контейнера.

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

localY

свойство

localY:Number

Язык версии:

ActionScript 3.0

Версии среды выполнения:

Flash Player 10.1, AIR 2, Flash Lite 4

Вертикальная координата события относительно спрайта-контейнера.

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

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

flash.events.GesturePhase

shiftKey

свойство

shiftKey:Boolean

Язык версии:

ActionScript 3.0

Версии среды выполнения:

Flash Player 10.1, AIR 2

Показывает активность клавиши Shift: true — активна, false — неактивна.

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

stageX

свойство

stageX:Number [только для чтения]

Язык версии:

ActionScript 3.0

Версии среды выполнения:

Flash Player 10.1, AIR 2, Flash Lite 4

Горизонтальная координата события в глобальных координатах рабочей области. Это свойство вычисляется, когда задано свойство localX.

Реализация
public function get stageX():Number

stageY

свойство

stageY:Number [только для чтения]

Язык версии:

ActionScript 3.0

Версии среды выполнения:

Flash Player 10.1, AIR 2, Flash Lite 4

Вертикальная координата события в глобальных координатах рабочей области. Это свойство вычисляется, когда задано свойство localY.

Реализация
public function get stageY():Number

Сведения о конструкторе

()

Конструктор

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`) — Определяет, участвует ли объект Event в фазе восходящей цепочки потока событий.

	`cancelable:Boolean` (default = `false`) — Определяет, можно ли отменить объект Event.

	`phase:String` (default = `null`) — Значение класса GesturePhase, обозначающее ход выполнения сенсорного жеста (начало, обновление, завершение или все).

	`localX:Number` (default = `0`) — Горизонтальная координата события относительно спрайта-контейнера.

	`localY:Number` (default = `0`) — Вертикальная координата события относительно спрайта-контейнера.

	`ctrlKey:Boolean` (default = `false`) — В Windows или Linux указывает на то, активирована ли клавиша Ctrl. В Mac указывает на то, активирована ли клавиша Ctrl или Command.

	`altKey:Boolean` (default = `false`) — Указывает на то, активирована ли клавиша Alt (только для Windows или Linux).

	`shiftKey:Boolean` (default = `false`) — Указывает, активирована ли клавиша Shift.

	`commandKey:Boolean` (default = `false`) — (Только для AIR) Указывает, активирована ли клавиша Command (только для Mac). Этот параметр только для Adobe AIR; не устанавливать его для содержимого Flash Player.

	`controlKey:Boolean` (default = `false`) — (Только для AIR)Указывает активирована ли клавиша Control или Ctrl. Этот параметр только для Adobe AIR; не устанавливать его для содержимого Flash Player.

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

flash.events.GesturePhase

Сведения о методе

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

flash.display.InteractiveObject.gestureTwoFingerTap
flash.events.GesturePhase

Примеры Использование этого примера

GestureTwoFingerTap.as

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

}

Юридическая информация | Политика конфиденциальности онлайн

GestureEvent - AS3

Классы x

altKey

commandKey

controlKey

ctrlKey

localX

localY

phase

shiftKey

stageX

stageY

GestureEvent

clone

toString

updateAfterEvent

GESTURE_TWO_FINGER_TAP