| 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 |
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.
Plus d’exemples
Eléments de l’API associés
flash.events.TouchEvent
flash.events.TransformGestureEvent
flash.events.PressAndTapGestureEvent
flash.events.MouseEvent
flash.events.EventDispatcher.addEventListener()
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é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 | ||
[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 | ||
|
Fonction d’un utilitaire permettant d’implémenter la méthode toString() dans des classes Event ActionScript 3.0 personnalisées. | Event | |
|
Indique si la propriété spécifiée d’un objet est définie. | Object | |
|
Vérifie si la méthode preventDefault() a été appelée pour l’événement. | Event | |
|
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 | |
|
Annule le comportement par défaut d’un événement si cette opération est possible. | Event | |
|
Indique si la propriété spécifiée existe et est énumérable. | Object | |
|
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | |
|
Bloque le traitement des écouteurs d’événement dans le nœud actuel et les suivants dans le flux d’événements. | Event | |
|
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 | |
|
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur. | Object | |
[override]
Renvoie une chaîne répertoriant toutes les propriétés de l’objet GestureEvent. | GestureEvent | ||
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 | ||
|
Renvoie la valeur primitive de l’objet spécifié. | Object | |
| 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 | ||
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):voidcontrolKey | 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):voidctrlKey | 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):voidlocalX | 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):voidlocalY | 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):voidphase | 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):voidEléments de l’API associés
shiftKey | propriété |
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():NumberstageY | 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():NumberGestureEvent | () | 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ètrestype:String — Type de l’événement. La valeur prise en charge est la suivante : GestureEvent.GESTURE_TWO_FINGER_TAP.
| |
bubbles:Boolean (default = true) | |
cancelable:Boolean (default = false) | |
phase:String (default = null) | |
localX:Number (default = 0) | |
localY:Number (default = 0) | |
ctrlKey:Boolean (default = false) | |
altKey:Boolean (default = false) | |
shiftKey:Boolean (default = false) | |
commandKey:Boolean (default = false) | |
controlKey:Boolean (default = false) |
Eléments de l’API associés
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éeEvent — 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 ... ]
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.
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
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"
}
Tue Jun 12 2018, 09:30 AM Z