Indica si la tecla Alt está activa (true) o inactiva (false). Sólo se admite en los sistema operativos Windows.

Indica si se pulsa el botón principal del ratón (true) o no (false).

Indica si la tecla Control está activa (true) o inactiva (false). En equipos con Macintosh, se debe utilizar esta propiedad para representar la tecla Comando.

Indica el número de líneas que debe desplazarse la visualización por cada vuelta de la rueda del ratón. Un valor delta positivo indica un desplazamiento hacia arriba; un valor negativo indica un desplazamiento hacia abajo. Los valores típicos van del 1 al 3, pero una rotación más rápida puede generar valores más grandes. Este parámetro depende del dispositivo y del sistema operativo y suele ser configurable por el usuario. Esta propiedad sólo se aplica al evento MouseEvent.mouseWheel.

La coordenada horizontal en la que se produce el evento en relación con la clase Sprite contenida.

La coordenada vertical en la que se produce el evento en relación con la clase Sprite contenida.

Referencia a un objeto de la lista de visualización relacionado con el evento. Por ejemplo, si se produce un evento mouseOut, relatedObject representa el objeto de la lista de visualización al que ahora apunta el dispositivo de señalización. Esta propiedad sólo se aplica a los eventos mouseOut y mouseOver.

Indica si la tecla Mayús está activa (true) o inactiva (false).

La coordenada horizontal en la que se produce el evento en las coordenadas globales del escenario. Esta propiedad se calcula al establecer localX.

La coordenada vertical en la que se produce el evento en las coordenadas globales del escenario. Esta propiedad se calcula al establecer localY.

Crea un objeto de evento que contiene información sobre eventos de ratón. Los objetos de evento se transfieren como parámetros a los detectores de eventos.

Crea una copia del objeto MouseEvent y define el valor de cada propiedad para que coincida con el del objeto original.

Devuelve una cadena con todas las propiedades del objeto MouseEvent. La cadena tiene el siguiente formato:

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

Si se ha modificado la lista de visualización, da instrucciones a Flash Player para que muestre la representación tras finalizar el procesamiento del evento.

Define el valor de la propiedad type de un objeto de evento click.

Este evento tiene las propiedades siguientes:

Véase también

Define el valor de la propiedad type de un objeto de evento doubleClick.

Este evento tiene las propiedades siguientes:

Véase también

Define el valor de la propiedad type de un objeto de evento mouseDown.

Este evento tiene las propiedades siguientes:

Véase también

Define el valor de la propiedad type de un objeto de evento mouseMove.

Este evento tiene las propiedades siguientes:

Véase también

Define el valor de la propiedad type de un objeto de evento mouseOut.

Este evento tiene las propiedades siguientes:

Véase también

Define el valor de la propiedad type de un objeto de evento mouseOver.

Este evento tiene las propiedades siguientes:

Véase también

Define el valor de la propiedad type de un objeto de evento mouseUp.

Este evento tiene las propiedades siguientes:

Véase también

Define el valor de la propiedad type de un objeto de evento mouseWheel.

Este evento tiene las propiedades siguientes:

Véase también

Define el valor de la propiedad type de un objeto de evento rollOut.

Este evento tiene las propiedades siguientes:

Véase también

Define el valor de la propiedad type de un objeto de evento rollOver.

Este evento tiene las propiedades siguientes:

Véase también

1. El ejemplo declara propiedades para el tamaño (100 x 100 píxeles) y el color de fondo (naranja) para utilizarlos después al dibujar el cuadrado.
2. El constructor crea un nuevo objeto ChildSprite child. Su constructor dibuja en primer lugar un cuadrado naranja de 100 x 100 píxeles en las coordenadas (0,0) llamando a su método draw() y, a continuación, añade siete detectores/suscriptores de eventos.
   • click / clickHandler(): Se distribuye cuando el usuario hace clic una sola vez con el botón izquierdo del ratón sobre el cuadrado.
   • doubleClick / doubleClickHandler(): Se distribuye cuando el usuario hace doble clic con el botón izquierdo del ratón sobre el cuadrado.
   • mouseDown / mouseDownHandler(): Al hacer clic en el objeto ChildSprite (el cuadrado naranja), se imprime un mensaje trace() en la pantalla y, seguidamente, se llama a ChildSprite.draw(), que dibuja un cuadrado amarillo oscuro en el lugar que ocupaba el cuadrado azul claro dibujado en mouseOverHandler(). El método mouseDownHandler() también añade un detector de eventos mouseMove y el suscriptor mouseMoveHandler() (se describe a continuación), que procesa los movimientos del ratón. Posteriormente se llama al método startDrag(), que permite que se arrastre el objeto Sprite.
   • mouseOut / mouseOutHandler(): Se distribuye cada vez que el puntero sale del área cuadrada. Se llama al método draw() para devolver el cuadrado a su tamaño y color normales.
   • mouseOver / mouseOverHandler(): Se distribuye cuando el puntero del ratón se encuentra sobre el cuadrado. El método redibuja el cuadrado para que sea más grande y para que el color de fondo sea amarillo oscuro.
   • mouseUp / mouseUpHandler(): Cuando el usuario suelta el botón del ratón, se elimina el detector de eventos mouseMove y se llama a stopDrag, que fija el cuadrado en su lugar correspondiente.
   • mouseMove / mouseMoveHandler(): Mientras el usuario esté pulsando el botón izquierdo del ratón, este método ordena a Flash Player a redibujar constantemente el cuadrado naranja.
   • mouseWheel / mouseWheelHandler(): Se distribuye cuando el usuario gira la rueda del ratón sobre el cuadrado.
3. Se añade la instancia de ChildSprite child a la lista de visualización por medio de addChild(), que dibuja rápidamente el cuadrado naranja.

Notas:

• La clase MouseEventExample no debe ser la raíz del documento.
• Algunos de los métodos de eventos mencionados arriba declaran una variable local sprite, a la que se asigna la modificación de event.target para escribir 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);
        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);
    }
}