Packageflash.ui
Classepublic final class Mouse
HéritageMouse Inheritance Object

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

Les méthodes de la classe Mouse permettent de masquer et d'afficher le pointeur de la souris. La classe Mouse est une classe de niveau supérieur dont les propriétés et les méthodes sont accessibles sans l'aide d'un constructeur. Le pointeur est visible par défaut, mais vous pouvez le masquer et mettre en place un pointeur personnalisé.

Consulter les exemples

Voir aussi

flash.events.MouseEvent
Capture des entrées de souris


Propriétés publiques
 PropriétéDéfini par
 Inheritedconstructor : Object
Référence à l'objet de classe ou à la fonction constructeur d'une occurrence donnée d'un objet.
Object
 Inheritedprototype : Object
[static] Référence à l’objet prototype d’un objet de classe ou fonction.
Object
Méthodes publiques
 MéthodeDéfini par
 Inherited
Indique si la propriété spécifiée d'un objet est définie.
Object
  
[static] Masque le pointeur.
Mouse
 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
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
  
[static] Affiche le pointeur.
Mouse
 Inherited
Renvoie la représentation sous forme de chaîne de l'objet spécifié.
Object
 Inherited
Renvoie la valeur primitive de l'objet spécifié.
Object
Détails des méthodes
hide()méthode
public static function hide():void

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

Masque le pointeur. Le pointeur est visible par défaut.

Voir aussi

show()méthode 
public static function show():void

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

Affiche le pointeur. Le pointeur est visible par défaut.

Voir aussi

Exemples Utilisation des exemples
MouseExample.as

L'exemple suivant utilise les classes MouseExample, SimpleButton, ButtonDisplayState et CustomCursor pour placer un bouton simple sur la scène. Celui-ci présente un pointeur personnalisé, et il se modifie lorsqu'il est cliqué. Cette opération se déroule selon la procédure suivante :
  1. Les propriétés d'occurrence suivantes sont déclarées : cursor de type CustomCursor, child de type CustomButton et gutter de type uint.
  2. child est attribuée à une nouvelle occurrence de CustomButton, ses coordonnées x et y sont définies sur 10 pixels chacun, puis l'occurrence est ajoutée à la liste d'affichage. La classe CustomButton remplace les propriétés downState, upState, overState et hitTestState dans SimpleButton. Chacune de ces propriétés instancie un objet ButtonDisplayState qui dessine un carré différent, en fonction de l'état de l'occurrence child.
  3. L'occurrence child est ensuite utilisée pour ajouter un écouteur d'événements MOUSE_OVER et une méthode d'écouteur mouseOverHandler() à un écouteur d'événements MOUSE_OUT associé à la méthode mouseOutHandler().
  4. Les écouteurs d'événements fonctionnent de la façon suivante :
    • mouseOverHandler : masque le pointeur « normal » et ajoute un écouteur MOUSE_MOVE qui assure le traitement des mouvements de la souris à l'aide de mouseMoveHandler(), comme décrit ci-dessous.
    • mouseOutHandler : lorsque la souris se déplace à l'extérieur du bouton personnalisé, le pointeur « normal » s'affiche, l'écouteur d'événements MOUSE_MOVE est supprimé et la visibilité du curseur personnalisé est définie sur false.
    • mouseMoveHandler : déplace le curseur personnalisé dans la zone où le pointeur est déplacé et définit la visibilité du curseur personnalisé sur true.
  5. Au niveau du constructeur MouseExample, la propriété du curseur est attribuée à un nouvel objet CustomCursor qui est ensuite ajouté à la liste d'affichage par l'intermédiaire de addChild(). La classe CustomCursor dessine un petit carré de couleur presque noire à la place du pointeur habituel chaque fois que la souris est positionnée au-dessus de child.
  6. Un quatrième écouteur d'événements de type MOUSE_LEAVE est ajouté avec la méthode associée mouseLeaveHandler(). Dans cette méthode (appelée si la souris quitte la scène), mouseOutHandler() reçoit un nouvel objet d'écouteur transmis, mouseMove, qui supprime principalement le pointeur pour le faire disparaître de la scène.
package {
    import flash.display.Sprite;
    import flash.display.DisplayObject;
    import flash.ui.Mouse;
    import flash.events.*;

    public class MouseExample extends Sprite {
         private var cursor:CustomCursor;
         private var child:CustomButton;
         private var gutter:uint = 10;

        public function MouseExample() {
            child = new CustomButton();
            child.x = gutter;
            child.y = gutter;
            addChild(child);

            child.addEventListener(MouseEvent.MOUSE_OVER, mouseOverHandler);
            child.addEventListener(MouseEvent.MOUSE_OUT, mouseOutHandler);

            cursor = new CustomCursor();
            addChild(cursor);

            stage.addEventListener(Event.MOUSE_LEAVE, mouseLeaveHandler);
        }

        private function mouseOverHandler(event:MouseEvent):void {
            trace("mouseOverHandler");
            Mouse.hide();
            child.addEventListener(MouseEvent.MOUSE_MOVE, mouseMoveHandler);
        }

        private function mouseOutHandler(event:MouseEvent):void {
            trace("mouseOutHandler");
            Mouse.show();
            child.removeEventListener(MouseEvent.MOUSE_MOVE, mouseMoveHandler);
            cursor.visible = false;
        }

        private function mouseMoveHandler(event:MouseEvent):void {
            trace("mouseMoveHandler");
            cursor.x = event.localX;
            cursor.y = event.localY;
            event.updateAfterEvent();
            cursor.visible = true;
        }

        private function mouseLeaveHandler(event:Event):void {
            trace("mouseLeaveHandler");
            mouseOutHandler(new MouseEvent(MouseEvent.MOUSE_MOVE));
        }
    }
}

import flash.display.Shape;
import flash.display.SimpleButton;
    
class CustomButton extends SimpleButton {
    var upColor:uint = 0xFFCC00;
    var overColor:uint = 0xCCFF00;
    var downColor:uint = 0x00CCFF;
    var size:uint = 80;
    
    public function CustomButton() {
        downState = new ButtonDisplayState(downColor, size+10);
        overState = new ButtonDisplayState(overColor, size);
        upState = new ButtonDisplayState(upColor, size);
        hitTestState = new ButtonDisplayState(upColor, size);
    }
}

class ButtonDisplayState extends Shape {
    var bgColor:uint;
    var size:uint;
    
    public function ButtonDisplayState(bgColor:uint, size:uint) {
        this.bgColor = bgColor;
        this.size = size;
        draw();
    }
    
    private function draw():void {
        graphics.clear();
        graphics.beginFill(bgColor);
        graphics.drawRect(0, 0, size, size);
        graphics.endFill();
    }
}
    
class CustomCursor extends Shape {
    var bgColor:uint = 0x333333;
    var size:uint = 10;
    
    public function CustomCursor() {
        visible = false;
        draw();
    }
    
    private function draw():void {
        graphics.clear();
        graphics.beginFill(bgColor);
        graphics.drawRect(0, 0, size, size);
        graphics.endFill();
    }
}




 

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/ui/Mouse.html