Package | flash.events |
Classe | public class TransformGestureEvent |
Héritage | TransformGestureEvent GestureEvent Event Object |
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Un périphérique ou un système d’exploitation interprète les gestes. Ainsi, différents périphériques ou systèmes d’exploitation ont différentes exigences selon le type de mouvement individuel. Un glissement sur un périphérique peut requérir un mouvement d’entrée différent qu’un glissement sur un autre périphérique. Consultez la documentation du matériel ou du système d’exploitation pour savoir comment le périphérique ou le système d’exploitation interprète le contact comme mouvement spécifique.
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.
Lorsque l’utilisateur est en contact avec le périphérique, les propriétés d’échelle, de rotation et de décalage de l’objet TransformGestureEvent sont les valeurs incrémentielles de l’événement de mouvement précédent. Par exemple, à mesure qu’un mouvement augmente la taille d’un objet d’affichage, les valeurs d’échelle peuvent suivre la séquence 1.03
, 1.01
, 1.01
, 1.02
, qui indique que l’objet d’affichage a été mis à l’échelle à 1.0717 fois sa taille d’origine vers la fin du mouvement.
Pour les objets TransformGestureEvent, les propriétés non modifiées par le mouvement actuel sont définies sur des valeurs d’identité. Par exemple, un panoramique ne présente aucune transformation par rotation ou par mise à l’échelle ; ainsi, la valeur rotation
de l’objet d’événement est 0
, et les propriétés scaleX
et scaleY
ont pour valeur 1
.
Plus d’exemples
Eléments de l’API associés
flash.events.TouchEvent
flash.events.GestureEvent
flash.events.PressAndTapGestureEvent
flash.events.MouseEvent
flash.events.EventDispatcher.addEventListener()
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 | ||
offsetX : Number
Translation horizontale de l’objet d’affichage, depuis l’événement gesture précédent. | TransformGestureEvent | ||
offsetY : Number
Translation verticale de l’objet d’affichage, depuis l’événement gesture précédent. | TransformGestureEvent | ||
phase : String
Valeur de la classe GesturePhase indiquant l’état du mouvement tactile. | GestureEvent | ||
rotation : Number
Angle de rotation actuel de l’objet d’affichage le long de l’axe z depuis l’événement gesture précédent, en degrés. | TransformGestureEvent | ||
scaleX : Number
Echelle horizontale de l’objet d’affichage, depuis l’événement gesture précédent. | TransformGestureEvent | ||
scaleY : Number
Echelle verticale de l’objet d’affichage, depuis l’événement gesture précédent. | TransformGestureEvent | ||
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 | ||
velocity : Number
Vitesse, en pixels par seconde, de l’événement de mouvement de transformation. | TransformGestureEvent |
Méthode | Défini par | ||
---|---|---|---|
TransformGestureEvent(type:String, bubbles:Boolean = true, cancelable:Boolean = false, phase:String = null, localX:Number = 0, localY:Number = 0, scaleX:Number = 1.0, scaleY:Number = 1.0, rotation:Number = 0, offsetX:Number = 0, offsetY:Number = 0, ctrlKey:Boolean = false, altKey:Boolean = false, shiftKey:Boolean = false, commandKey:Boolean = false, controlKey:Boolean = false, velocity:Number = 0)
Crée un objet Event contenant des informations sur des événements tactiles multipoints complexes, notamment lorsqu’un utilisateur fait glisser son doigt sur un écran. | TransformGestureEvent | ||
[override]
Crée une copie de l’objet TransformGestureEvent et définit la valeur de chaque propriété de sorte qu’elle corresponde à la valeur d’origine. | TransformGestureEvent | ||
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 TransformGestureEvent. | TransformGestureEvent | ||
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_DIRECTIONAL_TAP : String = "gestureDirectionalTap" [statique]
Définit la valeur de la propriété type d’un objet d’événement tactile GESTURE_DIRECTIONAL_TAP. | TransformGestureEvent | ||
GESTURE_PAN : String = "gesturePan" [statique]
Définit la valeur de la propriété type d’un objet d’événement tactile GESTURE_PAN. | TransformGestureEvent | ||
GESTURE_ROTATE : String = "gestureRotate" [statique]
Définit la valeur de la propriété type d’un objet d’événement tactile GESTURE_ROTATE. | TransformGestureEvent | ||
GESTURE_SWIPE : String = "gestureSwipe" [statique]
Définit la valeur de la propriété type d’un objet d’événement tactile GESTURE_SWIPE. | TransformGestureEvent | ||
GESTURE_ZOOM : String = "gestureZoom" [statique]
Définit la valeur de la propriété type d’un objet d’événement tactile GESTURE_ZOOM. | TransformGestureEvent |
offsetX | propriété |
offsetX:Number
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Translation horizontale de l’objet d’affichage, depuis l’événement gesture précédent.
Implémentation
public function get offsetX():Number
public function set offsetX(value:Number):void
offsetY | propriété |
offsetY:Number
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Translation verticale de l’objet d’affichage, depuis l’événement gesture précédent.
Implémentation
public function get offsetY():Number
public function set offsetY(value:Number):void
rotation | propriété |
rotation:Number
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Angle de rotation actuel de l’objet d’affichage le long de l’axe z depuis l’événement gesture précédent, en degrés.
Implémentation
public function get rotation():Number
public function set rotation(value:Number):void
scaleX | propriété |
scaleY | propriété |
velocity | propriété |
TransformGestureEvent | () | Constructeur |
public function TransformGestureEvent(type:String, bubbles:Boolean = true, cancelable:Boolean = false, phase:String = null, localX:Number = 0, localY:Number = 0, scaleX:Number = 1.0, scaleY:Number = 1.0, rotation:Number = 0, offsetX:Number = 0, offsetY:Number = 0, ctrlKey:Boolean = false, altKey:Boolean = false, shiftKey:Boolean = false, commandKey:Boolean = false, controlKey:Boolean = false, velocity:Number = 0)
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 des événements tactiles multipoints complexes, notamment lorsqu’un utilisateur fait glisser son doigt sur un écran. Les objets Event sont transmis en tant que paramètres aux écouteurs d’événements.
Paramètrestype:String — Type de l’événement. Les valeurs possibles sont les suivantes : TransformGestureEvent.GESTURE_PAN , TransformGestureEvent.GESTURE_ROTATE , TransformGestureEvent.GESTURE_SWIPE et TransformGestureEvent.GESTURE_ZOOM .
| |
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 ) — Cette valeur contrôle le début, la progression et la fin d’une action tactile. Les valeurs possibles sont les suivantes : GesturePhase.BEGIN , GesturePhase.END et GesturePhase.UPDATE .
| |
localX:Number (default = 0 ) — Coordonnée horizontale à laquelle l’événement s’est produit par rapport à l’objet d’affichage conteneur.
| |
localY:Number (default = 0 ) — Coordonnée verticale à laquelle l’événement s’est produit par rapport à l’objet d’affichage conteneur.
| |
scaleX:Number (default = 1.0 ) — Echelle horizontale de l’objet d’affichage.
| |
scaleY:Number (default = 1.0 ) — Echelle verticale de l’objet d’affichage.
| |
rotation:Number (default = 0 ) — Angle de rotation, en degrés, de l’objet d’affichage le long de l’axe z.
| |
offsetX:Number (default = 0 ) — Translation horizontale de l’objet d’affichage par rapport à sa position d’origine.
| |
offsetY:Number (default = 0 ) — Translation verticale de l’objet d’affichage par rapport à sa position d’origine.
| |
ctrlKey:Boolean (default = false ) — (AIR uniquement) Vitesse du mouvement de transformation en pixels par seconde.
| |
altKey: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.
| |
shiftKey:Boolean (default = false ) — Indique si la touche Alt est activée (Windows ou Linux uniquement).
| |
commandKey:Boolean (default = false ) — Indique si la touche Maj est activée.
| |
controlKey: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.
| |
velocity:Number (default = 0 ) — (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
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 TransformGestureEvent et définit la valeur de chaque propriété de sorte qu’elle corresponde à la valeur d’origine.
Valeur renvoyéeEvent — Nouvel objet TransformGestureEvent 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 TransformGestureEvent. La chaîne est écrite au format suivant :
[TransformGestureEvent type=valeur bubbles=valeur cancelable=valeur ... ]
String — Chaîne répertoriant toutes les propriétés de l’objet TransformGestureEvent.
|
GESTURE_DIRECTIONAL_TAP | Constante |
public static const GESTURE_DIRECTIONAL_TAP:String = "gestureDirectionalTap"
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 24, Flash Lite 4 |
Définit la valeur de la propriété type
d’un objet d’événement tactile GESTURE_DIRECTIONAL_TAP
.
L’objet TransformGestureEvent 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 | true sur le 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 de glissement, cette valeur est toujours all , qui correspond à la valeur GesturePhase.ALL une fois l’événement distribué. |
localX | Coordonnée horizontale à laquelle l’événement s’est produit, par rapport au sprite conteneur. Pour les mouvements d’appui directionnel, cette valeur correspond au centre de l’écran. |
localY | Coordonnée verticale à laquelle l’événement s’est produit, par rapport au sprite conteneur. Pour les mouvements d’appui directionnel, cette valeur correspond au centre de l’écran. |
scaleX | Echelle horizontale de l’objet d’affichage. Pour les mouvements d’appui directionnel, cette valeur est 1 |
scaleY | Echelle verticale de l’objet d’affichage. Pour les mouvements d’appui directionnel, cette valeur est 1 |
rotation | Angle de rotation, en degrés, de l’objet d’affichage le long de l’axe z. Pour les mouvements d’appui directionnel, cette valeur est 0 |
offsetX | Indique la direction horizontale : 1 pour droite et -1 pour gauche. |
offsetY | Indique la direction verticale : 1 pour bas et -1 pour haut. |
vitesse | Indique la vitesse du mouvement de glissement en pixels par seconde (AIR uniquement). |
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_PAN | Constante |
public static const GESTURE_PAN:String = "gesturePan"
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 tactile GESTURE_PAN
.
L’objet TransformGestureEvent 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 | true sur le 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 ; une valeur de la classe GesturePhase. |
localX | Coordonnée horizontale à laquelle l’événement s’est produit par rapport à l’objet d’affichage conteneur. |
localY | Coordonnée verticale à laquelle l’événement s’est produit par rapport à l’objet d’affichage conteneur. |
scaleX | Echelle horizontale de l’objet d’affichage depuis l’événement gesture précédent. Pour les panoramiques, cette valeur est 1 . |
scaleY | Echelle verticale de l’objet d’affichage depuis l’événement gesture précédent. Pour les panoramiques, cette valeur est 1 . |
rotation | Angle de rotation actuel de l’objet d’affichage le long de l’axe z depuis l’événement gesture précédent, en degrés. Pour les panoramiques, cette valeur est 0 . |
offsetX | Translation horizontale de l’objet d’affichage à partir la position de ce dernier lors de l’événement gesture précédent. |
offsetY | Translation verticale de l’objet d’affichage à partir de la position de ce dernier lors de l’événement gesture précédent. |
vitesse | Vitesse de l’événement de mouvement en pixels par seconde (AIR uniquement). Pour le panoramique, cette valeur est 0 |
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
Exemple ( Comment utiliser cet exemple )
GESTURE_PAN
. Lorsque l’utilisateur effectue un mouvement de panoramique sur le périphérique tactile, myTextField se remplit avec la phase actuelle.
Multitouch.inputMode = MultitouchInputMode.GESTURE; var mySprite = new Sprite(); mySprite.addEventListener(TransformGestureEvent.GESTURE_PAN , onPan); mySprite.graphics.beginFill(0x336699); mySprite.graphics.drawRect(0, 0, 100, 80); var myTextField = new TextField(); myTextField.y = 200; addChild(mySprite); addChild(myTextField); function onPan(evt:TransformGestureEvent):void { evt.target.localX++; if (evt.phase==GesturePhase.BEGIN) { myTextField.text = "Begin"; } if (evt.phase==GesturePhase.UPDATE) { myTextField.text = "Update"; } if (evt.phase==GesturePhase.END) { myTextField.text = "End"; } }
GESTURE_ROTATE | Constante |
public static const GESTURE_ROTATE:String = "gestureRotate"
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 tactile GESTURE_ROTATE
.
Lors de cet événement, la propriété rotation
contient l’angle de rotation. Les valeurs de rotation sont les suivantes :
- De 0 à 180 degrés dans le sens des aiguilles d’une montre
- De - 180 à 0 degrés dans le sens inverse des aiguilles d’une montre
L’objet TransformGestureEvent 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 | true sur le 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 ; une valeur de la classe GesturePhase. |
localX | Coordonnée horizontale à laquelle l’événement s’est produit par rapport à l’objet d’affichage conteneur. |
localY | Coordonnée verticale à laquelle l’événement s’est produit par rapport à l’objet d’affichage conteneur. |
scaleX | Echelle horizontale de l’objet d’affichage depuis l’événement gesture précédent. |
scaleY | Echelle verticale de l’objet d’affichage depuis l’événement gesture précédent. |
rotation | Angle de rotation actuel de l’objet d’affichage le long de l’axe z depuis l’événement gesture précédent, en degrés. |
offsetX | Translation horizontale de l’objet d’affichage à partir la position de ce dernier lors de l’événement gesture précédent. |
offsetY | Translation verticale de l’objet d’affichage à partir de la position de ce dernier lors de l’événement gesture précédent. |
vitesse | Vitesse de l’événement de mouvement en pixels par seconde (AIR uniquement). Pour le mouvement de rotation, cette valeur est 0 |
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
Exemple ( Comment utiliser cet exemple )
GESTURE_ROTATE
. Lorsque l’utilisateur effectue un mouvement de rotation sur le périphérique tactile, mySprite pivote et myTextField se remplit avec la phase actuelle.
Multitouch.inputMode = MultitouchInputMode.GESTURE; var mySprite = new Sprite(); mySprite.addEventListener(TransformGestureEvent.GESTURE_ROTATE , onRotate ); mySprite.graphics.beginFill(0x336699); mySprite.graphics.drawRect(0, 0, 100, 80); var myTextField = new TextField(); myTextField.y = 200; addChild(mySprite); addChild(myTextField); function onRotate(evt:TransformGestureEvent):void { evt.target.rotation -= 45; if (evt.phase==GesturePhase.BEGIN) { myTextField.text = "Begin"; } if (evt.phase==GesturePhase.UPDATE) { myTextField.text = "Update"; } if (evt.phase==GesturePhase.END) { myTextField.text = "End"; } }
GESTURE_SWIPE | Constante |
public static const GESTURE_SWIPE:String = "gestureSwipe"
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 tactile GESTURE_SWIPE
.
L’objet TransformGestureEvent 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 | true sur le 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 de glissement, cette valeur est toujours all , qui correspond à la valeur GesturePhase.ALL une fois l’événement distribué. |
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. |
scaleX | Echelle horizontale de l’objet d’affichage. Pour les mouvements de glissement, cette valeur est 1 |
scaleY | Echelle verticale de l’objet d’affichage. Pour les mouvements de glissement, cette valeur est 1 |
rotation | Angle de rotation, en degrés, de l’objet d’affichage le long de l’axe z. Pour les mouvements de glissement, cette valeur est 0 |
offsetX | Indique la direction horizontale : 1 pour droite et -1 pour gauche. |
offsetY | Indique la direction verticale : 1 pour bas et -1 pour haut. |
vitesse | Indique la vitesse du mouvement de glissement en pixels par seconde (AIR uniquement). Pour le reste, cette valeur est 0 |
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
Exemple ( Comment utiliser cet exemple )
GESTURE_SWIPE
. Lorsque l’utilisateur effectue un mouvement de glissement sur le périphérique tactile, myTextField se remplit avec la phase all
(unique phase pour les événements de glissement).
Multitouch.inputMode = MultitouchInputMode.GESTURE; var mySprite = new Sprite(); mySprite.addEventListener(TransformGestureEvent.GESTURE_SWIPE , onSwipe); mySprite.graphics.beginFill(0x336699); mySprite.graphics.drawRect(0, 0, 100, 80); var myTextField = new TextField(); myTextField.y = 200; addChild(mySprite); addChild(myTextField); function onSwipe(evt:TransformGestureEvent):void { if (evt.offsetX == 1 ) { myTextField.text = "right"; } if (evt.offsetY == -1) { myTextField.text = "up"; } myTextField.text = evt.phase; }
GESTURE_ZOOM | Constante |
public static const GESTURE_ZOOM:String = "gestureZoom"
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 tactile GESTURE_ZOOM
.
L’objet TransformGestureEvent 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 | true sur le 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 ; une valeur de la classe GesturePhase. |
localX | Coordonnée horizontale à laquelle l’événement s’est produit par rapport à l’objet d’affichage conteneur. |
localY | Coordonnée verticale à laquelle l’événement s’est produit par rapport à l’objet d’affichage conteneur. |
scaleX | Echelle horizontale de l’objet d’affichage depuis l’événement gesture précédent. |
scaleY | Echelle verticale de l’objet d’affichage depuis l’événement gesture précédent. |
rotation | Angle de rotation actuel de l’objet d’affichage le long de l’axe z depuis l’événement gesture précédent, en degrés. |
offsetX | Translation horizontale de l’objet d’affichage à partir la position de ce dernier lors de l’événement gesture précédent. |
offsetY | Translation verticale de l’objet d’affichage à partir de la position de ce dernier lors de l’événement gesture précédent. |
vitesse | Vitesse de l’événement de mouvement en pixels par seconde (AIR uniquement). Pour le mouvement de zoom, cette valeur est 0 |
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
Exemple ( Comment utiliser cet exemple )
GESTURE_ZOOM
. Lorsque l’utilisateur effectue un mouvement de zoom sur le périphérique tactile, myTextField se remplit avec la phase actuelle.
Multitouch.inputMode = MultitouchInputMode.GESTURE; var mySprite = new Sprite(); mySprite.addEventListener(TransformGestureEvent.GESTURE_ZOOM , onZoom); mySprite.graphics.beginFill(0x336699); mySprite.graphics.drawRect(0, 0, 100, 80); var myTextField = new TextField(); myTextField.y = 200; addChild(mySprite); addChild(myTextField); function onZoom(evt:TransformGestureEvent):void { evt.target.scaleX++; if (evt.phase==GesturePhase.BEGIN) { myTextField.text = "Begin"; } if (evt.phase==GesturePhase.UPDATE) { myTextField.text = "Update"; } if (evt.phase==GesturePhase.END) { myTextField.text = "End"; } }
GESTURE_ROTATE
. Lorsque l’utilisateur effectue un mouvement de rotation sur le périphérique tactile, mySprite pivote et myTextField se remplit avec la phase actuelle.
Multitouch.inputMode = MultitouchInputMode.GESTURE; var mySprite = new Sprite(); mySprite.addEventListener(TransformGestureEvent.GESTURE_ROTATE , onRotate ); mySprite.graphics.beginFill(0x336699); mySprite.graphics.drawRect(0, 0, 100, 80); var myTextField = new TextField(); myTextField.y = 200; addChild(mySprite); addChild(myTextField); function onRotate(evt:TransformGestureEvent):void { evt.target.rotation -= 45; if (evt.phase==GesturePhase.BEGIN) { myTextField.text = "Begin"; } if (evt.phase==GesturePhase.UPDATE) { myTextField.text = "Update"; } if (evt.phase==GesturePhase.END) { myTextField.text = "End"; } }
package { import flash.display.Bitmap; import flash.display.Sprite; import flash.events.TransformGestureEvent; import flash.text.TextField; import flash.text.TextFormat; import flash.ui.Multitouch; import flash.ui.MultitouchInputMode; [SWF(width=320, height=460, frameRate=24, backgroundColor=0x000000)] public class TransformGestureExample2 extends Sprite { [Embed(source="african_elephant.jpg")] public var ElephantImage:Class; public var scaleDebug:TextField; public var rotateDebug:TextField; public function TransformGestureExample2() { // Debug var tf:TextFormat = new TextFormat(); tf.color = 0xffffff; tf.font = "Helvetica"; tf.size = 11; this.scaleDebug = new TextField(); this.scaleDebug.width = 310; this.scaleDebug.defaultTextFormat = tf; this.scaleDebug.x = 2; this.scaleDebug.y = 2; this.stage.addChild(this.scaleDebug); this.rotateDebug = new TextField(); this.rotateDebug.width = 310; this.rotateDebug.defaultTextFormat = tf; this.rotateDebug.x = 2; this.rotateDebug.y = 15; this.stage.addChild(this.rotateDebug); var elephantBitmap:Bitmap = new ElephantImage(); var elephant:Sprite = new Sprite(); elephant.addChild(elephantBitmap); elephant.x = 160; elephant.y = 230; elephantBitmap.x = (300 - (elephantBitmap.bitmapData.width / 2)) * -1; elephantBitmap.y = (400 - (elephantBitmap.bitmapData.height / 2)) *-1; this.addChild(elephant); Multitouch.inputMode = MultitouchInputMode.GESTURE; elephant.addEventListener(TransformGestureEvent.GESTURE_ZOOM, onZoom); elephant.addEventListener(TransformGestureEvent.GESTURE_ROTATE, onRotate); } private function onZoom(e:TransformGestureEvent):void { this.scaleDebug.text = (e.scaleX + ", " + e.scaleY); var elephant:Sprite = e.target as Sprite; elephant.scaleX *= e.scaleX; elephant.scaleY *= e.scaleY; } private function onRotate(e:TransformGestureEvent):void { var elephant:Sprite = e.target as Sprite; this.rotateDebug.text = String(e.rotation); elephant.rotation += e.rotation; } } }
Tue Jun 12 2018, 09:30 AM Z