GestureEvent

Package	flash.events
Classe	public class GestureEvent
Héritage	GestureEvent Event Object
Sous-classes	PressAndTapGestureEvent, TransformGestureEvent

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

Flash Player 10.1, AIR 2, Flash Lite 4

La classe GestureEvent permet de gérer des événements tactiles multipoints sur des périphériques qui détectent les interactions complexes entre l’utilisateur et le périphérique (notamment lorsque l’utilisateur appuie simultanément avec deux doigts sur un écran tactile). Lorsqu’un utilisateur interagit avec un périphérique, par exemple avec un téléphone portable ou une tablette munis d’un écran tactile, il touche généralement l’écran et se déplace dessus avec ses doigts ou un dispositif de pointage. Vous pouvez développer des applications qui répondent à cette action de l’utilisateur à l’aide des classes GestureEvent et TransformGestureEvent. Vous pouvez créer des écouteurs d’événement à l’aide des types d’événements définis ici ou dans les classes TouchEvent et TransformGestureEvent associées. Vous pouvez ensuite utiliser les propriétés et les méthodes de ces classes pour construire des gestionnaires d’événement qui répondent aux mouvements tactiles de l’utilisateur sur le périphérique.

Utilisez la classe Multitouch pour activer et gérer la prise en charge des actions tactiles par l’environnement actuel.

Remarque : lorsque les objets sont imbriqués dans la liste d’affichage, les événements tactiles ciblent l’objet le plus profondément imbriqué et visible dans la liste d’affichage. Cet objet est appelé le nœud cible. Pour que l’ancêtre d’un nœud cible (objet contenant le nœud cible dans la liste d’affichage) reçoive la notification d’un événement tactile, utilisez EventDispatcher.addEventListener() sur le nœud de l’ancêtre en définissant le paramètre type sur l’événement tactile spécifique que vous souhaitez détecter.

Consulter les exemples

Plus d’exemples

Saisie tactile, multipoint et par mouvement

Eléments de l’API associés

flash.ui.Multitouch
flash.events.TouchEvent
flash.events.TransformGestureEvent
flash.events.PressAndTapGestureEvent
flash.events.MouseEvent
flash.events.EventDispatcher.addEventListener()

Propriétés publiques

Masquer les propriétés publiques héritées

Afficher les propriétés publiques héritées

	Propriété		Défini par
		altKey : Boolean Indique si la touche Alt est active (true) ou non (false).	GestureEvent
		bubbles : Boolean [lecture seule] Indique si un événement peut se propager vers le haut (bubbling).	Event
		cancelable : Boolean [lecture seule] Indique si le comportement associé à l’événement peut être évité.	Event
		commandKey : Boolean Indique si la touche Commande est activée (Mac uniquement).	GestureEvent
		constructor : Object Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet.	Object
		controlKey : Boolean Indique si la touche Contrôle et activée sous Mac et si la touche Ctrl est activée sous Windows ou Linux.	GestureEvent
		ctrlKey : Boolean Sous Windows ou Linux, indique si la touche Ctrl est activée (true) ou non (false).	GestureEvent
		currentTarget : Object [lecture seule] L’objet qui traite activement l’objet Event avec un écouteur d’événements.	Event
		eventPhase : uint [lecture seule] Phase actuelle du flux d’événements.	Event
		localX : Number Coordonnée horizontale à laquelle l’événement s’est produit par rapport au sprite conteneur.	GestureEvent
		localY : Number Coordonnée verticale à laquelle l’événement s’est produit par rapport au sprite conteneur.	GestureEvent
		phase : String Valeur de la classe GesturePhase indiquant l’état du mouvement tactile.	GestureEvent
		shiftKey : Boolean Indique si la touche Maj est activée (true) ou non (false).	GestureEvent
		stageX : Number [lecture seule] Coordonnée horizontale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène.	GestureEvent
		stageY : Number [lecture seule] Coordonnée verticale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène.	GestureEvent
		target : Object [lecture seule] Cible de l’événement.	Event
		type : String [lecture seule] Type d’événement.	Event

Méthodes publiques

Masquer les méthodes publiques héritées

Afficher les méthodes publiques héritées

	Méthode		Défini par
		GestureEvent(type:String, bubbles:Boolean = true, cancelable:Boolean = false, phase:String = null, localX:Number = 0, localY:Number = 0, ctrlKey:Boolean = false, altKey:Boolean = false, shiftKey:Boolean = false, commandKey:Boolean = false, controlKey:Boolean = false) Crée un objet Event contenant des informations sur les événements tactiles multipoints (notamment lorsque l’utilisateur appuie sur un écran tactile avec deux doigts).	GestureEvent
		clone():Event [override] Crée une copie de l’objet GestureEvent et définit la valeur de chaque propriété de sorte qu’elle corresponde à la valeur d’origine.	GestureEvent
		formatToString(className:String, ... arguments):String Fonction d’un utilitaire permettant d’implémenter la méthode toString() dans des classes Event ActionScript 3.0 personnalisées.	Event
		hasOwnProperty(name:String):Boolean Indique si la propriété spécifiée d’un objet est définie.	Object
		isDefaultPrevented():Boolean Vérifie si la méthode preventDefault() a été appelée pour l’événement.	Event
		isPrototypeOf(theClass:Object):Boolean Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l’objet spécifié en tant que paramètre.	Object
		preventDefault():void Annule le comportement par défaut d’un événement si cette opération est possible.	Event
		propertyIsEnumerable(name:String):Boolean Indique si la propriété spécifiée existe et est énumérable.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Définit la disponibilité d’une propriété dynamique pour les opérations en boucle.	Object
		stopImmediatePropagation():void Bloque le traitement des écouteurs d’événement dans le nœud actuel et les suivants dans le flux d’événements.	Event
		stopPropagation():void Bloque le traitement des écouteurs d’événement dans les nœuds qui suivent le nœud actuel dans le flux d’événements.	Event
		toLocaleString():String Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur.	Object
		toString():String [override] Renvoie une chaîne répertoriant toutes les propriétés de l’objet GestureEvent.	GestureEvent
		updateAfterEvent():void Actualise l’affichage du moteur d’exécution de Flash après le traitement de l’événement gesture, dans le cas où la liste d’affichage a été modifiée par le gestionnaire d’événement.	GestureEvent
		valueOf():Object Renvoie la valeur primitive de l’objet spécifié.	Object

Constantes publiques

Masquer les constantes publiques héritées

Afficher les constantes publiques héritées

	Constante		Défini par
		GESTURE_TWO_FINGER_TAP : String = "gestureTwoFingerTap" [statique] Définit la valeur de la propriété type d’un objet d’événement de mouvement GESTURE_TWO_FINGER_TAP.	GestureEvent

Détails de la propriété

altKey

propriété

altKey:Boolean

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

Flash Player 10.1, AIR 2

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

Implémentation
public function get altKey():Boolean
public function set altKey(value:Boolean):void

commandKey

propriété

commandKey:Boolean

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 2

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.

Implémentation
public function get commandKey():Boolean
public function set commandKey(value:Boolean):void

controlKey

propriété

controlKey:Boolean

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

Flash Player 10.1, AIR 2

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

Implémentation
public function get controlKey():Boolean
public function set controlKey(value:Boolean):void

ctrlKey

propriété

ctrlKey:Boolean

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

Flash Player 10.1, AIR 2

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.

Implémentation
public function get ctrlKey():Boolean
public function set ctrlKey(value:Boolean):void

localX

propriété

localX:Number

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

Flash Player 10.1, AIR 2, Flash Lite 4

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

Implémentation
public function get localX():Number
public function set localX(value:Number):void

localY

propriété

localY:Number

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

Flash Player 10.1, AIR 2, Flash Lite 4

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

Implémentation
public function get localY():Number
public function set localY(value:Number):void

phase

propriété

phase:String

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

Flash Player 10.1, AIR 2, Flash Lite 4

Valeur de la classe GesturePhase indiquant l’état du mouvement tactile. Pour la plupart des mouvements, la valeur est begin, update ou end. Pour les mouvements de glissement et d’appui bref à deux doigts, la valeur de phase est toujours all une fois l’événement distribué. Utilisez cette valeur pour déterminer si un gestionnaire d’événement répond à une interaction de l’utilisateur complexe, ou s’il répond de différentes façons selon la phase actuelle d’un mouvement tactile multipoint (par exemple, l’agrandissement, le déplacement et le « dépôt » lorsqu’un utilisateur touche un objet visuel et le fait glisser sur un écran).

Implémentation
public function get phase():String
public function set phase(value:String):void

Eléments de l’API associés

flash.events.GesturePhase

shiftKey

propriété

shiftKey:Boolean

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

Flash Player 10.1, AIR 2

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

Implémentation
public function get shiftKey():Boolean
public function set shiftKey(value:Boolean):void

stageX

propriété

stageX:Number [lecture seule]

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

Flash Player 10.1, AIR 2, Flash Lite 4

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.

Implémentation
public function get stageX():Number

stageY

propriété

stageY:Number [lecture seule]

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

Flash Player 10.1, AIR 2, Flash Lite 4

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.

Implémentation
public function get stageY():Number

Détails du constructeur

()

Constructeur

public function GestureEvent(type:String, bubbles:Boolean = true, cancelable:Boolean = false, phase:String = null, localX:Number = 0, localY:Number = 0, ctrlKey:Boolean = false, altKey:Boolean = false, shiftKey:Boolean = false, commandKey:Boolean = false, controlKey:Boolean = false)

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

Flash Player 10.1, AIR 2, Flash Lite 4

Crée un objet Event contenant des informations sur les événements tactiles multipoints (notamment lorsque l’utilisateur appuie sur un écran tactile avec deux doigts). Les objets Event sont transmis en tant que paramètres aux écouteurs d’événements.

Paramètres

	`type:String` — Type de l’événement. La valeur prise en charge est la suivante : `GestureEvent.GESTURE_TWO_FINGER_TAP`.

	`bubbles:Boolean` (default = `true`) — Détermine si l’objet Event prend part à la phase de propagation du flux d’événements.

	`cancelable:Boolean` (default = `false`) — Détermine si l’objet d’événement peut être annulé.

	`phase:String` (default = `null`) — Valeur de la classe GesturePhase indiquant l’état du mouvement tactile (begin, update, end ou all).

	`localX:Number` (default = `0`) — Coordonnée horizontale à laquelle l’événement s’est produit par rapport au sprite conteneur.

	`localY:Number` (default = `0`) — Coordonnée verticale à laquelle l’événement s’est produit par rapport au sprite conteneur.

	`ctrlKey:Boolean` (default = `false`) — Sous Windows ou Linux, indique si la touche Ctrl est activée. Sous Mac, indique si la touche Ctrl ou la touche Commande est activée.

	`altKey:Boolean` (default = `false`) — Indique si la touche Alt est activée (Windows ou Linux uniquement).

	`shiftKey:Boolean` (default = `false`) — Indique si la touche Maj est activée.

	`commandKey:Boolean` (default = `false`) — (AIR uniquement) Indique si la touche Commande est activée (Mac uniquement). Ce paramètre est destiné à Adobe AIR uniquement ; ne le définissez pas pour le contenu de Flash Player.

	`controlKey:Boolean` (default = `false`) — (AIR uniquement) Indique si la touche Contrôle ou Ctrl est activée (Mac uniquement). Ce paramètre est destiné à Adobe AIR uniquement ; ne le définissez pas pour le contenu de Flash Player.

Eléments de l’API associés

flash.events.GesturePhase

Détails de la méthode

clone

()

méthode

override public function clone():Event

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

Flash Player 10.1, AIR 2, Flash Lite 4

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

Valeur renvoyée

Event — Nouvel objet GestureEvent dont les propriétés ont la même valeur que celles de l’objet d’origine.

toString

()

méthode

override public function toString():String

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

Flash Player 10.1, AIR 2, Flash Lite 4

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

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

Valeur renvoyée

String — Chaîne répertoriant toutes les propriétés de l’objet GestureEvent.

updateAfterEvent

()

méthode

public function updateAfterEvent():void

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

Flash Player 10.1, AIR 2, Flash Lite 4

Actualise l’affichage du moteur d’exécution de Flash après le traitement de l’événement gesture, dans le cas où la liste d’affichage a été modifiée par le gestionnaire d’événement.

Détails de la constante

GESTURE_TWO_FINGER_TAP

Constante

public static const GESTURE_TWO_FINGER_TAP:String = "gestureTwoFingerTap"

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

Flash Player 10.1, AIR 2, Flash Lite 4

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

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

Propriété	Valeur
`altKey`	`true` si la touche Alt est activée (Windows ou Linux).
`bubbles`	`true`
`cancelable`	`false` ; il n’existe aucun comportement par défaut à annuler.
`commandKey`	(AIR uniquement) `true` sous Mac si la touche Commande est activée ; `false` si elle est désactivée. Toujours `false` sur Windows.
`controlKey`	`true` si la touche Ctrl ou Contrôle est activée ; `false` si elle est désactivée.
`ctrlKey`	`true` sous Windows ou Linux si la touche Ctrl est enfoncée. `true` sur Mac si la touche Ctrl ou la touche Commande est activée. Sinon, la valeur `false` est renvoyée.
`currentTarget`	L’objet qui traite activement l’objet Event avec un écouteur d’événements.
`phase`	Phase actuelle du flux d’événements. Pour les événements d’appui bref à deux doigts, cette valeur est toujours `all` ; elle correspond à la valeur `GesturePhase.ALL` une fois l’événement distribué.
`isRelatedObjectInaccessible`	`true` si la propriété relatedObject est définie sur `null` conformément aux règles du sandbox de sécurité.
`localX`	Coordonnée horizontale à laquelle l’événement s’est produit par rapport au sprite conteneur.
`localY`	Coordonnée verticale à laquelle l’événement s’est produit par rapport au sprite conteneur.
`shiftKey`	`true` si la touche Maj est activée ; `false` si elle ne l’est pas.
`target`	Occurrence d’InteractiveObject sous le dispositif de pointage. La propriété `target` ne correspond pas toujours à l’objet de la liste d’affichage qui est associé à l’écouteur d’événement. Utilisez la propriété `currentTarget` pour accéder à l’objet de la liste d’affichage qui traite actuellement l’événement.

Eléments de l’API associés

flash.display.InteractiveObject.gestureTwoFingerTap
flash.events.GesturePhase

Exemples Comment utiliser cet exemple

GestureTwoFingerTap.as

L’exemple suivant illustre la gestion d’événement pour l’événement GESTURE_TWO_FINGER_TAP. Lorsque l’utilisateur effectue un mouvement d’appui bref avec deux doigts, mySprite et myTextField se remplissent avec la phase all (unique phase des événements d’appui bref à deux doigts). Les autres mouvements de la classe TransformGestureEvent prennent en charge les phases begin (début), update (mise à jour) et end (fin).

Multitouch.inputMode = MultitouchInputMode.GESTURE;

var mySprite = new Sprite();
mySprite.addEventListener(GestureEvent.GESTURE_TWO_FINGER_TAP , onTwoFingerTap );
mySprite.graphics.beginFill(0x336699);
mySprite.graphics.drawRect(0, 0, 100, 80);
var myTextField = new TextField();
myTextField.y = 200;
addChild(mySprite);
addChild(myTextField);

function onTwoFingerTap(evt:GestureEvent):void {

    evt.target.rotation -= 45;
    myTextField.text = evt.phase; //"all"

}

Informations juridiques | Politique de confidentialité en ligne

GestureEvent - AS3

Packagesx

Eléments du langage

Annexes

Package flash.events

altKey

commandKey

controlKey

ctrlKey

localX

localY

phase

shiftKey

stageX

stageY

GestureEvent

clone

toString

updateAfterEvent

GESTURE_TWO_FINGER_TAP