Reserved for future use.

Indicates whether the primary mouse button is pressed (true) or not (false).

Indicates whether the Control key is active (true) or inactive (false). On Macintosh computers, you must use this property to represent the Command key.

Indicates how many lines should be scrolled for each unit the user rotates the mouse wheel. A positive delta value indicates an upward scroll; a negative value indicates a downward scroll. Typical values are 1 to 3, but faster rotation may produce larger values. This setting depends on the device and operating system and is usually configurable by the user. This property applies only to the MouseEvent.mouseWheel event.

The horizontal coordinate at which the event occurred relative to the containing sprite.

The vertical coordinate at which the event occurred relative to the containing sprite.

A reference to a display list object that is related to the event. For example, when a mouseOut event occurs, relatedObject represents the display list object to which the pointing device now points. This property applies only to the mouseOut and mouseOver events.

Indicates whether the Shift key is active (true) or inactive (false).

The horizontal coordinate at which the event occurred in global Stage coordinates. This property is calculated when the localX property is set.

The vertical coordinate at which the event occurred in global Stage coordinates. This property is calculated when the localY property is set.

Creates an Event object that contains information about mouse events. Event objects are passed as parameters to event listeners.

Creates a copy of the MouseEvent object and sets the value of each property to match that of the original.

Returns a string that contains all the properties of the MouseEvent object. The string is in the following format:

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

Instructs Flash Player to render after processing of this event completes, if the display list has been modified.

Defines the value of the type property of a click event object.

This event has the following properties:

See also

Defines the value of the type property of a doubleClick event object.

This event has the following properties:

See also

Defines the value of the type property of a mouseDown event object.

This event has the following properties:

See also

Defines the value of the type property of a mouseMove event object.

This event has the following properties:

See also

Defines the value of the type property of a mouseOut event object.

This event has the following properties:

See also

Defines the value of the type property of a mouseOver event object.

This event has the following properties:

See also

Defines the value of the type property of a mouseUp event object.

This event has the following properties:

See also

Defines the value of the type property of a mouseWheel event object.

This event has the following properties:

See also

Defines the value of the type property of a rollOut event object.

This event has the following properties:

See also

Defines the value of the type property of a rollOver event object.

This event has the following properties:

See also

1. The example declares properties for the size (100 x 100 pixels) and the background color (orange) for later use in drawing the square.
2. The constructor creates a new ChildSprite object child. Its constructor first draws an orange 100 x 100 pixel square at coordinates (0,0) by calling its draw() method and then adds seven event listeners/subscribers.
• click/clickHandler(): Dispatched when the user single-clicks with the left mouse button over the square.
• doubleClick/doubleClickHandler(): Dispatched when the user double-clicks the left mouse button over the square.
• mouseDown/mouseDownHandler(): When the ChildSprite object (the orange square) is clicked, a trace() message is printed to the screen, and then ChildSprite.draw() is called, which draws a dark yellow square in place of the light blue one drawn in mouseOverHandler(). The mouseDownHandler() method also adds a mouseMoveevent listener and the mouseMoveHandler() subscriber (described below), which processes the mouse moves. Then the startDrag() method is called, which allows the Sprite object to be dragged.
• mouseOut/mouseOutHandler(): Dispatched whenever the pointer leaves the square area. The draw() method is called to return the square to its normal size and color.
• mouseOver/mouseOverHandler(): Dispatched when the mouse pointer is over the square. This method redraws the square so that it is larger and its background color is dark yellow.
• mouseUp/mouseUpHandler(): When the user releases the mouse button, the mouseMove event listener is removed and stopDrag is called, which freezes the square in place.
• mouseMove/mouseMoveHandler(): As long as the user is pressing the left mouse button, this method instructs Flash Player to continuously redraw the orange square.
• mouseWheel/mouseWheelHandler(): Dispatched when the user rotates the mouse wheel over the square.
3. The ChildSprite instance child is then added to the display list by means of addChild(), which promptly draws the orange square.

Notes:

• The MouseEventExample class should be the document root.
• Some of the event methods listed above declare a local variable sprite, which is assigned the cast of event.target to 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);
        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);
    }
}