Packageflash.events
Classepublic class MouseEvent
HéritageMouseEvent Inheritance Event Inheritance Object

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

Flash® Player distribue des objets MouseEvent dans le flux d’événements à chaque événement de souris. 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



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 annulé.
Event
 Inheritedconstructor : Object
Référence à l'objet de classe ou à la fonction constructeur d'une occurrence donnée d'un objet.
Object
  ctrlKey : Boolean
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
  localX : Number
Coordonnée horizontale à laquelle l’événement s’est produit par rapport au sprite conteneur.
MouseEvent
  localY : Number
Coordonnée verticale à laquelle l’événement s’est produit par rapport au sprite conteneur.
MouseEvent
 Inheritedprototype : Object
[static] Référence à l’objet prototype d’un objet de classe ou fonction.
Object
  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, localY:Number, relatedObject:InteractiveObject = null, ctrlKey:Boolean = false, altKey:Boolean = false, shiftKey:Boolean = false, buttonDown:Boolean = false, delta:int = 0)
Crée un objet Event contenant des informations sur les événements de souris.
MouseEvent
  
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 votre classe Event personnalisée.
Event
 Inherited
Indique si la propriété spécifiée d'un objet est définie.
Object
 Inherited
Vérifie si 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
  
Renvoie une chaîne répertoriant toutes les propriétés de l'objet MouseEvent.
MouseEvent
  
Demande à Flash Player 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
 InheritedACTIVATE : String = "activate"
[static] Définit la valeur de la propriété type d'un objet événement activate.
Event
 InheritedADDED : String = "added"
[static] Définit la valeur de la propriété type d'un objet événement added.
Event
 InheritedADDED_TO_STAGE : String = "addedToStage"
[static] Définit la valeur de la propriété type d'un objet événement addedToStage.
Event
 InheritedCANCEL : String = "cancel"
[static] Définit la valeur de la propriété type d'un objet événement cancel.
Event
 InheritedCHANGE : String = "change"
[static] Définit la valeur de la propriété type d'un objet événement change.
Event
  CLICK : String = "click"
[static] Définit la valeur de la propriété type d'un objet événement click.
MouseEvent
 InheritedCLOSE : String = "close"
[static] Définit la valeur de la propriété type d'un objet événement close.
Event
 InheritedCOMPLETE : String = "complete"
[static] Définit la valeur de la propriété type d'un objet événement complete.
Event
 InheritedCONNECT : String = "connect"
[static] Définit la valeur de la propriété type d'un objet événement connect.
Event
 InheritedDEACTIVATE : String = "deactivate"
[static] Définit la valeur de la propriété type d'un objet événement deactivate.
Event
  DOUBLE_CLICK : String = "doubleClick"
[static] Définit la valeur de la propriété type d'un objet événement doubleClick.
MouseEvent
 InheritedENTER_FRAME : String = "enterFrame"
[static] Définit la valeur de la propriété type d'un objet événement enterFrame.
Event
 InheritedFULLSCREEN : String = "fullScreen"
[static] Définit la valeur de la propriété type d'un objet événement fullScreen.
Event
 InheritedID3 : String = "id3"
[static] Définit la valeur de la propriété type d'un objet événement id3.
Event
 InheritedINIT : String = "init"
[static] Définit la valeur de la propriété type d'un objet événement init.
Event
  MOUSE_DOWN : String = "mouseDown"
[static] Définit la valeur de la propriété type d'un objet événement mouseDown.
MouseEvent
 InheritedMOUSE_LEAVE : String = "mouseLeave"
[static] Définit la valeur de la propriété type d'un objet événement mouseLeave.
Event
  MOUSE_MOVE : String = "mouseMove"
[static] Définit la valeur de la propriété type d'un objet événement mouseMove.
MouseEvent
  MOUSE_OUT : String = "mouseOut"
[static] Définit la valeur de la propriété type d'un objet événement mouseOut.
MouseEvent
  MOUSE_OVER : String = "mouseOver"
[static] Définit la valeur de la propriété type d'un objet événement mouseOver.
MouseEvent
  MOUSE_UP : String = "mouseUp"
[static] Définit la valeur de la propriété type d'un objet événement mouseUp.
MouseEvent
  MOUSE_WHEEL : String = "mouseWheel"
[static] Définit la valeur de la propriété type d'un objet événement mouseWheel.
MouseEvent
 InheritedOPEN : String = "open"
[static] Définit la valeur de la propriété type d'un objet événement open.
Event
 InheritedREMOVED : String = "removed"
[static] Définit la valeur de la propriété type d'un objet événement removed.
Event
 InheritedREMOVED_FROM_STAGE : String = "removedFromStage"
[static] Définit la valeur de la propriété type d'un objet événement removedFromStage.
Event
 InheritedRENDER : String = "render"
[static] Définit la valeur de la propriété type d'un objet événement render.
Event
 InheritedRESIZE : String = "resize"
[static] Définit la valeur de la propriété type d'un objet événement resize.
Event
  ROLL_OUT : String = "rollOut"
[static] Définit la valeur de la propriété type d'un objet événement rollOut.
MouseEvent
  ROLL_OVER : String = "rollOver"
[static] Définit la valeur de la propriété type d'un objet événement rollOver.
MouseEvent
 InheritedSCROLL : String = "scroll"
[static] Définit la valeur de la propriété type d'un objet événement scroll.
Event
 InheritedSELECT : String = "select"
[static] Définit la valeur de la propriété type d'un objet événement select.
Event
 InheritedSOUND_COMPLETE : String = "soundComplete"
[static] Définit la valeur de la propriété type d'un objet événement soundComplete.
Event
 InheritedTAB_CHILDREN_CHANGE : String = "tabChildrenChange"
[static] Définit la valeur de la propriété type d'un objet événement tabChildrenChange.
Event
 InheritedTAB_ENABLED_CHANGE : String = "tabEnabledChange"
[static] Définit la valeur de la propriété type d'un objet événement tabEnabledChange.
Event
 InheritedTAB_INDEX_CHANGE : String = "tabIndexChange"
[static] Définit la valeur de la propriété type d'un objet événement tabIndexChange.
Event
 InheritedUNLOAD : String = "unload"
[static] Définit la valeur de la propriété type d'un objet événement unload.
Event
Détails des propriétés
altKeypropriété
altKey:Boolean  [lecture-écriture]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

Indique si la touche Alt est active (true) ou non (false). Pris en charge uniquement pour les systèmes d'exploitation Windows.


Implémentation
    public function get altKey():Boolean
    public function set altKey(value:Boolean):void
buttonDownpropriété 
buttonDown:Boolean  [lecture-écriture]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

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
ctrlKeypropriété 
ctrlKey:Boolean  [lecture-écriture]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

Indique si la touche Ctrl est activée (true) ou non (false). Sur les ordinateurs Macintosh, vous devez utiliser cette propriété pour représenter la touche Commande.


Implémentation
    public function get ctrlKey():Boolean
    public function set ctrlKey(value:Boolean):void
deltapropriété 
delta:int  [lecture-écriture]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

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
localXpropriété 
localX:Number  [lecture-écriture]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

Coordonnée horizontale à laquelle l’événement s’est produit par rapport au sprite conteneur.


Implémentation
    public function get localX():Number
    public function set localX(value:Number):void
localYpropriété 
localY:Number  [lecture-écriture]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

Coordonnée verticale à laquelle l’événement s’est produit par rapport au sprite conteneur.


Implémentation
    public function get localY():Number
    public function set localY(value:Number):void
relatedObjectpropriété 
relatedObject:InteractiveObject  [lecture-écriture]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

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 uniquement aux événements mouseOut et mouseOver.


Implémentation
    public function get relatedObject():InteractiveObject
    public function set relatedObject(value:InteractiveObject):void
shiftKeypropriété 
shiftKey:Boolean  [lecture-écriture]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

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
stageXpropriété 
stageX:Number  [lecture-seule]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

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
stageYpropriété 
stageY:Number  [lecture-seule]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

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
Détails du constructeur
MouseEvent()Constructeur
public function MouseEvent(type:String, bubbles:Boolean = true, cancelable:Boolean = false, localX:Number, localY:Number, relatedObject:InteractiveObject = null, ctrlKey:Boolean = false, altKey:Boolean = false, shiftKey:Boolean = false, buttonDown:Boolean = false, delta:int = 0)

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

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.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 vers le haut (bubbling) du flux d’événements.
 
cancelable:Boolean (default = false) — Détermine si l’objet Event peut être annulé.
 
localX:Number — Coordonnée horizontale à laquelle l’événement s’est produit par rapport au sprite conteneur.
 
localY:Number — 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) — Indique si la touche Ctrl est activée.
 
altKey:Boolean (default = false) — Indique si la touche Alt est activée (Windows 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.
Détails des méthodes
clone()méthode
public override function clone():Event

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

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 
public override function toString():String

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

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
Version du lecteur : Flash Player 9

Demande à Flash Player 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
CLICKConstante
public static const CLICK:String = "click"

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

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
bubblestrue
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.
ctrlKeytrue si la touche Ctrl est activée ; false si elle ne l'est pas.
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.
localYCoordonnée verticale à laquelle l’événement s’est produit par rapport au sprite conteneur.
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énements. Utilisez la propriété currentTarget pour accéder à l’objet de la liste d'affichage qui traite actuellement l'événement.

Voir aussi

DOUBLE_CLICKConstante 
public static const DOUBLE_CLICK:String = "doubleClick"

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

Définit la valeur de la propriété type d'un objet événement doubleClick.

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

PropriétéValeur
bubblestrue
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.
ctrlKeytrue si la touche Ctrl est activée ; false si elle ne l'est pas.
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.
localYCoordonnée verticale à laquelle l’événement s’est produit par rapport au sprite conteneur.
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énements. Utilisez la propriété currentTarget pour accéder à l’objet de la liste d'affichage qui traite actuellement l'événement.

Voir aussi

MOUSE_DOWNConstante 
public static const MOUSE_DOWN:String = "mouseDown"

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

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
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é.
ctrlKeytrue si la touche Ctrl est activée ; false si elle ne l'est pas.
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.
localYCoordonnée verticale à laquelle l’événement s’est produit par rapport au sprite conteneur.
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énements. Utilisez la propriété currentTarget pour accéder à l’objet de la liste d'affichage qui traite actuellement l'événement.

Voir aussi

MOUSE_MOVEConstante 
public static const MOUSE_MOVE:String = "mouseMove"

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

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
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é.
ctrlKeytrue si la touche Ctrl est activée ; false si elle ne l'est pas.
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.
localYCoordonnée verticale à laquelle l’événement s’est produit par rapport au sprite conteneur.
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énements. Utilisez la propriété currentTarget pour accéder à l’objet de la liste d'affichage qui traite actuellement l'événement.

Voir aussi

MOUSE_OUTConstante 
public static const MOUSE_OUT:String = "mouseOut"

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

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
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é.
ctrlKeytrue si la touche Ctrl est activée ; false si elle ne l'est pas.
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.
localYCoordonnée verticale à laquelle l’événement s’est produit par rapport au sprite conteneur.
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énements. Utilisez la propriété currentTarget pour accéder à l’objet de la liste d'affichage qui traite actuellement l'événement.

Voir aussi

MOUSE_OVERConstante 
public static const MOUSE_OVER:String = "mouseOver"

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

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
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é.
ctrlKeytrue si la touche Ctrl est activée ; false si elle ne l'est pas.
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.
localYCoordonnée verticale à laquelle l’événement s’est produit par rapport au sprite conteneur.
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énements. Utilisez la propriété currentTarget pour accéder à l’objet de la liste d'affichage qui traite actuellement l'événement.

Voir aussi

MOUSE_UPConstante 
public static const MOUSE_UP:String = "mouseUp"

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

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
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é.
ctrlKeytrue si la touche Ctrl est activée ; false si elle ne l'est pas.
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.
localYCoordonnée verticale à laquelle l’événement s’est produit par rapport au sprite conteneur.
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énements. Utilisez la propriété currentTarget pour accéder à l’objet de la liste d'affichage qui traite actuellement l'événement.

Voir aussi

MOUSE_WHEELConstante 
public static const MOUSE_WHEEL:String = "mouseWheel"

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

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
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é.
ctrlKeytrue si la touche Ctrl est activée ; false si elle ne l'est pas.
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.
localYCoordonnée verticale à laquelle l’événement s’est produit par rapport au sprite conteneur.
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énements. Utilisez la propriété currentTarget pour accéder à l’objet de la liste d'affichage qui traite actuellement l'événement.

Voir aussi

ROLL_OUTConstante 
public static const ROLL_OUT:String = "rollOut"

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

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
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.
ctrlKeytrue si la touche Ctrl est activée ; false si elle ne l'est pas.
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.
localYCoordonnée verticale à laquelle l’événement s’est produit par rapport au sprite conteneur.
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énements. Utilisez la propriété currentTarget pour accéder à l’objet de la liste d'affichage qui traite actuellement l'événement.

Voir aussi

ROLL_OVERConstante 
public static const ROLL_OVER:String = "rollOver"

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

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
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.
ctrlKeytrue si la touche Ctrl est activée ; false si elle ne l'est pas.
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.
localYCoordonnée verticale à laquelle l’événement s’est produit par rapport au sprite conteneur.
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énements. Utilisez la propriété currentTarget pour accéder à l’objet de la liste d'affichage qui traite actuellement l'événement.

Voir aussi

Exemples Utilisation des exemples
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() : Tant que l'utilisateur presse le bouton gauche de la souris, cette méthode indique à Flash Player de redessiner de façon continue le carré orange.
    • 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 :

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);
        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);
    }
}




 

M'envoyer un message électronique lorsque des commentaires sont ajoutés à cette page | Rapport de commentaire

Page en cours: http://livedocs.adobe.com/flash/9.0_fr/ActionScriptLangRefV3/flash/events/MouseEvent.html