将来の使用のために予約されています。

マウスの主ボタンが押されている (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 に指示します。

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

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

関連項目

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

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

関連項目

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

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

関連項目

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

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

関連項目

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

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

関連項目

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

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

関連項目

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

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

関連項目

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

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

関連項目

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

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

関連項目

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

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

関連項目

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