Пакет | flash.events |
Класс | public class TouchEvent |
Наследование | TouchEvent Event Object |
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | Flash Player 10.1, AIR 2, Flash Lite 4 |
При взаимодействии с таким устройством, как мобильный телефон или планшетный компьютер с сенсорным экраном, пользователь, как правило, касается экрана пальцами или указывающим устройством. Можно разработать программы, которые будут реагировать на базовые события сенсорного экрана (такие как касание одним пальцем) с помощью класса TouchEvent. Создайте прослушиватели для типов событий, определенных этим классом. Для взаимодействия пользователя сразу с несколькими точками контакта (например, пользователь проводит по сенсорному экрану сразу несколькими пальцами) используются связанные классы GestureEvent, PressAndTapGestureEvent и TransformGestureEvent. И с помощью свойств и методов этих классов создайте обработчики событий, которые реагируют на жесты пользователя.
Класс Multitouch служит для определения поддержки сенсорного взаимодействия в текущей среде и для управления этой поддержкой, если она имеется.
Примечание. Когда объекты вложены в список отображения, события сенсорного экрана нацеливаются на самый глубокий из видимых вложенных объектов. Этот объект называется целевым узлом. Чтобы родительский элемент целевого узла (объект, содержащий целевой узел в списке отображения) получил уведомление о событии сенсорного экрана, вызовите метод EventDispatcher.addEventListener()
для родительского элемента, задав в качестве параметра type конкретное событие, которое требуется отслеживать.
В среде AIR 3 и более поздних версий можно прослушивать события приближения на поддерживаемых устройствах Android с активным пером. На таких устройствах объекты событий proximityMove
и touchMove
предоставляют массив байтов, содержащий образцы пути и нажатия, полученные после отправки предыдущего события перемещения. Эти образцы можно использовать для создания траектории пера между событиями прикосновения. (Обратите внимание, что тестирование нажатием для взаимодействия ввода пером со списком отображения происходит только в конце сегмента траектории.)
Связанные элементы API
flash.events.GestureEvent
flash.events.TransformGestureEvent
flash.events.PressAndTapGestureEvent
flash.events.MouseEvent
flash.events.EventDispatcher.addEventListener()
Свойство | Определено | ||
---|---|---|---|
altKey : Boolean
Показывает активность клавиши Alt: true — активна, false — неактивна. | TouchEvent | ||
bubbles : Boolean [только для чтения]
Определяет, является ли событие событием восходящей цепочки. | Event | ||
cancelable : Boolean [только для чтения]
Указывает, можно ли предотвратить поведение, связанное с событием. | Event | ||
commandKey : Boolean
Указывает, активирована ли клавиша Command (только для Mac). | TouchEvent | ||
constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | ||
controlKey : Boolean
Указывает, активирована ли клавиша Control в Mac или клавиша Ctrl в Windows или Linux. | TouchEvent | ||
ctrlKey : Boolean
В Windows или Linux указывает на то, активирована ли клавиша Ctrl (true) или нет (false). | TouchEvent | ||
currentTarget : Object [только для чтения]
Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. | Event | ||
eventPhase : uint [только для чтения]
Текущая фаза в потоке событий. | Event | ||
isPrimaryTouchPoint : Boolean
Указывает, сопоставляется ли первая точка контакта событиям мыши. | TouchEvent | ||
isRelatedObjectInaccessible : Boolean
Если принимает значение true, свойство relatedObject принимает значение null по причинам, связанным с изолированными средами безопасности. | TouchEvent | ||
isTouchPointCanceled : Boolean
Сообщает об отмене операционной системой данной последовательности ввода прикосновением. | TouchEvent | ||
localX : Number
Горизонтальная координата события относительно спрайта-контейнера. | TouchEvent | ||
localY : Number
Вертикальная координата события относительно спрайта-контейнера. | TouchEvent | ||
pressure : Number
Значение в диапазоне 0.0 — 1.0, определяющее интенсивность контакта с устройством. | TouchEvent | ||
relatedObject : InteractiveObject
Ссылка на объект списка отображения, связанный с событием. | TouchEvent | ||
shiftKey : Boolean
Показывает активность клавиши Shift: true — активна, false — неактивна. | TouchEvent | ||
sizeX : Number
Ширина области контакта. | TouchEvent | ||
sizeY : Number
Высота области контакта. | TouchEvent | ||
stageX : Number [только для чтения]
Горизонтальная координата события в глобальных координатах рабочей области. | TouchEvent | ||
stageY : Number [только для чтения]
Вертикальная координата события в глобальных координатах рабочей области. | TouchEvent | ||
target : Object [только для чтения]
Целевой объект события. | Event | ||
timestamp : Number
Сообщает о времени события в миллисекундах. | TouchEvent | ||
touchIntent : String
Сообщает о том, сгенерировано ли событие основным пером или стирающим концом пера. | TouchEvent | ||
touchPointID : int
Уникальный идентификационный номер (целое число), присвоенный точке касания. | TouchEvent | ||
type : String [только для чтения]
Тип события. | Event |
Метод | Определено | ||
---|---|---|---|
TouchEvent(type:String, bubbles:Boolean = true, cancelable:Boolean = false, touchPointID:int = 0, isPrimaryTouchPoint:Boolean = false, localX:Number = NaN, localY:Number = NaN, sizeX:Number = NaN, sizeY:Number = NaN, pressure:Number = NaN, relatedObject:InteractiveObject = null, ctrlKey:Boolean = false, altKey:Boolean = false, shiftKey:Boolean = false, commandKey:Boolean = false, controlKey:Boolean = false, timestamp:Number = NaN, touchIntent:String, samples:ByteArray = null, isTouchPointCanceled:Boolean = false)
Создает объект Event, содержащий данные о событиях сенсорного экрана. | TouchEvent | ||
[переопределить]
Создает копию объекта TouchEvent и задает значение каждого свойства, совпадающее с оригиналом. | TouchEvent | ||
Служебная функция для реализации метода toString() в пользовательских классах ActionScript 3.0 Event. | Event | ||
Обновляет указанный объект ByteArray точками данных высокой частоты для события многоточечного прикосновения. | TouchEvent | ||
Показывает, определено ли заданное свойство для объекта. | Object | ||
Проверяет, выполнялся ли для события вызова метода preventDefault(). | Event | ||
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | ||
Сообщает о нажатии кнопки аппаратного обеспечения с указанным индексом. | TouchEvent | ||
Отменяет поведение по умолчанию для события, если такое поведение можно отменить. | Event | ||
Показывает наличие заданного свойства и его перечисляемость. | Object | ||
Задает доступность динамического свойства для операций цикла. | Object | ||
Отменяет обработку прослушивателей событий в текущем узле, а также во всех узлах, которые следуют в потоке событий за текущим узлом. | Event | ||
Отменяет обработку прослушивателей событий в узлах, которые следуют в потоке событий за текущим узлом. | Event | ||
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | ||
[переопределить]
Возвращает строку, содержащую все свойства объекта TouchEvent. | TouchEvent | ||
Предписывает проигрывателю Flash Player или Adobe AIR выполнить визуализацию после обработки данного события, если список отображения был изменен. | TouchEvent | ||
Возвращает элементарное значение заданного объекта. | Object |
Константа | Определено | ||
---|---|---|---|
PROXIMITY_BEGIN : String = "proximityBegin" [статические]
Определяет значение свойства type объекта события прикосновения PROXIMITY_BEGIN. | TouchEvent | ||
PROXIMITY_END : String = "proximityEnd" [статические]
Определяет значение свойства type объекта события прикосновения PROXIMITY_END. | TouchEvent | ||
PROXIMITY_MOVE : String = "proximityMove" [статические]
Определяет значение свойства type объекта события прикосновения PROXIMITY_MOVE. | TouchEvent | ||
PROXIMITY_OUT : String = "proximityOut" [статические]
Определяет значение свойства type объекта события прикосновения PROXIMITY_OUT. | TouchEvent | ||
PROXIMITY_OVER : String = "proximityOver" [статические]
Определяет значение свойства type объекта события прикосновения PROXIMITY_OVER. | TouchEvent | ||
PROXIMITY_ROLL_OUT : String = "proximityRollOut" [статические]
Определяет значение свойства type объекта события прикосновения PROXIMITY_ROLL_OUT. | TouchEvent | ||
PROXIMITY_ROLL_OVER : String = "proximityRollOver" [статические]
Определяет значение свойства type объекта события прикосновения PROXIMITY_ROLL_OVER. | TouchEvent | ||
TOUCH_BEGIN : String = "touchBegin" [статические]
Определяет значение свойства type объекта события касания TOUCH_BEGIN. | TouchEvent | ||
TOUCH_END : String = "touchEnd" [статические]
Определяет значение свойства type объекта события касания TOUCH_END. | TouchEvent | ||
TOUCH_MOVE : String = "touchMove" [статические]
Определяет значение свойства type объекта события касания TOUCH_MOVE. | TouchEvent | ||
TOUCH_OUT : String = "touchOut" [статические]
Определяет значение свойства type объекта события касания TOUCH_OUT. | TouchEvent | ||
TOUCH_OVER : String = "touchOver" [статические]
Определяет значение свойства type объекта события касания TOUCH_OVER. | TouchEvent | ||
TOUCH_ROLL_OUT : String = "touchRollOut" [статические]
Определяет значение свойства type объекта события касания TOUCH_ROLL_OUT. | TouchEvent | ||
TOUCH_ROLL_OVER : String = "touchRollOver" [статические]
Определяет значение свойства type объекта события касания TOUCH_ROLL_OVER. | TouchEvent | ||
TOUCH_TAP : String = "touchTap" [статические]
Определяет значение свойства type объекта события касания TOUCH_TAP. | TouchEvent |
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 |
Версии среды выполнения: | Flash Player 10.1, AIR 2 |
Указывает, активирована ли клавиша Command (только для Mac).
В ОС Mac OS свойство commandKey
имеет то же значение, что и свойство ctrlKey
. Это свойство всегда имеет значение false в ОС Windows или Linux.
Реализация
public function get commandKey():Boolean
public function set commandKey(value:Boolean):void
controlKey | свойство |
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
isPrimaryTouchPoint | свойство |
isPrimaryTouchPoint:Boolean
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Указывает, сопоставляется ли первая точка контакта событиям мыши.
Реализация
public function get isPrimaryTouchPoint():Boolean
public function set isPrimaryTouchPoint(value:Boolean):void
Связанные элементы API
isRelatedObjectInaccessible | свойство |
isRelatedObjectInaccessible:Boolean
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Если принимает значение true
, свойство relatedObject
принимает значение null
по причинам, связанным с изолированными средами безопасности. Если номинальным значением свойства relatedObject
является ссылка на объект DisplayObject в другой изолированной среде, свойство relatedObject
принимает значение null
, пока не будут заданы двусторонние права в границах данной изолированной среды. Права задаются путем вызова метода Security.allowDomain()
из SWF-файла или указания файла политик на сервере файла изображений и задания свойства LoaderContext.checkPolicyFile
при загрузке изображения.
Реализация
public function get isRelatedObjectInaccessible():Boolean
public function set isRelatedObjectInaccessible(value:Boolean):void
Связанные элементы API
isTouchPointCanceled | свойство |
isTouchPointCanceled:Boolean
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 3 |
Сообщает об отмене операционной системой данной последовательности ввода прикосновением.
События прикосновения могут быть отменены по различным причинам, например, когда прикосновение ладонью отклоняется, поскольку используется перо. isTouchPointCanceled
может принимать только значение true
в событии touchEnd
.
Реализация
public function get isTouchPointCanceled():Boolean
public function set isTouchPointCanceled(value:Boolean):void
localX | свойство |
localY | свойство |
pressure | свойство |
pressure:Number
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Значение в диапазоне 0.0
— 1.0
, определяющее интенсивность контакта с устройством. Если устройство не поддерживает определение давления, используется значение 1.0
.
Реализация
public function get pressure():Number
public function set pressure(value:Number):void
relatedObject | свойство |
relatedObject:InteractiveObject
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Ссылка на объект списка отображения, связанный с событием. Например, когда происходит событие touchOut
, relatedObject
представляет объект списка отображения, на который теперь показывает указатель. Это свойство применимо к событиям touchOut
, touchOver
, touchRollOut
и touchRollOver
.
Это свойство может принимать значение null
по двум причинам: связанный объект отсутствует или связанный объект существует, но находится в изолированной программной среде безопасности, доступ к которой запрещен. Используйте свойство isRelatedObjectInaccessible()
для определения причины.
Реализация
public function get relatedObject():InteractiveObject
public function set relatedObject(value:InteractiveObject):void
Связанные элементы API
shiftKey | свойство |
sizeX | свойство |
sizeY | свойство |
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
timestamp | свойство |
timestamp:Number
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 3 |
Сообщает о времени события в миллисекундах.
Выводимое время отсчитывается относительно времени начала выполнения приложения. Для событий, которые возвращают последовательность точек в буфере образцов, это время отражает истекшее время для последнего образца в буфере.
Реализация
public function get timestamp():Number
public function set timestamp(value:Number):void
Связанные элементы API
touchIntent | свойство |
touchIntent:String
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 3 |
Сообщает о том, сгенерировано ли событие основным пером или стирающим концом пера.
Если событие прикосновения сгенерировано пальцем или другим методом ввода без использования пера либо использование пера для отслеживания высокочастотных движений не поддерживается, это свойство выводит значение TouchEventIntent.UNKNOWN.
В классе TouchEventIntent определяются константы для возможных значений этого свойства. В их числе:
- TouchEventIntent.ERASER
- TouchEventIntent.PEN
- TouchEventIntent.UNKNOWN
Реализация
public function get touchIntent():String
public function set touchIntent(value:String):void
Связанные элементы API
touchPointID | свойство |
touchPointID:int
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Уникальный идентификационный номер (целое число), присвоенный точке касания.
Реализация
public function get touchPointID():int
public function set touchPointID(value:int):void
Пример ( Использование этого примера )
touchMoveID
для проверки правильного значения touchPointID
перед ответом на событие перемещения точки касания. В противном случае другой ввод с помощью касания также запускает обработчика события. Обратите внимание, что прослушиватели фаз перемещения и завершения закреплены за рабочей областью, а не экранным объектом. Рабочая область прослушивает фазы перемещения или завершения, если касание выходит за границы экранного объекта.
Multitouch.inputMode = MultitouchInputMode.TOUCH_POINT; var mySprite:Sprite = new Sprite(); mySprite.graphics.beginFill(0x336699); mySprite.graphics.drawRect(0,0,40,40); addChild(mySprite); var myTextField:TextField = new TextField(); addChild(myTextField); myTextField.width = 200; myTextField.height = 20; var touchMoveID:int = 0; mySprite.addEventListener(TouchEvent.TOUCH_BEGIN, onTouchBegin); function onTouchBegin(event:TouchEvent) { if(touchMoveID != 0) { myTextField.text = "already moving. ignoring new touch"; return; } touchMoveID = event.touchPointID; myTextField.text = "touch begin" + event.touchPointID; stage.addEventListener(TouchEvent.TOUCH_MOVE, onTouchMove); stage.addEventListener(TouchEvent.TOUCH_END, onTouchEnd); } function onTouchMove(event:TouchEvent) { if(event.touchPointID != touchMoveID) { myTextField.text = "ignoring unrelated touch"; return; } mySprite.x = event.stageX; mySprite.y = event.stageY; myTextField.text = "touch move" + event.touchPointID; } function onTouchEnd(event:TouchEvent) { if(event.touchPointID != touchMoveID) { myTextField.text = "ignoring unrelated touch end"; return; } touchMoveID = 0; stage.removeEventListener(TouchEvent.TOUCH_MOVE, onTouchMove); stage.removeEventListener(TouchEvent.TOUCH_END, onTouchEnd); myTextField.text = "touch end" + event.touchPointID; }
TouchEvent | () | Конструктор |
public function TouchEvent(type:String, bubbles:Boolean = true, cancelable:Boolean = false, touchPointID:int = 0, isPrimaryTouchPoint:Boolean = false, localX:Number = NaN, localY:Number = NaN, sizeX:Number = NaN, sizeY:Number = NaN, pressure:Number = NaN, relatedObject:InteractiveObject = null, ctrlKey:Boolean = false, altKey:Boolean = false, shiftKey:Boolean = false, commandKey:Boolean = false, controlKey:Boolean = false, timestamp:Number = NaN, touchIntent:String, samples:ByteArray = null, isTouchPointCanceled:Boolean = false)
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Создает объект Event, содержащий данные о событиях сенсорного экрана. Объекты Event передаются прослушивателям событий в качестве параметров.
Параметрыtype:String — Тип события. Возможные значения: TouchEvent.PROXIMITY_BEGIN , TouchEvent.PROXIMITY_END , TouchEvent.PROXIMITY_MOVE , TouchEvent.PROXIMITY_OUT , TouchEvent.PROXIMITY_OVER , TouchEvent.PROXIMITY_ROLL_OUT , TouchEvent.PROXIMITY_ROLL_OVER , TouchEvent.TOUCH_BEGIN , TouchEvent.TOUCH_END , TouchEvent.TOUCH_MOVE , TouchEvent.TOUCH_OUT , TouchEvent.TOUCH_OVER , TouchEvent.TOUCH_ROLL_OUT , TouchEvent.TOUCH_ROLL_OVER и TouchEvent.TOUCH_TAP .
| |
bubbles:Boolean (default = true ) — Определяет, участвует ли объект Event в фазе восходящей цепочки потока событий.
| |
cancelable:Boolean (default = false ) — Определяет, можно ли отменить объект Event.
| |
touchPointID:int (default = 0 ) — Уникальный идентификационный номер (целое число), присвоенный точке касания.
| |
isPrimaryTouchPoint:Boolean (default = false ) — Указывает, сопоставляется ли первая точка контакта событиям мыши.
| |
localX:Number (default = NaN ) — Горизонтальная координата события относительно спрайта-контейнера.
| |
localY:Number (default = NaN ) — Вертикальная координата события относительно спрайта-контейнера.
| |
sizeX:Number (default = NaN ) — Ширина области контакта.
| |
sizeY:Number (default = NaN ) — Высота области контакта.
| |
pressure:Number (default = NaN ) — Значение в диапазоне 0.0 — 1.0 , определяющее интенсивность контакта с устройством. Если устройство не поддерживает определение давления, используется значение 1.0 .
| |
relatedObject:InteractiveObject (default = null ) — Дополняющий экземпляр InteractiveObject, на который влияет событие. Например, когда происходит событие touchOut , relatedObject представляет объект списка отображения, на который теперь показывает указатель.
| |
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.
| |
timestamp:Number (default = NaN ) — (только в среде AIR) Метка времени события в миллисекундах относительно времени запуска приложения.
| |
touchIntent:String (default = NaN ) — (только в среде AIR) Значение, полученное из класса TouchEventIntent.
| |
samples:ByteArray (default = null ) — (только в среде AIR) Объект ByteArray, содержащий показания положения и нажатия для каждого промежуточного образца, записанного с момента отправки последнего события прикосновения или приближения в последовательности.
| |
isTouchPointCanceled:Boolean (default = false ) — (только в среде AIR) Значение true , если событие прикосновения отменено из-за отклоненного типа прикосновения.
|
clone | () | метод |
override public function clone():Event
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Создает копию объекта TouchEvent и задает значение каждого свойства, совпадающее с оригиналом.
ВозвращаетEvent — Новый объект TouchEvent, значения свойств которого соответствуют значениям оригинала.
|
getSamples | () | метод |
public function getSamples(buffer:ByteArray, append:Boolean = false):uint
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 3 |
Обновляет указанный объект ByteArray точками данных высокой частоты для события многоточечного прикосновения.
Объект ByteArray, на который ссылается параметр buffer
, обновляется значениями промежуточных точек данных между этим и предыдущим событием прикосновения. Три значения с плавающей запятой добавляются для каждого образца: координата x, координата y и значение нажима. Значения положения выводятся с координатами рабочей области. Нажим выводится в виде значения от 0 до 1. Образцы записываются с постоянными интервалами времени. Точная частота зависит от аппаратного обеспечения устройства и драйверов аппаратного обеспечения. Типовые частоты образцов равны приблизительно 133 Гц. Обратите внимание, что события прикосновения не отправляются с точными интервалами. То есть буфер для одним их тех же событий может содержать разное число образов. Последний образец в буфере имеет те же данные, что и свойства stageX
, stageY
и pressure
данного объекта события прикосновения.
Буфер образцов включается в объекты событий, отправляемые для событий proximityMove
и touchMove
.
Параметры
buffer:ByteArray — Объект ByteArray для получения данных образца.
| |
append:Boolean (default = false ) — Если установлено значение true , образцы добавляются в байтовый массив buffer , начиная с текущего свойства position массива. Если установлено значение false (значение по умолчанию), существующие данные в объекте буфера удаляются перед добавлением образцов.
|
uint — Число (типа uint) образцов, добавляемых в буфер. Каждый образец состоит из трех чисел с плавающей запятой.
|
Связанные элементы API
Пример ( Использование этого примера )
function touchMoveHandler( event:TouchEvent ):void { if( (event.type == TouchEvent.TOUCH_MOVE || event.type == TouchEvent.PROXIMITY_MOVE) && event.touchEventIntent != TouchEventIntent.UNKNOWN ) { var samples:ByteArray = new ByteArray(); event.getSamples( samples, true ); samples.position = 0; // rewind to beginning of array before reading var xCoord:Number, yCoord:Number, pressure:Number; while( samples.bytesAvailable > 0 ) { xCoord = samples.readFloat(); yCoord = samples.readFloat(); pressure = samples.readFloat(); //do something with the sample data } } }
var samples:ByteArray = new ByteArray(); function touchMoveHandler( event:TouchEvent ):void { if( (event.type == TouchEvent.TOUCH_MOVE || event.type == TouchEvent.PROXIMITY_MOVE) && event.touchEventIntent != TouchEventIntent.UNKNOWN ) { var sampleCount:uint = event.getSamples( samples, true ); var xCoord:Number, yCoord:Number, pressure:Number; for( var i:int; i < sampleCount; i++ ) { xCoord = samples.readFloat(); yCoord = samples.readFloat(); pressure = samples.readFloat(); //do something with the sample data } } }
isToolButtonDown | () | метод |
public function isToolButtonDown(index:int):Boolean
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 3 |
Сообщает о нажатии кнопки аппаратного обеспечения с указанным индексом.
Параметры
index:int — Отсчитываемый от нуля индекс кнопок поддерживается на устройствах ввода типа пера.
|
Boolean |
toString | () | метод |
override public function toString():String
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Возвращает строку, содержащую все свойства объекта TouchEvent. Строка имеет следующий формат:
[TouchEvent type=value bubbles=value cancelable=value ... ]
String — Строка, содержащая все свойства объекта TouchEvent.
|
updateAfterEvent | () | метод |
public function updateAfterEvent():void
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Предписывает проигрывателю Flash Player или Adobe AIR выполнить визуализацию после обработки данного события, если список отображения был изменен.
PROXIMITY_BEGIN | Константа |
public static const PROXIMITY_BEGIN:String = "proximityBegin"
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 3 |
Определяет значение свойства type
объекта события прикосновения PROXIMITY_BEGIN
.
Объект TouchEvent имеет следующие свойства.
Свойство | Значение |
---|---|
altKey | true , если клавиша Alt активна (Windows или Linux). |
bubbles | true |
cancelable | false ; поведение по умолчанию, подлежащее отмене, не определено. |
commandKey | true в Mac, если клавиша Command активна; false , если неактивна. Всегда false в Windows. |
controlKey | true , если клавиша Ctrl или Control активна; false , если неактивна. |
ctrlKey | true в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false . |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
eventPhase | Текущая фаза в потоке событий. |
isRelatedObjectInaccessible | Имеет значение true , если свойству relatedObject задано значение null в соответствии с правилами изолированной среды безопасности. |
localX | Горизонтальная координата события относительно спрайта-контейнера. |
localY | Вертикальная координата события относительно спрайта-контейнера. |
pressure | Значение в диапазоне 0.0 — 1.0 , определяющее интенсивность контакта с устройством. Если устройство не поддерживает определение давления, используется значение 1.0 . |
relatedObject | Ссылка на объект списка отображения, связанный с событием. |
shiftKey | true , если клавиша Shift активна; иначе — false . |
sizeX | Ширина области контакта. |
sizeY | Высота области контакта. |
stageX | Горизонтальная координата события в глобальных координатах рабочей области. |
stageY | Вертикальная координата события в глобальных координатах рабочей области. |
target | Экземпляр InteractiveObject под указывающим устройством. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент. |
touchPointID | Уникальный идентификационный номер (целое число), присвоенный точке касания. |
timestamp | (только в среде AIR) Метка времени события в миллисекундах относительно времени запуска приложения. |
touchIntent | (только в среде AIR) Значение, полученное из класса TouchEventIntent. |
isTouchPointCanceled | (только в среде AIR) Значение true , если событие прикосновения отменено из-за логики отклонения прикосновения устройства. |
Связанные элементы API
PROXIMITY_END | Константа |
public static const PROXIMITY_END:String = "proximityEnd"
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 3 |
Определяет значение свойства type
объекта события прикосновения PROXIMITY_END
.
Объект TouchEvent имеет следующие свойства.
Свойство | Значение |
---|---|
altKey | true , если клавиша Alt активна (Windows или Linux). |
bubbles | true |
cancelable | false ; поведение по умолчанию, подлежащее отмене, не определено. |
commandKey | true в Mac, если клавиша Command активна; false , если неактивна. Всегда false в Windows. |
controlKey | true , если клавиша Ctrl или Control активна; false , если неактивна. |
ctrlKey | true в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false . |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
eventPhase | Текущая фаза в потоке событий. |
isRelatedObjectInaccessible | Имеет значение true , если свойству relatedObject задано значение null в соответствии с правилами изолированной среды безопасности. |
localX | Горизонтальная координата события относительно спрайта-контейнера. |
localY | Вертикальная координата события относительно спрайта-контейнера. |
pressure | Значение в диапазоне 0.0 — 1.0 , определяющее интенсивность контакта с устройством. Если устройство не поддерживает определение давления, используется значение 1.0 . |
relatedObject | Ссылка на объект списка отображения, связанный с событием. |
shiftKey | true , если клавиша Shift активна; иначе — false . |
sizeX | Ширина области контакта. |
sizeY | Высота области контакта. |
stageX | Горизонтальная координата события в глобальных координатах рабочей области. |
stageY | Вертикальная координата события в глобальных координатах рабочей области. |
target | Экземпляр InteractiveObject под указывающим устройством. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент. |
touchPointID | Уникальный идентификационный номер (целое число), присвоенный точке касания. |
timestamp | (только в среде AIR) Метка времени события в миллисекундах относительно времени запуска приложения. |
touchIntent | (только в среде AIR) Значение, полученное из класса TouchEventIntent. |
isTouchPointCanceled | (только в среде AIR) Значение true , если событие прикосновения отменено из-за логики отклонения прикосновения устройства. |
Связанные элементы API
PROXIMITY_MOVE | Константа |
public static const PROXIMITY_MOVE:String = "proximityMove"
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 3 |
Определяет значение свойства type
объекта события прикосновения PROXIMITY_MOVE
.
Объект TouchEvent имеет следующие свойства.
Свойство | Значение |
---|---|
altKey | true , если клавиша Alt активна (Windows или Linux). |
bubbles | true |
cancelable | false ; поведение по умолчанию, подлежащее отмене, не определено. |
commandKey | true в Mac, если клавиша Command активна; false , если неактивна. Всегда false в Windows. |
controlKey | true , если клавиша Ctrl или Control активна; false , если неактивна. |
ctrlKey | true в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false . |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
eventPhase | Текущая фаза в потоке событий. |
isRelatedObjectInaccessible | Имеет значение true , если свойству relatedObject задано значение null в соответствии с правилами изолированной среды безопасности. |
localX | Горизонтальная координата события относительно спрайта-контейнера. |
localY | Вертикальная координата события относительно спрайта-контейнера. |
pressure | Значение в диапазоне 0.0 — 1.0 , определяющее интенсивность контакта с устройством. Если устройство не поддерживает определение давления, используется значение 1.0 . |
relatedObject | Ссылка на объект списка отображения, связанный с событием. |
shiftKey | true , если клавиша Shift активна; иначе — false . |
sizeX | Ширина области контакта. |
sizeY | Высота области контакта. |
stageX | Горизонтальная координата события в глобальных координатах рабочей области. |
stageY | Вертикальная координата события в глобальных координатах рабочей области. |
target | Экземпляр InteractiveObject под указывающим устройством. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент. |
touchPointID | Уникальный идентификационный номер (целое число), присвоенный точке касания. |
timestamp | (только в среде AIR) Метка времени события в миллисекундах относительно времени запуска приложения. |
touchIntent | (только в среде AIR) Значение, полученное из класса TouchEventIntent. |
isTouchPointCanceled | (только в среде AIR) Значение true , если событие прикосновения отменено из-за логики отклонения прикосновения устройства. |
Связанные элементы API
PROXIMITY_OUT | Константа |
public static const PROXIMITY_OUT:String = "proximityOut"
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 3 |
Определяет значение свойства type
объекта события прикосновения PROXIMITY_OUT
.
Объект TouchEvent имеет следующие свойства.
Свойство | Значение |
---|---|
altKey | true , если клавиша Alt активна (Windows или Linux). |
bubbles | true |
cancelable | false ; поведение по умолчанию, подлежащее отмене, не определено. |
commandKey | true в Mac, если клавиша Command активна; false , если неактивна. Всегда false в Windows. |
controlKey | true , если клавиша Ctrl или Control активна; false , если неактивна. |
ctrlKey | true в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false . |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
eventPhase | Текущая фаза в потоке событий. |
isRelatedObjectInaccessible | Имеет значение true , если свойству relatedObject задано значение null в соответствии с правилами изолированной среды безопасности. |
localX | Горизонтальная координата события относительно спрайта-контейнера. |
localY | Вертикальная координата события относительно спрайта-контейнера. |
pressure | Значение в диапазоне 0.0 — 1.0 , определяющее интенсивность контакта с устройством. Если устройство не поддерживает определение давления, используется значение 1.0 . |
relatedObject | Ссылка на объект списка отображения, связанный с событием. |
shiftKey | true , если клавиша Shift активна; иначе — false . |
sizeX | Ширина области контакта. |
sizeY | Высота области контакта. |
stageX | Горизонтальная координата события в глобальных координатах рабочей области. |
stageY | Вертикальная координата события в глобальных координатах рабочей области. |
target | Экземпляр InteractiveObject под указывающим устройством. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент. |
touchPointID | Уникальный идентификационный номер (целое число), присвоенный точке касания. |
timestamp | (только в среде AIR) Метка времени события в миллисекундах относительно времени запуска приложения. |
touchIntent | (только в среде AIR) Значение, полученное из класса TouchEventIntent. |
isTouchPointCanceled | (только в среде AIR) Значение true , если событие прикосновения отменено из-за логики отклонения прикосновения устройства. |
Связанные элементы API
PROXIMITY_OVER | Константа |
public static const PROXIMITY_OVER:String = "proximityOver"
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 3 |
Определяет значение свойства type
объекта события прикосновения PROXIMITY_OVER
.
Объект TouchEvent имеет следующие свойства.
Свойство | Значение |
---|---|
altKey | true , если клавиша Alt активна (Windows или Linux). |
bubbles | true |
cancelable | false ; поведение по умолчанию, подлежащее отмене, не определено. |
commandKey | true в Mac, если клавиша Command активна; false , если неактивна. Всегда false в Windows. |
controlKey | true , если клавиша Ctrl или Control активна; false , если неактивна. |
ctrlKey | true в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false . |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
eventPhase | Текущая фаза в потоке событий. |
isRelatedObjectInaccessible | Имеет значение true , если свойству relatedObject задано значение null в соответствии с правилами изолированной среды безопасности. |
localX | Горизонтальная координата события относительно спрайта-контейнера. |
localY | Вертикальная координата события относительно спрайта-контейнера. |
pressure | Значение в диапазоне 0.0 — 1.0 , определяющее интенсивность контакта с устройством. Если устройство не поддерживает определение давления, используется значение 1.0 . |
relatedObject | Ссылка на объект списка отображения, связанный с событием. |
shiftKey | true , если клавиша Shift активна; иначе — false . |
sizeX | Ширина области контакта. |
sizeY | Высота области контакта. |
stageX | Горизонтальная координата события в глобальных координатах рабочей области. |
stageY | Вертикальная координата события в глобальных координатах рабочей области. |
target | Экземпляр InteractiveObject под указывающим устройством. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент. |
touchPointID | Уникальный идентификационный номер (целое число), присвоенный точке касания. |
timestamp | (только в среде AIR) Метка времени события в миллисекундах относительно времени запуска приложения. |
touchIntent | (только в среде AIR) Значение, полученное из класса TouchEventIntent. |
isTouchPointCanceled | (только в среде AIR) Значение true , если событие прикосновения отменено из-за логики отклонения прикосновения устройства. |
Связанные элементы API
PROXIMITY_ROLL_OUT | Константа |
public static const PROXIMITY_ROLL_OUT:String = "proximityRollOut"
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 3 |
Определяет значение свойства type
объекта события прикосновения PROXIMITY_ROLL_OUT
.
Объект TouchEvent имеет следующие свойства.
Свойство | Значение |
---|---|
altKey | true , если клавиша Alt активна (Windows или Linux). |
bubbles | true |
cancelable | false ; поведение по умолчанию, подлежащее отмене, не определено. |
commandKey | true в Mac, если клавиша Command активна; false , если неактивна. Всегда false в Windows. |
controlKey | true , если клавиша Ctrl или Control активна; false , если неактивна. |
ctrlKey | true в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false . |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
eventPhase | Текущая фаза в потоке событий. |
isRelatedObjectInaccessible | Имеет значение true , если свойству relatedObject задано значение null в соответствии с правилами изолированной среды безопасности. |
localX | Горизонтальная координата события относительно спрайта-контейнера. |
localY | Вертикальная координата события относительно спрайта-контейнера. |
pressure | Значение в диапазоне 0.0 — 1.0 , определяющее интенсивность контакта с устройством. Если устройство не поддерживает определение давления, используется значение 1.0 . |
relatedObject | Ссылка на объект списка отображения, связанный с событием. |
shiftKey | true , если клавиша Shift активна; иначе — false . |
sizeX | Ширина области контакта. |
sizeY | Высота области контакта. |
stageX | Горизонтальная координата события в глобальных координатах рабочей области. |
stageY | Вертикальная координата события в глобальных координатах рабочей области. |
target | Экземпляр InteractiveObject под указывающим устройством. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент. |
touchPointID | Уникальный идентификационный номер (целое число), присвоенный точке касания. |
timestamp | (только в среде AIR) Метка времени события в миллисекундах относительно времени запуска приложения. |
touchIntent | (только в среде AIR) Значение, полученное из класса TouchEventIntent. |
isTouchPointCanceled | (только в среде AIR) Значение true , если событие прикосновения отменено из-за логики отклонения прикосновения устройства. |
Связанные элементы API
PROXIMITY_ROLL_OVER | Константа |
public static const PROXIMITY_ROLL_OVER:String = "proximityRollOver"
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 3 |
Определяет значение свойства type
объекта события прикосновения PROXIMITY_ROLL_OVER
.
Объект TouchEvent имеет следующие свойства.
Свойство | Значение |
---|---|
altKey | true , если клавиша Alt активна (Windows или Linux). |
bubbles | true |
cancelable | false ; поведение по умолчанию, подлежащее отмене, не определено. |
commandKey | true в Mac, если клавиша Command активна; false , если неактивна. Всегда false в Windows. |
controlKey | true , если клавиша Ctrl или Control активна; false , если неактивна. |
ctrlKey | true в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false . |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
eventPhase | Текущая фаза в потоке событий. |
isRelatedObjectInaccessible | Имеет значение true , если свойству relatedObject задано значение null в соответствии с правилами изолированной среды безопасности. |
localX | Горизонтальная координата события относительно спрайта-контейнера. |
localY | Вертикальная координата события относительно спрайта-контейнера. |
pressure | Значение в диапазоне 0.0 — 1.0 , определяющее интенсивность контакта с устройством. Если устройство не поддерживает определение давления, используется значение 1.0 . |
relatedObject | Ссылка на объект списка отображения, связанный с событием. |
shiftKey | true , если клавиша Shift активна; иначе — false . |
sizeX | Ширина области контакта. |
sizeY | Высота области контакта. |
stageX | Горизонтальная координата события в глобальных координатах рабочей области. |
stageY | Вертикальная координата события в глобальных координатах рабочей области. |
target | Экземпляр InteractiveObject под указывающим устройством. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент. |
touchPointID | Уникальный идентификационный номер (целое число), присвоенный точке касания. |
timestamp | (только в среде AIR) Метка времени события в миллисекундах относительно времени запуска приложения. |
touchIntent | (только в среде AIR) Значение, полученное из класса TouchEventIntent. |
isTouchPointCanceled | (только в среде AIR) Значение true , если событие прикосновения отменено из-за логики отклонения прикосновения устройства. |
Связанные элементы API
TOUCH_BEGIN | Константа |
public static const TOUCH_BEGIN:String = "touchBegin"
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Определяет значение свойства type
объекта события касания TOUCH_BEGIN
.
Объект TouchEvent имеет следующие свойства.
Свойство | Значение |
---|---|
altKey | true , если клавиша Alt активна (Windows или Linux). |
bubbles | true |
cancelable | false ; поведение по умолчанию, подлежащее отмене, не определено. |
commandKey | true в Mac, если клавиша Command активна; false , если неактивна. Всегда false в Windows. |
controlKey | true , если клавиша Ctrl или Control активна; false , если неактивна. |
ctrlKey | true в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false . |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
eventPhase | Текущая фаза в потоке событий. |
isRelatedObjectInaccessible | Имеет значение true , если свойству relatedObject задано значение null в соответствии с правилами изолированной среды безопасности. |
localX | Горизонтальная координата события относительно спрайта-контейнера. |
localY | Вертикальная координата события относительно спрайта-контейнера. |
pressure | Значение в диапазоне 0.0 — 1.0 , определяющее интенсивность контакта с устройством. Если устройство не поддерживает определение давления, используется значение 1.0 . |
relatedObject | Ссылка на объект списка отображения, связанный с событием. |
shiftKey | true , если клавиша Shift активна; иначе — false . |
sizeX | Ширина области контакта. |
sizeY | Высота области контакта. |
stageX | Горизонтальная координата события в глобальных координатах рабочей области. |
stageY | Вертикальная координата события в глобальных координатах рабочей области. |
target | Экземпляр InteractiveObject под указывающим устройством. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент. |
touchPointID | Уникальный идентификационный номер (целое число), присвоенный точке касания. |
Связанные элементы API
TOUCH_END | Константа |
public static const TOUCH_END:String = "touchEnd"
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Определяет значение свойства type
объекта события касания TOUCH_END
.
Объект TouchEvent имеет следующие свойства.
Свойство | Значение |
---|---|
altKey | true , если клавиша Alt активна (Windows или Linux). |
bubbles | true |
cancelable | false ; поведение по умолчанию, подлежащее отмене, не определено. |
commandKey | true в Mac, если клавиша Command активна; false , если неактивна. Всегда false в Windows. |
controlKey | true , если клавиша Ctrl или Control активна; false , если неактивна. |
ctrlKey | true в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false . |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
eventPhase | Текущая фаза в потоке событий. |
isRelatedObjectInaccessible | Имеет значение true , если свойству relatedObject задано значение null в соответствии с правилами изолированной среды безопасности. |
localX | Горизонтальная координата события относительно спрайта-контейнера. |
localY | Вертикальная координата события относительно спрайта-контейнера. |
pressure | Значение в диапазоне 0.0 — 1.0 , определяющее интенсивность контакта с устройством. Если устройство не поддерживает определение давления, используется значение 1.0 . |
relatedObject | Ссылка на объект списка отображения, связанный с событием. |
shiftKey | true , если клавиша Shift активна; иначе — false . |
sizeX | Ширина области контакта. |
sizeY | Высота области контакта. |
stageX | Горизонтальная координата события в глобальных координатах рабочей области. |
stageY | Вертикальная координата события в глобальных координатах рабочей области. |
target | Экземпляр InteractiveObject под указывающим устройством. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент. |
touchPointID | Уникальный идентификационный номер (целое число), присвоенный точке касания. |
Связанные элементы API
TOUCH_MOVE | Константа |
public static const TOUCH_MOVE:String = "touchMove"
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Определяет значение свойства type
объекта события касания TOUCH_MOVE
.
Объект TouchEvent имеет следующие свойства.
Свойство | Значение |
---|---|
altKey | true , если клавиша Alt активна (Windows или Linux). |
bubbles | true |
cancelable | false ; поведение по умолчанию, подлежащее отмене, не определено. |
commandKey | true в Mac, если клавиша Command активна; false , если неактивна. Всегда false в Windows. |
controlKey | true , если клавиша Ctrl или Control активна; false , если неактивна. |
ctrlKey | true в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false . |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
eventPhase | Текущая фаза в потоке событий. |
isRelatedObjectInaccessible | Имеет значение true , если свойству relatedObject задано значение null в соответствии с правилами изолированной среды безопасности. |
localX | Горизонтальная координата события относительно спрайта-контейнера. |
localY | Вертикальная координата события относительно спрайта-контейнера. |
pressure | Значение в диапазоне 0.0 — 1.0 , определяющее интенсивность контакта с устройством. Если устройство не поддерживает определение давления, используется значение 1.0 . |
relatedObject | Ссылка на объект списка отображения, связанный с событием. |
shiftKey | true , если клавиша Shift активна; иначе — false . |
sizeX | Ширина области контакта. |
sizeY | Высота области контакта. |
stageX | Горизонтальная координата события в глобальных координатах рабочей области. |
stageY | Вертикальная координата события в глобальных координатах рабочей области. |
target | Экземпляр InteractiveObject под указывающим устройством. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент. |
touchPointID | Уникальный идентификационный номер (целое число), присвоенный точке касания. |
Связанные элементы API
TOUCH_OUT | Константа |
public static const TOUCH_OUT:String = "touchOut"
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Определяет значение свойства type
объекта события касания TOUCH_OUT
.
Объект TouchEvent имеет следующие свойства.
Свойство | Значение |
---|---|
altKey | true , если клавиша Alt активна (Windows или Linux). |
bubbles | true |
cancelable | false ; поведение по умолчанию, подлежащее отмене, не определено. |
commandKey | true в Mac, если клавиша Command активна; false , если неактивна. Всегда false в Windows. |
controlKey | true , если клавиша Ctrl или Control активна; false , если неактивна. |
ctrlKey | true в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false . |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
eventPhase | Текущая фаза в потоке событий. |
isRelatedObjectInaccessible | Имеет значение true , если свойству relatedObject задано значение null в соответствии с правилами изолированной среды безопасности. |
localX | Горизонтальная координата события относительно спрайта-контейнера. |
localY | Вертикальная координата события относительно спрайта-контейнера. |
pressure | Значение в диапазоне 0.0 — 1.0 , определяющее интенсивность контакта с устройством. Если устройство не поддерживает определение давления, используется значение 1.0 . |
relatedObject | Ссылка на объект списка отображения, связанный с событием. |
shiftKey | true , если клавиша Shift активна; иначе — false . |
sizeX | Ширина области контакта. |
sizeY | Высота области контакта. |
stageX | Горизонтальная координата события в глобальных координатах рабочей области. |
stageY | Вертикальная координата события в глобальных координатах рабочей области. |
target | Экземпляр InteractiveObject под указывающим устройством. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент. |
touchPointID | Уникальный идентификационный номер (целое число), присвоенный точке касания. |
Связанные элементы API
TOUCH_OVER | Константа |
public static const TOUCH_OVER:String = "touchOver"
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Определяет значение свойства type
объекта события касания TOUCH_OVER
.
Объект TouchEvent имеет следующие свойства.
Свойство | Значение |
---|---|
altKey | true , если клавиша Alt активна (Windows или Linux). |
bubbles | true |
cancelable | false ; поведение по умолчанию, подлежащее отмене, не определено. |
commandKey | true в Mac, если клавиша Command активна; false , если неактивна. Всегда false в Windows. |
controlKey | true , если клавиша Ctrl или Control активна; false , если неактивна. |
ctrlKey | true в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false . |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
eventPhase | Текущая фаза в потоке событий. |
isRelatedObjectInaccessible | Имеет значение true , если свойству relatedObject задано значение null в соответствии с правилами изолированной среды безопасности. |
localX | Горизонтальная координата события относительно спрайта-контейнера. |
localY | Вертикальная координата события относительно спрайта-контейнера. |
pressure | Значение в диапазоне 0.0 — 1.0 , определяющее интенсивность контакта с устройством. Если устройство не поддерживает определение давления, используется значение 1.0 . |
relatedObject | Ссылка на объект списка отображения, связанный с событием. |
shiftKey | true , если клавиша Shift активна; иначе — false . |
sizeX | Ширина области контакта. |
sizeY | Высота области контакта. |
stageX | Горизонтальная координата события в глобальных координатах рабочей области. |
stageY | Вертикальная координата события в глобальных координатах рабочей области. |
target | Экземпляр InteractiveObject под указывающим устройством. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент. |
touchPointID | Уникальный идентификационный номер (целое число), присвоенный точке касания. |
Связанные элементы API
TOUCH_ROLL_OUT | Константа |
public static const TOUCH_ROLL_OUT:String = "touchRollOut"
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Определяет значение свойства type
объекта события касания TOUCH_ROLL_OUT
.
Объект TouchEvent имеет следующие свойства.
Свойство | Значение |
---|---|
altKey | true , если клавиша Alt активна (Windows или Linux). |
bubbles | true |
cancelable | false ; поведение по умолчанию, подлежащее отмене, не определено. |
commandKey | true в Mac, если клавиша Command активна; false , если неактивна. Всегда false в Windows. |
controlKey | true , если клавиша Ctrl или Control активна; false , если неактивна. |
ctrlKey | true в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false . |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
eventPhase | Текущая фаза в потоке событий. |
isRelatedObjectInaccessible | Имеет значение true , если свойству relatedObject задано значение null в соответствии с правилами изолированной среды безопасности. |
localX | Горизонтальная координата события относительно спрайта-контейнера. |
localY | Вертикальная координата события относительно спрайта-контейнера. |
pressure | Значение в диапазоне 0.0 — 1.0 , определяющее интенсивность контакта с устройством. Если устройство не поддерживает определение давления, используется значение 1.0 . |
relatedObject | Ссылка на объект списка отображения, связанный с событием. |
shiftKey | true , если клавиша Shift активна; иначе — false . |
sizeX | Ширина области контакта. |
sizeY | Высота области контакта. |
stageX | Горизонтальная координата события в глобальных координатах рабочей области. |
stageY | Вертикальная координата события в глобальных координатах рабочей области. |
target | Экземпляр InteractiveObject под указывающим устройством. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент. |
touchPointID | Уникальный идентификационный номер (целое число), присвоенный точке касания. |
Связанные элементы API
TOUCH_ROLL_OVER | Константа |
public static const TOUCH_ROLL_OVER:String = "touchRollOver"
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Определяет значение свойства type
объекта события касания TOUCH_ROLL_OVER
.
Объект TouchEvent имеет следующие свойства.
Свойство | Значение |
---|---|
altKey | true , если клавиша Alt активна (Windows или Linux). |
bubbles | true |
cancelable | false ; поведение по умолчанию, подлежащее отмене, не определено. |
commandKey | true в Mac, если клавиша Command активна; false , если неактивна. Всегда false в Windows. |
controlKey | true , если клавиша Ctrl или Control активна; false , если неактивна. |
ctrlKey | true в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false . |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
eventPhase | Текущая фаза в потоке событий. |
isRelatedObjectInaccessible | Имеет значение true , если свойству relatedObject задано значение null в соответствии с правилами изолированной среды безопасности. |
localX | Горизонтальная координата события относительно спрайта-контейнера. |
localY | Вертикальная координата события относительно спрайта-контейнера. |
pressure | Значение в диапазоне 0.0 — 1.0 , определяющее интенсивность контакта с устройством. Если устройство не поддерживает определение давления, используется значение 1.0 . |
relatedObject | Ссылка на объект списка отображения, связанный с событием. |
shiftKey | true , если клавиша Shift активна; иначе — false . |
sizeX | Ширина области контакта. |
sizeY | Высота области контакта. |
stageX | Горизонтальная координата события в глобальных координатах рабочей области. |
stageY | Вертикальная координата события в глобальных координатах рабочей области. |
target | Экземпляр InteractiveObject под указывающим устройством. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент. |
touchPointID | Уникальный идентификационный номер (целое число), присвоенный точке касания. |
Связанные элементы API
TOUCH_TAP | Константа |
public static const TOUCH_TAP:String = "touchTap"
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Определяет значение свойства type
объекта события касания TOUCH_TAP
.
Объект TouchEvent имеет следующие свойства.
Свойство | Значение |
---|---|
altKey | true , если клавиша Alt активна (Windows или Linux). |
bubbles | true |
cancelable | false ; поведение по умолчанию, подлежащее отмене, не определено. |
commandKey | true в Mac, если клавиша Command активна; false , если неактивна. Всегда false в Windows. |
controlKey | true , если клавиша Ctrl или Control активна; false , если неактивна. |
ctrlKey | true в Windows или Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false . |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
eventPhase | Текущая фаза в потоке событий. |
isRelatedObjectInaccessible | Имеет значение true , если свойству relatedObject задано значение null в соответствии с правилами изолированной среды безопасности. |
localX | Горизонтальная координата события относительно спрайта-контейнера. |
localY | Вертикальная координата события относительно спрайта-контейнера. |
pressure | Значение в диапазоне 0.0 — 1.0 , определяющее интенсивность контакта с устройством. Если устройство не поддерживает определение давления, используется значение 1.0 . |
relatedObject | Ссылка на объект списка отображения, связанный с событием. |
shiftKey | true , если клавиша Shift активна; иначе — false . |
sizeX | Ширина области контакта. |
sizeY | Высота области контакта. |
stageX | Горизонтальная координата события в глобальных координатах рабочей области. |
stageY | Вертикальная координата события в глобальных координатах рабочей области. |
target | Экземпляр InteractiveObject под указывающим устройством. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент. |
touchPointID | Уникальный идентификационный номер (целое число), присвоенный точке касания. |
Связанные элементы API
Пример ( Использование этого примера )
Multitouch.inputMode=MultitouchInputMode.TOUCH_POINT; var mySprite:Sprite = new Sprite(); var myTextField:TextField = new TextField(); mySprite.graphics.beginFill(0x336699); mySprite.graphics.drawRect(0,0,40,40); addChild(mySprite); mySprite.addEventListener(TouchEvent.TOUCH_TAP, taphandler); function taphandler(e:TouchEvent): void { myTextField.text = "I've been tapped"; myTextField.y = 50; addChild(myTextField); }
TOUCH_BEGIN
, TOUCH_MOVE
и TOUCH_END
. Во время перемещения точки контакта по экрану (onTouchMove
), отслеживается и отображается ее координата по оси X относительно рабочей области. Для параметров Sprite.startTouchDrag
в функции onTouchBegin
значением touchPointID является значение, присвоенное объекту события. Параметр bounds представляет собой прямоугольник, определяющий границы родительского экранного объекта (bg является экранным объектом, содержащим MySprite).
Multitouch.inputMode = MultitouchInputMode.TOUCH_POINT; MySprite.addEventListener(TouchEvent.TOUCH_BEGIN, onTouchBegin); MySprite.addEventListener(TouchEvent.TOUCH_MOVE, onTouchMove); MySprite.addEventListener(TouchEvent.TOUCH_END, onTouchEnd); function onTouchBegin(eBegin:TouchEvent) { eBegin.target.startTouchDrag(eBegin.touchPointID, false, bg.getRect(this)); trace("touch begin"); } function onTouchMove(eMove:TouchEvent) { trace(eMove.stageX); } function onTouchEnd(eEnd:TouchEvent) { eEnd.target.stopTouchDrag(eEnd.touchPointID); trace("touch end"); }
Multitouch.maxTouchPoints
и свойство touchPointID
объекта события прикосновения. Этот пример предоставлен Кристианом Кантреллом (Christian Cantrell), более подробное объявление приводится в его руководстве по быстрому началу работы: Multi-touch and gesture support on the Flash Platform (Поддержка технологии Multi-Touch и жестов на платформе Flash Platform).
package { import flash.display.Sprite; import flash.events.TouchEvent; import flash.text.AntiAliasType; import flash.text.TextField; import flash.text.TextFormat; import flash.ui.Multitouch; import flash.ui.MultitouchInputMode; [SWF(width=320, height=460, frameRate=24, backgroundColor=0xEB7F00)] public class TouchExample2 extends Sprite { private var dots:Object; private var labels:Object; private var labelFormat:TextFormat; private var dotCount:uint; private var dotsLeft:TextField; private static const LABEL_SPACING:uint = 15; public function TouchExample2() { super(); this.labelFormat = new TextFormat(); labelFormat.color = 0xACF0F2; labelFormat.font = "Helvetica"; labelFormat.size = 11; this.dotCount = 0; this.dotsLeft = new TextField(); this.dotsLeft.width = 300; this.dotsLeft.defaultTextFormat = this.labelFormat; this.dotsLeft.x = 3; this.dotsLeft.y = 0; this.stage.addChild(this.dotsLeft); this.updateDotsLeft(); this.dots = new Object(); this.labels = new Object(); Multitouch.inputMode = MultitouchInputMode.TOUCH_POINT; this.stage.addEventListener(TouchEvent.TOUCH_BEGIN, onTouchBegin); this.stage.addEventListener(TouchEvent.TOUCH_MOVE, onTouchMove); this.stage.addEventListener(TouchEvent.TOUCH_END, onTouchEnd); } private function onTouchBegin(e:TouchEvent):void { if (this.dotCount == Multitouch.maxTouchPoints) return; var dot:Sprite = this.getCircle(); dot.x = e.stageX; dot.y = e.stageY; this.stage.addChild(dot); dot.startTouchDrag(e.touchPointID, true); this.dots[e.touchPointID] = dot; ++this.dotCount; var label:TextField = this.getLabel(e.stageX + ", " + e.stageY); label.x = 3; label.y = this.dotCount * LABEL_SPACING; this.stage.addChild(label); this.labels[e.touchPointID] = label; this.updateDotsLeft(); } private function onTouchMove(e:TouchEvent):void { var label:TextField = this.labels[e.touchPointID]; label.text = (e.stageX + ", " + e.stageY); } private function onTouchEnd(e:TouchEvent):void { var dot:Sprite = this.dots[e.touchPointID]; var label:TextField = this.labels[e.touchPointID]; this.stage.removeChild(dot); this.stage.removeChild(label); delete this.dots[e.touchPointID]; delete this.labels[e.touchPointID]; --this.dotCount; this.updateDotsLeft(); } private function getCircle(circumference:uint = 40):Sprite { var circle:Sprite = new Sprite(); circle.graphics.beginFill(0x1695A3); circle.graphics.drawCircle(0, 0, circumference); return circle; } private function getLabel(initialText:String):TextField { var label:TextField = new TextField(); label.defaultTextFormat = this.labelFormat; label.selectable = false; label.antiAliasType = AntiAliasType.ADVANCED; label.text = initialText; return label; } private function updateDotsLeft():void { this.dotsLeft.text = "Touches Remaining: " + (Multitouch.maxTouchPoints - this.dotCount); } } }
Tue Jun 12 2018, 11:34 AM Z