| Paquete | flash.events |
| Clase | public class TouchEvent |
| Herencia | TouchEvent  Event Object |
| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Cuando el usuario interactúa con un dispositivo como un teléfono móvil o con un dispositivo con pantalla táctil, el usuario normalmente toca la pantalla con los dedos o con un dispositivo de señalización. Puede desarrollar aplicaciones básicas que respondan a eventos táctiles básicos (como un toque con un solo dedo) con la clase TouchEvent. Cree detectores de eventos utilizando los tipos de eventos definidos en esta clase. Para la interacción del usuario con varios puntos de contacto (como, por ejemplo, mover varios dedos por una pantalla táctil al mismo tiempo), utilice las clases GestureEvent, PressAndTapGestureEvent y TransformGestureEvent relacionadas. Y utilice las propiedades y métodos de estas clases para construir controladores de eventos que respondan a las acciones táctiles del usuario en el dispositivo.
Utilice la clase Multitouch para determinar la compatibilidad del entorno actual para dicha interacción y para gestionar la compatibilidad de la interacción táctil si el entorno actual lo admite.
Nota: cuando los objetos se anidan en la lista de visualización, los eventos táctiles se dirigen al objeto más anidado posible que esté visible en la lista de visualización. Este objeto se denomina nodo de destino. Para que un ascendiente del nodo de destino (un objeto que contiene el nodo de destino de la lista de visualización) reciba la notificación de un evento táctil, utilice EventDispatcher.addEventListener() en el nodo ascendiente con el parámetro type establecido para definir el evento táctil que quiera detectar.
En AIR 3 y posterior se pueden detectar eventos de proximidad en dispositivos Android compatibles con lápiz stylus. En estos dispositivos, los objetos de evento proximityMove y touchMove proporcionan un conjunto de bytes que contiene muestras de trazado y presión tomadas desde el anterior evento move. Se pueden utilizar estos ejemplos para construir el trazado del lápiz stylus entre eventos táctiles. (Tenga en cuenta las pruebas duras de interacción de la entrada del lápiz stylus con la lista de visualización sólo se producen al final de un segmento de trazado.)
Elementos de API relacionados
flash.ui.Multitouch
flash.events.GestureEvent
flash.events.TransformGestureEvent
flash.events.PressAndTapGestureEvent
flash.events.MouseEvent
flash.events.EventDispatcher.addEventListener()
flash.events.GestureEvent
flash.events.TransformGestureEvent
flash.events.PressAndTapGestureEvent
flash.events.MouseEvent
flash.events.EventDispatcher.addEventListener()
Propiedades públicas
Ocultar propiedades públicas heredadas
Mostrar propiedades públicas heredadas| Propiedad | Definido por | ||
|---|---|---|---|
| altKey : Boolean
Indica si la tecla Alt está activa (true) o inactiva (false). | TouchEvent | ||
 | bubbles : Boolean [solo lectura]
Indica si un evento es un evento de propagación. | Event | |
| cancelable : Boolean [solo lectura]
Indica si se puede evitar el comportamiento asociado al evento. | Event | |
| commandKey : Boolean
Indica si la tecla Comando está activada (sólo en Mac). | TouchEvent | ||
| constructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada. | Object | |
| controlKey : Boolean
Indica si la tecla Control está activada en Mac y si la tecla Ctrl está activada en Windows o Linux. | TouchEvent | ||
| ctrlKey : Boolean
En Windows o Linux, indica si la tecla Ctrl está activa (true) o inactiva (false). | TouchEvent | ||
| currentTarget : Object [solo lectura]
Objeto que procesa de forma activa el objeto de evento con un detector de eventos. | Event | |
| eventPhase : uint [solo lectura]
La fase actual en el flujo del evento. | Event | |
| isPrimaryTouchPoint : Boolean
Indica si el primer punto de contacto se asignará a los eventos del ratón. | TouchEvent | ||
| isRelatedObjectInaccessible : Boolean
Si es true, la propiedad relatedObject se establece como null por motivos relacionados con entornos limitados de seguridad. | TouchEvent | ||
| isTouchPointCanceled : Boolean
Informa de que esta secuencia de entrada táctil fue cancelada por el sistema operativo. | TouchEvent | ||
| localX : Number
La coordenada horizontal en la que se produce el evento en relación con la clase Sprite contenida. | TouchEvent | ||
| localY : Number
La coordenada vertical en la que se produce el evento en relación con la clase Sprite contenida. | TouchEvent | ||
| pressure : Number
Un valor entre 0.0 y 1.0 que indica fuerza de contacto con el dispositivo. | TouchEvent | ||
| relatedObject : InteractiveObject
Referencia a un objeto de la lista de visualización relacionado con el evento. | TouchEvent | ||
| shiftKey : Boolean
Indica si la tecla Mayús está activa (true) o inactiva (false). | TouchEvent | ||
| sizeX : Number
Anchura de la zona de contacto. | TouchEvent | ||
| sizeY : Number
Altura de la zona de contacto. | TouchEvent | ||
| stageX : Number [solo lectura]
La coordenada horizontal en la que se produce el evento en las coordenadas globales del escenario. | TouchEvent | ||
| stageY : Number [solo lectura]
La coordenada vertical en la que se produce el evento en las coordenadas globales del escenario. | TouchEvent | ||
| target : Object [solo lectura]
El destino del evento. | Event | |
| timestamp : Number
Informa sobre la hora del evento en milisegundos. | TouchEvent | ||
| touchIntent : String
Informa si el toque fue generado por el extremo principal o por el borrador de un lápiz stylus. | TouchEvent | ||
| touchPointID : int
Un número de identificación exclusivo (como un int) asignado al punto táctil. | TouchEvent | ||
| type : String [solo lectura]
El tipo de evento. | Event | |
Métodos públicos
| Método | Definido por | ||
|---|---|---|---|
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)
Crea un objeto de evento que contiene información sobre eventos táctiles. | TouchEvent | ||
[override]
Crea una copia del objeto TouchEvent y define el valor de cada propiedad para que coincida con el del objeto original. | TouchEvent | ||
|
Una función de utilidad para implementar el método toString() en las clases Event personalizadas de ActionScript 3.0. | Event | |
Actualiza el objeto ByteArray especificado con puntos de datos de alta frecuencia para un evento táctil multipunto. | TouchEvent | ||
|
Indica si un objeto tiene definida una propiedad especificada. | Object | |
|
Comprueba si se ha llamado a preventDefault() en el evento. | Event | |
|
Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro. | Object | |
Indica que el botón de hardware en el índice especificado está presionado. | TouchEvent | ||
|
Cancela el comportamiento predeterminado de un evento si es posible cancelarlo. | Event | |
|
Indica si existe la propiedad especificada y si es enumerable. | Object | |
|
Establece la disponibilidad de una propiedad dinámica para operaciones de bucle. | Object | |
|
Impide el proceso de cualquier detector de eventos en el nodo actual y los nodos siguientes en el flujo del evento. | Event | |
|
Impide el proceso de cualquier detector de eventos en nodos siguientes al nodo actual. | Event | |
|
Devuelve la representación de cadena de este objeto, con formato según las convenciones específicas de configuración regional. | Object | |
[override]
Devuelve una cadena con todas las propiedades del objeto TouchEvent. | TouchEvent | ||
Si se ha modificado la lista de visualización, da instrucciones a Flash Player o a Adobe AIR para que muestre la representación tras finalizar el procesamiento del evento. | TouchEvent | ||
|
Devuelve el valor simple del objeto especificado. | Object | |
Constantes públicas
| Constante | Definido por | ||
|---|---|---|---|
| PROXIMITY_BEGIN : String = "proximityBegin" [estática]
Define el valor de la propiedad type para un objeto de evento táctil TOUCH_BEGIN. | TouchEvent | ||
| PROXIMITY_END : String = "proximityEnd" [estática]
Define el valor de la propiedad type para un objeto de evento PROXIMITY_END. | TouchEvent | ||
| PROXIMITY_MOVE : String = "proximityMove" [estática]
Define el valor de la propiedad type para un objeto de evento táctil PROXIMITY_MOVE. | TouchEvent | ||
| PROXIMITY_OUT : String = "proximityOut" [estática]
Define el valor de la propiedad type para un objeto de evento táctil PROXIMITY_OUT. | TouchEvent | ||
| PROXIMITY_OVER : String = "proximityOver" [estática]
Define el valor de la propiedad type para un objeto de evento táctil PROXIMITY_OVER. | TouchEvent | ||
| PROXIMITY_ROLL_OUT : String = "proximityRollOut" [estática]
Define el valor de la propiedad type para un objeto de evento táctil PROXIMITY_ROLL_OUT. | TouchEvent | ||
| PROXIMITY_ROLL_OVER : String = "proximityRollOver" [estática]
Define el valor de la propiedad type para un objeto de evento táctil PROXIMITY_ROLL_OVER. | TouchEvent | ||
| TOUCH_BEGIN : String = "touchBegin" [estática]
Define el valor de la propiedad type para un objeto de evento táctil TOUCH_BEGIN. | TouchEvent | ||
| TOUCH_END : String = "touchEnd" [estática]
Define el valor de la propiedad type para un objeto de evento inlineGraphicStatusChanged. | TouchEvent | ||
| TOUCH_MOVE : String = "touchMove" [estática]
Define el valor de la propiedad type para un objeto de evento táctil TOUCH_MOVE. | TouchEvent | ||
| TOUCH_OUT : String = "touchOut" [estática]
Define el valor de la propiedad type para un objeto de evento táctil TOUCH_OUT. | TouchEvent | ||
| TOUCH_OVER : String = "touchOver" [estática]
Define el valor de la propiedad type para un objeto de evento táctil TOUCH_OVER. | TouchEvent | ||
| TOUCH_ROLL_OUT : String = "touchRollOut" [estática]
Define el valor de la propiedad type para un objeto de evento táctil TOUCH_ROLL_OUT. | TouchEvent | ||
| TOUCH_ROLL_OVER : String = "touchRollOver" [estática]
Define el valor de la propiedad type para un objeto de evento táctil TOUCH_ROLL_OVER. | TouchEvent | ||
| TOUCH_TAP : String = "touchTap" [estática]
Define el valor de la propiedad type para un objeto de evento táctil TOUCH_TAP. | TouchEvent | ||
Información sobre propiedades
altKey | propiedad |
altKey:Boolean| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10.1, AIR 2 |
Indica si la tecla Alt está activa (true) o inactiva (false). Sólo se admite en los sistema operativos Windows y Linux.
Implementación
public function get altKey():Boolean public function set altKey(value:Boolean):voidcommandKey | propiedad |
commandKey:Boolean| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10.1, AIR 2 |
Indica si la tecla Comando está activada (sólo en Mac).
En Mac OS, el valor de la propiedad commandKey es el mismo valor que el de la propiedad ctrlKey. Esta propiedad siempre es false en Windows o en Linux.
Implementación
public function get commandKey():Boolean public function set commandKey(value:Boolean):voidcontrolKey | propiedad |
controlKey:Boolean| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10.1, AIR 2 |
Indica si la tecla Control está activada en Mac y si la tecla Ctrl está activada en Windows o Linux.
Implementación
public function get controlKey():Boolean public function set controlKey(value:Boolean):voidctrlKey | propiedad |
ctrlKey:Boolean| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10.1, AIR 2 |
En Windows o Linux, indica si la tecla Ctrl está activa (true) o inactiva (false). En Macintosh, indica si está activada la tecla Control o Comando.
Implementación
public function get ctrlKey():Boolean public function set ctrlKey(value:Boolean):voidisPrimaryTouchPoint | propiedad |
isPrimaryTouchPoint:Boolean| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Indica si el primer punto de contacto se asignará a los eventos del ratón.
Implementación
public function get isPrimaryTouchPoint():Boolean public function set isPrimaryTouchPoint(value:Boolean):voidElementos de API relacionados
isRelatedObjectInaccessible | propiedad |
isRelatedObjectInaccessible:Boolean| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Si es true, la propiedad relatedObject se establece como null por motivos relacionados con entornos limitados de seguridad. Si el valor nominal de relatedObject es una referencia a un objeto DisplayObject en otro entorno limitado, relatedObject se establece como null a no ser que disponga de permiso en ambas direcciones dentro de los límites del entorno limitado. Puede establecer los permisos llamando a Security.allowDomain() desde un archivo SWF, o bien proporcionando un archivo de política desde el servidor de un archivo de imagen y estableciendo la propiedad LoaderContext.checkPolicyFile al cargar la imagen.
Implementación
public function get isRelatedObjectInaccessible():Boolean public function set isRelatedObjectInaccessible(value:Boolean):voidElementos de API relacionados
isTouchPointCanceled | propiedad |
isTouchPointCanceled:Boolean| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 3 |
Informa de que esta secuencia de entrada táctil fue cancelada por el sistema operativo.
Los eventos táctiles se pueden cancelar por diversas razones, por ejemplo, cuando una acción táctil generada con la palma de la mano se rechaza porque se está usando ya un lápiz stylus. isTouchPointCanceled sólo puede ser true en un evento touchEnd.
Implementación
public function get isTouchPointCanceled():Boolean public function set isTouchPointCanceled(value:Boolean):voidlocalX | propiedad |
localX:Number| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10.1, AIR 2, Flash Lite 4 |
La coordenada horizontal en la que se produce el evento en relación con la clase Sprite contenida.
Implementación
public function get localX():Number public function set localX(value:Number):voidlocalY | propiedad |
localY:Number| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10.1, AIR 2, Flash Lite 4 |
La coordenada vertical en la que se produce el evento en relación con la clase Sprite contenida.
Implementación
public function get localY():Number public function set localY(value:Number):voidpressure | propiedad |
pressure:Number| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Un valor entre 0.0 y 1.0 que indica fuerza de contacto con el dispositivo. Si el dispositivo no admite la detección de presión, el valor es 1.0.
Implementación
public function get pressure():Number public function set pressure(value:Number):voidrelatedObject | propiedad |
relatedObject:InteractiveObject| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Referencia a un objeto de la lista de visualización relacionado con el evento. Por ejemplo, si se produce un evento touchOut, relatedObject representa el objeto de la lista de visualización al que ahora apunta el dispositivo de señalización. Esta propiedad se aplica a los eventos touchOut, touchOver, touchRollOut y touchRollOver.
El valor de esta propiedad puede ser null en dos casos: si no hay ningún objeto relacionado, o si lo hay, pero se encuentra en un entorno limitado de seguridad al que no tiene acceso. Utilice la propiedad isRelatedObjectInaccessible() para determinar cuál de estas razones es la pertinente.
Implementación
public function get relatedObject():InteractiveObject public function set relatedObject(value:InteractiveObject):voidElementos de API relacionados
shiftKey | propiedad |
sizeX | propiedad |
sizeY | propiedad |
stageX | propiedad |
stageX:Number [solo lectura] | Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10.1, AIR 2, Flash Lite 4 |
La coordenada horizontal en la que se produce el evento en las coordenadas globales del escenario. Esta propiedad se calcula al establecer localX.
Implementación
public function get stageX():NumberstageY | propiedad |
stageY:Number [solo lectura] | Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10.1, AIR 2, Flash Lite 4 |
La coordenada vertical en la que se produce el evento en las coordenadas globales del escenario. Esta propiedad se calcula al establecer localY.
Implementación
public function get stageY():Number timestamp | propiedad |
timestamp:Number| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 3 |
Informa sobre la hora del evento en milisegundos.
Las horas notificadas son relativas a la hora en que se inició la ejecución de la aplicación. Para los eventos que devuelven una secuencia de puntos en el búfer de muestras, esta marca de hora refleja el tiempo transcurrido de la última muestra en el búfer.
Implementación
public function get timestamp():Number public function set timestamp(value:Number):voidElementos de API relacionados
touchIntent | propiedad |
touchIntent:String| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 3 |
Informa si el toque fue generado por el extremo principal o por el borrador de un lápiz stylus.
Si un evento táctil es generado por un dedo o por otro método de entrada que no sea un lápiz stylus, o un lápiz stylus no compatible con seguimiento de movimiento de alta frecuencia, esta propiedad informa sobre el valor: TouchEventIntent.UNKNOWN.
La clase TouchEventIntent define constantes para los valores posibles de esta propiedad, que incluyen:
- TouchEventIntent.ERASER
- TouchEventIntent.PEN
- TouchEventIntent.UNKNOWN
Implementación
public function get touchIntent():String public function set touchIntent(value:String):voidElementos de API relacionados
touchPointID | propiedad |
touchPointID:int| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Un número de identificación exclusivo (como un int) asignado al punto táctil.
Implementación
public function get touchPointID():int public function set touchPointID(value:int):voidEjemplo ( Cómo utilizar este ejemplo )
El siguiente ejemplo establece una variable
touchMoveID para probar el valor correcto de touchPointID antes de responder a un evento de movimiento táctil. En caso contrario, otra entrada táctil activará el controlador de eventos también. Tenga en cuenta que los detectores de las fases de movimiento y final se encuentran en el escenario, no en el objeto de visualización. El escenario detecta fases de movimiento o final en caso de que la acción táctil del usuario vaya más allá de los límites del objeto de visualización.
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;
}
Información sobre constructores
TouchEvent | () | Información sobre |
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)| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Crea un objeto de evento que contiene información sobre eventos táctiles. Los objetos de evento se transfieren como parámetros a los detectores de eventos.
Parámetrostype:String — El tipo de evento. Los valores posibles son: 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 y TouchEvent.TOUCH_TAP.
| |
bubbles:Boolean (default = true) | |
cancelable:Boolean (default = false) | |
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 y 1.0 que indica fuerza de contacto con el dispositivo. Si el dispositivo no admite la detección de presión, el valor es 1.0.
| |
relatedObject:InteractiveObject (default = null)touchOut, relatedObject representa el objeto de la lista de visualización al que ahora apunta el dispositivo de señalización.
| |
ctrlKey:Boolean (default = false) | |
altKey:Boolean (default = false) | |
shiftKey:Boolean (default = false) | |
commandKey:Boolean (default = false) | |
controlKey:Boolean (default = false) | |
timestamp:Number (default = NaN) | |
touchIntent:String (default = NaN) | |
samples:ByteArray (default = null) | |
isTouchPointCanceled:Boolean (default = false)true si el evento táctil se cancela debido al rechazo de un tipo de acción táctil.
|
Información sobre métodos
clone | () | método |
override public function clone():Event| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Crea una copia del objeto TouchEvent y define el valor de cada propiedad para que coincida con el del objeto original.
Valor devueltoEvent — Un nuevo objeto TouchEvent con valores de propiedades que coinciden con los del objeto original.
|
getSamples | () | método |
public function getSamples(buffer:ByteArray, append:Boolean = false):uint| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 3 |
Actualiza el objeto ByteArray especificado con puntos de datos de alta frecuencia para un evento táctil multipunto.
El objeto ByteArray al que hace referencia el parámetro buffer se actualiza con valores para los puntos de datos intermedios entre este y el anterior evento táctil. Se añaden tres valores de coma flotante para cada muestra: una coordenada x, una coordenada y, y un valor de presión. Los valores de posición notificados en las coordenadas del escenario. La presión se notifica como un valor entre 0 y 1. Las muestras se registran a intervalos de tiempo regulares. La frecuencia exacta depende del hardware del dispositivo y de los controladores de hardware. Las frecuencias de muestra habituales están en torno a 133 Hz. Tenga en cuenta que los eventos táctiles se no se distribuyen en intervalos precisos. Por consiguiente, el búfer para eventos similares puede contener un número diferente de muestras. La última muestra en el búfer tiene los mismo datos que las propiedades stageX, stageY, y pressure de este objeto de evento táctil.
Se incluye un búfer de muestra en los objetos de evento distribuidos para los eventos proximityMove y touchMove.
Parámetros
buffer:ByteArray — el objeto ByteArray que va a recibir las muestras de los datos.
| |
append:Boolean (default = false)true, las muestras se añaden al conjunto de bytes buffer comenzando en la propiedad position actual del conjunto. Si es false, de forma predeterminada, los datos existentes en el objeto búfer se descartan antes agregar las muestras.
|
uint — uint número de muestras añadido al búfer. Cada muestra consta de tres números de coma flotante.
|
Elementos de API relacionados
Ejemplo ( Cómo utilizar este ejemplo )
El ejemplo siguiente ilustra cómo recuperar los datos de ejemplo de un evento touchMove o proximitymove:
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
}
}
}
El ejemplo siguiente ilustra cómo recuperar los datos de ejemplo de un evento touchMove o proximitymove. En este ejemplo, las muestras se agregan a un conjunto de bytes existente:
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 | () | método |
public function isToolButtonDown(index:int):Boolean| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 3 |
Indica que el botón de hardware en el índice especificado está presionado.
Parámetros
index:int — el índice basado en cero de los botones admitidos por un lápiz stylus o dispositivo de entrada similar.
|
Boolean |
toString | () | método |
override public function toString():String| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Devuelve una cadena con todas las propiedades del objeto TouchEvent. La cadena tiene el siguiente formato:
[TouchEvent type=value bubbles=valor cancelable=valor ... ]
String — Una cadena que contiene todas las propiedades del objeto TouchEvent.
|
updateAfterEvent | () | método |
public function updateAfterEvent():void| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Si se ha modificado la lista de visualización, da instrucciones a Flash Player o a Adobe AIR para que muestre la representación tras finalizar el procesamiento del evento.
Información sobre constantes
PROXIMITY_BEGIN | Constante |
public static const PROXIMITY_BEGIN:String = "proximityBegin"| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 3 |
Define el valor de la propiedad type de un objeto de evento táctil PROXIMITY_BEGIN.
El objeto del evento TouchEvent tiene las siguientes propiedades:
| Propiedad | Valor |
|---|---|
altKey | true si la tecla Alt está activa (Windows o Linux). |
bubbles | true |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
commandKey | true en Mac, si la tecla Comando está activa; false si está inactiva. Siempre es false en Windows. |
controlKey | true si la tecla Control o Ctrl está activa; false si está inactiva. |
ctrlKey | true en Windows o Linux, si la tecla Ctrl está activa. true en Mac, si la tecla Ctrl o Comando está activa. En caso contrario, false. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
eventPhase | La fase actual en el flujo del evento. |
isRelatedObjectInaccessible | true si la propiedad relatedObject se establece en null por motivos de reglas del entorno limitado de seguridad. |
localX | La coordenada horizontal en la que se produce el evento en relación con la clase Sprite contenida. |
localY | La coordenada vertical en la que se produce el evento en relación con la clase Sprite contenida. |
pressure | Un valor entre 0.0 y 1.0 que indica fuerza de contacto con el dispositivo. Si el dispositivo no admite la detección de presión, el valor es 1.0. |
relatedObject | Referencia a un objeto de la lista de visualización relacionado con el evento. |
shiftKey | true si la tecla Mayús está activa; false si está inactiva. |
sizeX | Anchura de la zona de contacto. |
sizeY | Altura de la zona de contacto. |
stageX | La coordenada horizontal en la que se produce el evento en las coordenadas globales del escenario. |
stageY | La coordenada vertical en la que se produce el evento en las coordenadas globales del escenario. |
target | La instancia de InteractiveObject en el dispositivo táctil. El objeto target no siempre es el objeto de la lista de visualización que registró el detector de eventos. Utilice la propiedad currentTarget para acceder al objeto de la lista de visualización que está procesando el evento actualmente. |
touchPointID | Un número de identificación exclusivo (como un int) asignado al punto táctil. |
timestamp | (Sólo AIR) La marca de hora del evento en milisegundos con relación al inicio de la aplicación. |
touchIntent | (Sólo AIR) Un valor de la clase TouchEventIntent. |
isTouchPointCanceled | (Sólo AIR) true si el evento táctil se cancela debido a la lógica de rechazo de acciones táctiles del dispositivo. |
Elementos de API relacionados
PROXIMITY_END | Constante |
public static const PROXIMITY_END:String = "proximityEnd"| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 3 |
Define el valor de la propiedad type de un objeto de evento táctil PROXIMITY_END.
El objeto del evento TouchEvent tiene las siguientes propiedades:
| Propiedad | Valor |
|---|---|
altKey | true si la tecla Alt está activa (Windows o Linux). |
bubbles | true |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
commandKey | true en Mac, si la tecla Comando está activa; false si está inactiva. Siempre es false en Windows. |
controlKey | true si la tecla Control o Ctrl está activa; false si está inactiva. |
ctrlKey | true en Windows o Linux, si la tecla Ctrl está activa. true en Mac, si la tecla Ctrl o Comando está activa. En caso contrario, false. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
eventPhase | La fase actual en el flujo del evento. |
isRelatedObjectInaccessible | true si la propiedad relatedObject se establece en null por motivos de reglas del entorno limitado de seguridad. |
localX | La coordenada horizontal en la que se produce el evento en relación con la clase Sprite contenida. |
localY | La coordenada vertical en la que se produce el evento en relación con la clase Sprite contenida. |
pressure | Un valor entre 0.0 y 1.0 que indica fuerza de contacto con el dispositivo. Si el dispositivo no admite la detección de presión, el valor es 1.0. |
relatedObject | Referencia a un objeto de la lista de visualización relacionado con el evento. |
shiftKey | true si la tecla Mayús está activa; false si está inactiva. |
sizeX | Anchura de la zona de contacto. |
sizeY | Altura de la zona de contacto. |
stageX | La coordenada horizontal en la que se produce el evento en las coordenadas globales del escenario. |
stageY | La coordenada vertical en la que se produce el evento en las coordenadas globales del escenario. |
target | La instancia de InteractiveObject en el dispositivo táctil. El objeto target no siempre es el objeto de la lista de visualización que registró el detector de eventos. Utilice la propiedad currentTarget para acceder al objeto de la lista de visualización que está procesando el evento actualmente. |
touchPointID | Un número de identificación exclusivo (como un int) asignado al punto táctil. |
timestamp | (Sólo AIR) La marca de hora del evento en milisegundos con relación al inicio de la aplicación. |
touchIntent | (Sólo AIR) Un valor de la clase TouchEventIntent. |
isTouchPointCanceled | (Sólo AIR) true si el evento táctil se cancela debido a la lógica de rechazo de acciones táctiles del dispositivo. |
Elementos de API relacionados
PROXIMITY_MOVE | Constante |
public static const PROXIMITY_MOVE:String = "proximityMove"| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 3 |
Define el valor de la propiedad type de un objeto de evento táctil PROXIMITY_MOVE.
El objeto del evento TouchEvent tiene las siguientes propiedades:
| Propiedad | Valor |
|---|---|
altKey | true si la tecla Alt está activa (Windows o Linux). |
bubbles | true |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
commandKey | true en Mac, si la tecla Comando está activa; false si está inactiva. Siempre es false en Windows. |
controlKey | true si la tecla Control o Ctrl está activa; false si está inactiva. |
ctrlKey | true en Windows o Linux, si la tecla Ctrl está activa. true en Mac, si la tecla Ctrl o Comando está activa. En caso contrario, false. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
eventPhase | La fase actual en el flujo del evento. |
isRelatedObjectInaccessible | true si la propiedad relatedObject se establece en null por motivos de reglas del entorno limitado de seguridad. |
localX | La coordenada horizontal en la que se produce el evento en relación con la clase Sprite contenida. |
localY | La coordenada vertical en la que se produce el evento en relación con la clase Sprite contenida. |
pressure | Un valor entre 0.0 y 1.0 que indica fuerza de contacto con el dispositivo. Si el dispositivo no admite la detección de presión, el valor es 1.0. |
relatedObject | Referencia a un objeto de la lista de visualización relacionado con el evento. |
shiftKey | true si la tecla Mayús está activa; false si está inactiva. |
sizeX | Anchura de la zona de contacto. |
sizeY | Altura de la zona de contacto. |
stageX | La coordenada horizontal en la que se produce el evento en las coordenadas globales del escenario. |
stageY | La coordenada vertical en la que se produce el evento en las coordenadas globales del escenario. |
target | La instancia de InteractiveObject en el dispositivo táctil. El objeto target no siempre es el objeto de la lista de visualización que registró el detector de eventos. Utilice la propiedad currentTarget para acceder al objeto de la lista de visualización que está procesando el evento actualmente. |
touchPointID | Un número de identificación exclusivo (como un int) asignado al punto táctil. |
timestamp | (Sólo AIR) La marca de hora del evento en milisegundos con relación al inicio de la aplicación. |
touchIntent | (Sólo AIR) Un valor de la clase TouchEventIntent. |
isTouchPointCanceled | (Sólo AIR) true si el evento táctil se cancela debido a la lógica de rechazo de acciones táctiles del dispositivo. |
Elementos de API relacionados
PROXIMITY_OUT | Constante |
public static const PROXIMITY_OUT:String = "proximityOut"| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 3 |
Define el valor de la propiedad type de un objeto de evento táctil PROXIMITY_OUT.
El objeto del evento TouchEvent tiene las siguientes propiedades:
| Propiedad | Valor |
|---|---|
altKey | true si la tecla Alt está activa (Windows o Linux). |
bubbles | true |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
commandKey | true en Mac, si la tecla Comando está activa; false si está inactiva. Siempre es false en Windows. |
controlKey | true si la tecla Control o Ctrl está activa; false si está inactiva. |
ctrlKey | true en Windows o Linux, si la tecla Ctrl está activa. true en Mac, si la tecla Ctrl o Comando está activa. En caso contrario, false. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
eventPhase | La fase actual en el flujo del evento. |
isRelatedObjectInaccessible | true si la propiedad relatedObject se establece en null por motivos de reglas del entorno limitado de seguridad. |
localX | La coordenada horizontal en la que se produce el evento en relación con la clase Sprite contenida. |
localY | La coordenada vertical en la que se produce el evento en relación con la clase Sprite contenida. |
pressure | Un valor entre 0.0 y 1.0 que indica fuerza de contacto con el dispositivo. Si el dispositivo no admite la detección de presión, el valor es 1.0. |
relatedObject | Referencia a un objeto de la lista de visualización relacionado con el evento. |
shiftKey | true si la tecla Mayús está activa; false si está inactiva. |
sizeX | Anchura de la zona de contacto. |
sizeY | Altura de la zona de contacto. |
stageX | La coordenada horizontal en la que se produce el evento en las coordenadas globales del escenario. |
stageY | La coordenada vertical en la que se produce el evento en las coordenadas globales del escenario. |
target | La instancia de InteractiveObject en el dispositivo táctil. El objeto target no siempre es el objeto de la lista de visualización que registró el detector de eventos. Utilice la propiedad currentTarget para acceder al objeto de la lista de visualización que está procesando el evento actualmente. |
touchPointID | Un número de identificación exclusivo (como un int) asignado al punto táctil. |
timestamp | (Sólo AIR) La marca de hora del evento en milisegundos con relación al inicio de la aplicación. |
touchIntent | (Sólo AIR) Un valor de la clase TouchEventIntent. |
isTouchPointCanceled | (Sólo AIR) true si el evento táctil se cancela debido a la lógica de rechazo de acciones táctiles del dispositivo. |
Elementos de API relacionados
PROXIMITY_OVER | Constante |
public static const PROXIMITY_OVER:String = "proximityOver"| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 3 |
Define el valor de la propiedad type de un objeto de evento táctil PROXIMITY_OVER.
El objeto del evento TouchEvent tiene las siguientes propiedades:
| Propiedad | Valor |
|---|---|
altKey | true si la tecla Alt está activa (Windows o Linux). |
bubbles | true |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
commandKey | true en Mac, si la tecla Comando está activa; false si está inactiva. Siempre es false en Windows. |
controlKey | true si la tecla Control o Ctrl está activa; false si está inactiva. |
ctrlKey | true en Windows o Linux, si la tecla Ctrl está activa. true en Mac, si la tecla Ctrl o Comando está activa. En caso contrario, false. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
eventPhase | La fase actual en el flujo del evento. |
isRelatedObjectInaccessible | true si la propiedad relatedObject se establece en null por motivos de reglas del entorno limitado de seguridad. |
localX | La coordenada horizontal en la que se produce el evento en relación con la clase Sprite contenida. |
localY | La coordenada vertical en la que se produce el evento en relación con la clase Sprite contenida. |
pressure | Un valor entre 0.0 y 1.0 que indica fuerza de contacto con el dispositivo. Si el dispositivo no admite la detección de presión, el valor es 1.0. |
relatedObject | Referencia a un objeto de la lista de visualización relacionado con el evento. |
shiftKey | true si la tecla Mayús está activa; false si está inactiva. |
sizeX | Anchura de la zona de contacto. |
sizeY | Altura de la zona de contacto. |
stageX | La coordenada horizontal en la que se produce el evento en las coordenadas globales del escenario. |
stageY | La coordenada vertical en la que se produce el evento en las coordenadas globales del escenario. |
target | La instancia de InteractiveObject en el dispositivo táctil. El objeto target no siempre es el objeto de la lista de visualización que registró el detector de eventos. Utilice la propiedad currentTarget para acceder al objeto de la lista de visualización que está procesando el evento actualmente. |
touchPointID | Un número de identificación exclusivo (como un int) asignado al punto táctil. |
timestamp | (Sólo AIR) La marca de hora del evento en milisegundos con relación al inicio de la aplicación. |
touchIntent | (Sólo AIR) Un valor de la clase TouchEventIntent. |
isTouchPointCanceled | (Sólo AIR) true si el evento táctil se cancela debido a la lógica de rechazo de acciones táctiles del dispositivo. |
Elementos de API relacionados
PROXIMITY_ROLL_OUT | Constante |
public static const PROXIMITY_ROLL_OUT:String = "proximityRollOut"| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 3 |
Define el valor de la propiedad type para un objeto de evento táctil PROXIMITY_ROLL_OUT.
El objeto del evento TouchEvent tiene las siguientes propiedades:
| Propiedad | Valor |
|---|---|
altKey | true si la tecla Alt está activa (Windows o Linux). |
bubbles | true |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
commandKey | true en Mac, si la tecla Comando está activa; false si está inactiva. Siempre es false en Windows. |
controlKey | true si la tecla Control o Ctrl está activa; false si está inactiva. |
ctrlKey | true en Windows o Linux, si la tecla Ctrl está activa. true en Mac, si la tecla Ctrl o Comando está activa. En caso contrario, false. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
eventPhase | La fase actual en el flujo del evento. |
isRelatedObjectInaccessible | true si la propiedad relatedObject se establece en null por motivos de reglas del entorno limitado de seguridad. |
localX | La coordenada horizontal en la que se produce el evento en relación con la clase Sprite contenida. |
localY | La coordenada vertical en la que se produce el evento en relación con la clase Sprite contenida. |
pressure | Un valor entre 0.0 y 1.0 que indica fuerza de contacto con el dispositivo. Si el dispositivo no admite la detección de presión, el valor es 1.0. |
relatedObject | Referencia a un objeto de la lista de visualización relacionado con el evento. |
shiftKey | true si la tecla Mayús está activa; false si está inactiva. |
sizeX | Anchura de la zona de contacto. |
sizeY | Altura de la zona de contacto. |
stageX | La coordenada horizontal en la que se produce el evento en las coordenadas globales del escenario. |
stageY | La coordenada vertical en la que se produce el evento en las coordenadas globales del escenario. |
target | La instancia de InteractiveObject en el dispositivo táctil. El objeto target no siempre es el objeto de la lista de visualización que registró el detector de eventos. Utilice la propiedad currentTarget para acceder al objeto de la lista de visualización que está procesando el evento actualmente. |
touchPointID | Un número de identificación exclusivo (como un int) asignado al punto táctil. |
timestamp | (Sólo AIR) La marca de hora del evento en milisegundos con relación al inicio de la aplicación. |
touchIntent | (Sólo AIR) Un valor de la clase TouchEventIntent. |
isTouchPointCanceled | (Sólo AIR) true si el evento táctil se cancela debido a la lógica de rechazo de acciones táctiles del dispositivo. |
Elementos de API relacionados
PROXIMITY_ROLL_OVER | Constante |
public static const PROXIMITY_ROLL_OVER:String = "proximityRollOver"| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 3 |
Define el valor de la propiedad type para un objeto de evento táctil PROXIMITY_ROLL_OVER.
El objeto del evento TouchEvent tiene las siguientes propiedades:
| Propiedad | Valor |
|---|---|
altKey | true si la tecla Alt está activa (Windows o Linux). |
bubbles | true |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
commandKey | true en Mac, si la tecla Comando está activa; false si está inactiva. Siempre es false en Windows. |
controlKey | true si la tecla Control o Ctrl está activa; false si está inactiva. |
ctrlKey | true en Windows o Linux, si la tecla Ctrl está activa. true en Mac, si la tecla Ctrl o Comando está activa. En caso contrario, false. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
eventPhase | La fase actual en el flujo del evento. |
isRelatedObjectInaccessible | true si la propiedad relatedObject se establece en null por motivos de reglas del entorno limitado de seguridad. |
localX | La coordenada horizontal en la que se produce el evento en relación con la clase Sprite contenida. |
localY | La coordenada vertical en la que se produce el evento en relación con la clase Sprite contenida. |
pressure | Un valor entre 0.0 y 1.0 que indica fuerza de contacto con el dispositivo. Si el dispositivo no admite la detección de presión, el valor es 1.0. |
relatedObject | Referencia a un objeto de la lista de visualización relacionado con el evento. |
shiftKey | true si la tecla Mayús está activa; false si está inactiva. |
sizeX | Anchura de la zona de contacto. |
sizeY | Altura de la zona de contacto. |
stageX | La coordenada horizontal en la que se produce el evento en las coordenadas globales del escenario. |
stageY | La coordenada vertical en la que se produce el evento en las coordenadas globales del escenario. |
target | La instancia de InteractiveObject en el dispositivo táctil. El objeto target no siempre es el objeto de la lista de visualización que registró el detector de eventos. Utilice la propiedad currentTarget para acceder al objeto de la lista de visualización que está procesando el evento actualmente. |
touchPointID | Un número de identificación exclusivo (como un int) asignado al punto táctil. |
timestamp | (Sólo AIR) La marca de hora del evento en milisegundos con relación al inicio de la aplicación. |
touchIntent | (Sólo AIR) Un valor de la clase TouchEventIntent. |
isTouchPointCanceled | (Sólo AIR) true si el evento táctil se cancela debido a la lógica de rechazo de acciones táctiles del dispositivo. |
Elementos de API relacionados
TOUCH_BEGIN | Constante |
public static const TOUCH_BEGIN:String = "touchBegin"| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Define el valor de la propiedad type de un objeto de evento táctil TOUCH_BEGIN.
El objeto del evento TouchEvent tiene las siguientes propiedades:
| Propiedad | Valor |
|---|---|
altKey | true si la tecla Alt está activa (Windows o Linux). |
bubbles | true |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
commandKey | true en Mac, si la tecla Comando está activa; false si está inactiva. Siempre es false en Windows. |
controlKey | true si la tecla Control o Ctrl está activa; false si está inactiva. |
ctrlKey | true en Windows o Linux, si la tecla Ctrl está activa. true en Mac, si la tecla Ctrl o Comando está activa. En caso contrario, false. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
eventPhase | La fase actual en el flujo del evento. |
isRelatedObjectInaccessible | true si la propiedad relatedObject se establece en null por motivos de reglas del entorno limitado de seguridad. |
localX | La coordenada horizontal en la que se produce el evento en relación con la clase Sprite contenida. |
localY | La coordenada vertical en la que se produce el evento en relación con la clase Sprite contenida. |
pressure | Un valor entre 0.0 y 1.0 que indica fuerza de contacto con el dispositivo. Si el dispositivo no admite la detección de presión, el valor es 1.0. |
relatedObject | Referencia a un objeto de la lista de visualización relacionado con el evento. |
shiftKey | true si la tecla Mayús está activa; false si está inactiva. |
sizeX | Anchura de la zona de contacto. |
sizeY | Altura de la zona de contacto. |
stageX | La coordenada horizontal en la que se produce el evento en las coordenadas globales del escenario. |
stageY | La coordenada vertical en la que se produce el evento en las coordenadas globales del escenario. |
target | La instancia de InteractiveObject en el dispositivo táctil. El objeto target no siempre es el objeto de la lista de visualización que registró el detector de eventos. Utilice la propiedad currentTarget para acceder al objeto de la lista de visualización que está procesando el evento actualmente. |
touchPointID | Un número de identificación exclusivo (como un int) asignado al punto táctil. |
Elementos de API relacionados
TOUCH_END | Constante |
public static const TOUCH_END:String = "touchEnd"| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Define el valor de la propiedad type de un objeto de evento táctil TOUCH_END.
El objeto del evento TouchEvent tiene las siguientes propiedades:
| Propiedad | Valor |
|---|---|
altKey | true si la tecla Alt está activa (Windows o Linux). |
bubbles | true |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
commandKey | true en Mac, si la tecla Comando está activa; false si está inactiva. Siempre es false en Windows. |
controlKey | true si la tecla Control o Ctrl está activa; false si está inactiva. |
ctrlKey | true en Windows o Linux, si la tecla Ctrl está activa. true en Mac, si la tecla Ctrl o Comando está activa. En caso contrario, false. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
eventPhase | La fase actual en el flujo del evento. |
isRelatedObjectInaccessible | true si la propiedad relatedObject se establece en null por motivos de reglas del entorno limitado de seguridad. |
localX | La coordenada horizontal en la que se produce el evento en relación con la clase Sprite contenida. |
localY | La coordenada vertical en la que se produce el evento en relación con la clase Sprite contenida. |
pressure | Un valor entre 0.0 y 1.0 que indica fuerza de contacto con el dispositivo. Si el dispositivo no admite la detección de presión, el valor es 1.0. |
relatedObject | Referencia a un objeto de la lista de visualización relacionado con el evento. |
shiftKey | true si la tecla Mayús está activa; false si está inactiva. |
sizeX | Anchura de la zona de contacto. |
sizeY | Altura de la zona de contacto. |
stageX | La coordenada horizontal en la que se produce el evento en las coordenadas globales del escenario. |
stageY | La coordenada vertical en la que se produce el evento en las coordenadas globales del escenario. |
target | La instancia de InteractiveObject en el dispositivo táctil. El objeto target no siempre es el objeto de la lista de visualización que registró el detector de eventos. Utilice la propiedad currentTarget para acceder al objeto de la lista de visualización que está procesando el evento actualmente. |
touchPointID | Un número de identificación exclusivo (como un int) asignado al punto táctil. |
Elementos de API relacionados
TOUCH_MOVE | Constante |
public static const TOUCH_MOVE:String = "touchMove"| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Define el valor de la propiedad type de un objeto de evento táctil TOUCH_MOVE.
El objeto del evento TouchEvent tiene las siguientes propiedades:
| Propiedad | Valor |
|---|---|
altKey | true si la tecla Alt está activa (Windows o Linux). |
bubbles | true |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
commandKey | true en Mac, si la tecla Comando está activa; false si está inactiva. Siempre es false en Windows. |
controlKey | true si la tecla Control o Ctrl está activa; false si está inactiva. |
ctrlKey | true en Windows o Linux, si la tecla Ctrl está activa. true en Mac, si la tecla Ctrl o Comando está activa. En caso contrario, false. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
eventPhase | La fase actual en el flujo del evento. |
isRelatedObjectInaccessible | true si la propiedad relatedObject se establece en null por motivos de reglas del entorno limitado de seguridad. |
localX | La coordenada horizontal en la que se produce el evento en relación con la clase Sprite contenida. |
localY | La coordenada vertical en la que se produce el evento en relación con la clase Sprite contenida. |
pressure | Un valor entre 0.0 y 1.0 que indica fuerza de contacto con el dispositivo. Si el dispositivo no admite la detección de presión, el valor es 1.0. |
relatedObject | Referencia a un objeto de la lista de visualización relacionado con el evento. |
shiftKey | true si la tecla Mayús está activa; false si está inactiva. |
sizeX | Anchura de la zona de contacto. |
sizeY | Altura de la zona de contacto. |
stageX | La coordenada horizontal en la que se produce el evento en las coordenadas globales del escenario. |
stageY | La coordenada vertical en la que se produce el evento en las coordenadas globales del escenario. |
target | La instancia de InteractiveObject en el dispositivo táctil. El objeto target no siempre es el objeto de la lista de visualización que registró el detector de eventos. Utilice la propiedad currentTarget para acceder al objeto de la lista de visualización que está procesando el evento actualmente. |
touchPointID | Un número de identificación exclusivo (como un int) asignado al punto táctil. |
Elementos de API relacionados
TOUCH_OUT | Constante |
public static const TOUCH_OUT:String = "touchOut"| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Define el valor de la propiedad type de un objeto de evento táctil TOUCH_OUT.
El objeto del evento TouchEvent tiene las siguientes propiedades:
| Propiedad | Valor |
|---|---|
altKey | true si la tecla Alt está activa (Windows o Linux). |
bubbles | true |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
commandKey | true en Mac, si la tecla Comando está activa; false si está inactiva. Siempre es false en Windows. |
controlKey | true si la tecla Control o Ctrl está activa; false si está inactiva. |
ctrlKey | true en Windows o Linux, si la tecla Ctrl está activa. true en Mac, si la tecla Ctrl o Comando está activa. En caso contrario, false. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
eventPhase | La fase actual en el flujo del evento. |
isRelatedObjectInaccessible | true si la propiedad relatedObject se establece en null por motivos de reglas del entorno limitado de seguridad. |
localX | La coordenada horizontal en la que se produce el evento en relación con la clase Sprite contenida. |
localY | La coordenada vertical en la que se produce el evento en relación con la clase Sprite contenida. |
pressure | Un valor entre 0.0 y 1.0 que indica fuerza de contacto con el dispositivo. Si el dispositivo no admite la detección de presión, el valor es 1.0. |
relatedObject | Referencia a un objeto de la lista de visualización relacionado con el evento. |
shiftKey | true si la tecla Mayús está activa; false si está inactiva. |
sizeX | Anchura de la zona de contacto. |
sizeY | Altura de la zona de contacto. |
stageX | La coordenada horizontal en la que se produce el evento en las coordenadas globales del escenario. |
stageY | La coordenada vertical en la que se produce el evento en las coordenadas globales del escenario. |
target | La instancia de InteractiveObject en el dispositivo táctil. El objeto target no siempre es el objeto de la lista de visualización que registró el detector de eventos. Utilice la propiedad currentTarget para acceder al objeto de la lista de visualización que está procesando el evento actualmente. |
touchPointID | Un número de identificación exclusivo (como un int) asignado al punto táctil. |
Elementos de API relacionados
TOUCH_OVER | Constante |
public static const TOUCH_OVER:String = "touchOver"| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Define el valor de la propiedad type de un objeto de evento táctil TOUCH_OVER.
El objeto del evento TouchEvent tiene las siguientes propiedades:
| Propiedad | Valor |
|---|---|
altKey | true si la tecla Alt está activa (Windows o Linux). |
bubbles | true |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
commandKey | true en Mac, si la tecla Comando está activa; false si está inactiva. Siempre es false en Windows. |
controlKey | true si la tecla Control o Ctrl está activa; false si está inactiva. |
ctrlKey | true en Windows o Linux, si la tecla Ctrl está activa. true en Mac, si la tecla Ctrl o Comando está activa. En caso contrario, false. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
eventPhase | La fase actual en el flujo del evento. |
isRelatedObjectInaccessible | true si la propiedad relatedObject se establece en null por motivos de reglas del entorno limitado de seguridad. |
localX | La coordenada horizontal en la que se produce el evento en relación con la clase Sprite contenida. |
localY | La coordenada vertical en la que se produce el evento en relación con la clase Sprite contenida. |
pressure | Un valor entre 0.0 y 1.0 que indica fuerza de contacto con el dispositivo. Si el dispositivo no admite la detección de presión, el valor es 1.0. |
relatedObject | Referencia a un objeto de la lista de visualización relacionado con el evento. |
shiftKey | true si la tecla Mayús está activa; false si está inactiva. |
sizeX | Anchura de la zona de contacto. |
sizeY | Altura de la zona de contacto. |
stageX | La coordenada horizontal en la que se produce el evento en las coordenadas globales del escenario. |
stageY | La coordenada vertical en la que se produce el evento en las coordenadas globales del escenario. |
target | La instancia de InteractiveObject en el dispositivo táctil. El objeto target no siempre es el objeto de la lista de visualización que registró el detector de eventos. Utilice la propiedad currentTarget para acceder al objeto de la lista de visualización que está procesando el evento actualmente. |
touchPointID | Un número de identificación exclusivo (como un int) asignado al punto táctil. |
Elementos de API relacionados
TOUCH_ROLL_OUT | Constante |
public static const TOUCH_ROLL_OUT:String = "touchRollOut"| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Define el valor de la propiedad type para un objeto de evento táctil TOUCH_ROLL_OUT.
El objeto del evento TouchEvent tiene las siguientes propiedades:
| Propiedad | Valor |
|---|---|
altKey | true si la tecla Alt está activa (Windows o Linux). |
bubbles | true |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
commandKey | true en Mac, si la tecla Comando está activa; false si está inactiva. Siempre es false en Windows. |
controlKey | true si la tecla Control o Ctrl está activa; false si está inactiva. |
ctrlKey | true en Windows o Linux, si la tecla Ctrl está activa. true en Mac, si la tecla Ctrl o Comando está activa. En caso contrario, false. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
eventPhase | La fase actual en el flujo del evento. |
isRelatedObjectInaccessible | true si la propiedad relatedObject se establece en null por motivos de reglas del entorno limitado de seguridad. |
localX | La coordenada horizontal en la que se produce el evento en relación con la clase Sprite contenida. |
localY | La coordenada vertical en la que se produce el evento en relación con la clase Sprite contenida. |
pressure | Un valor entre 0.0 y 1.0 que indica fuerza de contacto con el dispositivo. Si el dispositivo no admite la detección de presión, el valor es 1.0. |
relatedObject | Referencia a un objeto de la lista de visualización relacionado con el evento. |
shiftKey | true si la tecla Mayús está activa; false si está inactiva. |
sizeX | Anchura de la zona de contacto. |
sizeY | Altura de la zona de contacto. |
stageX | La coordenada horizontal en la que se produce el evento en las coordenadas globales del escenario. |
stageY | La coordenada vertical en la que se produce el evento en las coordenadas globales del escenario. |
target | La instancia de InteractiveObject en el dispositivo táctil. El objeto target no siempre es el objeto de la lista de visualización que registró el detector de eventos. Utilice la propiedad currentTarget para acceder al objeto de la lista de visualización que está procesando el evento actualmente. |
touchPointID | Un número de identificación exclusivo (como un int) asignado al punto táctil. |
Elementos de API relacionados
TOUCH_ROLL_OVER | Constante |
public static const TOUCH_ROLL_OVER:String = "touchRollOver"| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Define el valor de la propiedad type para un objeto de evento táctil TOUCH_ROLL_OVER.
El objeto del evento TouchEvent tiene las siguientes propiedades:
| Propiedad | Valor |
|---|---|
altKey | true si la tecla Alt está activa (Windows o Linux). |
bubbles | true |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
commandKey | true en Mac, si la tecla Comando está activa; false si está inactiva. Siempre es false en Windows. |
controlKey | true si la tecla Control o Ctrl está activa; false si está inactiva. |
ctrlKey | true en Windows o Linux, si la tecla Ctrl está activa. true en Mac, si la tecla Ctrl o Comando está activa. En caso contrario, false. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
eventPhase | La fase actual en el flujo del evento. |
isRelatedObjectInaccessible | true si la propiedad relatedObject se establece en null por motivos de reglas del entorno limitado de seguridad. |
localX | La coordenada horizontal en la que se produce el evento en relación con la clase Sprite contenida. |
localY | La coordenada vertical en la que se produce el evento en relación con la clase Sprite contenida. |
pressure | Un valor entre 0.0 y 1.0 que indica fuerza de contacto con el dispositivo. Si el dispositivo no admite la detección de presión, el valor es 1.0. |
relatedObject | Referencia a un objeto de la lista de visualización relacionado con el evento. |
shiftKey | true si la tecla Mayús está activa; false si está inactiva. |
sizeX | Anchura de la zona de contacto. |
sizeY | Altura de la zona de contacto. |
stageX | La coordenada horizontal en la que se produce el evento en las coordenadas globales del escenario. |
stageY | La coordenada vertical en la que se produce el evento en las coordenadas globales del escenario. |
target | La instancia de InteractiveObject en el dispositivo táctil. El objeto target no siempre es el objeto de la lista de visualización que registró el detector de eventos. Utilice la propiedad currentTarget para acceder al objeto de la lista de visualización que está procesando el evento actualmente. |
touchPointID | Un número de identificación exclusivo (como un int) asignado al punto táctil. |
Elementos de API relacionados
TOUCH_TAP | Constante |
public static const TOUCH_TAP:String = "touchTap"| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Define el valor de la propiedad type de un objeto de evento táctil TOUCH_TAP.
El objeto del evento TouchEvent tiene las siguientes propiedades:
| Propiedad | Valor |
|---|---|
altKey | true si la tecla Alt está activa (Windows o Linux). |
bubbles | true |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
commandKey | true en Mac, si la tecla Comando está activa; false si está inactiva. Siempre es false en Windows. |
controlKey | true si la tecla Control o Ctrl está activa; false si está inactiva. |
ctrlKey | true en Windows o Linux, si la tecla Ctrl está activa. true en Mac, si la tecla Ctrl o Comando está activa. En caso contrario, false. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
eventPhase | La fase actual en el flujo del evento. |
isRelatedObjectInaccessible | true si la propiedad relatedObject se establece en null por motivos de reglas del entorno limitado de seguridad. |
localX | La coordenada horizontal en la que se produce el evento en relación con la clase Sprite contenida. |
localY | La coordenada vertical en la que se produce el evento en relación con la clase Sprite contenida. |
pressure | Un valor entre 0.0 y 1.0 que indica fuerza de contacto con el dispositivo. Si el dispositivo no admite la detección de presión, el valor es 1.0. |
relatedObject | Referencia a un objeto de la lista de visualización relacionado con el evento. |
shiftKey | true si la tecla Mayús está activa; false si está inactiva. |
sizeX | Anchura de la zona de contacto. |
sizeY | Altura de la zona de contacto. |
stageX | La coordenada horizontal en la que se produce el evento en las coordenadas globales del escenario. |
stageY | La coordenada vertical en la que se produce el evento en las coordenadas globales del escenario. |
target | La instancia de InteractiveObject en el dispositivo táctil. El objeto target no siempre es el objeto de la lista de visualización que registró el detector de eventos. Utilice la propiedad currentTarget para acceder al objeto de la lista de visualización que está procesando el evento actualmente. |
touchPointID | Un número de identificación exclusivo (como un int) asignado al punto táctil. |
Elementos de API relacionados
Ejemplo ( Cómo utilizar este ejemplo )
El siguiente ejemplo muestra un mensaje cuando el cuadrado dibujado en mySprite se toca en un dispositivo táctil:
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);
}
Ejemplos Cómo utilizar este ejemplo
TouchEventExample.as
En el ejemplo siguiente se muestra la gestión de eventos para los eventos
TOUCH_BEGIN, TOUCH_MOVE, y TOUCH_END. Mientras el punto de contacto se desplaza a lo largo de la pantalla (onTouchMove), la coordenada x con respecto al escenario se traza en la salida. Para los parámetros Sprite.startTouchDrag de la función onTouchBegin, el valor de touchPointID es el valor asignado al objeto de evento. El parámetro bounds es el rectángulo que define los límites del objeto de visualización principal (bg es un objeto de visualización que contiene 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");
}
TouchExample2.as
En el ejemplo siguiente se muestra cómo gestionar eventos táctiles y fases de eventos táctiles, así como las propiedades
Multitouch.maxTouchPoints y touchPointID del objeto del evento táctil. Este ejemplo proviene de Christian Cantrell, y se explica con más detalle en su guía de inicio rápido: (Compatibilidad de multitoque y gestos en la plataforma Flash, en inglés).
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, 02:12 PM Z