Guide de référence ActionScript® 3.0 pour la plate-forme Adobe® Flash®
Accueil  |  Masquer la liste des packages et des classes |  Packages  |  Classes  |  Nouveautés  |  Index  |  Annexes  |  Pourquoi existe-t-il du contenu en anglais ?
Filtres : Récupération des données du serveur...
Récupération des données du serveur...
flash.events 

MouseEvent  - AS3

Packageflash.events
Classepublic class MouseEvent
HéritageMouseEvent Inheritance Event Inheritance Object
Sous-classes AutomationDragEvent, ChartEvent, ChartItemEvent, DragEvent, FlexMouseEvent, GridEvent, LegendMouseEvent, ListEvent, MosaicDragEvent, NativeDragEvent, ScreenMouseEvent

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9, Flash Lite 4

Un objet MouseEvent est distribué dans le flux d’événements lorsque des événements mouse ont lieu. En règle générale, un événement de souris est généré par un périphérique d’entrée utilisateur, souris ou trackball (boule roulante) qui fonctionne avec un pointeur.

Lorsque des nœuds imbriqués sont utilisés, les événements de souris ciblent le dernier des nœuds imbriqués visible dans la liste d’affichage. Ce nœud est appelé target node. Pour qu’un ancêtre de nœud cible soit averti d’un événement de souris, utilisez EventDispatcher.addEventListener() sur l’ancêtre en définissant le paramètre type sur l’événement de souris à détecter.

Consulter les exemples

Plus d’exemples

Informations complémentaires



Propriétés publiques
 PropriétéDéfini par
  altKey : Boolean
Indique si la touche Alt est active (true) ou non (false).
MouseEvent
 Inheritedbubbles : Boolean
[lecture seule] Indique si un événement peut se propager vers le haut (bubbling).
Event
  buttonDown : Boolean
Indique si l’utilisateur appuie (true) ou non (false) sur le bouton principal de la souris.
MouseEvent
 Inheritedcancelable : Boolean
[lecture seule] Indique si le comportement associé à l’événement peut être évité.
Event
  clickCount : int
[lecture seule] Indique si l’événement mouse down fait partie d’une séquence multi-clic.
MouseEvent
  commandKey : Boolean
Indique si la touche Commande est activée (Mac uniquement). La valeur de la propriété commandKey a la même valeur que la propriété ctrlKey sur le Mac.
MouseEvent
 Inheritedconstructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet.
Object
  controlKey : Boolean
Indique si la touche Contrôle et activée sous Mac et si la touche Ctrl est activée sous Windows ou Linux.
MouseEvent
  ctrlKey : Boolean
Sous Windows ou Linux, indique si la touche Ctrl est activée (true) ou non (false).
MouseEvent
 InheritedcurrentTarget : Object
[lecture seule] L’objet qui traite activement l’objet Event avec un écouteur d’événements.
Event
  delta : int
Indique le nombre de lignes qui doivent défiler chaque fois que l’utilisateur fait tourner la molette de sa souris d’un cran.
MouseEvent
 InheritedeventPhase : uint
[lecture seule] Phase actuelle du flux d’événements.
Event
  isRelatedObjectInaccessible : Boolean
Si la valeur est true, la propriété relatedObject est définie sur null pour des raisons liées aux sandbox de sécurité.
MouseEvent
  localX : Number
Lorsque le verrouillage de la souris est désactivé, coordonnée horizontale à laquelle l’événement s’est produit, par rapport au sprite conteneur.
MouseEvent
  localY : Number
Lorsque le verrouillage de la souris est désactivé, coordonnée verticale à laquelle l’événement s’est produit, par rapport au sprite conteneur.
MouseEvent
  movementX : Number
Lorsque le verrouillage de la souris est activé, changement de position de la souris dans la direction X depuis le dernier événement de souris.
MouseEvent
  movementY : Number
Lorsque le verrouillage de la souris est activé, changement de position de la souris dans la direction Y depuis le dernier événement de souris.
MouseEvent
  relatedObject : InteractiveObject
Référence à un objet de la liste d’affichage qui est associé à l’événement.
MouseEvent
  shiftKey : Boolean
Indique si la touche Maj est activée (true) ou non (false).
MouseEvent
  stageX : Number
[lecture seule] Coordonnée horizontale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène.
MouseEvent
  stageY : Number
[lecture seule] Coordonnée verticale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène.
MouseEvent
 Inheritedtarget : Object
[lecture seule] Cible de l’événement.
Event
 Inheritedtype : String
[lecture seule] Type d’événement.
Event
Méthodes publiques
 MéthodeDéfini par
  
MouseEvent(type:String, bubbles:Boolean = true, cancelable:Boolean = false, localX:Number = NaN, localY:Number = NaN, relatedObject:InteractiveObject = null, ctrlKey:Boolean = false, altKey:Boolean = false, shiftKey:Boolean = false, buttonDown:Boolean = false, delta:int = 0, commandKey:Boolean = false, controlKey:Boolean = false, clickCount:int = 0)
Crée un objet Event contenant des informations sur les événements de souris.
MouseEvent
  
[override] Crée une copie de l’objet MouseEvent et définit la valeur de chaque propriété de sorte qu’elle corresponde à la valeur d’origine.
MouseEvent
 Inherited
formatToString(className:String, ... arguments):String
Fonction d’un utilitaire permettant d’implémenter la méthode toString() dans des classes Event ActionScript 3.0 personnalisées.
Event
 Inherited
Indique si la propriété spécifiée d’un objet est définie.
Object
 Inherited
Vérifie si la méthode preventDefault() a été appelée pour l’événement.
Event
 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
Annule le comportement par défaut d’un événement si cette opération est possible.
Event
 Inherited
Indique si la propriété spécifiée existe et est énumérable.
Object
 Inherited
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle.
Object
 Inherited
Bloque le traitement des écouteurs d’événement dans le nœud actuel et les suivants dans le flux d’événements.
Event
 Inherited
Bloque le traitement des écouteurs d’événement dans les nœuds qui suivent le nœud actuel dans le flux d’événements.
Event
 Inherited
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur.
Object
  
[override] Renvoie une chaîne répertoriant toutes les propriétés de l’objet MouseEvent.
MouseEvent
  
Demande à Flash Player ou à Adobe AIR d’effectuer un rendu à la fin du traitement de cet événement, si la liste d’affichage a été modifiée.
MouseEvent
 Inherited
Renvoie la valeur primitive de l’objet spécifié.
Object
Constantes publiques
 ConstanteDéfini par
  CLICK : String = "click"
[statique] Définit la valeur de la propriété type d’un objet d’événement click.
MouseEvent
  CONTEXT_MENU : String = "contextMenu"
[statique] La constante MouseEvent.CONTEXT_MENU définit la valeur de la propriété type d’un objet d’événement contextMenu.
MouseEvent
  DOUBLE_CLICK : String = "doubleClick"
[statique] Définit la valeur de la propriété type d’un objet d’événement doubleClick.
MouseEvent
  MIDDLE_CLICK : String = "middleClick"
[statique] Définit la valeur de la propriété type d’un objet d’événement middleClick.
MouseEvent
  MIDDLE_MOUSE_DOWN : String = "middleMouseDown"
[statique] Définit la valeur de la propriété type d’un objet d’événement middleMouseDown.
MouseEvent
  MIDDLE_MOUSE_UP : String = "middleMouseUp"
[statique] Définit la valeur de la propriété type d’un objet d’événement middleMouseUp.
MouseEvent
  MOUSE_DOWN : String = "mouseDown"
[statique] Définit la valeur de la propriété type d’un objet d’événement mouseDown.
MouseEvent
  MOUSE_MOVE : String = "mouseMove"
[statique] Définit la valeur de la propriété type d’un objet d’événement mouseMove.
MouseEvent
  MOUSE_OUT : String = "mouseOut"
[statique] Définit la valeur de la propriété type d’un objet d’événement mouseOut.
MouseEvent
  MOUSE_OVER : String = "mouseOver"
[statique] Définit la valeur de la propriété type d’un objet d’événement mouseOver.
MouseEvent
  MOUSE_UP : String = "mouseUp"
[statique] Définit la valeur de la propriété type d’un objet d’événement mouseUp.
MouseEvent
  MOUSE_WHEEL : String = "mouseWheel"
[statique] Définit la valeur de la propriété type d’un objet d’événement mouseWheel.
MouseEvent
  RELEASE_OUTSIDE : String = "releaseOutside"
[statique] Définit la valeur de la propriété type d’un objet d’événement releaseOutside.
MouseEvent
  RIGHT_CLICK : String = "rightClick"
[statique] Définit la valeur de la propriété type d’un objet d’événement rightClick.
MouseEvent
  RIGHT_MOUSE_DOWN : String = "rightMouseDown"
[statique] Définit la valeur de la propriété type d’un objet d’événement rightMouseDown.
MouseEvent
  RIGHT_MOUSE_UP : String = "rightMouseUp"
[statique] Définit la valeur de la propriété type d’un objet d’événement rightMouseUp.
MouseEvent
  ROLL_OUT : String = "rollOut"
[statique] Définit la valeur de la propriété type d’un objet d’événement rollOut.
MouseEvent
  ROLL_OVER : String = "rollOver"
[statique] Définit la valeur de la propriété type d’un objet d’événement rollOver.
MouseEvent
Détails de la propriété

altKey

propriété
altKey:Boolean

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9, Flash Lite 4

Indique si la touche Alt est active (true) ou non (false). Prise en charge sur Windows uniquement. Sous les autres systèmes d’exploitation, cette propriété est toujours définie sur false.



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

buttonDown

propriété 
buttonDown:Boolean

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9, Flash Lite 4

Indique si l’utilisateur appuie (true) ou non (false) sur le bouton principal de la souris.



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

clickCount

propriété 
clickCount:int  [lecture seule]

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Lite 4

Indique si l’événement mouse down fait partie d’une séquence multi-clic. Ce paramètre équivaut à zéro pour tous les événements mouse autres que MouseEvent.mouseDown, MouseEvent.mouseUp, MouseEvent.middleMouseDown, MouseEvent.middleMouseUp, MouseEvent.rightMouseDown et MouseEvent.rightMouseUp. L’écoute de clics simples, doubles ou de séquences multi-clic est possible avec le paramètre clickCount. Par exemple, un MouseEvent.mouseDown et MouseEvent.mouseUp initial a un clickCount de 1, et le second MouseEvent.mouseDown et MouseEvent.mouseUp dans une séquence double-clic a un clickCount de 2. Si la souris se déplace suffisamment ou que la séquence multi clic est interrompue, pour une raison ou pour une autre, le MouseEvent.mouseDown suivant a un clickCount de 1. L’événement doubleClick continue à se déclencher comme prévu.



Implémentation
    public function get clickCount():int

commandKey

propriété 
commandKey:Boolean

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Lite 4

Indique si la touche Commande est activée (Mac uniquement).

La valeur de la propriété commandKey a la même valeur que la propriété ctrlKey sur le Mac. Toujours false sous Windows ou Linux.



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

controlKey

propriété 
controlKey:Boolean

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Lite 4

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



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

ctrlKey

propriété 
ctrlKey:Boolean

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9, Flash Lite 4

Sous Windows ou Linux, indique si la touche Ctrl est activée (true) ou non (false). Sous Macintosh, indique si la touche Contrôle ou la touche Commande est activée.



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

delta

propriété 
delta:int

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9, Flash Lite 4

Indique le nombre de lignes qui doivent défiler chaque fois que l’utilisateur fait tourner la molette de sa souris d’un cran. Une valeur delta positive indique un défilement vers le haut ; une valeur négative un défilement vers le bas. Les valeurs types sont comprises entre 1 et 3 ; une rotation plus rapide peut générer des valeurs supérieures. Ce paramètre dépend du périphérique et du système d’exploitation et est généralement configurable par l’utilisateur. Cette propriété s’applique uniquement à l’événement MouseEvent.mouseWheel.



Implémentation
    public function get delta():int
    public function set delta(value:int):void

isRelatedObjectInaccessible

propriété 
isRelatedObjectInaccessible:Boolean

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 10, Flash Lite 4

Si la valeur est true, la propriété relatedObject est définie sur null pour des raisons liées aux sandbox de sécurité. Si la valeur nominale de relatedObject est une référence à un DisplayObject se trouvant dans un autre sandbox, relatedObject est défini sur null, à moins qu’il existe une autorisation dans les deux sens dans les limites de ce sandbox. L’autorisation est établie en appelant la méthode Security.allowDomain() à partir d’un fichier SWF ou en fournissant un fichier de régulation depuis le serveur d’un fichier image, puis en définissant la propriété LoaderContext.checkPolicyFile lors du chargement de l’image.



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

Eléments de l’API associés

localX

propriété 
localX:Number

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9, Flash Lite 4

Lorsque le verrouillage de la souris est désactivé, coordonnée horizontale à laquelle l’événement s’est produit, par rapport au sprite conteneur. Désactivez le verrouillage de la souris en définissant la propriété Stage.mouseLock sur false.

Lorsque le verrouillage de la souris est activé, les propriétés localX et localY sont définies sur 0. Utilisez movementX et movementY pour déterminer les changements de position de la souris lorsque le verrouillage de la souris est activé.



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

Eléments de l’API associés


Exemple
Comment utiliser cet exemple
Consultez l’exemple de la constante MOUSE_MOVE pour une illustration de l’utilisation de cette propriété.

localY

propriété 
localY:Number

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9, Flash Lite 4

Lorsque le verrouillage de la souris est désactivé, coordonnée verticale à laquelle l’événement s’est produit, par rapport au sprite conteneur. Désactivez le verrouillage de la souris en définissant la propriété Stage.mouseLock sur false.

Lorsque le verrouillage de la souris est activé, les propriétés localX et localY sont définies sur 0. Utilisez movementX et movementY pour déterminer les changements de position de la souris lorsque le verrouillage de la souris est activé.



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

Eléments de l’API associés


Exemple
Comment utiliser cet exemple
Consultez l’exemple de la constante MOUSE_MOVE pour une illustration de l’utilisation de cette propriété.

movementX

propriété 
movementX:Number

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 11.2, AIR 3.2

Lorsque le verrouillage de la souris est activé, changement de position de la souris dans la direction X depuis le dernier événement de souris. Activez le verrouillage de la souris en définissant la propriété Stage.mouseLock sur true.

Lorsque le verrouillage de la souris est activé :

  • Les propriétés localX et localY contiennent 0.
  • Les propriétés movementX et movementY contiennent les valeurs delta.
  • Les propriétés movementX et movementY ne sont jamais transformées conformément à la transformation de la scène. En d’autres termes, elles restent toujours dans les coordonnées de l’écran.

Les propriétés movementX et movementY sont définies sur 0 lorsque la propriété Stage.mouseLock est définie sur false.



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

Eléments de l’API associés


Exemple
Comment utiliser cet exemple
Consultez l’exemple de la constante MOUSE_MOVE pour une illustration de l’utilisation de cette propriété.

movementY

propriété 
movementY:Number

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 11.2, AIR 3.2

Lorsque le verrouillage de la souris est activé, changement de position de la souris dans la direction Y depuis le dernier événement de souris. Activez le verrouillage de la souris en définissant la propriété Stage.mouseLock sur true.

Lorsque le verrouillage de la souris est activé :

  • Les propriétés localX et localY contiennent 0.
  • Les propriétés movementX et movementY contiennent les valeurs delta.
  • Les propriétés movementX et movementY ne sont jamais transformées conformément à la transformation de la scène. En d’autres termes, elles restent toujours dans les coordonnées de l’écran.

Les propriétés movementX et movementY sont définies sur 0 lorsque la propriété Stage.mouseLock est définie sur false.



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

Eléments de l’API associés


Exemple
Comment utiliser cet exemple
Consultez l’exemple de la constante MOUSE_MOVE pour une illustration de l’utilisation de cette propriété.

relatedObject

propriété 
relatedObject:InteractiveObject

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9, Flash Lite 4

Référence à un objet de la liste d’affichage qui est associé à l’événement. Lorsqu’un événement mouseOut se produit par exemple, relatedObject représente l’objet de la liste d’affichage sur lequel pointe actuellement le périphérique de pointage. Cette propriété s’applique aux événements mouseOut, mouseOver, rollOut et rollOver.

La valeur de cette propriété peut être null dans deux cas : s’il n’existe aucun objet associé ou s’il existe un objet associé se trouvant dans un sandbox de sécurité auquel vous n’avez pas accès. Pour savoir dans quel cas vous vous trouvez, utilisez la propriété isRelatedObjectInaccessible().



Implémentation
    public function get relatedObject():InteractiveObject
    public function set relatedObject(value:InteractiveObject):void

Eléments de l’API associés

shiftKey

propriété 
shiftKey:Boolean

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9, Flash Lite 4

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



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

stageX

propriété 
stageX:Number  [lecture seule]

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9, Flash Lite 4

Coordonnée horizontale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène. Cette propriété est calculée lorsque la propriété localX est définie.



Implémentation
    public function get stageX():Number

Exemple
Comment utiliser cet exemple
Consultez l’exemple de la constante MOUSE_MOVE pour une illustration de l’utilisation de cette propriété.

stageY

propriété 
stageY:Number  [lecture seule]

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9, Flash Lite 4

Coordonnée verticale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène. Cette propriété est calculée lorsque la propriété localY est définie.



Implémentation
    public function get stageY():Number

Exemple
Comment utiliser cet exemple
Consultez l’exemple de la constante MOUSE_MOVE pour une illustration de l’utilisation de cette propriété.
Détails du constructeur

MouseEvent

()Constructeur
public function MouseEvent(type:String, bubbles:Boolean = true, cancelable:Boolean = false, localX:Number = NaN, localY:Number = NaN, relatedObject:InteractiveObject = null, ctrlKey:Boolean = false, altKey:Boolean = false, shiftKey:Boolean = false, buttonDown:Boolean = false, delta:int = 0, commandKey:Boolean = false, controlKey:Boolean = false, clickCount:int = 0)

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9, Flash Lite 4

Crée un objet Event contenant des informations sur les événements de souris. Les objets Event sont transmis en tant que paramètres aux écouteurs d’événements.

Paramètres
type:String — Type de l’événement. Les valeurs possibles sont les suivantes : MouseEvent.CLICK, MouseEvent.DOUBLE_CLICK, MouseEvent.MOUSE_DOWN, MouseEvent.MOUSE_MOVE, MouseEvent.MOUSE_OUT, MouseEvent.MOUSE_OVER, MouseEvent.MOUSE_UP, MouseEvent.MIDDLE_CLICK, MouseEvent.MIDDLE_MOUSE_DOWN, MouseEvent.MIDDLE_MOUSE_UP, MouseEvent.RIGHT_CLICK, MouseEvent.RIGHT_MOUSE_DOWN, MouseEvent.RIGHT_MOUSE_UP, MouseEvent.MOUSE_WHEEL, MouseEvent.ROLL_OUT et MouseEvent.ROLL_OVER.
 
bubbles:Boolean (default = true) — Détermine si l’objet Event prend part à la phase de propagation du flux d’événements.
 
cancelable:Boolean (default = false) — Détermine si l’objet d’événement peut être annulé.
 
localX:Number (default = NaN) — Coordonnée horizontale à laquelle l’événement s’est produit par rapport au sprite conteneur.
 
localY:Number (default = NaN) — Coordonnée verticale à laquelle l’événement s’est produit par rapport au sprite conteneur.
 
relatedObject:InteractiveObject (default = null) — Occurrence complémentaire d’InteractiveObject affectée par l’événement. Lorsqu’un événement mouseOut se produit par exemple, relatedObject représente l’objet de la liste d’affichage sur lequel pointe actuellement le périphérique de pointage.
 
ctrlKey:Boolean (default = false) — Sous Windows ou Linux, indique si la touche Ctrl est activée. Sous Mac, indique si la touche Ctrl ou la touche Commande est activée.
 
altKey:Boolean (default = false) — Indique si la touche Alt est activée (Windows ou Linux uniquement).
 
shiftKey:Boolean (default = false) — Indique si la touche Maj est activée.
 
buttonDown:Boolean (default = false) — Indique si l’utilisateur appuie sur le bouton principal de la souris.
 
delta:int (default = 0) — Indique le nombre de lignes qui doivent défiler chaque fois que l’utilisateur fait tourner la molette de sa souris d’un cran. Une valeur delta positive indique un défilement vers le haut ; une valeur négative un défilement vers le bas. Les valeurs types sont comprises entre 1 et 3 ; une rotation plus rapide peut générer des valeurs supérieures. Ce paramètre s’utilise uniquement avec l’événement MouseEvent.mouseWheel.
 
commandKey:Boolean (default = false) — (AIR uniquement) Indique si la touche Commande est activée (Mac uniquement). Ce paramètre est utilisé uniquement pour les événements MouseEvent.click, MouseEvent.mouseDown, MouseEvent.mouseUp, MouseEvent.middleClick, MouseEvent.middleMouseDown, MouseEvent.middleMouseUp, MouseEvent.rightClick, MouseEvent.rightMouseDown, MouseEvent.rightMouseUp et MouseEvent.doubleClick. Ce paramètre est destiné à Adobe AIR uniquement ; ne le définissez pas pour le contenu de Flash Player.
 
controlKey:Boolean (default = false) — (AIR uniquement) Indique si la touche Contrôle ou Ctrl est activée (Mac uniquement). Ce paramètre est utilisé uniquement pour les événements MouseEvent.click, MouseEvent.mouseDown, MouseEvent.mouseUp, MouseEvent.middleClick, MouseEvent.middleMouseDown, MouseEvent.middleMouseUp, MouseEvent.rightClick, MouseEvent.rightMouseDown, MouseEvent.rightMouseUp et MouseEvent.doubleClick. Ce paramètre est destiné à Adobe AIR uniquement ; ne le définissez pas pour le contenu de Flash Player.
 
clickCount:int (default = 0) — (AIR uniquement) Indique si l’événement mouse fait partie d’une séquence multi-clic. Ce paramètre équivaut à zéro pour tous les événements mouse autres que MouseEvent.mouseDown, MouseEvent.mouseUp, MouseEvent.middleMouseDown, MouseEvent.middleMouseUp, MouseEvent.rightMouseDown et MouseEvent.rightMouseUp. L’écoute de clics simples, doubles ou de séquences multi-clic est possible avec le paramètre clickCount. Ce paramètre est destiné à Adobe AIR uniquement ; ne le définissez pas pour le contenu de Flash Player.
Détails de la méthode

clone

()méthode
override public function clone():Event

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9, Flash Lite 4

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

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

toString

()méthode 
override public function toString():String

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9, Flash Lite 4

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

[MouseEvent type=value bubbles=valeur cancelable=valeur ... delta=valeur]

Valeur renvoyée
String — Chaîne répertoriant toutes les propriétés de l’objet MouseEvent.

updateAfterEvent

()méthode 
public function updateAfterEvent():void

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

Demande à Flash Player ou à Adobe AIR d’effectuer un rendu à la fin du traitement de cet événement, si la liste d’affichage a été modifiée.

Détails de la constante

CLICK

Constante
public static const CLICK:String = "click"

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9, Flash Lite 4

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

Les propriétés de cet événement sont les suivantes :

PropriétéValeur
altKeytrue si la touche Alt est activée (Windows).
bubblestrue
buttonDownPour les événements de clic, cette valeur est toujours définie sur false.
cancelablefalse ; il n’existe aucun comportement par défaut à annuler.
commandKeytrue sur le Mac si la touche Commande est activée ; false si elle est désactivée. Toujours false sur Windows.
controlKeytrue si la touche Ctrl ou Contrôle est activée ; false si elle est désactivée.
ctrlKeytrue sous Windows ou Linux si la touche Ctrl est enfoncée. true sur Mac si la touche Ctrl ou la touche Commande est activée. Sinon, la valeur false est renvoyée.
currentTargetL’objet qui traite activement l’objet Event avec un écouteur d’événements.
localXCoordonnée horizontale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé.
localYCoordonnée verticale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé.
movementXChangement de coordonnées horizontales de la position de la souris depuis le dernier événement de souris, si le verrouillage de la souris est activé.
movementYChangement de coordonnées verticales de la position de la souris depuis le dernier événement de souris, si le verrouillage de la souris est activé.
shiftKeytrue si la touche Maj est activée ; false si elle ne l’est pas.
stageXCoordonnée horizontale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène.
stageYCoordonnée verticale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène.
targetOccurrence d’InteractiveObject sous le périphérique de pointage. La propriété target ne correspond pas toujours à l’objet de la liste d’affichage qui est associé à l’écouteur d’événement. Utilisez la propriété currentTarget pour accéder à l’objet de la liste d’affichage qui traite actuellement l’événement.

Eléments de l’API associés

CONTEXT_MENU

Constante 
public static const CONTEXT_MENU:String = "contextMenu"

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Lite 4

La constante MouseEvent.CONTEXT_MENU définit la valeur de la propriété type d’un objet d’événement contextMenu.

Les propriétés de cet événement sont les suivantes :

PropriétéValeur
altKeytrue si la touche Alt est activée (Windows).
bubblestrue
buttonDowntrue si le bouton droit de la souris est enfoncé ; false dans tous les autres cas.
cancelablefalse ; le comportement par défaut ne peut pas être annulé.
commandKeytrue sur le Mac si la touche Commande est activée ; false si elle est désactivée. Toujours false sur Windows.
controlKeytrue si la touche Ctrl ou Contrôle est activée ; false si elle est désactivée.
ctrlKeytrue sous Windows ou Linux si la touche Ctrl est enfoncée. true sur Mac si la touche Ctrl ou la touche Commande est activée. Sinon, la valeur false est renvoyée.
currentTargetL’objet qui traite activement l’objet Event avec un écouteur d’événements.
localXCoordonnée horizontale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé.
localYCoordonnée verticale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé.
movementXChangement de coordonnées horizontales de la position de la souris depuis le dernier événement de souris, si le verrouillage de la souris est activé.
movementYChangement de coordonnées verticales de la position de la souris depuis le dernier événement de souris, si le verrouillage de la souris est activé.
shiftKeytrue si la touche Maj est activée ; false si elle ne l’est pas.
clickCountDécompte du nombre de clics souris pour indiquer si l’événement fait partie d’une séquence multi-clic.
stageXCoordonnée horizontale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène.
stageYCoordonnée verticale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène.
targetOccurrence 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.

DOUBLE_CLICK

Constante 
public static const DOUBLE_CLICK:String = "doubleClick"

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9, Flash Lite 4

Définit la valeur de la propriété type d’un objet d’événement doubleClick. La propriété doubleClickEnabled doit être true pour qu’un objet puisse générer l’événement doubleClick.

Les propriétés de cet événement sont les suivantes :

PropriétéValeur
altKeytrue si la touche Alt est activée (Windows).
bubblestrue
buttonDownPour les événements de double-clic, cette valeur est toujours définie sur false.
cancelablefalse ; il n’existe aucun comportement par défaut à annuler.
commandKeytrue sur le Mac si la touche Commande est activée ; false si elle est désactivée. Toujours false sur Windows.
controlKeytrue si la touche Ctrl ou Contrôle est activée ; false si elle est désactivée.
ctrlKeytrue sous Windows ou Linux si la touche Ctrl est enfoncée. true sur Mac si la touche Ctrl ou la touche Commande est activée. Sinon, la valeur false est renvoyée.
currentTargetL’objet qui traite activement l’objet Event avec un écouteur d’événements.
localXCoordonnée horizontale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé.
localYCoordonnée verticale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé.
movementXChangement de coordonnées horizontales de la position de la souris depuis le dernier événement de souris, si le verrouillage de la souris est activé.
movementYChangement de coordonnées verticales de la position de la souris depuis le dernier événement de souris, si le verrouillage de la souris est activé.
shiftKeytrue si la touche Maj est activée ; false si elle ne l’est pas.
stageXCoordonnée horizontale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène.
stageYCoordonnée verticale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène.
targetOccurrence d’InteractiveObject sous le périphérique de pointage. La propriété target ne correspond pas toujours à l’objet de la liste d’affichage qui est associé à l’écouteur d’événement. Utilisez la propriété currentTarget pour accéder à l’objet de la liste d’affichage qui traite actuellement l’événement.

Eléments de l’API associés

MIDDLE_CLICK

Constante 
public static const MIDDLE_CLICK:String = "middleClick"

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 11.2, Flash Lite 4

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

Les propriétés de cet événement sont les suivantes :

PropriétéValeur
altKeytrue si la touche Alt est activée (Windows).
bubblestrue
buttonDownPour les événements de clic central, cette valeur est toujours définie sur false.
cancelablefalse ; il n’existe aucun comportement par défaut à annuler.
commandKeytrue sur le Mac si la touche Commande est activée ; false si elle est désactivée. Toujours false sur Windows.
controlKeytrue si la touche Ctrl ou Contrôle est activée ; false si elle est désactivée.
ctrlKeytrue sous Windows ou Linux si la touche Ctrl est enfoncée. true sur Mac si la touche Ctrl ou la touche Commande est activée. Sinon, la valeur false est renvoyée.
currentTargetL’objet qui traite activement l’objet Event avec un écouteur d’événements.
localXCoordonnée horizontale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé.
localYCoordonnée verticale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé.
movementXChangement de coordonnées horizontales de la position de la souris depuis le dernier événement de souris, si le verrouillage de la souris est activé.
movementYChangement de coordonnées verticales de la position de la souris depuis le dernier événement de souris, si le verrouillage de la souris est activé.
shiftKeytrue si la touche Maj est activée ; false si elle ne l’est pas.
stageXCoordonnée horizontale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène.
stageYCoordonnée verticale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène.
targetOccurrence d’InteractiveObject sous le périphérique de pointage. La propriété target ne correspond pas toujours à l’objet de la liste d’affichage qui est associé à l’écouteur d’événement. Utilisez la propriété currentTarget pour accéder à l’objet de la liste d’affichage qui traite actuellement l’événement.

Eléments de l’API associés

MIDDLE_MOUSE_DOWN

Constante 
public static const MIDDLE_MOUSE_DOWN:String = "middleMouseDown"

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 11.2, Flash Lite 4

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

Les propriétés de cet événement sont les suivantes :

PropriétéValeur
altKeytrue si la touche Alt est activée (Windows).
bubblestrue
buttonDowntrue si le bouton central de la souris est enfoncé ; false dans tous les autres cas.
cancelablefalse ; le comportement par défaut ne peut pas être annulé.
commandKeytrue sur le Mac si la touche Commande est activée ; false si elle est désactivée. Toujours false sur Windows.
controlKeytrue si la touche Ctrl ou Contrôle est activée ; false si elle est désactivée.
ctrlKeytrue sous Windows ou Linux si la touche Ctrl est enfoncée. true sur Mac si la touche Ctrl ou la touche Commande est activée. Sinon, la valeur false est renvoyée.
currentTargetL’objet qui traite activement l’objet Event avec un écouteur d’événements.
localXCoordonnée horizontale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé.
localYCoordonnée verticale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé.
movementXChangement de coordonnées horizontales de la position de la souris depuis le dernier événement de souris, si le verrouillage de la souris est activé.
movementYChangement de coordonnées verticales de la position de la souris depuis le dernier événement de souris, si le verrouillage de la souris est activé.
shiftKeytrue si la touche Maj est activée ; false si elle ne l’est pas.
clickCountDécompte du nombre de clics souris pour indiquer si l’événement fait partie d’une séquence multi-clic.
stageXCoordonnée horizontale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène.
stageYCoordonnée verticale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène.
targetOccurrence d’InteractiveObject sous le périphérique de pointage. La propriété target ne correspond pas toujours à l’objet de la liste d’affichage qui est associé à l’écouteur d’événement. Utilisez la propriété currentTarget pour accéder à l’objet de la liste d’affichage qui traite actuellement l’événement.

Eléments de l’API associés

MIDDLE_MOUSE_UP

Constante 
public static const MIDDLE_MOUSE_UP:String = "middleMouseUp"

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 11.2, Flash Lite 4

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

Les propriétés de cet événement sont les suivantes :

PropriétéValeur
altKeytrue si la touche Alt est activée (Windows).
bubblestrue
buttonDowntrue si le bouton central de la souris est enfoncé ; false dans tous les autres cas.
cancelablefalse ; le comportement par défaut ne peut pas être annulé.
commandKeytrue sur le Mac si la touche Commande est activée ; false si elle est désactivée. Toujours false sur Windows.
controlKeytrue si la touche Ctrl ou Contrôle est activée ; false si elle est désactivée.
ctrlKeytrue sous Windows ou Linux si la touche Ctrl est enfoncée. true sur Mac si la touche Ctrl ou la touche Commande est activée. Sinon, la valeur false est renvoyée.
currentTargetL’objet qui traite activement l’objet Event avec un écouteur d’événements.
localXCoordonnée horizontale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé.
localYCoordonnée verticale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé.
movementXChangement de coordonnées horizontales de la position de la souris depuis le dernier événement de souris, si le verrouillage de la souris est activé.
movementYChangement de coordonnées verticales de la position de la souris depuis le dernier événement de souris, si le verrouillage de la souris est activé.
shiftKeytrue si la touche Maj est activée ; false si elle ne l’est pas.
clickCountDécompte du nombre de clics souris pour indiquer si l’événement fait partie d’une séquence multi-clic.
stageXCoordonnée horizontale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène.
stageYCoordonnée verticale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène.
targetOccurrence d’InteractiveObject sous le périphérique de pointage. La propriété target ne correspond pas toujours à l’objet de la liste d’affichage qui est associé à l’écouteur d’événement. Utilisez la propriété currentTarget pour accéder à l’objet de la liste d’affichage qui traite actuellement l’événement.

Eléments de l’API associés

MOUSE_DOWN

Constante 
public static const MOUSE_DOWN:String = "mouseDown"

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9, Flash Lite 4

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

Les propriétés de cet événement sont les suivantes :

PropriétéValeur
altKeytrue si la touche Alt est activée (Windows).
bubblestrue
buttonDowntrue si le bouton principal de la souris est enfoncé ; false dans tous les autres cas.
cancelablefalse ; le comportement par défaut ne peut pas être annulé.
commandKeytrue sur le Mac si la touche Commande est activée ; false si elle est désactivée. Toujours false sur Windows.
controlKeytrue si la touche Ctrl ou Contrôle est activée ; false si elle est désactivée.
ctrlKeytrue sous Windows et Linux si la touche Ctrl est activée. true sur Mac si la touche Ctrl ou la touche Commande est activée. Sinon, la valeur false est renvoyée.
currentTargetL’objet qui traite activement l’objet Event avec un écouteur d’événements.
localXCoordonnée horizontale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé.
localYCoordonnée verticale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé.
movementXChangement de coordonnées horizontales de la position de la souris depuis le dernier événement de souris, si le verrouillage de la souris est activé.
movementYChangement de coordonnées verticales de la position de la souris depuis le dernier événement de souris, si le verrouillage de la souris est activé.
shiftKeytrue si la touche Maj est activée ; false si elle ne l’est pas.
clickCountDécompte du nombre de clics souris pour indiquer si l’événement fait partie d’une séquence multi-clic.
stageXCoordonnée horizontale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène.
stageYCoordonnée verticale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène.
targetOccurrence d’InteractiveObject sous le périphérique de pointage. La propriété target ne correspond pas toujours à l’objet de la liste d’affichage qui est associé à l’écouteur d’événement. Utilisez la propriété currentTarget pour accéder à l’objet de la liste d’affichage qui traite actuellement l’événement.

Eléments de l’API associés


Exemple
Comment utiliser cet exemple
Consultez l’exemple de la constante MOUSE_MOVE pour une illustration de l’utilisation de cette constante.

MOUSE_MOVE

Constante 
public static const MOUSE_MOVE:String = "mouseMove"

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9, Flash Lite 4

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

Les propriétés de cet événement sont les suivantes :

PropriétéValeur
altKeytrue si la touche Alt est activée (Windows).
bubblestrue
buttonDowntrue si le bouton principal de la souris est enfoncé ; false dans tous les autres cas.
cancelablefalse ; le comportement par défaut ne peut pas être annulé.
commandKeytrue sur le Mac si la touche Commande est activée ; false si elle est désactivée. Toujours false sur Windows.
controlKeytrue si la touche Ctrl ou Contrôle est activée ; false si elle est désactivée.
ctrlKeytrue sous Windows ou Linux si la touche Ctrl est enfoncée. true sur Mac si la touche Ctrl ou la touche Commande est activée. Sinon, la valeur false est renvoyée.
currentTargetL’objet qui traite activement l’objet Event avec un écouteur d’événements.
localXCoordonnée horizontale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé.
localYCoordonnée verticale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé.
movementXChangement de coordonnées horizontales de la position de la souris depuis le dernier événement de souris, si le verrouillage de la souris est activé.
movementYChangement de coordonnées verticales de la position de la souris depuis le dernier événement de souris, si le verrouillage de la souris est activé.
shiftKeytrue si la touche Maj est activée ; false si elle ne l’est pas.
stageXCoordonnée horizontale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène.
stageYCoordonnée verticale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène.
targetOccurrence d’InteractiveObject sous le périphérique de pointage. La propriété target ne correspond pas toujours à l’objet de la liste d’affichage qui est associé à l’écouteur d’événement. Utilisez la propriété currentTarget pour accéder à l’objet de la liste d’affichage qui traite actuellement l’événement.

Eléments de l’API associés


Exemple  ( Comment utiliser cet exemple )

L’exemple suivant est un programme de dessin simple. L’utilisateur peut dessiner sur l’objet Sprite principal ou sur un plus petit objet Sprite rectangulaire.

Dans le constructeur, un objet Sprite innerRect de rectangle est créé et le style de ligne est défini sur vert. Le style de ligne pour dessiner sur le conteneur Sprite MouseEvent_MOUSE_MOVEExample est défini sur rouge. Des écouteurs d’événement séparés pour les événements MouseEvent.MOUSE_UP et MouseEvent.MOUSE_DOWN sont ajoutés pour l’objet Sprite principal de l’application et l’objet Sprite innerRect. Dans les deux cas, les méthodes de l’écouteur d’événement mouse down déplacent la position de dessin actuelle sur l’emplacement du pointeur de la souris et ajoutent un écouteur pour l’événement MouseEvent.MOUSE_MOVE. Lorsque le pointeur de la souris est déplacé, les méthodes de l’écouteur d’événements invoquées suivent le pointeur et tracent une ligne à l’aide de la méthode graphics.LineTo() (remarque : l’objet Sprite innerRect masque les lignes rouges de l’objet Sprite principal tracées derrière le rectangle). Lorsque l’événement MouseEvent.MOUSE_UP a lieu, l’écouteur pour l’événement MOUSE_MOVE est supprimé et le dessin est arrêté.

package {
    import flash.display.Sprite;
    import flash.display.Graphics;
    import flash.events.MouseEvent;

    public class MouseEvent_MOUSE_MOVEExample extends Sprite {
        private var innerRect:Sprite = new Sprite();
        
        public function MouseEvent_MOUSE_MOVEExample() {

            graphics.lineStyle(3, 0xFF0000, 1);
            stage.addEventListener(MouseEvent.MOUSE_DOWN, mouseDownHandler);
            stage.addEventListener(MouseEvent.MOUSE_UP, mouseUpHandler);

            innerRect.graphics.lineStyle(1, 0x00FF00, 1);
            innerRect.graphics.beginFill(0xFFFFFF);
            innerRect.graphics.drawRect(10, 10, 200, 200);
            innerRect.graphics.endFill();
            innerRect.addEventListener(MouseEvent.MOUSE_DOWN, innerRectMouseDownHandler);
            innerRect.addEventListener(MouseEvent.MOUSE_UP, innerRectMouseUpHandler);
            addChild(innerRect);
        }

        private function mouseDownHandler(event:MouseEvent):void {
            graphics.moveTo(event.stageX, event.stageY);
            stage.addEventListener(MouseEvent.MOUSE_MOVE, mouseMoveHandler);
        }
    
        private function mouseMoveHandler(event:MouseEvent):void {
            graphics.lineTo(event.stageX, event.stageY);
        }    
    
        private function mouseUpHandler(event:MouseEvent):void {
            stage.removeEventListener(MouseEvent.MOUSE_MOVE, mouseMoveHandler);
        }

        private function innerRectMouseDownHandler(event:MouseEvent):void {
            innerRect.graphics.moveTo(event.localX, event.localY);
            innerRect.addEventListener(MouseEvent.MOUSE_MOVE, innerRectMouseMoveHandler);
        }
    
        private function innerRectMouseMoveHandler(event:MouseEvent):void {
            innerRect.graphics.lineTo(event.localX, event.localY);
        }    
    
        private function innerRectMouseUpHandler(event:MouseEvent):void {
            innerRect.removeEventListener(MouseEvent.MOUSE_MOVE, innerRectMouseMoveHandler);
        }
    }
}

MOUSE_OUT

Constante 
public static const MOUSE_OUT:String = "mouseOut"

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9, Flash Lite 4

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

Les propriétés de cet événement sont les suivantes :

PropriétéValeur
altKeytrue si la touche Alt est activée (Windows).
bubblestrue
buttonDowntrue si le bouton principal de la souris est enfoncé ; false dans tous les autres cas.
cancelablefalse ; le comportement par défaut ne peut pas être annulé.
commandKeytrue sur le Mac si la touche Commande est activée ; false si elle est désactivée. Toujours false sur Windows.
controlKeytrue si la touche Ctrl ou Contrôle est activée ; false si elle est désactivée.
ctrlKeytrue sous Windows ou Linux si la touche Ctrl est enfoncée. true sur Mac si la touche Ctrl ou la touche Commande est activée. Sinon, la valeur false est renvoyée.
currentTargetL’objet qui traite activement l’objet Event avec un écouteur d’événements.
relatedObjectObjet de la liste d’affichage sur lequel pointe actuellement le périphérique de pointage.
localXCoordonnée horizontale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé.
localYCoordonnée verticale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé.
movementXChangement de coordonnées horizontales de la position de la souris depuis le dernier événement de souris, si le verrouillage de la souris est activé.
movementYChangement de coordonnées verticales de la position de la souris depuis le dernier événement de souris, si le verrouillage de la souris est activé.
shiftKeytrue si la touche Maj est activée ; false si elle ne l’est pas.
stageXCoordonnée horizontale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène.
stageYCoordonnée verticale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène.
targetOccurrence d’InteractiveObject sous le périphérique de pointage. La propriété target ne correspond pas toujours à l’objet de la liste d’affichage qui est associé à l’écouteur d’événement. Utilisez la propriété currentTarget pour accéder à l’objet de la liste d’affichage qui traite actuellement l’événement.

Eléments de l’API associés

MOUSE_OVER

Constante 
public static const MOUSE_OVER:String = "mouseOver"

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9, Flash Lite 4

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

Les propriétés de cet événement sont les suivantes :

PropriétéValeur
altKeytrue si la touche Alt est activée (Windows).
bubblestrue
buttonDowntrue si le bouton principal de la souris est enfoncé ; false dans tous les autres cas.
cancelablefalse ; le comportement par défaut ne peut pas être annulé.
commandKeytrue sur le Mac si la touche Commande est activée ; false si elle est désactivée. Toujours false sur Windows.
controlKeytrue si la touche Ctrl ou Contrôle est activée ; false si elle est désactivée.
ctrlKeytrue sous Windows ou Linux si la touche Ctrl est enfoncée. true sur Mac si la touche Ctrl ou la touche Commande est activée. Sinon, la valeur false est renvoyée.
currentTargetL’objet qui traite activement l’objet Event avec un écouteur d’événements.
relatedObjectObjet de la liste d’affichage sur lequel pointait le périphérique de pointage.
localXCoordonnée horizontale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé.
localYCoordonnée verticale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé.
movementXChangement de coordonnées horizontales de la position de la souris depuis le dernier événement de souris, si le verrouillage de la souris est activé.
movementYChangement de coordonnées verticales de la position de la souris depuis le dernier événement de souris, si le verrouillage de la souris est activé.
shiftKeytrue si la touche Maj est activée ; false si elle ne l’est pas.
stageXCoordonnée horizontale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène.
stageYCoordonnée verticale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène.
targetOccurrence d’InteractiveObject sous le périphérique de pointage. La propriété target ne correspond pas toujours à l’objet de la liste d’affichage qui est associé à l’écouteur d’événement. Utilisez la propriété currentTarget pour accéder à l’objet de la liste d’affichage qui traite actuellement l’événement.

Eléments de l’API associés

MOUSE_UP

Constante 
public static const MOUSE_UP:String = "mouseUp"

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9, Flash Lite 4

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

Les propriétés de cet événement sont les suivantes :

PropriétéValeur
altKeytrue si la touche Alt est activée (Windows).
bubblestrue
buttonDowntrue si le bouton principal de la souris est enfoncé ; false dans tous les autres cas.
cancelablefalse ; le comportement par défaut ne peut pas être annulé.
commandKeytrue sur le Mac si la touche Commande est activée ; false si elle est désactivée. Toujours false sur Windows.
controlKeytrue si la touche Ctrl ou Contrôle est activée ; false si elle est désactivée.
ctrlKeytrue sous Windows ou Linux si la touche Ctrl est enfoncée. true sur Mac si la touche Ctrl ou la touche Commande est activée. Sinon, la valeur false est renvoyée.
currentTargetL’objet qui traite activement l’objet Event avec un écouteur d’événements.
localXCoordonnée horizontale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé.
localYCoordonnée verticale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé.
movementXChangement de coordonnées horizontales de la position de la souris depuis le dernier événement de souris, si le verrouillage de la souris est activé.
movementYChangement de coordonnées verticales de la position de la souris depuis le dernier événement de souris, si le verrouillage de la souris est activé.
shiftKeytrue si la touche Maj est activée ; false si elle ne l’est pas.
clickCountDécompte du nombre de clics souris pour indiquer si l’événement fait partie d’une séquence multi-clic.
stageXCoordonnée horizontale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène.
stageYCoordonnée verticale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène.
targetOccurrence d’InteractiveObject sous le périphérique de pointage. La propriété target ne correspond pas toujours à l’objet de la liste d’affichage qui est associé à l’écouteur d’événement. Utilisez la propriété currentTarget pour accéder à l’objet de la liste d’affichage qui traite actuellement l’événement.

Eléments de l’API associés


Exemple
Comment utiliser cet exemple
Consultez l’exemple de la constante MOUSE_MOVE pour une illustration de l’utilisation de cette constante.

MOUSE_WHEEL

Constante 
public static const MOUSE_WHEEL:String = "mouseWheel"

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

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

Les propriétés de cet événement sont les suivantes :

PropriétéValeur
altKeytrue si la touche Alt est activée (Windows).
bubblestrue
buttonDowntrue si le bouton principal de la souris est enfoncé ; false dans tous les autres cas.
cancelablefalse ; le comportement par défaut ne peut pas être annulé.
commandKeytrue sur le Mac si la touche Commande est activée ; false si elle est désactivée. Toujours false sur Windows.
controlKeytrue si la touche Ctrl ou Contrôle est activée ; false si elle est désactivée.
ctrlKeytrue sous Windows ou Linux si la touche Ctrl est enfoncée. true sur Mac si la touche Ctrl ou la touche Commande est activée. Sinon, la valeur false est renvoyée.
currentTargetL’objet qui traite activement l’objet Event avec un écouteur d’événements.
deltaNombre de lignes représenté par chaque cran de la molette de la souris.
localXCoordonnée horizontale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé.
localYCoordonnée verticale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé.
movementXChangement de coordonnées horizontales de la position de la souris depuis le dernier événement de souris, si le verrouillage de la souris est activé.
movementYChangement de coordonnées verticales de la position de la souris depuis le dernier événement de souris, si le verrouillage de la souris est activé.
shiftKeytrue si la touche Maj est activée ; false si elle ne l’est pas.
stageXCoordonnée horizontale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène.
stageYCoordonnée verticale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène.
targetOccurrence d’InteractiveObject sous le périphérique de pointage. La propriété target ne correspond pas toujours à l’objet de la liste d’affichage qui est associé à l’écouteur d’événement. Utilisez la propriété currentTarget pour accéder à l’objet de la liste d’affichage qui traite actuellement l’événement.

Eléments de l’API associés

RELEASE_OUTSIDE

Constante 
public static const RELEASE_OUTSIDE:String = "releaseOutside"

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 3.3, Flash Player 11.3

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

Les propriétés de cet événement sont les suivantes :

PropriétéValeur
altKeytrue si la touche Alt est activée (Windows).
bubblestrue
buttonDownfalse
cancelablefalse ; le comportement par défaut ne peut pas être annulé.
commandKeytrue sur le Mac si la touche Commande est activée ; false si elle est désactivée. Toujours false sur Windows.
controlKeytrue si la touche Ctrl ou Contrôle est activée ; false si elle est désactivée.
ctrlKeytrue sous Windows ou Linux si la touche Ctrl est enfoncée. true sur Mac si la touche Ctrl ou la touche Commande est activée. Sinon, la valeur false est renvoyée.
currentTargetL’objet qui traite activement l’objet Event avec un écouteur d’événements.
localXCoordonnée horizontale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé.
localYCoordonnée verticale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé.
shiftKeytrue si la touche Maj est activée ; false si elle ne l’est pas.
clickCountDécompte du nombre de clics souris pour indiquer si l’événement fait partie d’une séquence multi-clic.
stageXCoordonnée horizontale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène.
stageYCoordonnée verticale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène.
targetL’objet InteractiveObject qui pointe vers le bouton du périphérique est tout d’abord enfoncé hors de l’occurrence, puis relâché. La propriété target ne correspond pas toujours à l’objet de la liste d’affichage qui est associé à l’écouteur d’événement. Utilisez la propriété currentTarget pour accéder à l’objet de la liste d’affichage qui traite actuellement l’événement.

Eléments de l’API associés


Exemple
Comment utiliser cet exemple
Consultez l’exemple de la constante MOUSE_MOVE pour une illustration de l’utilisation de cette constante.

RIGHT_CLICK

Constante 
public static const RIGHT_CLICK:String = "rightClick"

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 11.2, Flash Lite 4

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

Les propriétés de cet événement sont les suivantes :

PropriétéValeur
altKeytrue si la touche Alt est activée (Windows).
bubblestrue
buttonDownPour les événements de clic droit, cette valeur est toujours définie sur false.
cancelablefalse ; il n’existe aucun comportement par défaut à annuler.
commandKeytrue sur le Mac si la touche Commande est activée ; false si elle est désactivée. Toujours false sur Windows.
controlKeytrue si la touche Ctrl ou Contrôle est activée ; false si elle est désactivée.
ctrlKeytrue sous Windows ou Linux si la touche Ctrl est enfoncée. true sur Mac si la touche Ctrl ou la touche Commande est activée. Sinon, la valeur false est renvoyée.
currentTargetL’objet qui traite activement l’objet Event avec un écouteur d’événements.
localXCoordonnée horizontale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé.
localYCoordonnée verticale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé.
movementXChangement de coordonnées horizontales de la position de la souris depuis le dernier événement de souris, si le verrouillage de la souris est activé.
movementYChangement de coordonnées verticales de la position de la souris depuis le dernier événement de souris, si le verrouillage de la souris est activé.
shiftKeytrue si la touche Maj est activée ; false si elle ne l’est pas.
stageXCoordonnée horizontale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène.
stageYCoordonnée verticale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène.
targetOccurrence d’InteractiveObject sous le périphérique de pointage. La propriété target ne correspond pas toujours à l’objet de la liste d’affichage qui est associé à l’écouteur d’événement. Utilisez la propriété currentTarget pour accéder à l’objet de la liste d’affichage qui traite actuellement l’événement.

Eléments de l’API associés

RIGHT_MOUSE_DOWN

Constante 
public static const RIGHT_MOUSE_DOWN:String = "rightMouseDown"

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 11.2, Flash Lite 4

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

Les propriétés de cet événement sont les suivantes :

PropriétéValeur
altKeytrue si la touche Alt est activée (Windows).
bubblestrue
buttonDownPour les événements de clic droit, cette valeur est toujours définie sur true.
cancelablefalse ; le comportement par défaut ne peut pas être annulé.
commandKeytrue sur le Mac si la touche Commande est activée ; false si elle est désactivée. Toujours false sur Windows.
controlKeytrue si la touche Ctrl ou Contrôle est activée ; false si elle est désactivée.
ctrlKeytrue sous Windows ou Linux si la touche Ctrl est enfoncée. true sur Mac si la touche Ctrl ou la touche Commande est activée. Sinon, la valeur false est renvoyée.
currentTargetL’objet qui traite activement l’objet Event avec un écouteur d’événements.
localXCoordonnée horizontale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé.
localYCoordonnée verticale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé.
movementXChangement de coordonnées horizontales de la position de la souris depuis le dernier événement de souris, si le verrouillage de la souris est activé.
movementYChangement de coordonnées verticales de la position de la souris depuis le dernier événement de souris, si le verrouillage de la souris est activé.
shiftKeytrue si la touche Maj est activée ; false si elle ne l’est pas.
clickCountDécompte du nombre de clics souris pour indiquer si l’événement fait partie d’une séquence multi-clic.
stageXCoordonnée horizontale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène.
stageYCoordonnée verticale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène.
targetOccurrence d’InteractiveObject sous le périphérique de pointage. La propriété target ne correspond pas toujours à l’objet de la liste d’affichage qui est associé à l’écouteur d’événement. Utilisez la propriété currentTarget pour accéder à l’objet de la liste d’affichage qui traite actuellement l’événement.

Eléments de l’API associés

RIGHT_MOUSE_UP

Constante 
public static const RIGHT_MOUSE_UP:String = "rightMouseUp"

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 11.2, Flash Lite 4

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

Les propriétés de cet événement sont les suivantes :

PropriétéValeur
altKeytrue si la touche Alt est activée (Windows).
bubblestrue
buttonDowntrue si le bouton droit de la souris est enfoncé ; false dans tous les autres cas.
cancelablefalse ; le comportement par défaut ne peut pas être annulé.
commandKeytrue sur le Mac si la touche Commande est activée ; false si elle est désactivée. Toujours false sur Windows.
controlKeytrue si la touche Ctrl ou Contrôle est activée ; false si elle est désactivée.
ctrlKeytrue sous Windows ou Linux si la touche Ctrl est enfoncée. true sur Mac si la touche Ctrl ou la touche Commande est activée. Sinon, la valeur false est renvoyée.
currentTargetL’objet qui traite activement l’objet Event avec un écouteur d’événements.
localXCoordonnée horizontale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé.
localYCoordonnée verticale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé.
movementXChangement de coordonnées horizontales de la position de la souris depuis le dernier événement de souris, si le verrouillage de la souris est activé.
movementYChangement de coordonnées verticales de la position de la souris depuis le dernier événement de souris, si le verrouillage de la souris est activé.
shiftKeytrue si la touche Maj est activée ; false si elle ne l’est pas.
clickCountDécompte du nombre de clics souris pour indiquer si l’événement fait partie d’une séquence multi-clic.
stageXCoordonnée horizontale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène.
stageYCoordonnée verticale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène.
targetOccurrence d’InteractiveObject sous le périphérique de pointage. La propriété target ne correspond pas toujours à l’objet de la liste d’affichage qui est associé à l’écouteur d’événement. Utilisez la propriété currentTarget pour accéder à l’objet de la liste d’affichage qui traite actuellement l’événement.

Eléments de l’API associés

ROLL_OUT

Constante 
public static const ROLL_OUT:String = "rollOut"

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9, Flash Lite 4

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

Les propriétés de cet événement sont les suivantes :

PropriétéValeur
altKeytrue si la touche Alt est activée (Windows).
bubblesfalse
buttonDowntrue si le bouton principal de la souris est enfoncé ; false dans tous les autres cas.
cancelablefalse ; il n’existe aucun comportement par défaut à annuler.
commandKeytrue sur le Mac si la touche Commande est activée ; false si elle est désactivée. Toujours false sur Windows.
controlKeytrue si la touche Ctrl ou Contrôle est activée ; false si elle est désactivée.
ctrlKeytrue sous Windows ou Linux si la touche Ctrl est enfoncée. true sur Mac si la touche Ctrl ou la touche Commande est activée. Sinon, la valeur false est renvoyée.
currentTargetL’objet qui traite activement l’objet Event avec un écouteur d’événements.
relatedObjectObjet de la liste d’affichage sur lequel pointe actuellement le périphérique de pointage.
localXCoordonnée horizontale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé.
localYCoordonnée verticale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé.
movementXChangement de coordonnées horizontales de la position de la souris depuis le dernier événement de souris, si le verrouillage de la souris est activé.
movementYChangement de coordonnées verticales de la position de la souris depuis le dernier événement de souris, si le verrouillage de la souris est activé.
shiftKeytrue si la touche Maj est activée ; false si elle ne l’est pas.
stageXCoordonnée horizontale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène.
stageYCoordonnée verticale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène.
targetOccurrence d’InteractiveObject sous le périphérique de pointage. La propriété target ne correspond pas toujours à l’objet de la liste d’affichage qui est associé à l’écouteur d’événement. Utilisez la propriété currentTarget pour accéder à l’objet de la liste d’affichage qui traite actuellement l’événement.

Eléments de l’API associés

ROLL_OVER

Constante 
public static const ROLL_OVER:String = "rollOver"

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9, Flash Lite 4

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

Les propriétés de cet événement sont les suivantes :

PropriétéValeur
altKeytrue si la touche Alt est activée (Windows).
bubblesfalse
buttonDowntrue si le bouton principal de la souris est enfoncé ; false dans tous les autres cas.
cancelablefalse ; il n’existe aucun comportement par défaut à annuler.
commandKeytrue sur le Mac si la touche Commande est activée ; false si elle est désactivée. Toujours false sur Windows.
controlKeytrue si la touche Ctrl ou Contrôle est activée ; false si elle est désactivée.
ctrlKeytrue sous Windows ou Linux si la touche Ctrl est enfoncée. true sur Mac si la touche Ctrl ou la touche Commande est activée. Sinon, la valeur false est renvoyée.
currentTargetL’objet qui traite activement l’objet Event avec un écouteur d’événements.
relatedObjectObjet de la liste d’affichage sur lequel pointait le périphérique de pointage.
localXCoordonnée horizontale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé.
localYCoordonnée verticale à laquelle l’événement s’est produit, par rapport au sprite conteneur, si le verrouillage de la souris est désactivé.
movementXChangement de coordonnées horizontales de la position de la souris depuis le dernier événement de souris, si le verrouillage de la souris est activé.
movementYChangement de coordonnées verticales de la position de la souris depuis le dernier événement de souris, si le verrouillage de la souris est activé.
shiftKeytrue si la touche Maj est activée ; false si elle ne l’est pas.
stageXCoordonnée horizontale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène.
stageYCoordonnée verticale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène.
targetOccurrence d’InteractiveObject sous le périphérique de pointage. La propriété target ne correspond pas toujours à l’objet de la liste d’affichage qui est associé à l’écouteur d’événement. Utilisez la propriété currentTarget pour accéder à l’objet de la liste d’affichage qui traite actuellement l’événement.

Eléments de l’API associés

MouseEventExample.as

L’exemple suivant utilise les classes MouseEventExample et ChildSprite pour montrer comment les événements de souris sont distribués à l’aide d’une image simple. Cet exemple exécute les tâches suivantes :
  1. L’exemple déclare les propriétés de la taille (100x100 pixels) et de la couleur d’arrière-plan (orange) à utiliser pour tracer le carré.
  2. Le constructeur crée un nouvel objet ChildSprite child. Son constructeur dessine tout d’abord un carré orange de 100x100 pixels aux coordonnées (0,0) en appelant sa méthode draw() et en ajoutant ensuite sept écouteurs/abonnés d’événements.
    • click / clickHandler() : Distribué lorsque l’utilisateur clique une fois dans le carré avec le bouton gauche de sa souris.
    • doubleClick / doubleClickHandler() : Distribué lorsque l’utilisateur double-clique dans le carré avec le bouton gauche de sa souris.
    • mouseDown / mouseDownHandler() : Lorsque l’utilisateur clique sur l’objet ChildSprite (le carré orange), un message trace() est imprimé à l’écran, puis ChildSprite.draw() est appelé, pour dessiner un carré jaune foncé à la place du carré bleu clair dessiné par mouseOverHandler(). La méthode mouseDownHandler() ajoute également un écouteur d’événements mouseMove et l’abonné mouseMoveHandler() (décrit ci-dessous), qui traite les déplacements de la souris. La méthode startDrag() est ensuite appelée et permet de faire glisser l’objet Sprite.
    • mouseOut / mouseOutHandler() : Distribué chaque fois que le pointeur quitte la zone du carré. La méthode draw() est appelée pour réinitialiser la taille et la couleur normales du carré.
    • mouseOver / mouseOverHandler() : Distribué lorsque le pointeur de la souris survole le carré. Cette méthode redessine le carré avec une taille plus importante et une couleur d’arrière-plan jaune foncé.
    • mouseUp / mouseUpHandler() : Lorsque l’utilisateur relâche le bouton de sa souris, l’écouteur d’événements mouseMove est supprimé et stopDrag est appelé, ce qui fige le carré en place.
    • mouseMove/mouseMoveHandler() : Appelés dans le cadre de la fonction mouseDownHandler() et distribués lorsque l’utilisateur appuie sur le bouton gauche de la souris et fait glisser le carré.
    • mouseWheel / mouseWheelHandler() : Distribué lorsque l’utilisateur fait tourner la molette de sa souris dans le carré.
  3. L’occurrence ChildSprite child est ensuite ajoutée à la liste d’affichage par le biais de addChild(), qui redessine rapidement le carré orange.

Remarques :

  • la classe MouseEventExample doit être la racine du document.
  • Certaines des méthodes d’événements énumérées ci-dessus déclarent une variable locale sprite, qui affecte event.target au type Sprite.
package {
    import flash.display.Sprite;

    public class MouseEventExample extends Sprite {
        private var size:uint = 100;
        private var bgColor:uint = 0xFFCC00;

        public function MouseEventExample() {
            var child:ChildSprite = 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() {
        draw(size, size, backgroundColor);
            doubleClickEnabled = true;
        addEventListener(MouseEvent.CLICK, clickHandler);
        addEventListener(MouseEvent.DOUBLE_CLICK, doubleClickHandler);
        addEventListener(MouseEvent.MOUSE_DOWN, mouseDownHandler);
        addEventListener(MouseEvent.MOUSE_OUT, mouseOutHandler);
        addEventListener(MouseEvent.MOUSE_OVER, mouseOverHandler);
        addEventListener(MouseEvent.MOUSE_UP, mouseUpHandler);
        addEventListener(MouseEvent.MOUSE_WHEEL, mouseWheelHandler);
    }

    private function draw(w:uint, h:uint, bgColor:uint):void {
        graphics.clear();
        graphics.beginFill(bgColor);
        graphics.drawRect(0, 0, w, h);
        graphics.endFill();
    }

    private function clickHandler(event:MouseEvent):void {
        trace("clickHandler");
    }

    private function doubleClickHandler(event:MouseEvent):void {
        trace("doubleClickHandler");
    }

    private function mouseDownHandler(event:MouseEvent):void {
        trace("mouseDownHandler");
        draw(overSize, overSize, downColor);

        var sprite:Sprite = Sprite(event.target);
        sprite.addEventListener(MouseEvent.MOUSE_MOVE, mouseMoveHandler);
        sprite.startDrag();
    }

    private function mouseMoveHandler(event:MouseEvent):void {
        trace("mouseMoveHandler");
        event.updateAfterEvent();
    }

    private function mouseOutHandler(event:MouseEvent):void {
        trace("mouseOutHandler");
        draw(size, size, backgroundColor);
    }

    private function mouseOverHandler(event:MouseEvent):void {
        trace("mouseOverHandler");
        draw(overSize, overSize, overColor);
    }

    private function mouseWheelHandler(event:MouseEvent):void {
        trace("mouseWheelHandler delta: " + event.delta);
    }

    private function mouseUpHandler(event:MouseEvent):void {
        trace("mouseUpHandler");
        var sprite:Sprite = Sprite(event.target);
        sprite.removeEventListener(MouseEvent.MOUSE_MOVE, mouseMoveHandler);
        sprite.stopDrag();
        draw(overSize, overSize, overColor);
    }
}




[ X ]Pourquoi existe-t-il du contenu en anglais ?
Certaines parties du Guide de référence ActionScript 3.0 sont en anglais

Tout le contenu du Guide de référence ActionScript 3.0 n’a pas été traduit dans toutes les langues. Si un élément de langage n’est pas traduit, il s’affiche en anglais. Par exemple, la classe ga.controls.HelpBox n’est traduite dans aucune langue. Ainsi, dans la version française du guide de référence, la classe ga.controls.HelpBox apparaît en anglais.