TouchEvent  - AS3

Indica si la tecla Alt está activa (true) o inactiva (false). Sólo se admite en los sistema operativos Windows y Linux.

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.

Indica si la tecla Control está activada en Mac y si la tecla Ctrl está activada en Windows o Linux.

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.

Indica si el primer punto de contacto se asignará a los eventos del ratón.

Elementos de API relacionados

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.

Elementos de API relacionados

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.

La coordenada horizontal en la que se produce el evento en relación con la clase Sprite contenida.

La coordenada vertical en la que se produce el evento en relación con la clase Sprite contenida.

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.

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.

Elementos de API relacionados

Indica si la tecla Mayús está activa (true) o inactiva (false).

Anchura de la zona de contacto.

Altura de la zona de contacto.

La coordenada horizontal en la que se produce el evento en las coordenadas globales del escenario. Esta propiedad se calcula al establecer localX.

La coordenada vertical en la que se produce el evento en las coordenadas globales del escenario. Esta propiedad se calcula al establecer localY.

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.

Elementos de API relacionados

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

Elementos de API relacionados

Un número de identificación exclusivo (como un int) asignado al punto táctil.

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; 
}

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.

Crea una copia del objeto TouchEvent y define el valor de cada propiedad para que coincida con el del objeto original.

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

Elementos de API relacionados

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
        }
    }
}

Indica que el botón de hardware en el índice especificado está presionado.

Parámetros

Devuelve una cadena con todas las propiedades del objeto TouchEvent. La cadena tiene el siguiente formato:

[TouchEvent type=value bubbles=valor cancelable=valor ... ]

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.

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:

Elementos de API relacionados

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:

Elementos de API relacionados

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:

Elementos de API relacionados

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:

Elementos de API relacionados

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:

Elementos de API relacionados

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:

Elementos de API relacionados

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:

Elementos de API relacionados

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:

Elementos de API relacionados

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:

Elementos de API relacionados

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:

Elementos de API relacionados

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:

Elementos de API relacionados

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:

Elementos de API relacionados

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:

Elementos de API relacionados

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:

Elementos de API relacionados

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:

Elementos de API relacionados

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);
}