Packageflash.display
Classepublic class InteractiveObject
HéritageInteractiveObject Inheritance DisplayObject Inheritance EventDispatcher Inheritance Object
Sous-classes DisplayObjectContainer, SimpleButton, TextField

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: AIR 1.0 Flash Player 9

La classe InteractiveObject correspond à la classe abstraite de l'ensemble des objets d'affichage avec lesquels l'utilisateur peut interagir à l'aide de la souris et du clavier.

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. Par conséquent, si vous devez créer une sous-classe personnalisée de la classe InteractiveObject, vous devez étendre l'une de ses sous-classes qui dispose d'API de rendu de contenu à l'écran, telles que les classes Sprite, SimpleButton, TextField ou MovieClip.

Consulter les exemples

Voir aussi

Classes d'affichage principales


Propriétés publiques
 PropriétéDéfini par
 InheritedaccessibilityProperties : AccessibilityProperties
Options d'accessibilité actuelles de l'objet d'affichage.
DisplayObject
 Inheritedalpha : Number
Indique la valeur de transparence alpha de l'objet spécifié.
DisplayObject
 InheritedblendMode : String
Valeur de la classe BlendMode qui spécifie le mode de fondu à utiliser.
DisplayObject
 InheritedblendShader : Shader
[lecture seule] Définit un shader utilisé pour le fondu de l'arrière-plan et du premier plan.
DisplayObject
 InheritedcacheAsBitmap : Boolean
Si true est défini, Flash Player ou Adobe AIR place en mémoire cache une version bitmap interne de l’objet d'affichage.
DisplayObject
 Inheritedconstructor : 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
 Inheritedfilters : 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
 Inheritedheight : Number
Indique la hauteur de l'objet d'affichage, en pixels.
DisplayObject
 InheritedloaderInfo : LoaderInfo
[lecture seule] Renvoie un objet LoaderInfo qui contient des informations relatives au chargement du fichier auquel appartient cet objet d'affichage.
DisplayObject
 Inheritedmask : DisplayObject
L'objet d'affichage appelant est masqué par l'objet mask spécifié.
DisplayObject
  mouseEnabled : Boolean
Spécifie si l'objet reçoit les messages souris.
InteractiveObject
 InheritedmouseX : Number
[lecture seule] Indique la coordonnée x de la position de la souris, en pixels.
DisplayObject
 InheritedmouseY : Number
[lecture seule] Indique la coordonnée y de la position de la souris, en pixels.
DisplayObject
 Inheritedname : String
Indique le nom d'occurrence de DisplayObject.
DisplayObject
 InheritedopaqueBackground : Object
Indique si l'objet d'affichage est opaque avec une couleur d'arrière-plan spécifique.
DisplayObject
 Inheritedparent : DisplayObjectContainer
[lecture seule] Indique l'objet DisplayObjectContainer qui contient l'objet d'affichage.
DisplayObject
 Inheritedprototype : Object
[statique] Référence à l'objet prototype d'un objet de classe ou fonction.
Object
 Inheritedroot : 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
 Inheritedrotation : Number
Indique la rotation de l'occurrence de DisplayObject, en degrés, à partir de son orientation d'origine.
DisplayObject
 InheritedrotationX : 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
 InheritedrotationY : 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
 InheritedrotationZ : 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
 Inheritedscale9Grid : Rectangle
Grille de mise à l'échelle en vigueur.
DisplayObject
 InheritedscaleX : Number
Indique l'échelle horizontale (pourcentage) de l'objet telle qu'elle est appliquée à partir du point d'alignement.
DisplayObject
 InheritedscaleY : Number
Indique le redimensionnement vertical (pourcentage) de l'objet tel qu'il est appliqué à partir du point d'alignement.
DisplayObject
 InheritedscaleZ : Number
Indique l'échelle de profondeur (pourcentage) de l'objet tel qu'elle est appliquée à partir du point d'alignement.
DisplayObject
 InheritedscrollRect : Rectangle
Cadre de délimitation du défilement de l'objet d'affichage.
DisplayObject
 Inheritedstage : 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
 Inheritedtransform : 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
 Inheritedvisible : Boolean
Indique si l'objet d'affichage est visible ou non.
DisplayObject
 Inheritedwidth : Number
Indique la largeur de l'objet d'affichage, en pixels.
DisplayObject
 Inheritedx : Number
Indique la coordonnée x de l'occurrence de DisplayObject par rapport aux coordonnées locales de l'objet DisplayObjectContainer parent.
DisplayObject
 Inheritedy : Number
Indique la coordonnée y de l'occurrence de DisplayObject par rapport aux coordonnées locales de l'objet DisplayObjectContainer parent.
DisplayObject
 Inheritedz : 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éthodes publiques
 MéthodeDéfini par
  
L'appel du constructeur InteractiveObject() renvoie une exception ArgumentError.
InteractiveObject
 Inherited
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
 Inherited
Distribue un événement dans le flux d'événements.
EventDispatcher
 Inherited
getBounds(targetCoordinateSpace:DisplayObject):Rectangle
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
 Inherited
getRect(targetCoordinateSpace:DisplayObject):Rectangle
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
 Inherited
Convertit l'objet point des coordonnées de scène (globales) vers les coordonnées de l'objet d'affichage (locales).
DisplayObject
 Inherited
Convertit un point bidimensionnel à partir des coordonnées de scène (globales) vers les coordonnées d'un objet d'affichage tridimensionnel (locales).
DisplayObject
 Inherited
Vérifie si des écouteurs sont enregistrés auprès de l'objet EventDispatcher pour un type spécifique d'événement.
EventDispatcher
 Inherited
Indique si la propriété spécifiée d'un objet est définie.
Object
 Inherited
Evalue le cadre de délimitation de l'objet d'affichage pour savoir s'il recouvre ou recoupe le cadre de délimitation de l'objet d'affichage obj.
DisplayObject
 Inherited
hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean
Evalue l'objet d'affichage pour savoir s'il recouvre ou recoupe le point spécifié par les paramètres x et y.
DisplayObject
 Inherited
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
 Inherited
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
 Inherited
Convertit l'objet point des coordonnées de l'objet d'affichage (locales) vers les coordonnées de la scène (globales).
DisplayObject
 Inherited
Indique si la propriété spécifiée existe et est énumérable.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Supprime un écouteur de l'objet EventDispatcher.
EventDispatcher
 Inherited
Définit la disponibilité d'une propriété dynamique pour les opérations en boucle.
Object
 Inherited
Renvoie la représentation sous forme de chaîne de l'objet spécifié.
Object
 Inherited
Renvoie la valeur primitive de l'objet spécifié.
Object
 Inherited
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énements
 Evénement Synthèse Défini par
 Inherited[Evénement de diffusion] Distribué lorsque l'application Flash Player obtient le focus du système d'exploitation et devient active.EventDispatcher
 InheritedDistribué lorsqu'un objet d'affichage est ajouté à la liste d'affichage.DisplayObject
 InheritedEnvoyé 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
 Inherited[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
 Inherited[événement de diffusion] Distribué lorsque la tête de lecture est placée sur une nouvelle image.DisplayObject
 Inherited[é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
 Inherited[é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 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
 InheritedDistribué lorsqu'un objet d'affichage est sur le point d'être supprimé de la liste d'affichage.DisplayObject
 InheritedDistribué 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
 Inherited[é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é 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
Détails de la propriété
contextMenupropriété
contextMenu:NativeMenu  [lecture-écriture]

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: AIR 1.0 Flash Player 9

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.



Implémentation
    public function get contextMenu():NativeMenu
    public function set contextMenu(value:NativeMenu):void
doubleClickEnabledpropriété 
doubleClickEnabled:Boolean  [lecture-écriture]

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):void

Voir aussi

focusRectpropriété 
focusRect:Object  [lecture-écriture]

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: AIR 1.0 Flash Player 9

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):void
mouseEnabledpropriété 
mouseEnabled:Boolean  [lecture-écriture]

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 messages souris. La valeur par défaut est true, ce qui signifie que, par défaut, toute occurrence de InteractiveObject figurant dans la liste d'affichage reçoit les événements de souris. Si mouseEnabled est défini sur false, l'occurrence ne reçoit pas d'événement de souris. 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):void

Voir aussi

tabEnabledpropriété 
tabEnabled:Boolean  [lecture-écriture]

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 :



Implémentation
    public function get tabEnabled():Boolean
    public function set tabEnabled(value:Boolean):void
tabIndexpropriété 
tabIndex:int  [lecture-écriture]

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.



Implémentation
    public function get tabIndex():int
    public function set tabIndex(value:int):void
Détails du constructeur
InteractiveObject()Constructeur
public function InteractiveObject()

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: AIR 1.0 Flash Player 9

L'appel du constructeur new InteractiveObject() renvoie une exception ArgumentError. Vous pouvez cependant appeler des constructeurs pour les sous-classes suivantes de InteractiveObject :

Détails de l'événement
clear Evénement
Type d'objet événement: flash.events.Event
proprié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

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 constante Event.CLEAR définit la valeur de la propriété type d'un objet é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.
click Evénement  
Type d'objet événement: flash.events.MouseEvent
proprié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

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.

Définit la valeur de la propriété type d'un objet é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 ou Linux).
bubbles true
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. Autrement, false.
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.
localY Coordonnée verticale à laquelle l'événement s'est produit par rapport au sprite conteneur.
shiftKey true si la touche Maj est activée ; false si elle ne l'est pas.
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.
AIR-only contextMenu Evénement  
Type d'objet événement: flash.events.MouseEvent
proprié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 constante MouseEvent.CONTEXT_MENU définit la valeur de la propriété type d'un objet é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 ou Linux).
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. Autrement, false.
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.
localY Coordonnée verticale à laquelle l'événement s'est produit par rapport au sprite conteneur.
shiftKey true si la touche Maj est activée ; false si elle ne l'est pas.
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 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.

Voir aussi

copy Evénement  
Type d'objet événement: flash.events.Event
proprié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.
cut Evénement  
Type d'objet événement: flash.events.Event
proprié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.
doubleClick Evénement  
Type d'objet événement: flash.events.MouseEvent
proprié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.

Définit la valeur de la propriété type d'un objet é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 ou Linux).
bubbles true
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. Autrement, false.
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.
localY Coordonnée verticale à laquelle l'événement s'est produit par rapport au sprite conteneur.
shiftKey true si la touche Maj est activée ; false si elle ne l'est pas.
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.

Voir aussi

focusIn Evénement  
Type d'objet événement: flash.events.FocusEvent
proprié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

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.

Définit la valeur de la propriété 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  
Type d'objet événement: flash.events.FocusEvent
proprié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

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é.

Définit la valeur de la propriété 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.
keyDown Evénement  
Type d'objet événement: flash.events.KeyboardEvent
proprié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

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.

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 false ; il n'existe aucun comportement par défaut à annuler.
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. Autrement, false.
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.

Voir aussi

keyFocusChange Evénement  
Type d'objet événement: flash.events.FocusEvent
proprié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

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.

Définit la valeur de la propriété 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  
Type d'objet événement: flash.events.KeyboardEvent
proprié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

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 :

Définit la valeur de la propriété type d'un objet é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. Autrement, false.
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.
AIR-only middleClick Evénement  
Type d'objet événement: flash.events.MouseEvent
propriété MouseEvent.type = flash.events.MouseEvent.MIDDLE_CLICK

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: AIR 1.0

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.

Définit la valeur de la propriété type d'un objet é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 ou Linux).
bubbles true
buttonDown true si le bouton central 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. Autrement, false.
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.
localY Coordonnée verticale à laquelle l'événement s'est produit par rapport au sprite conteneur.
shiftKey true si la touche Maj est activée ; false si elle ne l'est pas.
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 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.
AIR-only middleMouseDown Evénement  
Type d'objet événement: flash.events.MouseEvent
propriété MouseEvent.type = flash.events.MouseEvent.MIDDLE_MOUSE_DOWN

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: AIR 1.0

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 é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 ou Linux).
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. Autrement, false.
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.
localY Coordonnée verticale à laquelle l'événement s'est produit par rapport au sprite conteneur.
shiftKey true si la touche Maj est activée ; false si elle ne l'est pas.
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 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.
AIR-only middleMouseUp Evénement  
Type d'objet événement: flash.events.MouseEvent
propriété MouseEvent.type = flash.events.MouseEvent.MIDDLE_MOUSE_UP

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: AIR 1.0

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 é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 ou Linux).
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. Autrement, false.
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.
localY Coordonnée verticale à laquelle l'événement s'est produit par rapport au sprite conteneur.
shiftKey true si la touche Maj est activée ; false si elle ne l'est pas.
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 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  
Type d'objet événement: flash.events.MouseEvent
proprié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

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.

Définit la valeur de la propriété type d'un objet é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 ou Linux).
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. Autrement, false.
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.
localY Coordonnée verticale à laquelle l'événement s'est produit par rapport au sprite conteneur.
shiftKey true si la touche Maj est activée ; false si elle ne l'est pas.
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  
Type d'objet événement: flash.events.FocusEvent
proprié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

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.

Définit la valeur de la propriété 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  
Type d'objet événement: flash.events.MouseEvent
proprié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

Distribué lorsque l'utilisateur déplace le périphérique de pointage placé sur une occurrence d'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 é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 ou Linux).
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. Autrement, false.
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.
localY Coordonnée verticale à laquelle l'événement s'est produit par rapport au sprite conteneur.
shiftKey true si la touche Maj est activée ; false si elle ne l'est pas.
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  
Type d'objet événement: flash.events.MouseEvent
proprié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

Distribué lorsque l'utilisateur éloigne un périphérique de pointage d'une occurrence d'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.

Définit la valeur de la propriété type d'un objet é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 ou Linux).
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. Autrement, false.
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.
localY Coordonnée verticale à laquelle l'événement s'est produit par rapport au sprite conteneur.
shiftKey true si la touche Maj est activée ; false si elle ne l'est pas.
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  
Type d'objet événement: flash.events.MouseEvent
proprié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

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.

Définit la valeur de la propriété type d'un objet é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 ou Linux).
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. Autrement, false.
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.
localY Coordonnée verticale à laquelle l'événement s'est produit par rapport au sprite conteneur.
shiftKey true si la touche Maj est activée ; false si elle ne l'est pas.
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  
Type d'objet événement: flash.events.MouseEvent
proprié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

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.

Définit la valeur de la propriété type d'un objet é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 ou Linux).
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. Autrement, false.
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.
localY Coordonnée verticale à laquelle l'événement s'est produit par rapport au sprite conteneur.
shiftKey true si la touche Maj est activée ; false si elle ne l'est pas.
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 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  
Type d'objet événement: flash.events.MouseEvent
proprié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.

Définit la valeur de la propriété type d'un objet é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 ou Linux).
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. Autrement, false.
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.
localY Coordonnée verticale à laquelle l'événement s'est produit par rapport au sprite conteneur.
shiftKey true si la touche Maj est activée ; false si elle ne l'est pas.
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.
AIR-only nativeDragComplete Evénement  
Type d'objet événement: flash.events.NativeDragEvent
propriété NativeDragEvent.type = flash.events.NativeDragEvent.NATIVE_DRAG_COMPLETE

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: AIR 1.0

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énements nativeDragComplete est un endroit commode pour mettre à jour l'état de l'objet d'affichage déclencheur, par exemple, en supprimant un élément d'une liste (sur une action glisser de « move »), ou en changeant les propriétés visuelles.

NativeDragEvent.NATIVE_DRAG_COMPLETE définit la valeur de la propriété type d'un objet é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 false
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).
AIR-only nativeDragDrop Evénement  
Type d'objet événement: flash.events.NativeDragEvent
propriété NativeDragEvent.type = flash.events.NativeDragEvent.NATIVE_DRAG_DROP

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: AIR 1.0

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 é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.

NativeDragEvent.NATIVE_DRAG_DROP définit la valeur de la propriété type d'un objet é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 false
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).
AIR-only nativeDragEnter Evénement  
Type d'objet événement: flash.events.NativeDragEvent
propriété NativeDragEvent.type = flash.events.NativeDragEvent.NATIVE_DRAG_ENTER

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: AIR 1.0

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 événement sont adaptées, et les actions glisser dans la propriétéallowedActions.

NativeDragEvent.NATIVE_DRAG_ENTER définit la valeur de la propriété type d'un objet é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 false
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).
AIR-only nativeDragExit Evénement  
Type d'objet événement: flash.events.NativeDragEvent
propriété NativeDragEvent.type = flash.events.NativeDragEvent.NATIVE_DRAG_EXIT

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: AIR 1.0

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 é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 false
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).
AIR-only nativeDragOver Evénement  
Type d'objet événement: flash.events.NativeDragEvent
propriété NativeDragEvent.type = flash.events.NativeDragEvent.NATIVE_DRAG_OVER

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: AIR 1.0

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 événement sont adaptées, et les actions glisser dans la propriétéallowedActions.

NativeDragEvent.NATIVE_DRAG_OVER définit la valeur de la propriété type d'un objet é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 false
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).
AIR-only nativeDragStart Evénement  
Type d'objet événement: flash.events.NativeDragEvent
propriété NativeDragEvent.type = flash.events.NativeDragEvent.NATIVE_DRAG_START

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: AIR 1.0

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 é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 false
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).
AIR-only nativeDragUpdate Evénement  
Type d'objet événement: flash.events.NativeDragEvent
propriété NativeDragEvent.type = flash.events.NativeDragEvent.NATIVE_DRAG_UPDATE

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: AIR 1.0

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.

NativeDragEvent.NATIVE_DRAG_UPDATE définit la valeur de la propriété type d'un objet é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 false
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  
Type d'objet événement: flash.events.Event
proprié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 constante Event.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 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 paste.
AIR-only rightClick Evénement  
Type d'objet événement: flash.events.MouseEvent
propriété MouseEvent.type = flash.events.MouseEvent.RIGHT_CLICK

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: AIR 1.0

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.

Définit la valeur de la propriété type d'un objet é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 ou Linux).
bubbles true
buttonDown true si le bouton droit 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. Autrement, false.
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.
localY Coordonnée verticale à laquelle l'événement s'est produit par rapport au sprite conteneur.
shiftKey true si la touche Maj est activée ; false si elle ne l'est pas.
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 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.
AIR-only rightMouseDown Evénement  
Type d'objet événement: flash.events.MouseEvent
propriété MouseEvent.type = flash.events.MouseEvent.RIGHT_MOUSE_DOWN

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: AIR 1.0

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 é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 ou Linux).
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. Autrement, false.
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.
localY Coordonnée verticale à laquelle l'événement s'est produit par rapport au sprite conteneur.
shiftKey true si la touche Maj est activée ; false si elle ne l'est pas.
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 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.
AIR-only rightMouseUp Evénement  
Type d'objet événement: flash.events.MouseEvent
propriété MouseEvent.type = flash.events.MouseEvent.RIGHT_MOUSE_UP

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: AIR 1.0

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 é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 ou Linux).
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. Autrement, false.
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.
localY Coordonnée verticale à laquelle l'événement s'est produit par rapport au sprite conteneur.
shiftKey true si la touche Maj est activée ; false si elle ne l'est pas.
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 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  
Type d'objet événement: flash.events.MouseEvent
proprié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

Distribué lorsque l'utilisateur éloigne un périphérique de pointage d'une occurrence d'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.

Définit la valeur de la propriété type d'un objet é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 ou Linux).
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. Autrement, false.
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.
localY Coordonnée verticale à laquelle l'événement s'est produit par rapport au sprite conteneur.
shiftKey true si la touche Maj est activée ; false si elle ne l'est pas.
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  
Type d'objet événement: flash.events.MouseEvent
proprié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

Distribué lorsque l'utilisateur place un périphérique de pointage sur une occurrence d'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.

Définit la valeur de la propriété type d'un objet é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 ou Linux).
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. Autrement, false.
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.
localY Coordonnée verticale à laquelle l'événement s'est produit par rapport au sprite conteneur.
shiftKey true si la touche Maj est activée ; false si elle ne l'est pas.
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  
Type d'objet événement: flash.events.Event
proprié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 constante Event.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.
tabChildrenChange Evénement  
Type d'objet événement: flash.events.Event
proprié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.

La constante 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  
Type d'objet événement: flash.events.Event
proprié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.

La constante Event.TAB_ENABLED_CHANGE définit la valeur de la propriété type d'un objet é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  
Type d'objet événement: flash.events.Event
proprié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.

La constante Event.TAB_INDEX_CHANGE définit la valeur de la propriété type d'un objet é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.
Exemples Utilisation des exemples
InteractiveObjectExample.as

L'exemple suivant utilise la classe 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 :
  1. Dans le constructeur InteractiveObjectExample, un nouvel objet ChildSprite de type Sprite appelé child est 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'objet child est ajouté dans la partie supérieure de la liste d'affichage aux coordonnées x = 0, y = 0.
  2. Dans la classe ChildSprite, déclarez les propriétés size et overSize qui sont utilisées par la suite par les méthodes draw() et MouseEvent.
  3. 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.
  4. Dans le constructeur ChildSprite, un carré orange est dessiné à l'aide des méthodes de la classe Graphics et de la méthode draw().
  5. Le constructeur ajoute quatre méthodes d'écouteur d'événement MouseEvent :
    • mouseOverHandler : dessine de nouveau un carré plus grand, de 60x60 pixels, en jaune plus sombre et aux coordonnées d'origine.
    • 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);
    }
}