TouchEvent  - AS3

Indica se a tecla Alt está ativa (true) ou inativa (false). Com suporte apenas para sistemas operacionais Windows e Linux.

Indica se a tecla Command está ativada (só no Mac).

No sistema operacional Mac, o valor da propriedade commandKey é o mesmo valor da propriedade ctrlKey. Esta propriedade é sempre falsa no Windows ou Linux.

Indica se a tecla Control está ativada no Mac e se a tecla Ctrl está ativada no Windows ou no Linux.

No Windows ou no Linux, indica se a tecla Ctrl está ativa (true) ou inativa (false). No Macintosh, indica se a tecla Control ou se a tecla Command está ativada.

Indica se o primeiro ponto do contato é mapeado a eventos de mouse.

Elementos da API relacionados

Se for true, a propriedade relatedObject será definida como null pelos motivos relacionados às caixas de proteção de segurança. Se o valor nominal de relatedObject for uma referência a um DisplayObject de outra caixa de proteção, a propriedade relatedObject será definida como null, a menos que haja permissão em ambas as direções do limite dessa caixa de proteção. A permissão é estabelecida chamando Security.allowDomain() de um arquivo SWF ou fornecendo um arquivo de diretivas do servidor de um arquivo de imagem e definindo a propriedade LoaderContext.checkPolicyFile quando carregar a imagem.

Elementos da API relacionados

Relata que essa sequência de entrada de toque foi cancelada pelo sistema operacional.

Os eventos de toque poderão ser cancelados por várias razões, como quando um toque gerado pela palma é rejeitado porque um estilo de caneta está sendo utilizado. O isTouchPointCanceled somente poderá sertrue em um evento touchEnd.

A coordenada horizontal na qual o evento ocorreu com relação à entidade gráfica continente.

A coordenada vertical na qual o evento ocorreu com relação à entidade gráfica continente.

Um valor entre 0.0 e 1.0 indicando força do contato com o dispositivo. Se o dispositivo não conseguir detectar a pressão, o valor será 1.0.

Uma referência a um objeto de lista de exibição relacionado ao evento. Por exemplo, quando ocorre um evento touchOut, o relatedObject representa o objeto da lista de exibição para o qual o dispositivo apontador agora aponta. Esta propriedade é aplicada aos eventos touchOut, touchOver, touchRollOut e touchRollOver.

O valor dessa propriedade pode ser null em duas situações: se não houver nenhum objeto relacionado, ou se houver um objeto relacionado, mas que esteja em uma área de segurança à qual você não tem acesso. Use a propriedade isRelatedObjectInaccessible() para determinar qual desses motivos se aplica.

Elementos da API relacionados

Indica se a tecla Shift está ativa (true) ou inativa (false).

Largura da área de contato.

Altura da área de contato.

A coordenada horizontal na qual o evento ocorreu em coordenadas globais de Palco. Esta propriedade é calculada quando a propriedade localX está definida.

A coordenada vertical na qual o evento ocorreu em coordenadas globais de Palco. Esta propriedade é calculada quando a propriedade localY está definida.

Informa a hora do evento em milissegundos relativos.

As horas informadas são relativas à hora em que o aplicativo iniciou a execução. Para eventos que retornam uma sequência de pontos no buffer de amostras, esta marca de data e hora reflete o tempo decorrido da última amostra no buffer.

Elementos da API relacionados

Informa se o toque foi gerado pela extremidade primária ou de borracha de um estilo.

Se um evento de toque for gerado por um dedo ou outro método de entrada de não-estilo, ou um estilo para o qual o rastreamento de movimento de alta frequência não for suportado, esta propriedade informará o valor: TouchEventIntent.UNKNOWN.

A classe TouchEventIntent define constantes dos valores possíveis desta propriedade, que incluem:

• TouchEventIntent.ERASER
• TouchEventIntent.PEN
• TouchEventIntent.UNKNOWN

Elementos da API relacionados

Um número de identificação exclusiva (como um int) destinado ao ponto de toque.

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

Cria um objeto Event que contém informações sobre eventos de toque. Objetos Event são transmitidos como parâmetros para ouvintes de eventos.

Cria uma cópia do objeto TouchEvent e define o valor de cada propriedade para corresponder ao do original.

Atualiza o objeto ByteArray especificado com os pontos de dados de alta frequência de um evento de toque de pontos múltiplos.

O objeto de ByteArray referido pelo parâmetro de buffer é atualizado com valores dos pontos de dados intermediários entre eles e o evento de toque anterior. Três valores de ponto flutuante são adicionados para cada amostra: uma coordenada de x, uma coordenada y e um valor de pressão. Os valores de posição relatados nas coordenadas da etapa. A pressão é relatada como um valor entre 0 e 1. As amostras são registradas em intervalos de tempo regulares. A frequência exata depende dos drivers de hardware e do hardware de dispositivo. As frequências de amostra típicas são aproximadamente 133 Hz. Observe que os eventos de toque não são despachados em intervalos exatos. Assim, o buffer para eventos semelhantes pode conter um número de amostras diferente. A última amostra no buffer tem os mesmos dados que as propriedades stageX, stageY e de pressão deste objeto de evento de toque.

Um buffer de amostra é incluída nos objetos de evento despachados para eventos proximityMove e touchMove.

Parâmetros

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

Relata que o botão de hardware no índice especificado foi pressionado.

Parâmetros

Retorna uma string que contém todas as propriedades do objeto TouchEvent. A string está no seguinte formato:

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

Instrui o Flash Player ou Adobe AIR a aplicar acabamento após o término do processamento desse evento, se a lista de exibição tiver sido modificada.

Define o valor do tipo da propriedade de um objeto de evento de toque PROXIMITY_BEGIN.

O objeto TouchEvent despachado tem as seguintes propriedades:

Elementos da API relacionados

Define o valor do tipo da propriedade de um objeto de evento de toquePROXIMITY_END.

O objeto TouchEvent despachado tem as seguintes propriedades:

Elementos da API relacionados

Define o valor do tipo da propriedade de um objeto de evento de toque PROXIMITY_MOVE.

O objeto TouchEvent despachado tem as seguintes propriedades:

Elementos da API relacionados

Define o valor do tipo da propriedade de um objeto de evento de toque PROXIMITY_OUT.

O objeto TouchEvent despachado tem as seguintes propriedades:

Elementos da API relacionados

Define o valor do tipo da propriedade de um objeto de evento de toque PROXIMITY_OVER.

O objeto TouchEvent despachado tem as seguintes propriedades:

Elementos da API relacionados

Define o valor do tipo da propriedade de um objeto de evento de toque PROXIMITY_ROLL_OUT.

O objeto TouchEvent despachado tem as seguintes propriedades:

Elementos da API relacionados

Define o valor do tipo da propriedade de um objeto de evento de toque PROXIMITY_ROLL_OVER.

O objeto TouchEvent despachado tem as seguintes propriedades:

Elementos da API relacionados

Define o valor da propriedade type de um objeto de evento de toque TOUCH_BEGIN.

O objeto TouchEvent despachado tem as seguintes propriedades:

Elementos da API relacionados

Define o valor da propriedade type de um objeto de evento TOUCH_END.

O objeto TouchEvent despachado tem as seguintes propriedades:

Elementos da API relacionados

Define o valor da propriedade type de um objeto de evento de toque TOUCH_MOVE.

O objeto TouchEvent despachado tem as seguintes propriedades:

Elementos da API relacionados

Define o valor da propriedade type de um objeto de evento de toque TOUCH_OUT.

O objeto TouchEvent despachado tem as seguintes propriedades:

Elementos da API relacionados

Define o valor da propriedade type de um objeto de evento de toque TOUCH_OVER.

O objeto TouchEvent despachado tem as seguintes propriedades:

Elementos da API relacionados

Define o valor da propriedade type de um objeto de evento de toque TOUCH_ROLL_OUT.

O objeto TouchEvent despachado tem as seguintes propriedades:

Elementos da API relacionados

Define o valor da propriedade type de um objeto de evento de toque TOUCH_ROLL_OVER.

O objeto TouchEvent despachado tem as seguintes propriedades:

Elementos da API relacionados

Define o valor da propriedade type de um objeto de evento de toque TOUCH_TAP.

O objeto TouchEvent despachado tem as seguintes propriedades:

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