Alt キーがアクティブになっているか (true) 非アクティブになっているか (false) を示します。Windows オペレーティングシステムでのみサポートされます。

マウスの主ボタンが押されているか (true) 押されていないか (false) を示します。

Ctrl キーがアクティブになっているか (true) 非アクティブになっているか (false) を示します。Macintosh コンピュータの場合、このプロパティは Command キーの状態を表します。

ユーザーがマウスホイールを 1 目盛り回すごとにスクロールする行数を示します。正の delta 値は上方向へのスクロールを表します。負の値は下方向へのスクロールを表します。一般的な値は 1 ～ 3 の範囲ですが、ホイールの回転が速くなると、delta の値は大きくなります。この設定は、デバイスやオペレーティングシステムによって異なります。通常はユーザーが構成できます。このプロパティは、MouseEvent.mouseWheel イベントにのみ適用されます。

スプライトを基準とするイベント発生位置の水平座標です。

スプライトを基準とするイベント発生位置の垂直座標です。

イベントに関連する表示リストオブジェクトへの参照です。たとえば、mouseOut イベントが発生した場合、relatedObject はポインティングデバイスが現在指している表示リストオブジェクトを表します。このプロパティは、mouseOut イベントと mouseOver イベントにのみ適用されます。

Shift キーがアクティブになっているか (true) 非アクティブになっているか (false) を示します。

グローバルステージ座標を基準とするイベント発生位置の水平座標です。このプロパティは、localX プロパティが設定されている場合に計算されます。

グローバルステージ座標を基準とするイベント発生位置の垂直座標です。このプロパティは、localY プロパティが設定されている場合に計算されます。

マウスイベントに関する情報を含む Event オブジェクトを作成します。イベントリスナーには Event オブジェクトがパラメータとして渡されます。

MouseEvent オブジェクトのコピーを作成して、各プロパティの値を元のプロパティの値と一致するように設定します。

MouseEvent オブジェクトのすべてのプロパティを含むストリングを返します。ストリングは次の形式です。

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

表示リストが変更されている場合は、このイベント終了処理の後にレンダリングするよう Flash Player に指示します。

type プロパティ (click イベントオブジェクト) の値を定義します。

このイベントには、次のプロパティがあります。

関連項目

type プロパティ (doubleClick イベントオブジェクト) の値を定義します。

このイベントには、次のプロパティがあります。

関連項目

type プロパティ (mouseDown イベントオブジェクト) の値を定義します。

このイベントには、次のプロパティがあります。

関連項目

type プロパティ (mouseMove イベントオブジェクト) の値を定義します。

このイベントには、次のプロパティがあります。

関連項目

type プロパティ (mouseOut イベントオブジェクト) の値を定義します。

このイベントには、次のプロパティがあります。

関連項目

type プロパティ (mouseOver イベントオブジェクト) の値を定義します。

このイベントには、次のプロパティがあります。

関連項目

type プロパティ (mouseUp イベントオブジェクト) の値を定義します。

このイベントには、次のプロパティがあります。

関連項目

type プロパティ (mouseWheel イベントオブジェクト) の値を定義します。

このイベントには、次のプロパティがあります。

関連項目

type プロパティ (rollOut イベントオブジェクト) の値を定義します。

このイベントには、次のプロパティがあります。

関連項目

type プロパティ (rollOver イベントオブジェクト) の値を定義します。

このイベントには、次のプロパティがあります。

関連項目

1. 後で四角形の描画に使用するサイズ (100 × 100 ピクセル) と背景色 (オレンジ色) のプロパティを宣言します。
2. コンストラクタが新しい ChildSprite オブジェクト child を作成します。コンストラクタは、draw() メソッドを呼び出して、オレンジ色の 100 × 100 ピクセルの四角形を (0,0) の座標に描画し、次に 7 つのイベントリスナーとサブスクライバを追加します。
   • click/clickHandler() : 四角形の上で左マウスボタンがクリックされたときに送出されます。
   • doubleClick/doubleClickHandler() : 四角形の上で左マウスボタンがダブルクリックされたときに送出されます。
   • mouseDown/mouseDownHandler() : ChildSprite オブジェクト (オレンジ色の四角形) がクリックされると、trace() メッセージが画面に表示されます。次に、ChildSprite.draw() が呼び出されて、mouseOverHandler() で描画された明るい青色の四角形の位置に暗い黄色の四角形を描画します。また、mouseDownHandler() メソッドによって mouseMove イベントリスナーと mouseMoveHandler() サブスクライバ (後で説明) が追加されます。これによって、マウスの移動が処理されます。次に startDrag() メソッドが呼び出されます。これによって Sprite オブジェクトのドラッグが可能になります。
   • mouseOut/mouseOutHandler() : ポインタが四角形の領域を離れると送出されます。draw() メソッドによって、四角形のサイズとカラーを通常の状態に戻します。
   • mouseOver/mouseOverHandler(): マウスポインタが四角形に重なると送出されます。このメソッドは、暗い黄色の背景色で四角形を大きく再描画します。
   • mouseUp/mouseUpHandler() : ユーザーがマウスボタンを離すと、mouseMove イベントリスナーが削除され、stopDrag が呼び出されます。これによって、四角形の位置が固定されます。
   • mouseMove/mouseMoveHandler() : 左マウスボタンが押されている間、このメソッドは Flash Player に対して引き続きオレンジ色の四角形を再描画するよう指示します。
   • mouseWheel/mouseWheelHandler() : 四角形の上でマウスホイールを回転させるたびに送出されます。
3. ChildSprite インスタンス child が、addChild() を使用して表示リストに追加され、オレンジ色の四角形が直ちに描画されます。

メモ :

• MouseEventExample クラスは、ドキュメントルートにあることが必要です。
• 前述したイベントメソッドの中には、ローカル変数 sprite を宣言するものがあります。この変数には、Sprite 型への event.target のキャストが割り当てられます。

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