| Package | flash.display |
| Classe | public class InteractiveObject |
| Héritage | InteractiveObject  DisplayObject EventDispatcher Object |
| Sous-classes | DisplayObjectContainer, SimpleButton, TextField |
| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Il est impossible d’instancier directement la classe InteractiveObject. Tout appel au constructeur new InteractiveObject() renvoie une exception ArgumentError.
La classe InteractiveObject n’inclut pas d’API pour le rendu de contenu à l’écran. Pour créer une sous-classe personnalisée de la classe InteractiveObject, étendez l’une des sous-classes disposant d’API pour le rendu du contenu à l’écran, telles que Sprite, SimpleButton, TextField ou MovieClip.
Informations complémentaires
Concepts fondamentaux de la programmation de l’affichage
Classes d’affichage de base
Masquer les propriétés publiques héritées
Afficher les propriétés publiques héritées| Propriété | Défini par | ||
|---|---|---|---|
| accessibilityImplementation : AccessibilityImplementation
Implémentation d’accessibilité (AccessibilityImplementation) actuelle pour cette occurrence d’InteractiveObject. | InteractiveObject | ||
 | accessibilityProperties : AccessibilityProperties
Options d’accessibilité actuelles de l’objet d’affichage. | DisplayObject | |
| alpha : Number
Indique la valeur de transparence alpha de l’objet spécifié. | DisplayObject | |
| blendMode : String
Valeur de la classe BlendMode qui spécifie le mode de fusion à utiliser. | DisplayObject | |
| blendShader : Shader [écriture seule]
Définit un shader utilisé pour la fusion de l’arrière-plan et du premier plan. | DisplayObject | |
| cacheAsBitmap : Boolean
Si la valeur true est définie, les moteurs d’exécution de Flash placent en mémoire cache une version bitmap interne de l’objet d’affichage. | DisplayObject | |
| cacheAsBitmapMatrix : Matrix
S’il n’est pas nul, cet objet Matrix définit le mode de rendu d’un objet d’affichage lorsque cacheAsBitmap est définie sur true. | DisplayObject | |
| constructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet. | Object | |
| contextMenu : NativeMenu
Spécifie le menu contextuel associé à l’objet. | InteractiveObject | ||
| doubleClickEnabled : Boolean
Spécifie si l’objet reçoit les événements doubleClick. | InteractiveObject | ||
| filters : Array
Tableau indexé contenant tous les objets filtre actuellement associés à l’objet d’affichage. | DisplayObject | |
| focusRect : Object
Spécifie si l’objet affiche un rectangle de focus. | InteractiveObject | ||
| height : Number
Indique la hauteur de l’objet d’affichage, en pixels. | DisplayObject | |
| loaderInfo : LoaderInfo [lecture seule]
Renvoie un objet LoaderInfo qui contient des informations relatives au chargement du fichier auquel appartient cet objet d’affichage. | DisplayObject | |
| mask : DisplayObject
L’objet d’affichage appelant est masqué par l’objet mask spécifié. | DisplayObject | |
| metaData : Object
Obtient les données d’objet de métadonnées de l’occurrence DisplayObject si les données d’meta a été stockée près de la l’occurrence de cette DisplayObject dans le fichier SWF à l’aide d’une balise de4 PlaceObject. | DisplayObject | |
| mouseEnabled : Boolean
Spécifie si l’objet reçoit des messages de la souris ou d’un autre périphérique de saisie utilisateur. | InteractiveObject | ||
| mouseX : Number [lecture seule]
Indique la coordonnée x de la souris ou ou la position du périphérique de saisie utilisateur, en pixels. | DisplayObject | |
| mouseY : Number [lecture seule]
Indique la coordonnée y de la souris ou la position du périphérique de saisie utilisateur, en pixels. | DisplayObject | |
| name : String
Indique le nom d’occurrence de DisplayObject. | DisplayObject | |
| needsSoftKeyboard : Boolean
Indique si un clavier virtuel (clavier logiciel à l’écran) doit s’afficher lorsque cette occurrence d’InteractiveObject reçoit le focus. | InteractiveObject | ||
| opaqueBackground : Object
Indique si l’objet d’affichage est opaque avec une couleur d’arrière-plan spécifique. | DisplayObject | |
| parent : DisplayObjectContainer [lecture seule]
Indique l’objet DisplayObjectContainer qui contient l’objet d’affichage. | DisplayObject | |
| root : DisplayObject [lecture seule]
Pour un objet d’affichage résidant dans un fichier SWF chargé, la propriété root correspond à l’objet d’affichage de premier niveau dans la partie de la structure arborescente de la liste d’affichage représentée par ce fichier. | DisplayObject | |
| rotation : Number
Indique la rotation de l’occurrence de DisplayObject, en degrés, à partir de son orientation d’origine. | DisplayObject | |
| rotationX : Number
Indique la rotation de l’axe des x de l’occurrence DisplayObject, en degrés, à partir de son orientation d’origine par rapport au conteneur 3D parent. | DisplayObject | |
| rotationY : Number
Indique la rotation de l’axe des y de l’occurrence DisplayObject, en degrés, à partir de son orientation d’origine par rapport au conteneur 3D parent. | DisplayObject | |
| rotationZ : Number
Indique la rotation de l’axe des z de l’occurrence DisplayObject, en degrés, à partir de son orientation d’origine par rapport au conteneur 3D parent. | DisplayObject | |
| scale9Grid : Rectangle
Grille de mise à l’échelle en vigueur. | DisplayObject | |
| scaleX : Number
Indique l’échelle horizontale (pourcentage) de l’objet telle qu’elle est appliquée à partir du point d’alignement. | DisplayObject | |
| scaleY : Number
Indique l’échelle verticale (pourcentage) de l’objet telle qu’elle est appliquée à partir du point d’alignement. | DisplayObject | |
| scaleZ : Number
Indique l’échelle de profondeur (pourcentage) de l’objet tel qu’elle est appliquée à partir du point d’alignement. | DisplayObject | |
| scrollRect : Rectangle
Cadre de sélection du défilement de l’objet d’affichage. | DisplayObject | |
| softKeyboard : String
Contrôle l’aspect du clavier logiciel. | InteractiveObject | ||
| softKeyboardInputAreaOfInterest : Rectangle
Définit la zone qui doit rester à l’écran lorsqu’un clavier logiciel s’affiche (non disponible sur iOS) | InteractiveObject | ||
| stage : Stage [lecture seule]
Scène de l’objet d’affichage. | DisplayObject | |
| tabEnabled : Boolean
Indique si cet objet est spécifié dans l’ordre de tabulation. | InteractiveObject | ||
| tabIndex : int
Spécifie l’ordre de tabulation des objets dans un fichier SWF. | InteractiveObject | ||
| transform : flash.geom:Transform
Objet dont les propriétés se rapportent à la matrice, à la transformation des couleurs et aux limites des pixels d’un objet d’affichage. | DisplayObject | |
| visible : Boolean
Indique si l’objet d’affichage est visible ou non. | DisplayObject | |
| width : Number
Indique la largeur de l’objet d’affichage, en pixels. | DisplayObject | |
| x : Number
Indique la coordonnée x de l’occurrence de DisplayObject par rapport aux coordonnées locales de l’objet DisplayObjectContainer parent. | DisplayObject | |
| y : Number
Indique la coordonnée y de l’occurrence de DisplayObject par rapport aux coordonnées locales de l’objet DisplayObjectContainer parent. | DisplayObject | |
| z : Number
Indique la position de coordonnée z le long de l’axe des z de l’occurrence DisplayObject par rapport au conteneur 3D parent. | DisplayObject | |
| Méthode | Défini par | ||
|---|---|---|---|
L’appel du constructeur InteractiveObject() renvoie une exception ArgumentError. | InteractiveObject | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Enregistre un objet écouteur d’événement auprès d’un objet EventDispatcher afin que l’écouteur soit averti d’un événement. | EventDispatcher | |
|
Distribue un événement dans le flux d’événements. | EventDispatcher | |
|
Renvoie un rectangle qui définit la zone de l’objet d’affichage relativement au système de coordonnées de l’objet targetCoordinateSpace. | DisplayObject | |
|
Renvoie un rectangle qui définit les limites de l’objet d’affichage, en se basant sur le système de coordonnées défini par le paramètre targetCoordinateSpace, moins tout trait appliqué aux formes. | DisplayObject | |
|
Convertit l’objet point des coordonnées de scène (globales) vers les coordonnées de l’objet d’affichage (locales). | DisplayObject | |
|
Convertit un point bidimensionnel à partir des coordonnées de scène (globales) vers les coordonnées d’un objet d’affichage tridimensionnel (locales). | DisplayObject | |
|
Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement. | EventDispatcher | |
|
Indique si la propriété spécifiée d’un objet est définie. | Object | |
|
Evalue le cadre de sélection de l’objet d’affichage pour savoir s’il recouvre ou recoupe le cadre de sélection de l’objet d’affichage obj. | DisplayObject | |
|
Evalue l’objet d’affichage pour savoir s’il recouvre ou recoupe le point spécifié par les paramètres x et y. | DisplayObject | |
|
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 | |
|
Convertit un point tridimensionnel des coordonnées de l’objet d’affichage tridimensionnel (locales) vers un point bidimensionnel dans les coordonnées de scène (globales). | DisplayObject | |
|
Convertit l’objet point des coordonnées de l’objet d’affichage (locales) vers les coordonnées de la scène (globales). | DisplayObject | |
|
Indique si la propriété spécifiée existe et est énumérable. | Object | |
|
Supprime un écouteur de l’objet EventDispatcher. | EventDispatcher | |
Affiche un clavier virtuel. | InteractiveObject | ||
|
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | |
|
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur. | Object | |
|
Renvoie la représentation sous forme de chaîne de l’objet spécifié. | Object | |
|
Renvoie la valeur primitive de l’objet spécifié. | Object | |
|
Vérifie si un écouteur d’événement est enregistré auprès de cet objet EventDispatcher ou de ses ancêtres pour le type d’événement spécifié. | EventDispatcher | |
| Evénement | Synthèse | Défini par | ||
|---|---|---|---|---|
| [Evénement de diffusion] Distribué lorsque l’application Flash Player obtient le focus du système d’exploitation et devient active. | EventDispatcher | ||
| Distribué lorsqu’un objet d’affichage est ajouté à la liste d’affichage. | DisplayObject | ||
| Envoyé lorsqu’un objet d’affichage est ajouté dans la liste d’affichage de la scène, directement ou par l’intermédiaire d’une arborescence secondaire qui contient l’objet d’affichage. | DisplayObject | ||
| Distribué lorsque l’utilisateur sélectionne ’Effacer’ (ou ’Supprimer’) dans le menu contextuel. | InteractiveObject | |||
| Distribué lorsque l’utilisateur appuie sur le bouton principal de son périphérique de pointage et le relâche sur la même occurrence de InteractiveObject. | InteractiveObject | |||
| Distribué lorsque l’action d’un utilisateur active le menu contextuel associé à cet objet interactif dans une application AIR. | InteractiveObject | |||
| Distribué lorsque l’utilisateur active la combinaison de touches de raccourci propre à la plate-forme pour une opération de copie ou sélectionne "Copier" dans le menu contextuel. | InteractiveObject | |||
| Distribué lorsque l’utilisateur active la combinaison de touches de raccourci propre à la plate-forme pour une opération de coupage ou sélectionne "Couper" dans le menu contextuel. | InteractiveObject | |||
| [Evénement de diffusion] Distribué lorsque l’application Flash Player ou AIR perd le focus du système d’exploitation et devient inactive. | EventDispatcher | ||
| Distribué lorsque l’utilisateur appuie sur le bouton principal d’un périphérique de pointage et le relâche deux fois de suite sur la même occurrence d’InteractiveObject si l’indicateur doubleClickEnabled de cet objet est réglé sur true. | InteractiveObject | |||
| [événement de diffusion] Distribué lorsque la tête de lecture est placée sur une nouvelle image. | DisplayObject | ||
| [événement de diffusion] Distribué lorsque la tête de lecture quitte l’image en cours. | DisplayObject | ||
| Distribué après la prise de focus par un objet d’affichage. | InteractiveObject | |||
| Distribué après la perte de focus par un objet d’affichage. | InteractiveObject | |||
| [événement de diffusion] Distribué après l’exécution des constructeurs des objets d’affichage d’image, mais avant celle des scripts d’image. | DisplayObject | ||
| Distribué lorsque l’utilisateur crée un point de contact le long du bord de la surface tactile à l’aide d’une occurrence InteractiveObject (par exemple, en appuyant le long du bord de la surface tactile sur la télécommande Siri Remote pour l’Apple TV). Certains périphériques peuvent également interpréter ce contact comme une combinaison de plusieurs événements tactiles. | InteractiveObject | |||
| Distribué lorsque l’utilisateur appuie sur deux points de contact sur la même occurrence d’InteractiveObject sur un périphérique tactile (notamment lorsque l’utilisateur appuie avec deux doigts sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile, puis les retire). | InteractiveObject | |||
| Distribué lorsque l’utilisateur déplace un point de contact sur l’occurrence d’InteractiveObject d’un périphérique tactile (notamment lorsqu’il déplace un doigt de gauche à droite sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile). | InteractiveObject | |||
| Distribué lorsque l’utilisateur effectue un mouvement de rotation sur un point de contact à l’aide d’une occurrence d’InteractiveObject (par exemple, lorsqu’il pose deux doigts sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile, puis les fait pivoter). | InteractiveObject | |||
| Distribué lorsque l’utilisateur effectue un mouvement de glissement sur un point de contact à l’aide d’une occurrence d’InteractiveObject (par exemple, lorsqu’il pose trois doigts puis les déplace parallèlement sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile). | InteractiveObject | |||
| Distribué lorsque l’utilisateur crée un point de contact à l’aide d’une occurrence d’InteractiveObject, puis appuie brièvement sur un périphérique tactile (notamment lorsqu’il place plusieurs doigts sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile pour ouvrir un menu, puis appuie brièvement avec un doigt pour sélectionner une option de menu). | InteractiveObject | |||
| Distribué lorsque l’utilisateur effectue un mouvement de zoom sur un point de contact à l’aide d’une occurrence d’InteractiveObject (par exemple, lorsqu’il pose deux doigts, puis les écarte rapidement sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile). | InteractiveObject | |||
| Cet événement est distribué à une application cliente prenant en charge la saisie en ligne avec un éditeur IME. | InteractiveObject | |||
| Distribué lorsque l’utilisateur appuie sur une touche. | InteractiveObject | |||
| Distribué lorsque l’utilisateur tente de déplacer le focus à l’aide du clavier. | InteractiveObject | |||
| Distribué lorsque l’utilisateur relâche une touche. | InteractiveObject | |||
| Distribué lorsque l’utilisateur appuie sur le bouton central de son périphérique de pointage et le relâche sur la même occurrence de InteractiveObject. | InteractiveObject | |||
| Distribué lorsqu’un utilisateur appuie sur le bouton du périphérique de pointage central sur une occurrence InteractiveObject. | InteractiveObject | |||
| Distribué lorsqu’un utilisateur relâche le bouton du périphérique de pointage sur une occurrence InteractiveObject. | InteractiveObject | |||
| Distribué lorsqu’un utilisateur appuie sur le bouton du périphérique de pointage sur une occurrence InteractiveObject. | InteractiveObject | |||
| Distribué lorsque l’utilisateur tente de déplacer le focus à l’aide d’un périphérique de pointage. | InteractiveObject | |||
| Distribué lorsque l’utilisateur déplace le périphérique de pointage placé sur une occurrence de InteractiveObject. | InteractiveObject | |||
| Distribué lorsque l’utilisateur éloigne un périphérique de pointage d’une occurrence de InteractiveObject. | InteractiveObject | |||
| Distribué lorsque l’utilisateur place un périphérique de pointage sur une occurrence de InteractiveObject. | InteractiveObject | |||
| Distribué lorsqu’un utilisateur relâche le bouton du périphérique de pointage sur une occurrence InteractiveObject. | InteractiveObject | |||
| Distribué lorsque la molette d’une souris est actionnée sur une occurrence de InteractiveObject. | InteractiveObject | |||
| Distribué par l’initiateur glisser InteractiveObject lorsque l’utilisateur arrête l’opération glisser. | InteractiveObject | |||
| Distribué par l’objet InteractiveObject cible lorsqu’un objet glissé est déposé dessus et que l’opération déposer a été acceptée avec un appel à DragManager.acceptDragDrop(). | InteractiveObject | |||
| Distribué par un InteractiveObject lorsqu’une opération glisser entre dans ses limites. | InteractiveObject | |||
| Distribué par un InteractiveObject lorsqu’une opération glisser sort des limites. | InteractiveObject | |||
| Distribué par un objet InteractiveObject de façon continue lorsqu’une opération glisser reste dans ses limites. | InteractiveObject | |||
| Distribué au début d’une opération glisser par l’objet InteractiveObject spécifié comme initiateur de l’action glisser dans l’appel DragManager.doDrag(). | InteractiveObject | |||
| Distribué lors d’une opération glisser par l’objet InteractiveObject spécifié comme initiateur de l’action glisser dans l’appel DragManager.doDrag(). | InteractiveObject | |||
| Distribué lorsque l’utilisateur active la combinaison de touches de raccourci propre à la plate-forme pour une opération de collage ou sélectionne "Coller" dans le menu contextuel. | InteractiveObject | |||
| Distribué lorsque l’utilisateur approche un stylet actif de l’écran après le seuil de détection de proximité de l’écran. | InteractiveObject | |||
| Distribué lorsque l’utilisateur soulève un stylet actif au-dessus du seuil de détection de proximité de l’écran. | InteractiveObject | |||
| Distribué lorsque l’utilisateur déplace un stylet actif sur l’écran tout en respectant le seuil de détection de proximité. | InteractiveObject | |||
| Distribué lorsque l’utilisateur déplace un stylet actif en dehors de cet objet InteractiveObject, tout en respectant le seuil de détection de proximité de l’écran. | InteractiveObject | |||
| Distribué lorsque l’utilisateur déplace un stylet actif directement au-dessus de cet objet InteractiveObject, tout en respectant le seuil de détection de proximité de l’écran. | InteractiveObject | |||
| Distribué lorsque l’utilisateur déplace un stylet actif hors de cet objet InteractiveObject et de l’un de ses enfants, tout en respectant le seuil de détection de proximité de l’écran. | InteractiveObject | |||
| Distribué lorsque l’utilisateur déplace un stylet actif sur cet objet InteractiveObject de l’extérieur de l’arborescence d’objets de descendants dans la liste d’affichage (tout en respectant le seuil de détection de proximité de l’écran). | InteractiveObject | |||
| Distribué lorsqu’un utilisateur relâche le bouton du périphérique de pointage après avoir appuyé sur le bouton sur une occurrence d’InteractiveObject, puis après avoir déplacé le périphérique de pointage hors de l’occurrence d’InteractiveObject. | InteractiveObject | |||
| Distribué lorsqu’un objet d’affichage est sur le point d’être supprimé de la liste d’affichage. | DisplayObject | ||
| Distribué lorsqu’un objet d’affichage est sur le point d’être supprimé de la liste d’affichage de la scène, directement ou par l’intermédiaire de la suppression d’une arborescence secondaire qui contient l’objet d’affichage. | DisplayObject | ||
| [événement de diffusion] Distribué lorsque la liste d’affichage est sur le point d’être mise à jour et restituée. | DisplayObject | ||
| Distribué lorsque l’utilisateur appuie sur le bouton droit de son périphérique de pointage et le relâche sur la même occurrence de InteractiveObject. | InteractiveObject | |||
| Distribué lorsqu’un utilisateur appuie sur le bouton du périphérique de pointage sur une occurrence InteractiveObject. | InteractiveObject | |||
| Distribué lorsqu’un utilisateur relâche le bouton du périphérique de pointage sur une occurrence InteractiveObject. | InteractiveObject | |||
| Distribué lorsque l’utilisateur éloigne un périphérique de pointage d’une occurrence de InteractiveObject. | InteractiveObject | |||
| Distribué lorsque l’utilisateur place un périphérique de pointage sur une occurrence de InteractiveObject. | InteractiveObject | |||
| Distribué lorsque l’utilisateur active la combinaison de touches de raccourci propre à la plate-forme pour tout sélectionner ou choisit "Sélectionner tout" dans le menu contextuel. | InteractiveObject | |||
| Distribué immédiatement après l’affichage du clavier logiciel. | InteractiveObject | |||
| Distribué immédiatement avant l’affichage du clavier logiciel. | InteractiveObject | |||
| Distribué immédiatement après la disparition du clavier logiciel. | InteractiveObject | |||
| Distribué lorsque la valeur de l’indicateur tabChildren de l’objet change. | InteractiveObject | |||
| Distribué lorsque l’indicateur tabEnabled de l’objet change. | InteractiveObject | |||
| Distribué lorsque la valeur de la propriété tabIndex de l’objet change. | InteractiveObject | |||
| Distribué lorsqu’un utilisateur entre un ou plusieurs caractères de texte. | InteractiveObject | |||
| Distribué lorsque l’utilisateur touche pour la première fois un périphérique tactile (notamment lorsqu’il pose un doigt sur un téléphone portable ou une tablette munis d’un écran tactile). | InteractiveObject | |||
| Distribué lorsque l’utilisateur cesse le contact avec un périphérique tactile (notamment lorsqu’il retire le doigt d’un téléphone portable ou d’une tablette munis d’un écran tactile). | InteractiveObject | |||
| Distribué lorsque l’utilisateur appuie sur le périphérique, et est continuellement distribué jusqu’au retrait du point de contact. | InteractiveObject | |||
| Distribué lorsque l’utilisateur retire le point de contact d’une occurrence d’InteractiveObject sur un périphérique tactile (notamment lorsqu’il fait glisser un doigt d’un objet d’affichage vers un autre sur un téléphone portable ou une tablette munis d’un écran tactile). | InteractiveObject | |||
| Distribué lorsque l’utilisateur déplace le point de contact sur une occurrence d’InteractiveObject sur un périphérique tactile (notamment lorsqu’il fait glisser un doigt d’un point se trouvant en dehors d’un objet d’affichage vers un point sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile). | InteractiveObject | |||
| Distribué lorsque l’utilisateur retire le point de contact d’une occurrence d’InteractiveObject sur un périphérique tactile (notamment lorsqu’il fait glisser un doigt d’un se trouvant sur l’objet d’affichage d’un téléphone portable ou une tablette munis d’un écran tactile vers un point se trouvant en dehors de cet objet). | InteractiveObject | |||
| Distribué lorsque l’utilisateur déplace le point de contact sur une occurrence d’InteractiveObject sur un périphérique tactile (notamment lorsqu’il fait glisser un doigt d’un point se trouvant en dehors d’un objet d’affichage vers un point sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile). | InteractiveObject | |||
| Distribué lorsque l’utilisateur lève le point de contact sur la même occurrence d’InteractiveObject sur laquelle le contact a été lancé sur un périphérique tactile (notamment lorsqu’il appuie avec un doigt à partir d’un point de contact unique sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile, puis le retire). | InteractiveObject | |||
accessibilityImplementation | propriété |
accessibilityImplementation:AccessibilityImplementation| Version du langage: | ActionScript 3.0 |
Implémentation d’accessibilité (AccessibilityImplementation) actuelle pour cette occurrence d’InteractiveObject.
Implémentation
public function get accessibilityImplementation():AccessibilityImplementation public function set accessibilityImplementation(value:AccessibilityImplementation):voidEléments de l’API associés
contextMenu | propriété |
contextMenu:NativeMenu| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Spécifie le menu contextuel associé à l’objet.
Pour le contenu s’exécutant dans Flash Player, cette propriété est un objet ContextMenu. Dans le moteur d’exécution AIR, la classe ContextMenu étend la classe NativeMenu, mais Flash Player prend en charge la classe ContextMenu uniquement, pas la classe NativeMenu.
Remarque : les objets TextField incluent toujours un menu du Presse-papiers dans le menu contextuel. Le menu du Presse-papiers comporte les commandes Couper, Copier, Coller, Effacer et Sélectionner tout. Vous ne pouvez pas supprimer ces commandes du menu contextuel pour les objets TextField. Pour les objets TextField, la sélection de ces commandes (ou leurs équivalents clavier) ne génère pas d’événement clear, copy, cut, paste ou selectAll.
Implémentation
public function get contextMenu():NativeMenu public function set contextMenu(value:NativeMenu):voidExemple ( Comment utiliser cet exemple )
var red_cmi:ContextMenuItem = new ContextMenuItem("red");
red_cmi.addEventListener(ContextMenuEvent.MENU_ITEM_SELECT, cmi_menuItemSelect);
var cm:ContextMenu = new ContextMenu();
cm.customItems.push(red_cmi);
cm.hideBuiltInItems();
var spr:Sprite = new Sprite();
spr.contextMenu = cm;
spr.graphics.beginFill(0x000000);
spr.graphics.drawRect(0, 0, 120, 90);
spr.graphics.endFill();
spr.x = 10;
spr.y = 10;
addChild(spr);
function cmi_menuItemSelect(evt:ContextMenuEvent):void {
spr.graphics.clear();
spr.graphics.beginFill(0xFF0000);
spr.graphics.drawRect(0, 0, 120, 90);
spr.graphics.endFill();
}
doubleClickEnabled | propriété |
doubleClickEnabled:Boolean| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, Flash Player 9 |
Spécifie si l’objet reçoit les événements doubleClick. La valeur par défaut est false, ce qui signifie que, par défaut, une occurrence d’InteractiveObject ne reçoit pas les événements doubleClick. Si la propriété doubleClickEnabled est réglée sur true, l’occurrence reçoit les événements doubleClick qui la concernent. La propriété mouseEnabled de l’occurrence d’InteractiveObject doit également être réglée sur true pour que l’objet reçoive les événements doubleClick.
Définir cette propriété ne distribue aucun événement. Vous devez utiliser la méthode addEventListener() pour ajouter un écouteur d’événement à l’événement doubleClick.
Implémentation
public function get doubleClickEnabled():Boolean public function set doubleClickEnabled(value:Boolean):voidEléments de l’API associés
focusRect | propriété |
focusRect:Object| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Spécifie si l’objet affiche un rectangle de focus. Trois valeurs sont possibles : true, false ou null. Les valeurs true et false fonctionnent comme prévu, c’est-à-dire indiquent si le rectangle du focus s’affiche. La valeur null indique que cet objet dépend de la propriété stageFocusRect de la scène.
Implémentation
public function get focusRect():Object public function set focusRect(value:Object):voidmouseEnabled | propriété |
mouseEnabled:Boolean| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Spécifie si l’objet reçoit des messages de la souris ou d’un autre périphérique de saisie utilisateur. La valeur par défaut est true, ce qui signifie que, par défaut, toute occurrence d’InteractiveObject figurant dans la liste d’affichage reçoit des événements de souris ou d’autres événements de saisie utilisateur. Si la propriété mouseEnabled est définie sur false, l’occurrence ne reçoit aucun événement de souris (ni aucun autre événement de saisie utilisateur, tel qu’un événement de clavier). Aucun enfant de cette occurrence figurant dans la liste d’affichage n’est affecté. Pour modifier le comportement mouseEnabled de tous les enfants d’un objet figurant dans la liste d’affichage, utilisez flash.display.DisplayObjectContainer.mouseChildren.
Définir cette propriété ne distribue aucun événement. La méthode addEventListener() vous permet de créer une fonctionnalité interactive.
Implémentation
public function get mouseEnabled():Boolean public function set mouseEnabled(value:Boolean):voidEléments de l’API associés
needsSoftKeyboard | propriété |
needsSoftKeyboard:Boolean| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10.2, AIR 2.6 |
Indique si un clavier virtuel (clavier logiciel à l’écran) doit s’afficher lorsque cette occurrence d’InteractiveObject reçoit le focus.
Par défaut, cette valeur est définie sur false ; placer le focus sur une occurrence d’InteractiveObject n’affiche pas de clavier logiciel. Si la propriété needsSoftKeyboard est définie sur true, le moteur d’exécution affiche un clavier logiciel lorsque l’occurrence d’InteractiveObject est prête à prendre en charge la saisie utilisateur. Une occurrence d’InteractiveObject est prête à prendre en charge la saisie utilisateur après un appel par programmation visant à définir la propriété focus de la scène ou une interaction utilisateur, telle qu’un appui bref. Si le système client dispose d’un clavier matériel ou ne prend pas en charge les claviers virtuels, le clavier logiciel n’apparaît pas.
L’occurrence d’InteractiveObject distribue les événements softKeyboardActivating, softKeyboardActivate et softKeyboardDeactivate lorsque le clavier logiciel apparaît ou disparaît.
Remarque : cette propriété n’est pas prise en charge dans les applications AIR sous iOS.
Implémentation
public function get needsSoftKeyboard():Boolean public function set needsSoftKeyboard(value:Boolean):voidEléments de l’API associés
softKeyboard | propriété |
softKeyboard:String| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 21.0 |
Contrôle l’aspect du clavier logiciel.
Les périphériques disposant de claviers logiciels peuvent personnaliser les touches du clavier afin de répondre au type d’entrée prévu. Par exemple, si une entrée numérique est attendue, un périphérique peut utiliser SoftKeyboardType.NUMBER pour afficher uniquement des chiffres sur le clavier logiciel. Les valeurs valides sont définies comme constantes dans la classe SoftKeyboardType.
- "default"
- "punctuation"
- "url"
- "nombre"
- "contact"
- "e-mail"
- "phone"
- "decimalpad"
Ces valeurs sont utilisées comme conseils pour aider un périphérique à afficher le clavier le mieux adapté à l’opération en cours.
La valeur par défaut est SoftKeyboardType.DEFAULT.
Implémentation
public function get softKeyboard():String public function set softKeyboard(value:String):voidValeur émise
ArgumentError — Si la propriété est définie sur une valeur n’appartenant pas à SoftKeyboardType
|
Eléments de l’API associés
softKeyboardInputAreaOfInterest | propriété |
softKeyboardInputAreaOfInterest:Rectangle| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10.2, AIR 2.6 |
Définit la zone qui doit rester à l’écran lorsqu’un clavier logiciel s’affiche (non disponible sur iOS)
Si la propriété needsSoftKeyboard de cet objet InteractiveObject est définie sur true, le moteur d’exécution ajuste l’affichage en conséquence pour conserver l’objet en vue lorsque l’utilisateur effectue une saisie. En règle générale, le moteur d’exécution utilise les limites de l’objet obtenues à partir de la méthode DisplayObject.getBounds(). Vous pouvez spécifier une autre zone à l’aide de cette propriété softKeyboardInputAreaOfInterest.
Spécifiez la propriété softKeyboardInputAreaOfInterest dans les coordonnées de la scène.
Remarque : sous Android, la propriété softKeyboardInputAreaOfInterest n’est pas respectée en mode paysage.
Remarque : softKeyboardInputAreaOfInterest n’est pas pris en charge sur iOS.
Implémentation
public function get softKeyboardInputAreaOfInterest():Rectangle public function set softKeyboardInputAreaOfInterest(value:Rectangle):voidEléments de l’API associés
tabEnabled | propriété |
tabEnabled:Boolean| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, Flash Player 9 |
Indique si cet objet est spécifié dans l’ordre de tabulation. Lorsque cet objet figure dans l’ordre de tabulation, la valeur est true. Sinon, elle est false. La valeur par défaut est false, sauf pour les éléments suivants :
- Pour un objet SimpleButton, la valeur est
true. - Pour un objet TextField avec
type = "input", la valeur esttrue. - Pour un objet Sprite ou MovieClip avec
buttonMode = true, la valeurtrue.
Implémentation
public function get tabEnabled():Boolean public function set tabEnabled(value:Boolean):voidtabIndex | propriété |
tabIndex:int| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, Flash Player 9 |
Spécifie l’ordre de tabulation des objets dans un fichier SWF. La propriété tabIndex est réglée sur -1 par défaut, ce qui signifie qu’aucun index de tabulation n’est associé à l’objet.
Si un objet actuellement affiché dans le fichier SWF contient une propriété tabIndex, l’ordre de tabulation automatique est désactivé : l’ordre de tabulation est alors calculé à partir des propriétés tabIndex des objets contenus dans le fichier SWF. L’ordre de tabulation personnalisé inclut uniquement les objets dotés de propriétés tabIndex.
La propriété tabIndex peut être un entier non négatif. Les objets sont triés selon leurs propriétés tabIndex, par ordre croissant. Un objet dont la valeur de tabIndex est définie sur 1 précède celui dont la valeur de tabIndex est 2. N’appliquez pas la même valeur tabIndex à plusieurs objets.
L’ordre de tabulation personnalisé défini par la propriété tabIndex est flat. Cela signifie que les relations hiérarchiques des objets contenus dans le fichier SWF ne sont pas prises en compte. Tous les objets du fichier SWF dotés de propriétés tabIndex sont placés dans l’ordre de tabulation, qui est déterminé par l’ordre des valeurs tabIndex.
Remarque : pour définir l’ordre de tabulation des occurrences de TLFTextField, distribuez l’objet d’affichage enfant de TLFTextField en tant qu’objet InteractiveObject, puis définissez la propriété tabIndex. Par exemple :
InteractiveObject(tlfInstance.getChildAt(1)).tabIndex = 3;Pour inverser l’ordre de tabulation par défaut pour trois occurrences d’un objet TLFTextField (
tlfInstance1, tlfInstance2 et tlfInstance3), utilisez :
InteractiveObject(tlfInstance1.getChildAt(1)).tabIndex = 3; InteractiveObject(tlfInstance2.getChildAt(1)).tabIndex = 2; InteractiveObject(tlfInstance3.getChildAt(1)).tabIndex = 1;
Implémentation
public function get tabIndex():int public function set tabIndex(value:int):voidInteractiveObject | () | Constructeur |
public function InteractiveObject()| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, Flash Player 9, Flash Lite 4 |
L’appel du constructeur new InteractiveObject() renvoie une exception ArgumentError. Vous pouvez cependant appeler des constructeurs pour les sous-classes suivantes de InteractiveObject :
new SimpleButton()new TextField()new Loader()new Sprite()new MovieClip()
requestSoftKeyboard | () | méthode |
public function requestSoftKeyboard():Boolean| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10.2, AIR 2.6 |
Affiche un clavier virtuel.
L’appel de cette méthode place le focus sur l’occurrence d’InteractiveObject et affiche le clavier logiciel, si nécessaire. La propriété needsSoftKeyboard doit également être définie sur true. Aucun clavier n’apparaît si un clavier matériel est disponible ou si le système client ne prend pas en charge les claviers virtuels.
Remarque : cette méthode n’est pas prise en charge dans les applications AIR sous iOS.
Valeur renvoyéeBoolean — La valeur true signifie que la demande de clavier logiciel a été accordée, la valeur false que le clavier logiciel n’a pas été activé.
|
Eléments de l’API associés
clear | Evénement |
flash.events.Eventpropriété Event.type =
flash.events.Event.CLEAR| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Distribué lorsque l’utilisateur sélectionne ’Effacer’ (ou ’Supprimer’) dans le menu contextuel. Cet événement est distribué à l’objet qui possède actuellement le focus. Si l’objet qui a le focus est un TextField, le comportement par défaut de cet événement est de supprimer le texte actuellement sélectionné dans le champ de texte.
La constanteEvent.CLEAR définit la valeur de la propriété type d’un objet d’événement clear.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
cancelable | false ; il n’existe aucun comportement par défaut à annuler. |
currentTarget | L’objet qui traite activement l’objet Event avec un écouteur d’événements. |
target | Toute occurrence InteractiveObject à laquelle est associé un écouteur pour l’événement clear. |
Remarque : les objets TextField ne distribuent pas les événements clear, copy, cut, paste ou selectAll. Les objets TextField incluent toujours les commandes Couper, Copier, Coller, Effacer et Sélectionner tout dans le menu contextuel. Vous ne pouvez pas supprimer ces commandes du menu contextuel pour les objets TextField. Pour les objets TextField, la sélection de ces commandes (ou leurs équivalents clavier) ne génère pas d’événement clear, copy, cut, paste ou selectAll. Toutefois, les autres classes qui étendent la classe InteractiveObject, y compris les composants intégrés à l’aide de Flash Text Engine (FTE), distribueront ces événements en réponse aux actions de l’utilisateur (raccourcis clavier et menus contextuels, entre autres).
click | Evénement |
flash.events.MouseEventpropriété MouseEvent.type =
flash.events.MouseEvent.CLICK| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Distribué lorsque l’utilisateur appuie sur le bouton principal de son périphérique de pointage et le relâche sur la même occurrence de InteractiveObject. Pour qu’un événement clic se produise, il doit toujours suivre cette série d’événements dans l’ordre suivant : événement mouseDown, puis mouseUp. L’objet cible doit être identique pour ces deux événements, sans quoi l’événement click ne se produit pas. Quel que soit le nombre d’autres événements de souris effectués entre les événements mouseDown et mouseUp, l’événement click se produit.
type d’un objet d’événement click.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
altKey | true si la touche Alt est activée (Windows). |
bubbles | true |
buttonDown | Pour les événements de clic, cette valeur est toujours définie sur false. |
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. |
localX | Coordonnée horizontale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé. |
localY | Coordonnée verticale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé. |
movementX | Changement de coordonnées horizontales de la position de la souris depuis le dernier événement de souris, si le verrouillage de la souris est activé. |
movementY | Changement de coordonnées verticales de la position de la souris depuis le dernier événement de souris, si le verrouillage de la souris est activé. |
shiftKey | true si la touche Maj est activée ; false si elle ne l’est pas. |
stageX | Coordonnée horizontale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène. |
stageY | Coordonnée verticale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène. |
target | Occurrence d’InteractiveObject sous le périphérique 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. |
contextMenu | Evénement |
flash.events.MouseEventpropriété MouseEvent.type =
flash.events.MouseEvent.CONTEXT_MENU| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0 |
Distribué lorsque l’action d’un utilisateur active le menu contextuel associé à cet objet interactif dans une application AIR.
La constanteMouseEvent.CONTEXT_MENU définit la valeur de la propriété type d’un objet d’événement contextMenu.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
altKey | true si la touche Alt est activée (Windows). |
bubbles | true |
buttonDown | true si le bouton droit de la souris est enfoncé ; false dans tous les autres cas. |
cancelable | false ; le comportement par défaut ne peut pas être annulé. |
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. |
localX | Coordonnée horizontale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé. |
localY | Coordonnée verticale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé. |
movementX | Changement de coordonnées horizontales de la position de la souris depuis le dernier événement de souris, si le verrouillage de la souris est activé. |
movementY | Changement de coordonnées verticales de la position de la souris depuis le dernier événement de souris, si le verrouillage de la souris est activé. |
shiftKey | true si la touche Maj est activée ; false si elle ne l’est pas. |
clickCount | Décompte du nombre de clics souris pour indiquer si l’événement fait partie d’une séquence multi-clic. |
stageX | Coordonnée horizontale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène. |
stageY | Coordonnée verticale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène. |
target | Occurrence d’InteractiveObject sous le périphérique 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
copy | Evénement |
flash.events.Eventpropriété Event.type =
flash.events.Event.COPY| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Distribué lorsque l’utilisateur active la combinaison de touches de raccourci propre à la plate-forme pour une opération de copie ou sélectionne "Copier" dans le menu contextuel. Cet événement est distribué à l’objet qui possède actuellement le focus. Si l’objet qui a le focus est un TextField, le comportement par défaut de cet événement est de copier le texte actuellement sélectionné dans le champ de texte pour l’envoyer dans le presse-papiers.
Définit la valeur de la propriététype d’un objet d’événement copy.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
cancelable | false ; il n’existe aucun comportement par défaut à annuler. |
currentTarget | L’objet qui traite activement l’objet Event avec un écouteur d’événements. |
target | Toute occurrence InteractiveObject à laquelle est associé un écouteur pour l’événement copy. |
Remarque : les objets TextField ne distribuent pas les événements clear, copy, cut, paste ou selectAll. Les objets TextField incluent toujours les commandes Couper, Copier, Coller, Effacer et Sélectionner tout dans le menu contextuel. Vous ne pouvez pas supprimer ces commandes du menu contextuel pour les objets TextField. Pour les objets TextField, la sélection de ces commandes (ou leurs équivalents clavier) ne génère pas d’événement clear, copy, cut, paste ou selectAll. Toutefois, les autres classes qui étendent la classe InteractiveObject, y compris les composants intégrés à l’aide de Flash Text Engine (FTE), distribueront ces événements en réponse aux actions de l’utilisateur (raccourcis clavier et menus contextuels, entre autres).
cut | Evénement |
flash.events.Eventpropriété Event.type =
flash.events.Event.CUT| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Distribué lorsque l’utilisateur active la combinaison de touches de raccourci propre à la plate-forme pour une opération de coupage ou sélectionne "Couper" dans le menu contextuel. Cet événement est distribué à l’objet qui possède actuellement le focus. Si l’objet qui a le focus est un TextField, le comportement par défaut de cet événement est de couper le texte actuellement sélectionné dans le champ de texte pour l’envoyer dans le presse-papiers.
Définit la valeur de la propriététype d’un objet d’événement cut.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
cancelable | false ; il n’existe aucun comportement par défaut à annuler. |
currentTarget | L’objet qui traite activement l’objet Event avec un écouteur d’événements. |
target | Toute occurrence InteractiveObject à laquelle est associé un écouteur pour l’événement cut. |
Remarque : les objets TextField ne distribuent pas les événements clear, copy, cut, paste ou selectAll. Les objets TextField incluent toujours les commandes Couper, Copier, Coller, Effacer et Sélectionner tout dans le menu contextuel. Vous ne pouvez pas supprimer ces commandes du menu contextuel pour les objets TextField. Pour les objets TextField, la sélection de ces commandes (ou leurs équivalents clavier) ne génère pas d’événement clear, copy, cut, paste ou selectAll. Toutefois, les autres classes qui étendent la classe InteractiveObject, y compris les composants intégrés à l’aide de Flash Text Engine (FTE), distribueront ces événements en réponse aux actions de l’utilisateur (raccourcis clavier et menus contextuels, entre autres).
doubleClick | Evénement |
flash.events.MouseEventpropriété MouseEvent.type =
flash.events.MouseEvent.DOUBLE_CLICK| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, Flash Player 9 |
Distribué lorsque l’utilisateur appuie sur le bouton principal d’un périphérique de pointage et le relâche deux fois de suite sur la même occurrence d’InteractiveObject si l’indicateur doubleClickEnabled de cet objet est défini sur true. Pour qu’un événement doubleClick se produise, il doit suivre immédiatement la série d’événements ci-après : mouseDown, mouseUp, click, mouseDown, mouseUp. Tous ces événements doivent partager la même cible en tant qu’événement doubleClick. Le second clic, représenté par les seconds événements mouseDown et mouseUp, doit se produire dans un délai spécifique après l’événement click. La longueur autorisée de ce délai varie selon le système d’exploitation et peut souvent être configurée par l’utilisateur. Si la cible est un champ de texte sélectionnable, le comportement par défaut consiste à sélectionner le mot qui se trouve sous le pointeur. Si l’indicateur doubleClickEnabled de l’objet InteractiveObject cible n’est pas réglé sur true, celui-ci reçoit deux événements click.
La propriété doubleClickEnabled prend par défaut la valeur false.
Le comportement de sélection de texte par le biais d’un double clic d’un objet TextField n’est pas lié à l’événement doubleClick. Utilisez TextField.doubleClickEnabled pour contrôler les sélections TextField.
type d’un objet d’événement doubleClick. La propriété doubleClickEnabled doit être true pour qu’un objet puisse générer l’événement doubleClick.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
altKey | true si la touche Alt est activée (Windows). |
bubbles | true |
buttonDown | Pour les événements de double-clic, cette valeur est toujours définie sur false. |
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. |
localX | Coordonnée horizontale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé. |
localY | Coordonnée verticale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé. |
movementX | Changement de coordonnées horizontales de la position de la souris depuis le dernier événement de souris, si le verrouillage de la souris est activé. |
movementY | Changement de coordonnées verticales de la position de la souris depuis le dernier événement de souris, si le verrouillage de la souris est activé. |
shiftKey | true si la touche Maj est activée ; false si elle ne l’est pas. |
stageX | Coordonnée horizontale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène. |
stageY | Coordonnée verticale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène. |
target | Occurrence d’InteractiveObject sous le périphérique 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
focusIn | Evénement |
flash.events.FocusEventpropriété FocusEvent.type =
flash.events.FocusEvent.FOCUS_IN| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Distribué après la prise de focus d’un objet d’affichage. Ce cas de figure se produit lorsqu’un utilisateur affiche l’objet en surbrillance à l’aide d’un périphérique de pointage ou du clavier. L’objet qui reçoit le focus s’appelle l’objet cible de cet événement, tandis que l’occurrence d’InteractiveObject correspondante qui perd le focus en raison de ce changement porte le nom d’objet apparenté. Une référence à l’objet apparenté est enregistrée dans la propriété relatedObject de l’objet cible. La propriété shiftKey n’est pas utilisée. Cet événement suit la distribution de l’événement focusOut de l’objet précédent.
type d’un objet événement focusIn.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | true |
cancelable | false ; il n’existe aucun comportement par défaut à annuler. |
currentTarget | L’objet qui traite activement l’objet Event avec un écouteur d’événements. |
keyCode | 0 ; s’applique uniquement aux événements keyFocusChange. |
relatedObject | Occurrence complémentaire d’InteractiveObject affectée par le déplacement du focus. |
shiftKey | false ; s’applique uniquement aux événements keyFocusChange. |
target | Occurrence d’InteractiveObject qui vient de recevoir le focus. 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.
|
direction | La direction à partir de laquelle le focus a été attribué. Cette propriété signale la valeur du paramètre direction de la méthode assignFocus() de la scène. Si le focus a changé par d’autres moyens, la valeur est toujours FocusDirection.NONE. S’applique uniquement aux événements focusIn. Pour tous les autres événements focus, la valeur est FocusDirection.NONE. |
focusOut | Evénement |
flash.events.FocusEventpropriété FocusEvent.type =
flash.events.FocusEvent.FOCUS_OUT| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Distribué après la perte de focus d’un objet d’affichage. Ce cas de figure se produit lorsqu’un utilisateur affiche en surbrillance un autre objet à l’aide d’un périphérique de pointage ou du clavier. L’objet qui perd le focus s’appelle l’objet cible de cet événement, tandis que l’occurrence d’InteractiveObject correspondante qui reçoit le focus porte le nom d’objet apparenté. Une référence à l’objet apparenté est enregistrée dans la propriété relatedObject de l’objet cible. La propriété shiftKey n’est pas utilisée. Cet événement précède la distribution de l’événement focusIn par l’objet apparenté.
type d’un objet événement focusOut.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | true |
cancelable | false ; il n’existe aucun comportement par défaut à annuler. |
currentTarget | L’objet qui traite activement l’objet Event avec un écouteur d’événements. |
keyCode | 0 ; s’applique uniquement aux événements keyFocusChange. |
relatedObject | Occurrence complémentaire d’InteractiveObject affectée par le déplacement du focus. |
shiftKey | false ; s’applique uniquement aux événements keyFocusChange. |
target | Occurrence d’InteractiveObject qui vient de perdre le focus. 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.
|
gestureDirectionalTap | Evénement |
flash.events.TransformGestureEventpropriété TransformGestureEvent.type =
flash.events.TransformGestureEvent.GESTURE_DIRECTIONAL_TAP| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 24, Flash Lite 4 |
Distribué lorsque l’utilisateur crée un point de contact le long du bord de la surface tactile à l’aide d’une occurrence InteractiveObject (par exemple, en appuyant le long du bord de la surface tactile sur la télécommande Siri Remote pour l’Apple TV). Certains périphériques peuvent également interpréter ce contact comme une combinaison de plusieurs événements tactiles.
De façon plus spécifique, si un utilisateur pose ses doigts sur un objet InteractiveObject, puis les déplace, l’occurrence InteractiveObject peut distribuer un événement touchBegin et un événement touchEnd (entre autres) en plus de l’événement gestureDirectionalTap, ou tous ces événements si l’environnement actuel le permet. Choisissez la manière dont vous souhaitez gérer l’interaction de l’utilisateur. Utilisez la classe flash.ui.Multitouch pour gérer les événements tactiles (activez la gestion des événements de mouvements tactiles ou la gestion des événements de points tactiles simples, ou désactivez les événements tactiles afin de ne distribuer que les événements de souris). Si vous choisissez de gérer l’événement touchBegin, le même gestionnaire d’événement sera exécuté sur un périphérique tactile. Toutefois, si vous choisissez de gérer l’événement gestureDirectionalTap, vous pouvez concevoir votre gestionnaire d’événement de façon à répondre aux besoins spécifiques d’un environnement tactile et à fournir aux utilisateurs des fonctionnalités tactiles avancées. Vous pouvez également gérer ces deux événements de façon indépendante pour fournir une réponse différente selon qu’il s’agit d’un événement de mouvement ou d’un événement tactile. Cependant, la décision de déclenchement de l’événement tactile ou de mouvement revient à la classe flash.ui.Multitouch.
Lors de la gestion des propriétés de l’objet d’événement, notez que les propriétés localX et localY sont définies sur le point de contact principal (pour l’Apple TV, il s’agit du centre de l’écran). Les propriétés offsetX et offsetY correspondent à la direction du mouvement.
Remarque : Cette API ne prend en charge que l’appui directionnel avec un seul doigt.
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
gestureLongPress | Evénement |
flash.events.TapGestureEventpropriété TapGestureEvent.type =
flash.events.GestureEvent.GESTURE_LONG_PRESS| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Distribué lorsque l’utilisateur appuie sur deux points de contact sur la même occurrence d’InteractiveObject sur un périphérique tactile (notamment lorsque l’utilisateur appuie avec deux doigts sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile, puis les retire). Certains périphériques peuvent également interpréter ce contact comme un événement doubleClick.
De façon plus spécifique, si un utilisateur appuie brièvement avec deux doigts sur un objet InteractiveObject, l’occurrence d’InteractiveObject peut distribuer un événement doubleClick ou un événement gestureTwoFingerTap, ou les deux si l’environnement actuel le permet. Choisissez la manière dont vous souhaitez gérer l’interaction de l’utilisateur. Utilisez la classe flash.ui.Multitouch pour gérer les événements tactiles (activez la gestion des événements de mouvements tactiles ou la gestion des événements de points tactiles simples, ou désactivez les événements tactiles afin de ne distribuer que les événements de souris). Si vous choisissez de gérer l’événement doubleClick, le gestionnaire d’événement sera exécuté sur un périphérique tactile et sur un périphérique de type souris. Toutefois, si vous choisissez de gérer l’événement gestureTwoFingerTap, vous pouvez concevoir votre gestionnaire d’événement de façon à répondre aux besoins spécifiques d’un environnement tactile et à fournir aux utilisateurs des fonctionnalités tactiles avancées. Vous pouvez également gérer ces deux événements de façon indépendante pour fournir une réponse différente selon qu’il s’agit d’un événement tactile ou d’un événement de souris.
Remarque : voir la classe Multitouch pour plus d’informations sur la compatibilité de l’environnement.
Eléments de l’API associés
gesturePan | Evénement |
flash.events.TransformGestureEventpropriété TransformGestureEvent.type =
flash.events.TransformGestureEvent.GESTURE_PAN| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Distribué lorsque l’utilisateur déplace un point de contact sur l’occurrence d’InteractiveObject d’un périphérique tactile (notamment lorsqu’il déplace un doigt de gauche à droite sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile). Certains périphériques peuvent également interpréter ce contact comme un événement mouseOver et comme un événement touchOver.
De façon plus spécifique, si un utilisateur déplace ses doigts sur un objet InteractiveObject, l’occurrence d’InteractiveObject peut distribuer un événement mouseOver, un événement touchOver ou un événement gesturePan, ou tous ces événements si l’environnement actuel le permet. Choisissez la manière dont vous souhaitez gérer l’interaction de l’utilisateur. Utilisez la classe flash.ui.Multitouch pour gérer les événements tactiles (activez la gestion des événements de mouvements tactiles ou la gestion des événements de points tactiles simples, ou désactivez les événements tactiles afin de ne distribuer que les événements de souris). Si vous choisissez de gérer l’événement mouseOver, le gestionnaire d’événement sera exécuté sur un périphérique tactile et sur un périphérique de type souris. Toutefois, si vous choisissez de gérer l’événement gesturePan, vous pouvez concevoir votre gestionnaire d’événement de façon à répondre aux besoins spécifiques d’un environnement tactile et à fournir aux utilisateurs des fonctionnalités tactiles avancées. Vous pouvez également gérer ces deux événements de façon indépendante pour fournir une réponse différente selon qu’il s’agit d’un événement tactile ou d’un événement de souris.
Remarque : voir la classe Multitouch pour plus d’informations sur la compatibilité de l’environnement.
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. |
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";
}
}
Eléments de l’API associés
gestureRotate | Evénement |
flash.events.TransformGestureEventpropriété TransformGestureEvent.type =
flash.events.TransformGestureEvent.GESTURE_ROTATE| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Distribué lorsque l’utilisateur effectue un mouvement de rotation sur un point de contact à l’aide d’une occurrence d’InteractiveObject (par exemple, lorsqu’il pose deux doigts sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile, puis les fait pivoter). Bien que cette manière d’effectuer une rotation soit commune, chaque périphérique et système d’exploitation peut avoir sa propre méthode de rotation. Certains périphériques peuvent également interpréter ce contact comme une combinaison de plusieurs événements de souris.
De façon plus spécifique, si un utilisateur déplace ses doigts sur un objet InteractiveObject, l’occurrence d’InteractiveObject peut distribuer un événement mouseOver et un événement click (entre autres) en plus de l’événement gestureRotate, ou tous ces événements si l’environnement actuel le permet. Choisissez la manière dont vous souhaitez gérer l’interaction de l’utilisateur. Utilisez la classe flash.ui.Multitouch pour gérer les événements tactiles (activez la gestion des événements de mouvements tactiles ou la gestion des événements de points tactiles simples, ou désactivez les événements tactiles afin de ne distribuer que les événements de souris). Si vous choisissez de gérer l’événement mouseOver, le gestionnaire d’événement sera exécuté sur un périphérique tactile et sur un périphérique de type souris. Toutefois, si vous choisissez de gérer l’événement gestureRotate, vous pouvez concevoir votre gestionnaire d’événement de façon à répondre aux besoins spécifiques d’un environnement tactile et à fournir aux utilisateurs des fonctionnalités tactiles avancées. Vous pouvez également gérer ces deux événements de façon indépendante pour fournir une réponse différente selon qu’il s’agit d’un événement tactile ou d’un événement de souris.
Lors de la gestion des propriétés de l’objet d’événement, notez que les propriétés localX et localY sont définies sur le point de contact principal. Les propriétés offsetX et offsetY représentent la distance jusqu’au point de contact où le mouvement de rotation se termine.
Remarque : voir la classe Multitouch pour plus d’informations sur la compatibilité de l’environnement.
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. |
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";
}
}
Eléments de l’API associés
gestureSwipe | Evénement |
flash.events.TransformGestureEventpropriété TransformGestureEvent.type =
flash.events.TransformGestureEvent.GESTURE_SWIPE| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Distribué lorsque l’utilisateur effectue un mouvement de glissement sur un point de contact à l’aide d’une occurrence d’InteractiveObject (par exemple, lorsqu’il pose trois doigts puis les déplace parallèlement sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile). Bien que le déplacement parallèle de plusieurs doigts soit un mouvement de glissement commun, chaque périphérique ou système d’exploitation peut avoir sa propre méthode de glissement. Certains périphériques peuvent également interpréter ce contact comme une combinaison de plusieurs événements de souris.
De façon plus spécifique, si un utilisateur pose ses doigts sur un objet InteractiveObject, puis les déplace simultanément, l’occurrence d’InteractiveObject peut distribuer un événement rollOver et un événement rollOut (entre autres) en plus de l’événement gestureSwipe, ou tous ces événements si l’environnement actuel le permet. Choisissez la manière dont vous souhaitez gérer l’interaction de l’utilisateur. Si vous choisissez de gérer l’événement rollOver, le gestionnaire d’événement sera exécuté sur un périphérique tactile et sur un périphérique de type souris. Toutefois, si vous choisissez de gérer l’événement gestureSwipe, vous pouvez concevoir votre gestionnaire d’événement de façon à répondre aux besoins spécifiques d’un environnement tactile et à fournir aux utilisateurs des fonctionnalités tactiles avancées. Vous pouvez également gérer ces deux événements de façon indépendante pour fournir une réponse différente selon qu’il s’agit d’un événement tactile ou d’un événement de souris.
Lors de la gestion des propriétés de l’objet d’événement, notez que les propriétés localX et localY sont définies sur le point de contact principal. Les propriétés offsetX et offsetY représentent la distance jusqu’au point de contact où se termine le mouvement de glissement.
Remarque : bien que certains périphériques qui utilisent le système d’exploitation Mac OS soient capables d’interpréter un glissement à quatre doigts, cette API prend en charge un glissement à trois doigts uniquement.
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. |
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;
}
Eléments de l’API associés
gestureTap | Evénement |
flash.events.TapGestureEventpropriété TapGestureEvent.type =
flash.events.PressAndTapGestureEvent.GESTURE_TAP| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Distribué lorsque l’utilisateur crée un point de contact à l’aide d’une occurrence d’InteractiveObject, puis appuie brièvement sur un périphérique tactile (notamment lorsqu’il place plusieurs doigts sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile pour ouvrir un menu, puis appuie brièvement avec un doigt pour sélectionner une option de menu). Certains périphériques peuvent également interpréter ce contact comme une combinaison de plusieurs événements de souris.
De façon plus spécifique, si un utilisateur déplace ses doigts sur un objet InteractiveObject, puis appuie brièvement dessus avec un doigt, l’occurrence d’InteractiveObject peut distribuer un événement mouseOver et un événement click (entre autres) en plus de l’événement gesturePressAndTap, ou tous ces événements si l’environnement actuel le permet. Choisissez la manière dont vous souhaitez gérer l’interaction de l’utilisateur. Utilisez la classe flash.ui.Multitouch pour gérer les événements tactiles (activez la gestion des événements de mouvements tactiles ou la gestion des événements de points tactiles simples, ou désactivez les événements tactiles afin de ne distribuer que les événements de souris). Si vous choisissez de gérer l’événement mouseOver, le gestionnaire d’événement sera exécuté sur un périphérique tactile et sur un périphérique de type souris. Toutefois, si vous choisissez de gérer l’événement gesturePressAndTap, vous pouvez concevoir votre gestionnaire d’événement de façon à répondre aux besoins spécifiques d’un environnement tactile et à fournir aux utilisateurs des fonctionnalités tactiles avancées. Vous pouvez également gérer ces deux événements de façon indépendante pour fournir une réponse différente selon qu’il s’agit d’un événement tactile ou d’un événement de souris.
Lors de la gestion des propriétés de l’objet d’événement, notez que les propriétés localX et localY sont définies sur le point de contact principal (l’« appui »). Les propriétés offsetX et offsetY représentent la distance au point de contact secondaire (l’« appui bref »).
Eléments de l’API associés
gestureZoom | Evénement |
flash.events.TransformGestureEventpropriété TransformGestureEvent.type =
flash.events.TransformGestureEvent.GESTURE_ZOOM| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Distribué lorsque l’utilisateur effectue un mouvement de zoom sur un point de contact à l’aide d’une occurrence d’InteractiveObject (par exemple, lorsqu’il pose deux doigts, puis les écarte rapidement sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile). Bien que cette manière d’effectuer un zoom soit commune, chaque périphérique et système d’exploitation peut avoir sa propre méthode de zoom. Certains périphériques peuvent également interpréter ce contact comme une combinaison de plusieurs événements de souris.
De façon plus spécifique, si un utilisateur pose ses doigts sur un objet InteractiveObject, puis les écarte, l’occurrence d’InteractiveObject peut distribuer un événement mouseOver et un événement click (entre autres) en plus de l’événement gestureZoom, ou tous ces événements si l’environnement actuel le permet. Choisissez la manière dont vous souhaitez gérer l’interaction de l’utilisateur. Utilisez la classe flash.ui.Multitouch pour gérer les événements tactiles (activez la gestion des événements de mouvements tactiles ou la gestion des événements de points tactiles simples, ou désactivez les événements tactiles afin de ne distribuer que les événements de souris). Si vous choisissez de gérer l’événement mouseOver, le gestionnaire d’événement sera exécuté sur un périphérique tactile et sur un périphérique de type souris. Toutefois, si vous choisissez de gérer l’événement gestureZoom, vous pouvez concevoir votre gestionnaire d’événement de façon à répondre aux besoins spécifiques d’un environnement tactile et à fournir aux utilisateurs des fonctionnalités tactiles avancées. Vous pouvez également gérer ces deux événements de façon indépendante pour fournir une réponse différente selon qu’il s’agit d’un événement tactile ou d’un événement de souris.
Lors de la gestion des propriétés de l’objet d’événement, notez que les propriétés localX et localY sont définies sur le point de contact principal. Les propriétés offsetX et offsetY représentent la distance jusqu’au point de contact où le mouvement de zoom se termine.
Remarque : voir la classe Multitouch pour plus d’informations sur la compatibilité de l’environnement.
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. |
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";
}
}
Eléments de l’API associés
imeStartComposition | Evénement |
flash.events.IMEEvent| Versions du moteur d’exécution: | Flash Lite 4 |
Cet événement est distribué à une application cliente prenant en charge la saisie en ligne avec un éditeur IME.
keyDown | Evénement |
flash.events.KeyboardEventpropriété KeyboardEvent.type =
flash.events.KeyboardEvent.KEY_DOWN| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Distribué lorsque l’utilisateur appuie sur une touche. La concordance entre les touches et des caractères spécifiques dépend du périphérique et du système d’exploitation. Ce type d’événement est généré lors du mappage, mais avant le traitement d’un éditeur de méthode d’entrée (IME). Les IME permettent d’entrer des caractères, tels que les idéogrammes chinois, que le clavier AZERTY standard ne permet pas de produire. Cet événement se produit avant l’événement keyUp.
Dans AIR, l’annulation de cet événement empêche le caractère d’être inséré dans un champ de texte.
La constanteKeyboardEvent.KEY_DOWN définit la valeur de la propriété type d’un objet événement keyDown.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | true |
cancelable | true dans AIR, false dans Flash Player ; dans AIR, l’annulation de cet événement empêche l’insertion du caractère dans un champ de texte. |
charCode | Valeur du code de caractère associé à la touche enfoncée ou relâchée. |
commandKey | true sous Mac si la touche Commande est activée. Autrement, false |
controlKey | true sous Windows et Linux si la touche Ctrl est activée. true sous Mac si la touche Contrôle est activée. Autrement, false |
ctrlKey | true sous Windows et Linux si la touche Ctrl est activé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. |
keyCode | Valeur de code correspondant à la touche enfoncée ou relâchée. |
keyLocation | Emplacement de la touche sur le clavier. |
shiftKey | true si la touche Maj est activée ; false si elle ne l’est pas. |
target | Occurrence d’InteractiveObject possédant le focus. 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. |
Plus d’exemples
keyFocusChange | Evénement |
flash.events.FocusEventpropriété FocusEvent.type =
flash.events.FocusEvent.KEY_FOCUS_CHANGE| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Distribué lorsque l’utilisateur tente de déplacer le focus à l’aide du clavier. Le comportement par défaut de cet événement consiste à déplacer le focus et à distribuer les événements focusIn et focusOut correspondants.
Cet événement est distribué à l’objet qui possède actuellement le focus. L’objet apparenté de cet événement correspond à l’occurrence d’InteractiveObject qui reçoit le focus si vous ne bloquez pas le comportement par défaut. Pour éviter le déplacement du focus, appelez preventDefault() dans un écouteur d’événement correctement enregistré auprès de l’objet cible. Le focus change et les événements focusIn et focusOut sont distribués par défaut.
type d’un objet événement keyFocusChange.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | true |
cancelable | true ; appelez la méthode preventDefault() pour annuler le comportement par défaut. |
currentTarget | L’objet qui traite activement l’objet Event avec un écouteur d’événements. |
keyCode | Valeur de code correspondant à la touche utilisée pour déclencher un événement keyFocusChange. |
relatedObject | Occurrence complémentaire d’InteractiveObject affectée par le déplacement du focus. |
shiftKey | true si le modificateur de la touche Maj est activé ; false dans tous les autres cas. |
target | Occurrence d’InteractiveObject qui possède actuellement le focus. 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.
|
keyUp | Evénement |
flash.events.KeyboardEventpropriété KeyboardEvent.type =
flash.events.KeyboardEvent.KEY_UP| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Distribué lorsque l’utilisateur relâche une touche. La concordance entre les touches et des caractères spécifiques dépend du périphérique et du système d’exploitation. Ce type d’événement est généré lors du mappage, mais avant le traitement d’un éditeur de méthode d’entrée (IME). Les IME permettent d’entrer des caractères, tels que les idéogrammes chinois, que le clavier AZERTY standard ne permet pas de produire. Cet événement se produit après un événement keyDown et présente les caractéristiques suivantes :
KeyboardEvent.KEY_UP définit la valeur de la propriété type d’un objet d’événement keyUp.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | true |
cancelable | false ; il n’existe aucun comportement par défaut à annuler. |
charCode | Contient la valeur du code de caractère associé à la touche enfoncée ou relâchée. |
commandKey | true sous Mac si la touche Commande est activée. Autrement, false |
controlKey | true sous Windows et Linux si la touche Ctrl est activée. true sous Mac si la touche Contrôle est activée. Autrement, false |
ctrlKey | true sur Windows 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. |
keyCode | Valeur de code correspondant à la touche enfoncée ou relâchée. |
keyLocation | Emplacement de la touche sur le clavier. |
shiftKey | true si la touche Maj est activée ; false si elle ne l’est pas. |
target | Occurrence d’InteractiveObject possédant le focus. 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. |
middleClick | Evénement |
flash.events.MouseEventpropriété MouseEvent.type =
flash.events.MouseEvent.MIDDLE_CLICK| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, Flash Lite 4 |
Distribué lorsque l’utilisateur appuie sur le bouton central de son périphérique de pointage et le relâche sur la même occurrence de InteractiveObject. Pour qu’un événement middleClick se produise, il doit toujours suivre cette série d’événements dans l’ordre suivant : événement middleMouseDown, puis middleMouseUp. L’objet cible doit être identique pour ces deux événements, sans quoi l’événement middleClick ne se produit pas. Quel que soit le nombre d’autres événements de souris effectués entre les événements middleMouseDown et middleMouseUp, l’événement middleClick se produit.
type d’un objet d’événement middleClick.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
altKey | true si la touche Alt est activée (Windows). |
bubbles | true |
buttonDown | Pour les événements de clic central, cette valeur est toujours définie sur false. |
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. |
localX | Coordonnée horizontale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé. |
localY | Coordonnée verticale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé. |
movementX | Changement de coordonnées horizontales de la position de la souris depuis le dernier événement de souris, si le verrouillage de la souris est activé. |
movementY | Changement de coordonnées verticales de la position de la souris depuis le dernier événement de souris, si le verrouillage de la souris est activé. |
shiftKey | true si la touche Maj est activée ; false si elle ne l’est pas. |
stageX | Coordonnée horizontale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène. |
stageY | Coordonnée verticale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène. |
target | Occurrence d’InteractiveObject sous le périphérique 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. |
middleMouseDown | Evénement |
flash.events.MouseEventpropriété MouseEvent.type =
flash.events.MouseEvent.MIDDLE_MOUSE_DOWN| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, Flash Lite 4 |
Distribué lorsqu’un utilisateur appuie sur le bouton du périphérique de pointage central sur une occurrence InteractiveObject.
Définit la valeur de la propriététype d’un objet d’événement middleMouseDown.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
altKey | true si la touche Alt est activée (Windows). |
bubbles | true |
buttonDown | true si le bouton central de la souris est enfoncé ; false dans tous les autres cas. |
cancelable | false ; le comportement par défaut ne peut pas être annulé. |
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. |
localX | Coordonnée horizontale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé. |
localY | Coordonnée verticale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé. |
movementX | Changement de coordonnées horizontales de la position de la souris depuis le dernier événement de souris, si le verrouillage de la souris est activé. |
movementY | Changement de coordonnées verticales de la position de la souris depuis le dernier événement de souris, si le verrouillage de la souris est activé. |
shiftKey | true si la touche Maj est activée ; false si elle ne l’est pas. |
clickCount | Décompte du nombre de clics souris pour indiquer si l’événement fait partie d’une séquence multi-clic. |
stageX | Coordonnée horizontale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène. |
stageY | Coordonnée verticale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène. |
target | Occurrence d’InteractiveObject sous le périphérique 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. |
middleMouseUp | Evénement |
flash.events.MouseEventpropriété MouseEvent.type =
flash.events.MouseEvent.MIDDLE_MOUSE_UP| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, Flash Lite 4 |
Distribué lorsqu’un utilisateur relâche le bouton du périphérique de pointage sur une occurrence InteractiveObject.
Définit la valeur de la propriététype d’un objet d’événement middleMouseUp.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
altKey | true si la touche Alt est activée (Windows). |
bubbles | true |
buttonDown | true si le bouton central de la souris est enfoncé ; false dans tous les autres cas. |
cancelable | false ; le comportement par défaut ne peut pas être annulé. |
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. |
localX | Coordonnée horizontale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé. |
localY | Coordonnée verticale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé. |
movementX | Changement de coordonnées horizontales de la position de la souris depuis le dernier événement de souris, si le verrouillage de la souris est activé. |
movementY | Changement de coordonnées verticales de la position de la souris depuis le dernier événement de souris, si le verrouillage de la souris est activé. |
shiftKey | true si la touche Maj est activée ; false si elle ne l’est pas. |
clickCount | Décompte du nombre de clics souris pour indiquer si l’événement fait partie d’une séquence multi-clic. |
stageX | Coordonnée horizontale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène. |
stageY | Coordonnée verticale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène. |
target | Occurrence d’InteractiveObject sous le périphérique 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. |
mouseDown | Evénement |
flash.events.MouseEventpropriété MouseEvent.type =
flash.events.MouseEvent.MOUSE_DOWN| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Distribué lorsqu’un utilisateur appuie sur le bouton du périphérique de pointage sur une occurrence InteractiveObject. Lorsque la cible est une occurrence de SimpleButton, celle-ci affiche l’objet d’affichage downState en tant que comportement par défaut. Si la cible est un champ de texte sélectionnable, le champ de texte commence la sélection, ce qui est son comportement par défaut.
type d’un objet d’événement mouseDown.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
altKey | true si la touche Alt est activée (Windows). |
bubbles | true |
buttonDown | true si le bouton principal de la souris est enfoncé ; false dans tous les autres cas. |
cancelable | false ; le comportement par défaut ne peut pas être annulé. |
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 et Linux si la touche Ctrl est activé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. |
localX | Coordonnée horizontale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé. |
localY | Coordonnée verticale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé. |
movementX | Changement de coordonnées horizontales de la position de la souris depuis le dernier événement de souris, si le verrouillage de la souris est activé. |
movementY | Changement de coordonnées verticales de la position de la souris depuis le dernier événement de souris, si le verrouillage de la souris est activé. |
shiftKey | true si la touche Maj est activée ; false si elle ne l’est pas. |
clickCount | Décompte du nombre de clics souris pour indiquer si l’événement fait partie d’une séquence multi-clic. |
stageX | Coordonnée horizontale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène. |
stageY | Coordonnée verticale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène. |
target | Occurrence d’InteractiveObject sous le périphérique 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. |
mouseFocusChange | Evénement |
flash.events.FocusEventpropriété FocusEvent.type =
flash.events.FocusEvent.MOUSE_FOCUS_CHANGE| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Distribué lorsque l’utilisateur tente de déplacer le focus à l’aide d’un périphérique de pointage. Le comportement par défaut de cet événement consiste à déplacer le focus et à distribuer les événements focusIn et focusOut correspondants.
Cet événement est distribué à l’objet qui possède actuellement le focus. L’objet apparenté de cet événement correspond à l’occurrence d’InteractiveObject qui reçoit le focus si vous ne bloquez pas le comportement par défaut. Pour éviter le déplacement du focus, appelez preventDefault() dans un écouteur d’événement correctement enregistré auprès de l’objet cible. La propriété shiftKey n’est pas utilisée. Le focus change et les événements focusIn et focusOut sont distribués par défaut.
type d’un objet événement mouseFocusChange.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | true |
cancelable | true ; appelez la méthode preventDefault() pour annuler le comportement par défaut. |
currentTarget | L’objet qui traite activement l’objet Event avec un écouteur d’événements. |
keyCode | 0 ; s’applique uniquement aux événements keyFocusChange. |
relatedObject | Occurrence complémentaire d’InteractiveObject affectée par le déplacement du focus. |
shiftKey | false ; s’applique uniquement aux événements keyFocusChange. |
target | Occurrence d’InteractiveObject qui possède actuellement le focus. 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.
|
mouseMove | Evénement |
flash.events.MouseEventpropriété MouseEvent.type =
flash.events.MouseEvent.MOUSE_MOVE| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Distribué lorsque l’utilisateur déplace le périphérique de pointage placé sur une occurrence de InteractiveObject. Si la cible est un champ de texte sélectionné par l’utilisateur, le comportement par défaut consiste à mettre à jour la sélection.
Définit la valeur de la propriététype d’un objet d’événement mouseMove.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
altKey | true si la touche Alt est activée (Windows). |
bubbles | true |
buttonDown | true si le bouton principal de la souris est enfoncé ; false dans tous les autres cas. |
cancelable | false ; le comportement par défaut ne peut pas être annulé. |
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. |
localX | Coordonnée horizontale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé. |
localY | Coordonnée verticale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé. |
movementX | Changement de coordonnées horizontales de la position de la souris depuis le dernier événement de souris, si le verrouillage de la souris est activé. |
movementY | Changement de coordonnées verticales de la position de la souris depuis le dernier événement de souris, si le verrouillage de la souris est activé. |
shiftKey | true si la touche Maj est activée ; false si elle ne l’est pas. |
stageX | Coordonnée horizontale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène. |
stageY | Coordonnée verticale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène. |
target | Occurrence d’InteractiveObject sous le périphérique 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. |
mouseOut | Evénement |
flash.events.MouseEventpropriété MouseEvent.type =
flash.events.MouseEvent.MOUSE_OUT| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Distribué lorsque l’utilisateur éloigne un périphérique de pointage d’une occurrence de InteractiveObject. L’événement a pour cible l’objet précédemment placé sous le périphérique de pointage. L’objet relatedObject correspond à l’objet sur lequel s’est placé le périphérique de pointage. Lorsque la cible est une occurrence de SimpleButton, le bouton présente l’objet d’affichage upState comme comportement par défaut.
L’événement mouseOut est envoyé chaque fois que la souris quitte la zone d’un objet enfant du conteneur d’objet d’affichage, même si la souris reste au-dessus d’un autre objet enfant du conteneur d’objet d’affichage. Ce comportement est différent de celui de l’événement rollOut qui a pour objet de simplifier le codage des comportements de survol des conteneurs d’objet d’affichage avec enfants. Lorsque la souris quitte la zone d’un objet d’affichage ou de l’un de ses enfants pour atteindre un objet qui ne fait pas partie de ses enfants, l’objet d’affichage distribue l’événement rollOut. Les événements rollOut sont distribués de façon consécutive vers le haut de la chaîne parent de l’objet, en commençant par l’objet et en se terminant par le parent de plus haut niveau qui n’est ni la racine, ni l’ancêtre de relatedObject.
type d’un objet d’événement mouseOut.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
altKey | true si la touche Alt est activée (Windows). |
bubbles | true |
buttonDown | true si le bouton principal de la souris est enfoncé ; false dans tous les autres cas. |
cancelable | false ; le comportement par défaut ne peut pas être annulé. |
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. |
relatedObject | Objet de la liste d’affichage sur lequel pointe actuellement le périphérique de pointage. |
localX | Coordonnée horizontale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé. |
localY | Coordonnée verticale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé. |
movementX | Changement de coordonnées horizontales de la position de la souris depuis le dernier événement de souris, si le verrouillage de la souris est activé. |
movementY | Changement de coordonnées verticales de la position de la souris depuis le dernier événement de souris, si le verrouillage de la souris est activé. |
shiftKey | true si la touche Maj est activée ; false si elle ne l’est pas. |
stageX | Coordonnée horizontale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène. |
stageY | Coordonnée verticale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène. |
target | Occurrence d’InteractiveObject sous le périphérique 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. |
mouseOver | Evénement |
flash.events.MouseEventpropriété MouseEvent.type =
flash.events.MouseEvent.MOUSE_OVER| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Distribué lorsque l’utilisateur place un périphérique de pointage sur une occurrence de InteractiveObject. relatedObject correspond à l’objet précédemment placé sous le périphérique de pointage. Si la cible est une occurrence de SimpleButton, l’objet présente l’objet d’affichage overState ou upState, selon que le bouton de la souris est enfoncé ou non, comme comportement par défaut.
L’événement mouseOver est envoyé chaque fois que la souris pénètre dans la zone d’un objet enfant du conteneur d’objet d’affichage, même si la souris survolait déjà un autre objet enfant du conteneur d’objet d’affichage. Ce comportement est différent de celui de l’événement rollOver qui a pour objet de simplifier le codage des comportements de fin de sélection des conteneurs d’objet d’affichage avec enfants. Lorsque la souris pénètre dans la zone d’un objet d’affichage ou de l’un de ses enfants à partir d’un objet qui ne fait pas partie de ses enfants, l’objet d’affichage distribue l’événement rollOver. Les événements rollOver sont envoyés de façon consécutive vers le bas de la chaîne parent de l’objet, en commençant par le parent de plus haut niveau qui ne constitue ni la racine, ni l’ancêtre de relatedObject et se termine par l’objet.
type d’un objet d’événement mouseOver.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
altKey | true si la touche Alt est activée (Windows). |
bubbles | true |
buttonDown | true si le bouton principal de la souris est enfoncé ; false dans tous les autres cas. |
cancelable | false ; le comportement par défaut ne peut pas être annulé. |
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. |
relatedObject | Objet de la liste d’affichage sur lequel pointait le périphérique de pointage. |
localX | Coordonnée horizontale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé. |
localY | Coordonnée verticale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé. |
movementX | Changement de coordonnées horizontales de la position de la souris depuis le dernier événement de souris, si le verrouillage de la souris est activé. |
movementY | Changement de coordonnées verticales de la position de la souris depuis le dernier événement de souris, si le verrouillage de la souris est activé. |
shiftKey | true si la touche Maj est activée ; false si elle ne l’est pas. |
stageX | Coordonnée horizontale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène. |
stageY | Coordonnée verticale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène. |
target | Occurrence d’InteractiveObject sous le périphérique 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. |
mouseUp | Evénement |
flash.events.MouseEventpropriété MouseEvent.type =
flash.events.MouseEvent.MOUSE_UP| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Distribué lorsqu’un utilisateur relâche le bouton du périphérique de pointage sur une occurrence InteractiveObject. Si la cible est une occurrence de SimpleButton, l’objet présente l’objet d’affichage upState. Si la cible est un champ de texte sélectionnable, le champ de texte termine la sélection, ce qui est son comportement par défaut.
type d’un objet d’événement mouseUp.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
altKey | true si la touche Alt est activée (Windows). |
bubbles | true |
buttonDown | true si le bouton principal de la souris est enfoncé ; false dans tous les autres cas. |
cancelable | false ; le comportement par défaut ne peut pas être annulé. |
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. |
localX | Coordonnée horizontale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé. |
localY | Coordonnée verticale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé. |
movementX | Changement de coordonnées horizontales de la position de la souris depuis le dernier événement de souris, si le verrouillage de la souris est activé. |
movementY | Changement de coordonnées verticales de la position de la souris depuis le dernier événement de souris, si le verrouillage de la souris est activé. |
shiftKey | true si la touche Maj est activée ; false si elle ne l’est pas. |
clickCount | Décompte du nombre de clics souris pour indiquer si l’événement fait partie d’une séquence multi-clic. |
stageX | Coordonnée horizontale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène. |
stageY | Coordonnée verticale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène. |
target | Occurrence d’InteractiveObject sous le périphérique 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. |
mouseWheel | Evénement |
flash.events.MouseEventpropriété MouseEvent.type =
flash.events.MouseEvent.MOUSE_WHEEL| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, Flash Player 9 |
Distribué lorsque la molette d’une souris est actionnée sur une occurrence de InteractiveObject. Si la cible est un champ de texte, le comportement par défaut consiste à faire défiler le texte. Disponible uniquement sur les systèmes d’exploitation Microsoft Windows.
Définit la valeur de la propriététype d’un objet d’événement mouseWheel.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
altKey | true si la touche Alt est activée (Windows). |
bubbles | true |
buttonDown | true si le bouton principal de la souris est enfoncé ; false dans tous les autres cas. |
cancelable | false ; le comportement par défaut ne peut pas être annulé. |
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. |
delta | Nombre de lignes représenté par chaque cran de la molette de la souris. |
localX | Coordonnée horizontale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé. |
localY | Coordonnée verticale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé. |
movementX | Changement de coordonnées horizontales de la position de la souris depuis le dernier événement de souris, si le verrouillage de la souris est activé. |
movementY | Changement de coordonnées verticales de la position de la souris depuis le dernier événement de souris, si le verrouillage de la souris est activé. |
shiftKey | true si la touche Maj est activée ; false si elle ne l’est pas. |
stageX | Coordonnée horizontale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène. |
stageY | Coordonnée verticale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène. |
target | Occurrence d’InteractiveObject sous le périphérique 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. |
nativeDragComplete | Evénement |
flash.events.NativeDragEventpropriété NativeDragEvent.type =
flash.events.NativeDragEvent.NATIVE_DRAG_COMPLETE| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, Flash Lite 4 |
Distribué par l’initiateur glisser InteractiveObject lorsque l’utilisateur arrête l’opération glisser.
La propriété dropAction de l’événement indique l’action définie par l’objet cible drag ; une valeur "none" (DragActions.NONE) indique que l’opération déposer a été annulée ou refusée.
Le gestionnaire d’événement nativeDragComplete est un espace pratique permettant de mettre à jour l’état de l’objet d’affichage déclencheur, notamment en supprimant un élément d’une liste (sur un mouvement de glissement) ou en changeant les propriétés visuelles.
type d’un objet d’événement nativeDragComplete.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
allowedActions | L’objet NativeDragOptions spécifiant les actions liées à cette opération glisser. |
bubbles | true |
cancelable | false ; il n’existe aucun comportement par défaut à annuler. |
clipboard | L’objet Clipboard contenant les données glissées. |
dropAction | Action choisie par la cible de dépôt (ou none si aucune action n’est définie). |
nativeDragDrop | Evénement |
flash.events.NativeDragEventpropriété NativeDragEvent.type =
flash.events.NativeDragEvent.NATIVE_DRAG_DROP| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, Flash Lite 4 |
Distribué par l’objet InteractiveObject cible lorsqu’un objet glissé est déposé dessus et que l’opération déposer a été acceptée avec un appel à DragManager.acceptDragDrop().
Accédez aux données déposées à l’aide de la propriété clipboard de l’objet d’événement.
Le gestionnaire de cet événement doit régler la propriété DragManager.dropAction pour fournir des informations à l’objet déclencheur sur l’action glisser effectuée. Si aucune valeur n’est réglée, le DragManager sélectionne une valeur par défaut dans la liste des actions autorisées.
type d’un objet d’événement nativeDragDrop.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
allowedActions | L’objet NativeDragOptions spécifiant les actions liées à cette opération glisser. |
bubbles | true |
cancelable | true ; l’annulation de cet événement annule l’opération de déplacement. |
clipboard | L’objet Clipboard contenant les données glissées. Le presse-papiers peut être lu même si l’objet distribuant cet événement ne se trouve pas dans le même domaine de sécurité que l’initiateur. |
dropAction | Action choisie par la cible de dépôt (ou none si aucune action n’est définie). |
nativeDragEnter | Evénement |
flash.events.NativeDragEventpropriété NativeDragEvent.type =
flash.events.NativeDragEvent.NATIVE_DRAG_ENTER| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, Flash Lite 4 |
Distribué par un InteractiveObject lorsqu’une opération glisser entre dans ses limites.
Gérez les événements nativeDragEnter ou nativeDragOver pour permettre à l’objet d’affichage de devenir la cible déposer.
Pour déterminer si l’objet d’affichage de distribution peut accepter l’opération déposer, vérifiez si les données dans la propriété clipboard de l’objet d’événement sont adaptées, et les actions glisser dans la propriétéallowedActions.
type d’un objet d’événement nativeDragEnter.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
allowedActions | L’objet NativeDragOptions spécifiant les actions liées à cette opération glisser. |
bubbles | true |
cancelable | false ; il n’existe aucun comportement par défaut à annuler. |
clipboard | L’objet Clipboard contenant les données glissées. Le presse-papiers ne peut être lu que si l’objet distribuant cet événement se trouve dans le même domaine de sécurité que l’initiateur. |
dropAction | Action choisie par la cible de dépôt (ou none si aucune action n’est définie). |
nativeDragExit | Evénement |
flash.events.NativeDragEventpropriété NativeDragEvent.type =
flash.events.NativeDragEvent.NATIVE_DRAG_EXIT| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, Flash Lite 4 |
Distribué par un InteractiveObject lorsqu’une opération glisser sort des limites.
NativeDragEvent.NATIVE_DRAG_EXIT définit la valeur de la propriététype d’un objet d’événement nativeDragExit.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
allowedActions | L’objet NativeDragOptions spécifiant les actions liées à cette opération glisser. |
bubbles | true |
cancelable | false ; il n’existe aucun comportement par défaut à annuler. |
clipboard | L’objet Clipboard contenant les données glissées. Le presse-papiers ne peut être lu que si l’objet distribuant cet événement se trouve dans le même domaine de sécurité que l’initiateur. |
dropAction | Action choisie par la cible de dépôt (ou none si aucune action n’est définie). |
nativeDragOver | Evénement |
flash.events.NativeDragEventpropriété NativeDragEvent.type =
flash.events.NativeDragEvent.NATIVE_DRAG_OVER| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, Flash Lite 4 |
Distribué par un objet InteractiveObject de façon continue lorsqu’une opération glisser reste dans ses limites.
Les événements nativeDragOver sont distribués dès que la souris est déplacée. Sous Windows et Mac, ils sont également distribués après quelques secondes, même lorsque la souris n’a pas été déplacée.
Gérez les événements nativeDragOver ou nativeDragEnter pour permettre à l’objet d’affichage de devenir la cible déposer.
Pour déterminer si l’objet d’affichage de distribution peut accepter l’opération déposer, vérifiez si les données dans la propriété clipboard de l’objet d’événement sont adaptées, et les actions glisser dans la propriétéallowedActions.
type d’un objet d’événement nativeDragOver.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
allowedActions | L’objet NativeDragOptions spécifiant les actions liées à cette opération glisser. |
bubbles | true |
cancelable | true ; l’annulation de cet événement annule l’opération de déplacement. |
clipboard | L’objet Clipboard contenant les données glissées. Le presse-papiers ne peut être lu que si l’objet distribuant cet événement se trouve dans le même domaine de sécurité que l’initiateur. |
dropAction | Action choisie par la cible de dépôt (ou none si aucune action n’est définie). |
nativeDragStart | Evénement |
flash.events.NativeDragEventpropriété NativeDragEvent.type =
flash.events.NativeDragEvent.NATIVE_DRAG_START| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, Flash Lite 4 |
Distribué au début d’une opération glisser par l’objet InteractiveObject spécifié comme initiateur de l’action glisser dans l’appel DragManager.doDrag().
NativeDragEvent.NATIVE_DRAG_START définit la valeur de la propriététype d’un objet d’événement nativeDragStart.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
allowedActions | L’objet NativeDragOptions spécifiant les actions liées à cette opération glisser. |
bubbles | true |
cancelable | true ; l’annulation de cet événement annule l’opération de déplacement. |
clipboard | L’objet Clipboard contenant les données glissées. |
dropAction | Action choisie par la cible de dépôt (ou none si aucune action n’est définie). |
nativeDragUpdate | Evénement |
flash.events.NativeDragEventpropriété NativeDragEvent.type =
flash.events.NativeDragEvent.NATIVE_DRAG_UPDATE| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, Flash Lite 4 |
Distribué lors d’une opération glisser par l’objet InteractiveObject spécifié comme initiateur de l’action glisser dans l’appel DragManager.doDrag().
Les événements nativeDragUpdate ne sont pas distribués sous Linux.
type d’un objet d’événement nativeDragUpdate.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
allowedActions | L’objet NativeDragOptions spécifiant les actions liées à cette opération glisser. |
bubbles | true |
cancelable | false ; il n’existe aucun comportement par défaut à annuler. |
clipboard | L’objet Clipboard contenant les données glissées. |
dropAction | Action choisie par la cible de dépôt (ou none si aucune action n’est définie). |
paste | Evénement |
flash.events.Eventpropriété Event.type =
flash.events.Event.PASTE| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Distribué lorsque l’utilisateur active la combinaison de touches de raccourci propre à la plate-forme pour une opération de collage ou sélectionne "Coller" dans le menu contextuel. Cet événement est distribué à l’objet qui possède actuellement le focus. Si l’objet qui a le focus est un TextField, le comportement par défaut de cet événement est de coller le contenu du presse-papiers dans le champ de texte, au niveau du point d’insertion actuel, en remplaçant éventuellement le texte actuellement sélectionné dans le champ de texte.
La constanteEvent.PASTE définit la valeur de la propriété type d’un objet événement paste.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | true (false pour le moteur d’exécution AIR.) |
cancelable | false ; il n’existe aucun comportement par défaut à annuler. |
currentTarget | L’objet qui traite activement l’objet Event avec un écouteur d’événements. |
target | Toute occurrence InteractiveObject à laquelle est associé un écouteur pour l’événement paste. |
Remarque : les objets TextField ne distribuent pas les événements clear, copy, cut, paste ou selectAll. Les objets TextField incluent toujours les commandes Couper, Copier, Coller, Effacer et Sélectionner tout dans le menu contextuel. Vous ne pouvez pas supprimer ces commandes du menu contextuel pour les objets TextField. Pour les objets TextField, la sélection de ces commandes (ou leurs équivalents clavier) ne génère pas d’événement clear, copy, cut, paste ou selectAll. Toutefois, les autres classes qui étendent la classe InteractiveObject, y compris les composants intégrés à l’aide de Flash Text Engine (FTE), distribueront ces événements en réponse aux actions de l’utilisateur (raccourcis clavier et menus contextuels, entre autres).
proximityBegin | Evénement |
flash.events.TouchEventpropriété TouchEvent.type =
flash.events.TouchEvent.PROXIMITY_BEGIN| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 3 |
Distribué lorsque l’utilisateur approche un stylet actif de l’écran après le seuil de détection de proximité de l’écran.
Séquence typique d’événements qui se produit lorsqu’un utilisateur approche un stylet de l’écran, le déplace sur l’écran et le soulève pour le retirer :
- proximityBegin
- proximityMove
- touchBegin
- touchMove
- touchEnd
- proximityMove
- proximityEnd
Remarque : voir la classe Multitouch pour plus d’informations sur la compatibilité de l’environnement.
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 :
| 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. |
eventPhase | Phase actuelle du flux d’événements. |
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. |
pressure | 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. |
relatedObject | Référence à un objet de la liste d’affichage qui est associé à l’événement. |
shiftKey | true si la touche Maj est activée ; false si elle ne l’est pas. |
sizeX | Largeur de la surface de contact. |
sizeY | Hauteur de la surface de contact. |
stageX | Coordonnée horizontale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène. |
stageY | Coordonnée verticale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène. |
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. |
touchPointID | Numéro d’identification unique (sous la forme d’une valeur int) affecté au point tactile. |
timestamp | (AIR uniquement) La date et l’heure de l’événement en millisecondes par rapport au démarrage de l’application. |
touchIntent | (AIR uniquement) Une valeur de la classe TouchEventIntent. |
isTouchPointCanceled | (AIR uniquement) true si l’événement tactile est annulé à cause de la logique de rejet tactile du périphérique. |
Eléments de l’API associés
proximityEnd | Evénement |
flash.events.TouchEventpropriété TouchEvent.type =
flash.events.TouchEvent.PROXIMITY_END| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 3 |
Distribué lorsque l’utilisateur soulève un stylet actif au-dessus du seuil de détection de proximité de l’écran.
Aucun événement proximityEnd n’est distribué lorsque le stylet touche l’écran.
Séquence typique d’événements qui se produit lorsqu’un utilisateur approche un stylet de l’écran, le déplace sur l’écran et le soulève pour le retirer :
- proximityBegin
- proximityMove
- touchBegin
- touchMove
- touchEnd
- proximityMove
- proximityEnd
Remarque : voir la classe Multitouch pour plus d’informations sur la compatibilité de l’environnement.
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 :
| 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. |
eventPhase | Phase actuelle du flux d’événements. |
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. |
pressure | 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. |
relatedObject | Référence à un objet de la liste d’affichage qui est associé à l’événement. |
shiftKey | true si la touche Maj est activée ; false si elle ne l’est pas. |
sizeX | Largeur de la surface de contact. |
sizeY | Hauteur de la surface de contact. |
stageX | Coordonnée horizontale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène. |
stageY | Coordonnée verticale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène. |
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. |
touchPointID | Numéro d’identification unique (sous la forme d’une valeur int) affecté au point tactile. |
timestamp | (AIR uniquement) La date et l’heure de l’événement en millisecondes par rapport au démarrage de l’application. |
touchIntent | (AIR uniquement) Une valeur de la classe TouchEventIntent. |
isTouchPointCanceled | (AIR uniquement) true si l’événement tactile est annulé à cause de la logique de rejet tactile du périphérique. |
Eléments de l’API associés
proximityMove | Evénement |
flash.events.TouchEventpropriété TouchEvent.type =
flash.events.TouchEvent.PROXIMITY_MOVE| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 3 |
Distribué lorsque l’utilisateur déplace un stylet actif sur l’écran tout en respectant le seuil de détection de proximité.
Séquence typique d’événements qui se produit lorsqu’un utilisateur approche un stylet de l’écran, le déplace sur l’écran et le soulève pour le retirer :
- proximityBegin
- proximityMove
- touchBegin
- touchMove
- touchEnd
- proximityMove
- proximityEnd
Remarque : voir la classe Multitouch pour plus d’informations sur la compatibilité de l’environnement.
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 :
| 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. |
eventPhase | Phase actuelle du flux d’événements. |
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. |
pressure | 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. |
relatedObject | Référence à un objet de la liste d’affichage qui est associé à l’événement. |
shiftKey | true si la touche Maj est activée ; false si elle ne l’est pas. |
sizeX | Largeur de la surface de contact. |
sizeY | Hauteur de la surface de contact. |
stageX | Coordonnée horizontale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène. |
stageY | Coordonnée verticale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène. |
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. |
touchPointID | Numéro d’identification unique (sous la forme d’une valeur int) affecté au point tactile. |
timestamp | (AIR uniquement) La date et l’heure de l’événement en millisecondes par rapport au démarrage de l’application. |
touchIntent | (AIR uniquement) Une valeur de la classe TouchEventIntent. |
isTouchPointCanceled | (AIR uniquement) true si l’événement tactile est annulé à cause de la logique de rejet tactile du périphérique. |
Eléments de l’API associés
proximityOut | Evénement |
flash.events.TouchEventpropriété TouchEvent.type =
flash.events.TouchEvent.PROXIMITY_OUT| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 3 |
Distribué lorsque l’utilisateur déplace un stylet actif en dehors de cet objet InteractiveObject, tout en respectant le seuil de détection de proximité de l’écran.
Remarque : voir la classe Multitouch pour plus d’informations sur la compatibilité de l’environnement.
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 :
| 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. |
eventPhase | Phase actuelle du flux d’événements. |
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. |
pressure | 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. |
relatedObject | Référence à un objet de la liste d’affichage qui est associé à l’événement. |
shiftKey | true si la touche Maj est activée ; false si elle ne l’est pas. |
sizeX | Largeur de la surface de contact. |
sizeY | Hauteur de la surface de contact. |
stageX | Coordonnée horizontale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène. |
stageY | Coordonnée verticale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène. |
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. |
touchPointID | Numéro d’identification unique (sous la forme d’une valeur int) affecté au point tactile. |
timestamp | (AIR uniquement) La date et l’heure de l’événement en millisecondes par rapport au démarrage de l’application. |
touchIntent | (AIR uniquement) Une valeur de la classe TouchEventIntent. |
isTouchPointCanceled | (AIR uniquement) true si l’événement tactile est annulé à cause de la logique de rejet tactile du périphérique. |
Eléments de l’API associés
proximityOver | Evénement |
flash.events.TouchEventpropriété TouchEvent.type =
flash.events.TouchEvent.PROXIMITY_OVER| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 3 |
Distribué lorsque l’utilisateur déplace un stylet actif directement au-dessus de cet objet InteractiveObject, tout en respectant le seuil de détection de proximité de l’écran.
Remarque : voir la classe Multitouch pour plus d’informations sur la compatibilité de l’environnement.
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 :
| 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. |
eventPhase | Phase actuelle du flux d’événements. |
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. |
pressure | 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. |
relatedObject | Référence à un objet de la liste d’affichage qui est associé à l’événement. |
shiftKey | true si la touche Maj est activée ; false si elle ne l’est pas. |
sizeX | Largeur de la surface de contact. |
sizeY | Hauteur de la surface de contact. |
stageX | Coordonnée horizontale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène. |
stageY | Coordonnée verticale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène. |
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. |
touchPointID | Numéro d’identification unique (sous la forme d’une valeur int) affecté au point tactile. |
timestamp | (AIR uniquement) La date et l’heure de l’événement en millisecondes par rapport au démarrage de l’application. |
touchIntent | (AIR uniquement) Une valeur de la classe TouchEventIntent. |
isTouchPointCanceled | (AIR uniquement) true si l’événement tactile est annulé à cause de la logique de rejet tactile du périphérique. |
Eléments de l’API associés
proximityRollOut | Evénement |
flash.events.TouchEventpropriété TouchEvent.type =
flash.events.TouchEvent.PROXIMITY_ROLL_OUT| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 3 |
Distribué lorsque l’utilisateur déplace un stylet actif hors de cet objet InteractiveObject et de l’un de ses enfants, tout en respectant le seuil de détection de proximité de l’écran.
L’événement a pour cible l’objet placé précédemment sous le périphérique de pointage ou un parent de cet objet. L’objet relatedObject correspond à l’objet au dessus duquel le stylet a été placé. Les événements proximityRollOut sont envoyés de façon consécutive vers le haut de la chaîne parent de l’objet, en commençant par l’objet et en se terminant par le parent de plus haut niveau qui n’est ni la racine, ni l’ancêtre de relatedObject.
L’événement proximityRollOut a pour objet de simplifier le codage des comportements de survol des conteneurs d’objet d’affichage avec enfants. Lorsque le stylet quitte la zone d’un objet d’affichage ou de l’un de ses enfants pour atteindre un objet qui ne fait pas partie de ses enfants, l’objet d’affichage distribue l’événement proximityRollOut. Ce comportement diffère de celui de l’événement proximityOut, qui est envoyé lorsque la souris quitte la zone d’un objet enfant du conteneur d’objet d’affichage, même si la souris reste au-dessus d’un autre objet enfant du conteneur d’objet d’affichage.
Remarque : voir la classe Multitouch pour plus d’informations sur la compatibilité de l’environnement.
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 :
| 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. |
eventPhase | Phase actuelle du flux d’événements. |
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. |
pressure | 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. |
relatedObject | Référence à un objet de la liste d’affichage qui est associé à l’événement. |
shiftKey | true si la touche Maj est activée ; false si elle ne l’est pas. |
sizeX | Largeur de la surface de contact. |
sizeY | Hauteur de la surface de contact. |
stageX | Coordonnée horizontale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène. |
stageY | Coordonnée verticale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène. |
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. |
touchPointID | Numéro d’identification unique (sous la forme d’une valeur int) affecté au point tactile. |
timestamp | (AIR uniquement) La date et l’heure de l’événement en millisecondes par rapport au démarrage de l’application. |
touchIntent | (AIR uniquement) Une valeur de la classe TouchEventIntent. |
isTouchPointCanceled | (AIR uniquement) true si l’événement tactile est annulé à cause de la logique de rejet tactile du périphérique. |
Eléments de l’API associés
proximityRollOver | Evénement |
flash.events.TouchEventpropriété TouchEvent.type =
flash.events.TouchEvent.PROXIMITY_ROLL_OVER| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 3 |
Distribué lorsque l’utilisateur déplace un stylet actif sur cet objet InteractiveObject de l’extérieur de l’arborescence d’objets de descendants dans la liste d’affichage (tout en respectant le seuil de détection de proximité de l’écran).
L’événement a pour cible l’objet placé sous le stylet ou un parent de cet objet. relatedObject correspond à l’objet précédemment placé sous le stylet. Les événements proximityRollOver sont envoyés de façon consécutive vers le bas de la chaîne parent de l’objet, en commençant par le parent de plus haut niveau qui ne constitue ni la racine, ni l’ancêtre de relatedObject et se termine par l’objet.
L’événement proximityRollOver a pour objet de simplifier le codage des comportements de fin de sélection des conteneurs d’objet d’affichage avec enfants. Lorsque la souris pénètre dans la zone d’un objet d’affichage ou de l’un de ses enfants à partir d’un objet qui ne fait pas partie de ses enfants, l’objet d’affichage distribue l’événement proximityRollOver. Ce comportement diffère de celui de l’événement proximityOver, qui est envoyé lorsque la souris entre dans la zone d’un objet enfant du conteneur d’objet d’affichage, même si la souris reste au-dessus d’un autre objet enfant du conteneur d’objet d’affichage.
Remarque : voir la classe Multitouch pour plus d’informations sur la compatibilité de l’environnement.
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 :
| 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. |
eventPhase | Phase actuelle du flux d’événements. |
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. |
pressure | 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. |
relatedObject | Référence à un objet de la liste d’affichage qui est associé à l’événement. |
shiftKey | true si la touche Maj est activée ; false si elle ne l’est pas. |
sizeX | Largeur de la surface de contact. |
sizeY | Hauteur de la surface de contact. |
stageX | Coordonnée horizontale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène. |
stageY | Coordonnée verticale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène. |
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. |
touchPointID | Numéro d’identification unique (sous la forme d’une valeur int) affecté au point tactile. |
timestamp | (AIR uniquement) La date et l’heure de l’événement en millisecondes par rapport au démarrage de l’application. |
touchIntent | (AIR uniquement) Une valeur de la classe TouchEventIntent. |
isTouchPointCanceled | (AIR uniquement) true si l’événement tactile est annulé à cause de la logique de rejet tactile du périphérique. |
Eléments de l’API associés
releaseOutside | Evénement |
flash.events.MouseEventpropriété MouseEvent.type =
flash.events.MouseEvent.RELEASE_OUTSIDE| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 3.3, Flash Player 11.3 |
Distribué lorsqu’un utilisateur relâche le bouton du périphérique de pointage après avoir appuyé sur le bouton sur une occurrence d’InteractiveObject, puis après avoir déplacé le périphérique de pointage hors de l’occurrence d’InteractiveObject. Si la cible est une occurrence de SimpleButton, l’objet présente l’objet d’affichage upState. Si la cible est un champ de texte sélectionnable, le champ de texte termine la sélection, ce qui est son comportement par défaut.
type d’un objet d’événement releaseOutside.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
altKey | true si la touche Alt est activée (Windows). |
bubbles | true |
buttonDown | false |
cancelable | false ; le comportement par défaut ne peut pas être annulé. |
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. |
localX | Coordonnée horizontale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé. |
localY | Coordonnée verticale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé. |
shiftKey | true si la touche Maj est activée ; false si elle ne l’est pas. |
clickCount | Décompte du nombre de clics souris pour indiquer si l’événement fait partie d’une séquence multi-clic. |
stageX | Coordonnée horizontale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène. |
stageY | Coordonnée verticale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène. |
target | L’objet InteractiveObject qui pointe vers le bouton du périphérique est tout d’abord enfoncé hors de l’occurrence, puis relâché. 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. |
rightClick | Evénement |
flash.events.MouseEventpropriété MouseEvent.type =
flash.events.MouseEvent.RIGHT_CLICK| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, Flash Lite 4 |
Distribué lorsque l’utilisateur appuie sur le bouton droit de son périphérique de pointage et le relâche sur la même occurrence de InteractiveObject. Pour qu’un événement rightClick se produise, il doit toujours suivre cette série d’événements dans l’ordre suivant : événement rightMouseDown, puis rightMouseUp. L’objet cible doit être identique pour ces deux événements, sans quoi l’événement rightClick ne se produit pas. Quel que soit le nombre d’autres événements de souris effectués entre les événements rightmouseDown et rightmouseUp, l’événement rightclick se produit.
type d’un objet d’événement rightClick.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
altKey | true si la touche Alt est activée (Windows). |
bubbles | true |
buttonDown | Pour les événements de clic droit, cette valeur est toujours définie sur false. |
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. |
localX | Coordonnée horizontale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé. |
localY | Coordonnée verticale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé. |
movementX | Changement de coordonnées horizontales de la position de la souris depuis le dernier événement de souris, si le verrouillage de la souris est activé. |
movementY | Changement de coordonnées verticales de la position de la souris depuis le dernier événement de souris, si le verrouillage de la souris est activé. |
shiftKey | true si la touche Maj est activée ; false si elle ne l’est pas. |
stageX | Coordonnée horizontale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène. |
stageY | Coordonnée verticale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène. |
target | Occurrence d’InteractiveObject sous le périphérique 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. |
rightMouseDown | Evénement |
flash.events.MouseEventpropriété MouseEvent.type =
flash.events.MouseEvent.RIGHT_MOUSE_DOWN| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, Flash Lite 4 |
Distribué lorsqu’un utilisateur appuie sur le bouton du périphérique de pointage sur une occurrence InteractiveObject.
Définit la valeur de la propriététype d’un objet d’événement rightMouseDown.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
altKey | true si la touche Alt est activée (Windows). |
bubbles | true |
buttonDown | Pour les événements de clic droit, cette valeur est toujours définie sur true. |
cancelable | false ; le comportement par défaut ne peut pas être annulé. |
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. |
localX | Coordonnée horizontale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé. |
localY | Coordonnée verticale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé. |
movementX | Changement de coordonnées horizontales de la position de la souris depuis le dernier événement de souris, si le verrouillage de la souris est activé. |
movementY | Changement de coordonnées verticales de la position de la souris depuis le dernier événement de souris, si le verrouillage de la souris est activé. |
shiftKey | true si la touche Maj est activée ; false si elle ne l’est pas. |
clickCount | Décompte du nombre de clics souris pour indiquer si l’événement fait partie d’une séquence multi-clic. |
stageX | Coordonnée horizontale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène. |
stageY | Coordonnée verticale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène. |
target | Occurrence d’InteractiveObject sous le périphérique 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. |
rightMouseUp | Evénement |
flash.events.MouseEventpropriété MouseEvent.type =
flash.events.MouseEvent.RIGHT_MOUSE_UP| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, Flash Lite 4 |
Distribué lorsqu’un utilisateur relâche le bouton du périphérique de pointage sur une occurrence InteractiveObject.
Définit la valeur de la propriététype d’un objet d’événement rightMouseUp.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
altKey | true si la touche Alt est activée (Windows). |
bubbles | true |
buttonDown | true si le bouton droit de la souris est enfoncé ; false dans tous les autres cas. |
cancelable | false ; le comportement par défaut ne peut pas être annulé. |
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. |
localX | Coordonnée horizontale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé. |
localY | Coordonnée verticale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé. |
movementX | Changement de coordonnées horizontales de la position de la souris depuis le dernier événement de souris, si le verrouillage de la souris est activé. |
movementY | Changement de coordonnées verticales de la position de la souris depuis le dernier événement de souris, si le verrouillage de la souris est activé. |
shiftKey | true si la touche Maj est activée ; false si elle ne l’est pas. |
clickCount | Décompte du nombre de clics souris pour indiquer si l’événement fait partie d’une séquence multi-clic. |
stageX | Coordonnée horizontale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène. |
stageY | Coordonnée verticale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène. |
target | Occurrence d’InteractiveObject sous le périphérique 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. |
rollOut | Evénement |
flash.events.MouseEventpropriété MouseEvent.type =
flash.events.MouseEvent.ROLL_OUT| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Distribué lorsque l’utilisateur éloigne un périphérique de pointage d’une occurrence de InteractiveObject. L’événement a pour cible l’objet placé précédemment sous le périphérique de pointage ou un parent de cet objet. L’objet relatedObject correspond à l’objet sur lequel s’est placé le périphérique de pointage. Les événements rollOut sont envoyés de façon consécutive vers le haut de la chaîne parent de l’objet, en commençant par l’objet et en se terminant par le parent de plus haut niveau qui n’est ni la racine, ni l’ancêtre de relatedObject.
L’événement rollOut a pour objet de simplifier le codage des comportements de survol des conteneurs d’objet d’affichage avec enfants. Lorsque la souris quitte la zone d’un objet d’affichage ou de l’un de ses enfants pour atteindre un objet qui ne fait pas partie de ses enfants, l’objet d’affichage distribue l’événement rollOut. Ce comportement diffère de celui de l’événement mouseOut, qui est envoyé lorsque la souris quitte la zone d’un objet enfant du conteneur d’objet d’affichage, même si la souris reste au-dessus d’un autre objet enfant du conteneur d’objet d’affichage.
type d’un objet d’événement rollOut.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
altKey | true si la touche Alt est activée (Windows). |
bubbles | false |
buttonDown | true si le bouton principal de la souris est enfoncé ; false dans tous les autres cas. |
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. |
relatedObject | Objet de la liste d’affichage sur lequel pointe actuellement le périphérique de pointage. |
localX | Coordonnée horizontale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé. |
localY | Coordonnée verticale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé. |
movementX | Changement de coordonnées horizontales de la position de la souris depuis le dernier événement de souris, si le verrouillage de la souris est activé. |
movementY | Changement de coordonnées verticales de la position de la souris depuis le dernier événement de souris, si le verrouillage de la souris est activé. |
shiftKey | true si la touche Maj est activée ; false si elle ne l’est pas. |
stageX | Coordonnée horizontale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène. |
stageY | Coordonnée verticale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène. |
target | Occurrence d’InteractiveObject sous le périphérique 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. |
rollOver | Evénement |
flash.events.MouseEventpropriété MouseEvent.type =
flash.events.MouseEvent.ROLL_OVER| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Distribué lorsque l’utilisateur place un périphérique de pointage sur une occurrence de InteractiveObject. L’événement a pour cible l’objet placé sous le périphérique de pointage ou un parent de cet objet. relatedObject correspond à l’objet précédemment placé sous le périphérique de pointage. Les événements rollOver sont envoyés de façon consécutive vers le bas de la chaîne parent de l’objet, en commençant par le parent de plus haut niveau qui ne constitue ni la racine, ni l’ancêtre de relatedObject et se termine par l’objet.
L’événement rollOver a pour objet de simplifier le codage des comportements de fin de sélection des conteneurs d’objet d’affichage avec enfants. Lorsque la souris pénètre dans la zone d’un objet d’affichage ou de l’un de ses enfants à partir d’un objet qui ne fait pas partie de ses enfants, l’objet d’affichage distribue l’événement rollOver. Ce comportement diffère de celui de l’événement mouseOver, qui est envoyé lorsque la souris entre dans la zone d’un objet enfant du conteneur d’objet d’affichage, même si la souris reste au-dessus d’un autre objet enfant du conteneur d’objet d’affichage.
type d’un objet d’événement rollOver.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
altKey | true si la touche Alt est activée (Windows). |
bubbles | false |
buttonDown | true si le bouton principal de la souris est enfoncé ; false dans tous les autres cas. |
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. |
relatedObject | Objet de la liste d’affichage sur lequel pointait le périphérique de pointage. |
localX | Coordonnée horizontale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé. |
localY | Coordonnée verticale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé. |
movementX | Changement de coordonnées horizontales de la position de la souris depuis le dernier événement de souris, si le verrouillage de la souris est activé. |
movementY | Changement de coordonnées verticales de la position de la souris depuis le dernier événement de souris, si le verrouillage de la souris est activé. |
shiftKey | true si la touche Maj est activée ; false si elle ne l’est pas. |
stageX | Coordonnée horizontale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène. |
stageY | Coordonnée verticale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène. |
target | Occurrence d’InteractiveObject sous le périphérique 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. |
selectAll | Evénement |
flash.events.Eventpropriété Event.type =
flash.events.Event.SELECT_ALL| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Distribué lorsque l’utilisateur active la combinaison de touches de raccourci propre à la plate-forme pour tout sélectionner ou choisit "Sélectionner tout" dans le menu contextuel. Cet événement est distribué à l’objet qui possède actuellement le focus. Si l’objet qui a actuellement le focus est un TextField, le comportement par défaut de cet événement est de sélectionner l’ensemble du contenu du champ de texte.
La constanteEvent.SELECT_ALL définit la valeur de la propriété type d’un objet événement selectAll.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
cancelable | false ; il n’existe aucun comportement par défaut à annuler. |
currentTarget | L’objet qui traite activement l’objet Event avec un écouteur d’événements. |
target | Toute occurrence InteractiveObject à laquelle est associé un écouteur pour l’événement selectAll. |
Remarque : les objets TextField ne distribuent pas les événements clear, copy, cut, paste ou selectAll. Les objets TextField incluent toujours les commandes Couper, Copier, Coller, Effacer et Sélectionner tout dans le menu contextuel. Vous ne pouvez pas supprimer ces commandes du menu contextuel pour les objets TextField. Pour les objets TextField, la sélection de ces commandes (ou leurs équivalents clavier) ne génère pas d’événement clear, copy, cut, paste ou selectAll. Toutefois, les autres classes qui étendent la classe InteractiveObject, y compris les composants intégrés à l’aide de Flash Text Engine (FTE), distribueront ces événements en réponse aux actions de l’utilisateur (raccourcis clavier et menus contextuels, entre autres).
softKeyboardActivate | Evénement |
flash.events.SoftKeyboardEventpropriété SoftKeyboardEvent.type =
flash.events.SoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATE| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10.2, AIR 2.6 |
Distribué immédiatement après l’affichage du clavier logiciel.
La constanteSoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATE définit la valeur de la propriété type de l’objet SoftKeyboardEvent lors de l’affichage d’un clavier logiciel. Pour cet événement, cancellable = false.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
type | SOFT_KEYBOARD_ACTIVATE |
bubbles | true |
cancelable | false ; il n’existe aucun comportement par défaut à annuler. |
relatedObjectVal | Référence à un objet de la liste d’affichage qui est associé à l’événement. |
triggerTypeVal | Indique si l’événement de clavier a été déclenché par une application ou un utilisateur. |
currentTarget | L’objet qui traite activement l’objet Event avec un écouteur d’événements. |
Eléments de l’API associés
softKeyboardActivating | Evénement |
flash.events.SoftKeyboardEventpropriété SoftKeyboardEvent.type =
flash.events.SoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATING| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10.2, AIR 2.6 |
Distribué immédiatement avant l’affichage du clavier logiciel.
La constanteSoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATING définit la valeur de la propriété type de l’objet SoftKeyboardEvent immédiatement avant l’affichage d’un clavier logiciel. Pour cet événement, cancellable = true.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
type | SOFT_KEYBOARD_ACTIVATING |
bubbles | true |
cancelable | true, à moins que l’événement soit distribué par un objet StageText. Pour les objets StageText, l’événement n’est pas annulable. |
relatedObjectVal | Référence à un objet de la liste d’affichage qui est associé à l’événement. |
triggerTypeVal | Indique si l’événement de clavier a été déclenché par une application ou un utilisateur. |
currentTarget | L’objet qui traite activement l’objet Event avec un écouteur d’événements. |
Eléments de l’API associés
softKeyboardDeactivate | Evénement |
flash.events.SoftKeyboardEventpropriété SoftKeyboardEvent.type =
flash.events.SoftKeyboardEvent.SOFT_KEYBOARD_DEACTIVATE| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10.2, AIR 2.6 |
Distribué immédiatement après la disparition du clavier logiciel.
La constanteSoftKeyboardEvent.SOFT_KEYBOARD_DEACTIVATE définit la valeur de la propriété type de l’objet SoftKeyboardEvent lors de la disparition ou du masquage d’un clavier logiciel. Pour cet événement, cancellable = false.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
type | SOFT_KEYBOARD_DEACTIVATE |
bubbles | true |
cancelable | false ; il n’existe aucun comportement par défaut à annuler. |
relatedObjectVal | Référence à un objet de la liste d’affichage qui est associé à l’événement. |
triggerTypeVal | Indique si l’événement de clavier a été déclenché par une application ou un utilisateur. |
currentTarget | L’objet qui traite activement l’objet Event avec un écouteur d’événements. |
Eléments de l’API associés
tabChildrenChange | Evénement |
flash.events.Eventpropriété Event.type =
flash.events.Event.TAB_CHILDREN_CHANGE| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, Flash Player 9 |
Distribué lorsque la valeur de l’indicateur tabChildren de l’objet change.
Event.TAB_CHILDREN_CHANGE définit la valeur de la propriété type d’un objet événement tabChildrenChange.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | true |
cancelable | false ; il n’existe aucun comportement par défaut à annuler. |
currentTarget | L’objet qui traite activement l’objet Event avec un écouteur d’événements. |
target | Objet dont l’indicateur tabChildren a changé. 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. |
tabEnabledChange | Evénement |
flash.events.Eventpropriété Event.type =
flash.events.Event.TAB_ENABLED_CHANGE| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, Flash Player 9 |
Distribué lorsque l’indicateur tabEnabled de l’objet change.
Event.TAB_ENABLED_CHANGE définit la valeur de la propriété type d’un objet d’événement tabEnabledChange.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | true |
cancelable | false ; il n’existe aucun comportement par défaut à annuler. |
currentTarget | L’objet qui traite activement l’objet Event avec un écouteur d’événements. |
target | Objet InteractiveObject dont l’indicateur tabEnabled a changé. 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. |
tabIndexChange | Evénement |
flash.events.Eventpropriété Event.type =
flash.events.Event.TAB_INDEX_CHANGE| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, Flash Player 9 |
Distribué lorsque la valeur de la propriété tabIndex de l’objet change.
Event.TAB_INDEX_CHANGE définit la valeur de la propriété type d’un objet d’événement tabIndexChange.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | true |
cancelable | false ; il n’existe aucun comportement par défaut à annuler. |
currentTarget | L’objet qui traite activement l’objet Event avec un écouteur d’événements. |
target | Objet dont l’indicateur tabIndex a changé. 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. |
textInput | Evénement |
flash.events.TextEventpropriété TextEvent.type =
flash.events.TextEvent.TEXT_INPUT| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Distribué lorsqu’un utilisateur entre un ou plusieurs caractères de texte. Différentes méthodes de saisie de texte peuvent générer cet événement, ce qui inclut les claviers standard, les éditeurs de méthode d’entrée (IME), les systèmes de reconnaissance vocale, voire même la copie de texte simple sans formatage ni ajout de style.
Définit la valeur de la propriététype d’un objet événement textInput.
Remarque : cet événement n’est pas distribué pour les touches Supprimer ou Retour arrière.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | true |
cancelable | true ; appelez la méthode preventDefault() pour annuler le comportement par défaut. |
currentTarget | L’objet qui traite activement l’objet Event avec un écouteur d’événements. |
target | Champ de texte dans lequel sont entrés des caractères. La cible 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. |
text | Caractère ou série de caractères entré par l’utilisateur. |
touchBegin | Evénement |
flash.events.TouchEventpropriété TouchEvent.type =
flash.events.TouchEvent.TOUCH_BEGIN| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Distribué lorsque l’utilisateur touche pour la première fois un périphérique tactile (notamment lorsqu’il pose un doigt sur un téléphone portable ou une tablette munis d’un écran tactile). Certains périphériques peuvent également interpréter ce contact comme un événement mouseDown.
De façon plus spécifique, si un utilisateur pose le doigt sur écran tactile, l’occurrence d’InteractiveObject peut distribuer un événement mouseDown ou un événement touchBegin, ou les deux si l’environnement actuel le permet. Choisissez la manière dont vous souhaitez gérer l’interaction de l’utilisateur. Utilisez la classe flash.ui.Multitouch pour gérer les événements tactiles (activez la gestion des événements de mouvements tactiles ou la gestion des événements de points tactiles simples, ou désactivez les événements tactiles afin de ne distribuer que les événements de souris). Si vous choisissez de gérer l’événement mouseDown, le gestionnaire d’événement sera exécuté sur un périphérique tactile et sur un périphérique de type souris. Toutefois, si vous choisissez de gérer l’événement touchBegin, vous pouvez concevoir votre gestionnaire d’événement de façon à répondre aux besoins spécifiques d’un environnement tactile et à fournir aux utilisateurs des fonctionnalités tactiles avancées. Vous pouvez également gérer ces deux événements de façon indépendante pour fournir une réponse différente selon qu’il s’agit d’un événement tactile ou d’un événement de souris.
Remarque : voir la classe Multitouch pour plus d’informations sur la compatibilité de l’environnement.
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 :
| 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. |
eventPhase | Phase actuelle du flux d’événements. |
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. |
pressure | 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. |
relatedObject | Référence à un objet de la liste d’affichage qui est associé à l’événement. |
shiftKey | true si la touche Maj est activée ; false si elle ne l’est pas. |
sizeX | Largeur de la surface de contact. |
sizeY | Hauteur de la surface de contact. |
stageX | Coordonnée horizontale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène. |
stageY | Coordonnée verticale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène. |
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. |
touchPointID | Numéro d’identification unique (sous la forme d’une valeur int) affecté au point tactile. |
Exemple ( Comment utiliser cet exemple )
TOUCH_BEGIN, TOUCH_MOVE et TOUCH_END. Lorsque le point de contact se déplace sur l’écran (onTouchMove), la coordonnée x par rapport à la scène est tracée à la sortie. Pour les paramètres sprite.startTouchDrag de la fonction onTouchBegin, la valeur de touchPointID correspond à la valeur affectée à l’objet d’événement. Le paramètre bounds correspond au rectangle qui définit les limites de l’objet d’affichage parent (bg est un objet d’affichage contenant MySprite).
Multitouch.inputMode = MultitouchInputMode.TOUCH_POINT;
MySprite.addEventListener(TouchEvent.TOUCH_BEGIN, onTouchBegin);
MySprite.addEventListener(TouchEvent.TOUCH_MOVE, onTouchMove);
MySprite.addEventListener(TouchEvent.TOUCH_END, onTouchEnd);
function onTouchBegin(eBegin:TouchEvent) {
eBegin.target.startTouchDrag(eBegin.touchPointID, false, bg.getRect(this));
trace("touch begin");
}
function onTouchMove(eMove:TouchEvent) {
trace(eMove.stageX);
}
function onTouchEnd(eEnd:TouchEvent) {
eEnd.target.stopTouchDrag(eEnd.touchPointID);
trace("touch end");
}
Eléments de l’API associés
touchEnd | Evénement |
flash.events.TouchEventpropriété TouchEvent.type =
flash.events.TouchEvent.TOUCH_END| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Distribué lorsque l’utilisateur cesse le contact avec un périphérique tactile (notamment lorsqu’il retire le doigt d’un téléphone portable ou d’une tablette munis d’un écran tactile). Certains périphériques peuvent également interpréter ce contact comme un événement mouseUp.
De façon plus spécifique, si un utilisateur retire le doigt d’un écran tactile, l’occurrence d’InteractiveObject peut distribuer un événement mouseEnd ou un événement touchEnd, ou les deux si l’environnement actuel le permet. Choisissez la manière dont vous souhaitez gérer l’interaction de l’utilisateur. Utilisez la classe flash.ui.Multitouch pour gérer les événements tactiles (activez la gestion des événements de mouvements tactiles ou la gestion des événements de points tactiles simples, ou désactivez les événements tactiles afin de ne distribuer que les événements de souris). Si vous choisissez de gérer l’événement mouseUp, le gestionnaire d’événement sera exécuté sur un périphérique tactile et sur un périphérique de type souris. Toutefois, si vous choisissez de gérer l’événement touchEnd, vous pouvez concevoir votre gestionnaire d’événement de façon à répondre aux besoins spécifiques d’un environnement tactile et à fournir aux utilisateurs des fonctionnalités tactiles avancées. Vous pouvez également gérer ces deux événements de façon indépendante pour fournir une réponse différente selon qu’il s’agit d’un événement tactile ou d’un événement de souris.
Remarque : voir la classe Multitouch pour plus d’informations sur la compatibilité de l’environnement.
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 :
| 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. |
eventPhase | Phase actuelle du flux d’événements. |
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. |
pressure | 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. |
relatedObject | Référence à un objet de la liste d’affichage qui est associé à l’événement. |
shiftKey | true si la touche Maj est activée ; false si elle ne l’est pas. |
sizeX | Largeur de la surface de contact. |
sizeY | Hauteur de la surface de contact. |
stageX | Coordonnée horizontale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène. |
stageY | Coordonnée verticale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène. |
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. |
touchPointID | Numéro d’identification unique (sous la forme d’une valeur int) affecté au point tactile. |
Exemple ( Comment utiliser cet exemple )
TOUCH_BEGIN, TOUCH_MOVE et TOUCH_END. Lorsque le point de contact se déplace sur l’écran (onTouchMove), la coordonnée x par rapport à la scène est tracée à la sortie. Pour les paramètres sprite.startTouchDrag de la fonction onTouchBegin, la valeur de touchPointID correspond à la valeur affectée à l’objet d’événement. Le paramètre bounds correspond au rectangle qui définit les limites de l’objet d’affichage parent (bg est un objet d’affichage contenant MySprite).
Multitouch.inputMode = MultitouchInputMode.TOUCH_POINT;
MySprite.addEventListener(TouchEvent.TOUCH_BEGIN, onTouchBegin);
MySprite.addEventListener(TouchEvent.TOUCH_MOVE, onTouchMove);
MySprite.addEventListener(TouchEvent.TOUCH_END, onTouchEnd);
function onTouchBegin(eBegin:TouchEvent) {
eBegin.target.startTouchDrag(eBegin.touchPointID, false, bg.getRect(this));
trace("touch begin");
}
function onTouchMove(eMove:TouchEvent) {
trace(eMove.stageX);
}
function onTouchEnd(eEnd:TouchEvent) {
eEnd.target.stopTouchDrag(eEnd.touchPointID);
trace("touch end");
}
Eléments de l’API associés
touchMove | Evénement |
flash.events.TouchEventpropriété TouchEvent.type =
flash.events.TouchEvent.TOUCH_MOVE| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Distribué lorsque l’utilisateur appuie sur le périphérique, et est continuellement distribué jusqu’au retrait du point de contact. Notez que cet événement ne nécessite pas un mouvement du point de contact pour être distribué.
Certains périphériques peuvent interpréter ce contact comme un événement mouseMove. De façon plus spécifique, si un utilisateur déplace un doigt sur un écran tactile, l’occurrence d’InteractiveObject peut distribuer un événement mouseMove ou un événement touchMove, ou les deux si l’environnement actuel le permet. Choisissez la manière dont vous souhaitez gérer l’interaction de l’utilisateur. Utilisez la classe flash.ui.Multitouch pour gérer les événements tactiles (activez la gestion des événements de mouvements tactiles ou la gestion des événements de points tactiles simples, ou désactivez les événements tactiles afin de ne distribuer que les événements de souris). Si vous choisissez de gérer l’événement mouseMove, le gestionnaire d’événement sera exécuté sur un périphérique tactile et sur un périphérique de type souris. Toutefois, si vous choisissez de gérer l’événement touchMove, vous pouvez concevoir votre gestionnaire d’événement de façon à répondre aux besoins spécifiques d’un environnement tactile et à fournir aux utilisateurs des fonctionnalités tactiles avancées. Vous pouvez également gérer ces deux événements de façon indépendante pour fournir une réponse différente selon qu’il s’agit d’un événement tactile ou d’un événement de souris.
Remarque : voir la classe Multitouch pour plus d’informations sur la compatibilité de l’environnement.
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 :
| 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. |
eventPhase | Phase actuelle du flux d’événements. |
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. |
pressure | 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. |
relatedObject | Référence à un objet de la liste d’affichage qui est associé à l’événement. |
shiftKey | true si la touche Maj est activée ; false si elle ne l’est pas. |
sizeX | Largeur de la surface de contact. |
sizeY | Hauteur de la surface de contact. |
stageX | Coordonnée horizontale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène. |
stageY | Coordonnée verticale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène. |
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. |
touchPointID | Numéro d’identification unique (sous la forme d’une valeur int) affecté au point tactile. |
Exemple ( Comment utiliser cet exemple )
TOUCH_BEGIN, TOUCH_MOVE et TOUCH_END. Lorsque le point de contact se déplace sur l’écran (onTouchMove), la coordonnée x par rapport à la scène est tracée à la sortie. Pour les paramètres sprite.startTouchDrag de la fonction onTouchBegin, la valeur de touchPointID correspond à la valeur affectée à l’objet d’événement. Le paramètre bounds correspond au rectangle qui définit les limites de l’objet d’affichage parent (bg est un objet d’affichage contenant MySprite).
Multitouch.inputMode = MultitouchInputMode.TOUCH_POINT;
MySprite.addEventListener(TouchEvent.TOUCH_BEGIN, onTouchBegin);
MySprite.addEventListener(TouchEvent.TOUCH_MOVE, onTouchMove);
MySprite.addEventListener(TouchEvent.TOUCH_END, onTouchEnd);
function onTouchBegin(eBegin:TouchEvent) {
eBegin.target.startTouchDrag(eBegin.touchPointID, false, bg.getRect(this));
trace("touch begin");
}
function onTouchMove(eMove:TouchEvent) {
trace(eMove.stageX);
}
function onTouchEnd(eEnd:TouchEvent) {
eEnd.target.stopTouchDrag(eEnd.touchPointID);
trace("touch end");
}
Eléments de l’API associés
touchOut | Evénement |
flash.events.TouchEventpropriété TouchEvent.type =
flash.events.TouchEvent.TOUCH_OUT| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Distribué lorsque l’utilisateur retire le point de contact d’une occurrence d’InteractiveObject sur un périphérique tactile (notamment lorsqu’il fait glisser un doigt d’un objet d’affichage vers un autre sur un téléphone portable ou une tablette munis d’un écran tactile). Certains périphériques peuvent également interpréter ce contact comme un événement mouseOut.
De façon plus spécifique, si un utilisateur déplace un doigt sur un écran tactile, l’occurrence d’InteractiveObject peut distribuer un événement mouseOut ou un événement touchOut, ou les deux si l’environnement actuel le permet. Choisissez la manière dont vous souhaitez gérer l’interaction de l’utilisateur. Utilisez la classe flash.ui.Multitouch pour gérer les événements tactiles (activez la gestion des événements de mouvements tactiles ou la gestion des événements de points tactiles simples, ou désactivez les événements tactiles afin de ne distribuer que les événements de souris). Si vous choisissez de gérer l’événement mouseOut, le gestionnaire d’événement sera exécuté sur un périphérique tactile et sur un périphérique de type souris. Toutefois, si vous choisissez de gérer l’événement touchOut, vous pouvez concevoir votre gestionnaire d’événement de façon à répondre aux besoins spécifiques d’un environnement tactile et à fournir aux utilisateurs des fonctionnalités tactiles avancées. Vous pouvez également gérer ces deux événements de façon indépendante pour fournir une réponse différente selon qu’il s’agit d’un événement tactile ou d’un événement de souris.
Remarque : voir la classe Multitouch pour plus d’informations sur la compatibilité de l’environnement.
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 :
| 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. |
eventPhase | Phase actuelle du flux d’événements. |
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. |
pressure | 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. |
relatedObject | Référence à un objet de la liste d’affichage qui est associé à l’événement. |
shiftKey | true si la touche Maj est activée ; false si elle ne l’est pas. |
sizeX | Largeur de la surface de contact. |
sizeY | Hauteur de la surface de contact. |
stageX | Coordonnée horizontale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène. |
stageY | Coordonnée verticale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène. |
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. |
touchPointID | Numéro d’identification unique (sous la forme d’une valeur int) affecté au point tactile. |
Eléments de l’API associés
touchOver | Evénement |
flash.events.TouchEventpropriété TouchEvent.type =
flash.events.TouchEvent.TOUCH_OVER| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Distribué lorsque l’utilisateur déplace le point de contact sur une occurrence d’InteractiveObject sur un périphérique tactile (notamment lorsqu’il fait glisser un doigt d’un point se trouvant en dehors d’un objet d’affichage vers un point sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile). Certains périphériques peuvent également interpréter ce contact comme un événement mouseOver.
De façon plus spécifique, si un utilisateur déplace un doigt sur un objet InteractiveObject, l’occurrence d’InteractiveObject peut distribuer un événement mouseOver ou un événement touchOver, ou les deux si l’environnement actuel le permet. Choisissez la manière dont vous souhaitez gérer l’interaction de l’utilisateur. Utilisez la classe flash.ui.Multitouch pour gérer les événements tactiles (activez la gestion des événements de mouvements tactiles ou la gestion des événements de points tactiles simples, ou désactivez les événements tactiles afin de ne distribuer que les événements de souris). Si vous choisissez de gérer l’événement mouseOver, le gestionnaire d’événement sera exécuté sur un périphérique tactile et sur un périphérique de type souris. Toutefois, si vous choisissez de gérer l’événement touchOver, vous pouvez concevoir votre gestionnaire d’événement de façon à répondre aux besoins spécifiques d’un environnement tactile et à fournir aux utilisateurs des fonctionnalités tactiles avancées. Vous pouvez également gérer ces deux événements de façon indépendante pour fournir une réponse différente selon qu’il s’agit d’un événement tactile ou d’un événement de souris.
Remarque : voir la classe Multitouch pour plus d’informations sur la compatibilité de l’environnement.
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 :
| 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. |
eventPhase | Phase actuelle du flux d’événements. |
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. |
pressure | 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. |
relatedObject | Référence à un objet de la liste d’affichage qui est associé à l’événement. |
shiftKey | true si la touche Maj est activée ; false si elle ne l’est pas. |
sizeX | Largeur de la surface de contact. |
sizeY | Hauteur de la surface de contact. |
stageX | Coordonnée horizontale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène. |
stageY | Coordonnée verticale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène. |
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. |
touchPointID | Numéro d’identification unique (sous la forme d’une valeur int) affecté au point tactile. |
Eléments de l’API associés
touchRollOut | Evénement |
flash.events.TouchEventpropriété TouchEvent.type =
flash.events.TouchEvent.TOUCH_ROLL_OUT| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Distribué lorsque l’utilisateur retire le point de contact d’une occurrence d’InteractiveObject sur un périphérique tactile (notamment lorsqu’il fait glisser un doigt d’un se trouvant sur l’objet d’affichage d’un téléphone portable ou une tablette munis d’un écran tactile vers un point se trouvant en dehors de cet objet). Certains périphériques peuvent également interpréter ce contact comme un événement rollOut.
De façon plus spécifique, si un utilisateur déplace un doigt sur un objet InteractiveObject, l’occurrence d’InteractiveObject peut distribuer un événement rollOut ou un événement touchRollOut, ou les deux si l’environnement actuel le permet. Choisissez la manière dont vous souhaitez gérer l’interaction de l’utilisateur. Utilisez la classe flash.ui.Multitouch pour gérer les événements tactiles (activez la gestion des événements de mouvements tactiles ou la gestion des événements de points tactiles simples, ou désactivez les événements tactiles afin de ne distribuer que les événements de souris). Si vous choisissez de gérer l’événement rollOut, le gestionnaire d’événement sera exécuté sur un périphérique tactile et sur un périphérique de type souris. Toutefois, si vous choisissez de gérer l’événement touchRollOut, vous pouvez concevoir votre gestionnaire d’événement de façon à répondre aux besoins spécifiques d’un environnement tactile et à fournir aux utilisateurs des fonctionnalités tactiles avancées. Vous pouvez également gérer ces deux événements de façon indépendante pour fournir une réponse différente selon qu’il s’agit d’un événement tactile ou d’un événement de souris.
Remarque : voir la classe Multitouch pour plus d’informations sur la compatibilité de l’environnement.
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 :
| 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. |
eventPhase | Phase actuelle du flux d’événements. |
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. |
pressure | 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. |
relatedObject | Référence à un objet de la liste d’affichage qui est associé à l’événement. |
shiftKey | true si la touche Maj est activée ; false si elle ne l’est pas. |
sizeX | Largeur de la surface de contact. |
sizeY | Hauteur de la surface de contact. |
stageX | Coordonnée horizontale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène. |
stageY | Coordonnée verticale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène. |
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. |
touchPointID | Numéro d’identification unique (sous la forme d’une valeur int) affecté au point tactile. |
Eléments de l’API associés
touchRollOver | Evénement |
flash.events.TouchEventpropriété TouchEvent.type =
flash.events.TouchEvent.TOUCH_ROLL_OVER| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Distribué lorsque l’utilisateur déplace le point de contact sur une occurrence d’InteractiveObject sur un périphérique tactile (notamment lorsqu’il fait glisser un doigt d’un point se trouvant en dehors d’un objet d’affichage vers un point sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile). Certains périphériques peuvent également interpréter ce contact comme un événement rollOver.
De façon plus spécifique, si un utilisateur déplace un doigt sur un objet InteractiveObject, l’occurrence d’InteractiveObject peut distribuer un événement rollOver ou un événement touchRollOver, ou les deux si l’environnement actuel le permet. Choisissez la manière dont vous souhaitez gérer l’interaction de l’utilisateur. Utilisez la classe flash.ui.Multitouch pour gérer les événements tactiles (activez la gestion des événements de mouvements tactiles ou la gestion des événements de points tactiles simples, ou désactivez les événements tactiles afin de ne distribuer que les événements de souris). Si vous choisissez de gérer l’événement rollOver, le gestionnaire d’événement sera exécuté sur un périphérique tactile et sur un périphérique de type souris. Toutefois, si vous choisissez de gérer l’événement touchRollOver, vous pouvez concevoir votre gestionnaire d’événement de façon à répondre aux besoins spécifiques d’un environnement tactile et à fournir aux utilisateurs des fonctionnalités tactiles avancées. Vous pouvez également gérer ces deux événements de façon indépendante pour fournir une réponse différente selon qu’il s’agit d’un événement tactile ou d’un événement de souris.
Remarque : voir la classe Multitouch pour plus d’informations sur la compatibilité de l’environnement.
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 :
| 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. |
eventPhase | Phase actuelle du flux d’événements. |
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. |
pressure | 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. |
relatedObject | Référence à un objet de la liste d’affichage qui est associé à l’événement. |
shiftKey | true si la touche Maj est activée ; false si elle ne l’est pas. |
sizeX | Largeur de la surface de contact. |
sizeY | Hauteur de la surface de contact. |
stageX | Coordonnée horizontale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène. |
stageY | Coordonnée verticale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène. |
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. |
touchPointID | Numéro d’identification unique (sous la forme d’une valeur int) affecté au point tactile. |
Eléments de l’API associés
touchTap | Evénement |
flash.events.TouchEventpropriété TouchEvent.type =
flash.events.TouchEvent.TOUCH_TAP| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Distribué lorsque l’utilisateur lève le point de contact sur la même occurrence d’InteractiveObject sur laquelle le contact a été lancé sur un périphérique tactile (notamment lorsqu’il appuie avec un doigt à partir d’un point de contact unique sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile, puis le retire). Certains périphériques peuvent également interpréter ce contact comme un événement click.
De façon plus spécifique, si un utilisateur appuie brièvement avec deux doigts sur un objet InteractiveObject, l’occurrence d’InteractiveObject peut distribuer un événement click ou un événement touchTap, ou les deux si l’environnement actuel le permet. Choisissez la manière dont vous souhaitez gérer l’interaction de l’utilisateur. Utilisez la classe flash.ui.Multitouch pour gérer les événements tactiles (activez la gestion des événements de mouvements tactiles ou la gestion des événements de points tactiles simples, ou désactivez les événements tactiles afin de ne distribuer que les événements de souris). Si vous choisissez de gérer l’événement click, le gestionnaire d’événement sera exécuté sur un périphérique tactile et sur un périphérique de type souris. Toutefois, si vous choisissez de gérer l’événement touchTap, vous pouvez concevoir votre gestionnaire d’événement de façon à répondre aux besoins spécifiques d’un environnement tactile et à fournir aux utilisateurs des fonctionnalités tactiles avancées. Vous pouvez également gérer ces deux événements de façon indépendante pour fournir une réponse différente selon qu’il s’agit d’un événement tactile ou d’un événement de souris.
Remarque : voir la classe Multitouch pour plus d’informations sur la compatibilité de l’environnement.
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 :
| 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. |
eventPhase | Phase actuelle du flux d’événements. |
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. |
pressure | 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. |
relatedObject | Référence à un objet de la liste d’affichage qui est associé à l’événement. |
shiftKey | true si la touche Maj est activée ; false si elle ne l’est pas. |
sizeX | Largeur de la surface de contact. |
sizeY | Hauteur de la surface de contact. |
stageX | Coordonnée horizontale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène. |
stageY | Coordonnée verticale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène. |
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. |
touchPointID | Numéro d’identification unique (sous la forme d’une valeur int) affecté au point tactile. |
Exemple ( Comment utiliser cet exemple )
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);
}
Eléments de l’API associés
InteractiveObjectExample, qui en retour utilise la classe ChildSprite pour dessiner un rectangle et le manipule en fonction des différents événements de la souris. Pour ce faire, procédez comme suit :
- Dans le constructeur
InteractiveObjectExample, un nouvel objet ChildSprite de type Sprite appeléchildest créé, qui en retour appelle la méthode de constructeur ChildSprite pour dessiner la forme et ajoute des événements de souris à la forme (comme expliqué au cours des étapes suivantes). L’objetchildest ajouté dans la partie supérieure de la liste d’affichage aux coordonnées x = 0, y = 0. - Dans la classe
ChildSprite, déclarez les propriétéssizeetoverSizequi sont utilisées par la suite par les méthodesdraw()et MouseEvent. - Déclare des propriétés qui définissent la couleur de fond sur orange, la couleur de survol de la souris sur jaune et la couleur clic sur bleu clair.
- Dans le constructeur
ChildSprite, un carré orange est dessiné à l’aide des méthodes de la classe Graphics et de la méthodedraw(). - Le constructeur ajoute quatre méthodes d’écouteur d’événements MouseEvent :
mouseOverHandler: redraws a larger 60 x 60 pixel square with a dark-yellow color at the original coordinates.mouseOutHandler: rétablit la couleur et la taille d’origine du carré.mouseDownHandler: dessine de nouveau un carré plus grand, de 60x60 pixels, en bleu clair et aux coordonnées d’origine.mouseUpHandler: identique àmouseOverHandler.
package {
import flash.display.Sprite;
public class InteractiveObjectExample extends Sprite {
public function InteractiveObjectExample() {
var child:Sprite = new ChildSprite();
addChild(child);
}
}
}
import flash.display.Sprite;
import flash.events.MouseEvent;
class ChildSprite extends Sprite {
private var size:uint = 50;
private var overSize:uint = 60;
private var backgroundColor:uint = 0xFFCC00;
private var overColor:uint = 0xCCFF00;
private var downColor:uint = 0x00CCFF;
public function ChildSprite() {
buttonMode = true;
draw(size, size, backgroundColor);
addEventListener(MouseEvent.MOUSE_OVER, mouseOverHandler);
addEventListener(MouseEvent.MOUSE_OUT, mouseOutHandler);
addEventListener(MouseEvent.MOUSE_DOWN, mouseDownHandler);
addEventListener(MouseEvent.MOUSE_UP, mouseUpHandler);
}
private function draw(w:uint, h:uint, bgColor:uint):void {
graphics.clear();
graphics.beginFill(bgColor);
graphics.drawRect(0, 0, w, h);
graphics.endFill();
}
public function mouseOverHandler(event:MouseEvent):void {
trace("mouseOverHandler");
draw(overSize, overSize, overColor);
}
public function mouseOutHandler(event:MouseEvent):void {
trace("mouseOutHandler");
draw(size, size, backgroundColor);
}
public function mouseDownHandler(event:MouseEvent):void {
trace("mouseDownHandler");
draw(overSize, overSize, downColor);
}
public function mouseUpHandler(event:MouseEvent):void {
trace("mouseUpHandler");
draw(overSize, overSize, overColor);
}
}
Tue Jun 12 2018, 09:30 AM Z