TouchEvent  - AS3

Indica se il tasto Alt è attivo (true) o inattivo (false). Supportato solo per i sistemi operativi Windows e Linux.

Indica se il tasto Comando è attivato (solo Mac).

In Mac OS, il valore della proprietà commandKey è uguale al valore della proprietà ctrlKey. Questa proprietà è sempre false in Windows o Linux.

Indica se il comando Ctrl è attivato in Mac, Windows e Linux.

In Windows o Linux, indica se il tasto Ctrl è attivo (true) o inattivo (false). In Macintosh, indica se il tasto Ctrl o il tasto Comando è attivato.

Indica se il primo punto di contatto è mappato agli eventi del mouse.

Elementi API correlati

Se è true, la proprietà relatedObject viene impostata su null per motivi riconducibili alle sandbox. Se il valore nominale di relatedObject è un riferimento a DisplayObject in un'altra sandbox, relatedObject viene impostato su null a meno che non vi sia autorizzazione in entrambe le direzioni attraverso questa sandbox. L'autorizzazione si stabilisce chiamando Security.allowDomain() da un file SWF o fornendo un file di criteri dal server di un file di immagine e impostando la proprietà LoaderContext.checkPolicyFile quando si carica l'immagine.

Elementi API correlati

Segnala che questa sequenza di input di tocco è stata annullata dal sistema operativo.

Gli eventi di tocco possono essere annullati per vari motivi, ad esempio quando un tocco generato dal palmo viene rifiutato perché l'utente sta utilizzando uno stilo. isTouchPointCanceled può essere solo true in un evento touchEnd.

La coordinata orizzontale in cui si è verificato l'evento rispetto all'oggetto Sprite che lo contiene.

La coordinata verticale in cui si è verificato l'evento rispetto all'oggetto Sprite che lo contiene.

Un valore compreso tra 0.0 e 1.0 che indica la forza del contatto con il dispositivo. Se il dispositivo non supporta il rilevamento della pressione, il valore è 1.0.

Un riferimento a un oggetto dell'elenco di visualizzazione relativo all'evento. Quando ad esempio si verifica un evento touchOut, relatedObject rappresenta l'oggetto dell'elenco di visualizzazione a cui punta ora il dispositivo di puntamento. Questa proprietà si applica agli eventi touchOut, touchOver, touchRollOut e touchRollOver.

Il valore di questa proprietà può essere null in due casi: se non vi è un oggetto correlato oppure se esiste un oggetto correlato ma si trova in una sandbox di sicurezza a cui non potete accedere. Per individuare il motivo, utilizzate la proprietà isRelatedObjectInaccessible().

Elementi API correlati

Indica se il tasto Maiusc è attivo (true) o inattivo (false).

Larghezza dell'area di contatto.

Altezza dell'area di contatto.

La coordinata orizzontale in cui si è verificato l'evento nelle coordinate globali dello stage. Questa proprietà viene calcolata quando viene impostata la proprietà localX.

La coordinata verticale in cui si è verificato l'evento nelle coordinate globali dello stage. Questa proprietà viene calcolata quando viene impostata la proprietà localY.

Segnala il tempo dell'evento in millisecondi relativi.

I tempi segnalati sono relativi al tempo di esecuzione dell'avvio dell'applicazione. Per gli eventi che restituiscono una sequenza di punti nel buffer dei campioni, il marcatore temporale riflette il tempo trascorso dell'ultimo campione nel buffer.

Elementi API correlati

Segnala se il tocco è stato generato dall'estremità principale o dall'estremità della gomma di uno stilo.

Se un evento di tocco è generato da un dito o mediante un altro metodo di input diverso dallo stilo, oppure da uno stilo per il quale non è supportato il tracciamento del movimento ad alta frequenza, questa proprietà segnala il valore TouchEventIntent.UNKNOWN.

La classe TouchEventIntent definisce le costanti per i valori possibili di questa proprietà, che includono:

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

Elementi API correlati

Un numero di identificazione univoco (ad esempio un int) assegnato al punto di contatto.

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 oggetto Event che contiene informazioni sugli eventi di tocco. Gli oggetti evento vengono passati ai listener di eventi come parametri.

Crea una copia dell'oggetto TouchEvent e imposta il valore di ogni proprietà in modo che corrisponda a quello dell'originale.

Aggiorna l'oggetto ByteArray con i punti dati ad alta frequenza per un evento di tocco multi-punto.

L'oggetto a cui fa riferimento il parametro buffer viene aggiornato con i valori dei punti dati intermedi tra questo evento di tocco e quello precedente. Tre valori a virgola mobile vengono aggiunti per ciascun campione: una coordinata x, una coordinata y e un valore di pressione. I valori di posizione, riportati in coordinate dello stage. La pressione è espressa con un valore compreso tra 0 e 1. I campioni vengono registrati a intervalli di tempo regolari. La frequenza esatta dipende dall'hardware del dispositivo e dai driver dell'hardware. Le frequenze tipiche dei campioni sono intorno ai 133 Hz. Tenete presente che gli eventi di tocco non vengono inviati a intervalli precisi. Quindi, il buffer per gli eventi simili può contenere un numero differente di campioni. L'ultimo campione nel buffer ha gli stessi dati delle proprietà stageX, stageY e pressure di questo oggetto evento di tocco.

Un buffer di campioni viene incluso negli oggetti evento inviati per gli eventi proximityMove e touchMove.

Parametri

Elementi API correlati

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

Segnala che è stato premuto il pulsante hardware in corrispondenza dell'indice specificato.

Parametri

Restituisce una stringa che contiene tutte le proprietà dell'oggetto TouchEvent. La stringa ha il seguente formato:

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

Indica a Flash Player o ad Adobe AIR di eseguire il rendering al termine dell'elaborazione dell'evento se l'elenco di visualizzazione è stato modificato.

Definisce il valore della proprietà type di un oggetto evento PROXIMITY_BEGIN.

L'oggetto TouchEvent ha le proprietà seguenti:

Elementi API correlati

Definisce il valore della proprietà type di un oggetto evento PROXIMITY_END.

L'oggetto TouchEvent ha le proprietà seguenti:

Elementi API correlati

Definisce il valore della proprietà type di un oggetto evento PROXIMITY_MOVE.

L'oggetto TouchEvent ha le proprietà seguenti:

Elementi API correlati

Definisce il valore della proprietà type di un oggetto evento PROXIMITY_OUT.

L'oggetto TouchEvent ha le proprietà seguenti:

Elementi API correlati

Definisce il valore della proprietà type di un oggetto evento PROXIMITY_OVER.

L'oggetto TouchEvent ha le proprietà seguenti:

Elementi API correlati

Definisce il valore della proprietà type di un oggetto evento PROXIMITY_ROLL_OUT.

L'oggetto TouchEvent ha le proprietà seguenti:

Elementi API correlati

Definisce il valore della proprietà type di un oggetto evento PROXIMITY_ROLL_OVER.

L'oggetto TouchEvent ha le proprietà seguenti:

Elementi API correlati

Definisce il valore della proprietà type di un oggetto evento di tocco TOUCH_BEGIN.

L'oggetto TouchEvent ha le proprietà seguenti:

Elementi API correlati

Definisce il valore della proprietà type di un oggetto evento di tocco TOUCH_END.

L'oggetto TouchEvent ha le proprietà seguenti:

Elementi API correlati

Definisce il valore della proprietà type di un oggetto evento di tocco TOUCH_MOVE.

L'oggetto TouchEvent ha le proprietà seguenti:

Elementi API correlati

Definisce il valore della proprietà type di un oggetto evento di tocco TOUCH_OUT.

L'oggetto TouchEvent ha le proprietà seguenti:

Elementi API correlati

Definisce il valore della proprietà type di un oggetto evento di tocco TOUCH_OVER.

L'oggetto TouchEvent ha le proprietà seguenti:

Elementi API correlati

Definisce il valore della proprietà type di un oggetto evento di tocco TOUCH_ROLL_OUT.

L'oggetto TouchEvent ha le proprietà seguenti:

Elementi API correlati

Definisce il valore della proprietà type di un oggetto evento di tocco TOUCH_ROLL_OVER.

L'oggetto TouchEvent ha le proprietà seguenti:

Elementi API correlati

Definisce il valore della proprietà type di un oggetto evento di tocco TOUCH_TAP.

L'oggetto TouchEvent ha le proprietà seguenti:

Elementi API correlati

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