TouchEvent  - AS3

Indique si la touche Alt est active (true) ou non (false). Pris en charge uniquement pour les systèmes d’exploitation Windows et Linux.

Indique si la touche Commande est activée (Mac uniquement).

Sous Mac OS, la valeur de la propriété commandKey est la même valeur que la propriété ctrlKey. Cette propriété est toujours définie sur false sous Windows ou Linux.

Indique si la touche Contrôle et activée sous Mac et si la touche Ctrl est activée sous Windows ou Linux.

Sous Windows ou Linux, indique si la touche Ctrl est activée (true) ou non (false). Sous Macintosh, indique si la touche Contrôle ou la touche Commande est activée.

Indique si le premier point de contact est associé aux événements de souris.

Eléments de l’API associés

Si la valeur est true, la propriété relatedObject est définie sur null pour des raisons liées aux sandbox de sécurité. Si la valeur nominale de relatedObject est une référence à un DisplayObject se trouvant dans un autre sandbox, relatedObject est défini sur null, à moins qu’il existe une autorisation dans les deux sens dans les limites de ce sandbox. L’autorisation est établie en appelant la méthode Security.allowDomain() à partir d’un fichier SWF ou en fournissant un fichier de régulation depuis le serveur d’un fichier image, puis en définissant la propriété LoaderContext.checkPolicyFile lors du chargement de l’image.

Eléments de l’API associés

Signale que cette séquence de saisie tactile séquence a été annulée par le système d’exploitation.

Les événements tactiles peuvent être annulés pour diverses raisons, notamment lorsqu’un événement tactile généré par la paume de la main est rejeté car un stylet est en cours d’utilisation. isTouchPointCanceled peut être uniquement défini sur true dans un événement touchEnd.

Coordonnée horizontale à laquelle l’événement s’est produit par rapport au sprite conteneur.

Coordonnée verticale à laquelle l’événement s’est produit par rapport au sprite conteneur.

Valeur comprise entre 0.0 et 1.0 qui indique l’intensité du contact avec le périphérique. Si le périphérique ne prend pas en charge la détection de la pression, la valeur est 1.0.

Référence à un objet de la liste d’affichage qui est associé à l’événement. Par exemple, lorsqu’un événement touchOut se produit, relatedObject représente l’objet de la liste d’affichage sur lequel pointe actuellement le dispositif de pointage. Cette propriété s’applique aux événements touchOut, touchOver, touchRollOut et touchRollOver.

La valeur de cette propriété peut être null dans deux cas : s’il n’existe aucun objet associé ou s’il existe un objet associé se trouvant dans un sandbox de sécurité auquel vous n’avez pas accès. Pour savoir dans quel cas vous vous trouvez, utilisez la propriété isRelatedObjectInaccessible().

Eléments de l’API associés

Indique si la touche Maj est activée (true) ou non (false).

Largeur de la surface de contact.

Hauteur de la surface de contact.

Coordonnée horizontale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène. Cette propriété est calculée lorsque la propriété localX est définie.

Coordonnée verticale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène. Cette propriété est calculée lorsque la propriété localY est définie.

Indique la durée de l’événement en millisecondes relatives.

Les durées signalées sont relatives à l’heure à laquelle le l’application a commencé à s’exécuter. Pour les événements qui renvoient une séquence de points dans les tampons échantillons, cet horodatage indique la durée écoulée du dernier échantillon dans la mémoire tampon.

Eléments de l’API associés

Indique si la l’événement tactile a été généré par le stylet principal ou la gomme d’un stylet.

Si un événement tactile est généré à l’aide d’un doigt ou d’une méthode d’entrée autre qu’un stylet, ou avec un stylet pour lequel le suivi du déplacement haute fréquence n’est pas pris en charge, cette propriété signale la valeur : TouchEventIntent.UNKNOWN.

La classe TouchEventIntent définit des constantes pour les valeurs possibles de cette propriété, c’est-à-dire :

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

Eléments de l’API associés

Numéro d’identification unique (sous la forme d’une valeur int) affecté au point tactile.

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

Crée un objet Event contenant des informations sur les événements tactiles. Les objets Event sont transmis en tant que paramètres aux écouteurs d’événements.

Crée une copie de l’objet TouchEvent et définit la valeur de chaque propriété de sorte qu’elle corresponde à la valeur d’origine.

Met à jour l’objet ByteArray spécifié avec les points de données haute fréquence pour un événement tactile multipoint.

L’objet ByteArray référencé par le paramètre buffer est mis à jour avec des valeurs pour les points de données intermédiaires entre cet événement tactile et le précédent. Trois valeurs à virgule flottante sont ajoutées pour chaque échantillon : une coordonnée x, une coordonnée y et une valeur de pression. Valeurs de position indiquées dans les coordonnées de la scène. La pression est signalée comme une valeur comprise entre 0 et 1. Des échantillons sont enregistrés à intervalles réguliers. La fréquence exacte dépend du périphérique et des pilotes matériels. Les fréquences d’échantillonnage standard sont autour de 133 Hz. Notez que les événements tactiles ne sont pas distribués à intervalles réguliers. Par conséquent, la mémoire tampon des événements similaires peut contenir un nombre différent d’échantillons. Le dernier échantillon dans la mémoire tampon possède les mêmes données que les propriétés stageX, stageY et pressure de cet objet d’événement tactile.

Un tampon échantillon est inclus dans les objets d’événement distribués pour les événements proximityMove et touchMove.

Paramètres

Eléments de l’API associés

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

Signale que l’utilisateur a cliqué sur le bouton du matériel qui se trouve à l’index spécifié.

Paramètres

Renvoie une chaîne répertoriant toutes les propriétés de l’objet TouchEvent. La chaîne est écrite au format suivant :

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

Demande à Flash Player ou à Adobe AIR d’effectuer un rendu à la fin du traitement de cet événement, si la liste d’affichage a été modifiée.

Définit la valeur de la propriété type d’un objet d’événement PROXIMITY_BEGIN.

L’objet TouchEvent distribué possède les propriétés suivantes :

Eléments de l’API associés

Définit la valeur de la propriété type d’un objet d’événement PROXIMITY_END.

L’objet TouchEvent distribué possède les propriétés suivantes :

Eléments de l’API associés

Définit la valeur de la propriété type d’un objet d’événement PROXIMITY_MOVE.

L’objet TouchEvent distribué possède les propriétés suivantes :

Eléments de l’API associés

Définit la valeur de la propriété type d’un objet d’événement PROXIMITY_OUT.

L’objet TouchEvent distribué possède les propriétés suivantes :

Eléments de l’API associés

Définit la valeur de la propriété type d’un objet d’événement PROXIMITY_OVER.

L’objet TouchEvent distribué possède les propriétés suivantes :

Eléments de l’API associés

Définit la valeur de la propriété type d’un objet d’événement PROXIMITY_ROLL_OUT.

L’objet TouchEvent distribué possède les propriétés suivantes :

Eléments de l’API associés

Définit la valeur de la propriété type d’un objet d’événement PROXIMITY_ROLL_OVER.

L’objet TouchEvent distribué possède les propriétés suivantes :

Eléments de l’API associés

Définit la valeur de la propriété type d’un objet d’événement TOUCH_BEGIN.

L’objet TouchEvent distribué possède les propriétés suivantes :

Eléments de l’API associés

Définit la valeur de la propriété type d’un objet d’événement TOUCH_END.

L’objet TouchEvent distribué possède les propriétés suivantes :

Eléments de l’API associés

Définit la valeur de la propriété type d’un objet d’événement TOUCH_MOVE.

L’objet TouchEvent distribué possède les propriétés suivantes :

Eléments de l’API associés

Définit la valeur de la propriété type d’un objet d’événement TOUCH_OUT.

L’objet TouchEvent distribué possède les propriétés suivantes :

Eléments de l’API associés

Définit la valeur de la propriété type d’un objet d’événement TOUCH_OVER.

L’objet TouchEvent distribué possède les propriétés suivantes :

Eléments de l’API associés

Définit la valeur de la propriété type d’un objet d’événement TOUCH_ROLL_OUT.

L’objet TouchEvent distribué possède les propriétés suivantes :

Eléments de l’API associés

Définit la valeur de la propriété type d’un objet d’événement TOUCH_ROLL_OVER.

L’objet TouchEvent distribué possède les propriétés suivantes :

Eléments de l’API associés

Définit la valeur de la propriété type d’un objet d’événement TOUCH_TAP.

L’objet TouchEvent distribué possède les propriétés suivantes :

Eléments de l’API associés

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