// フレームアクション
// クラスのimport
import flash.display.BitmapData;
import flash.display.Bitmap;
// ビットマップからBitmapDataインスタンスを生成
var myBitmapData:BitmapData = new Pen(0, 0);
// BitmapDataを用いてBitmapインスタンスを生成
var myBitmap:Bitmap = new Bitmap(myBitmapData);
// タイムラインのディスプレイリストに追加
addChild(myBitmap);
trace(this.getChildIndex(myBitmap));   // 出力: 0

// インスタンスの型指定
var myButton:mx.controls.Button;
var my_txt:TextField;
// 初期値設定
// TextField: my_txtを配置
var nRadian:Number = 0;
// リスナーオブジェクト生成
var oListener:Object = new Object();
// ボタンMovieClip
button_mc.onRelease = function():Void {
  my_mc.onEnterFrame = xAnimate;
};
function xAnimate():Void {
  this._xscale = Math.cos(nRadian += 0.1)*100;
}
// Buttonコンポーネント
myButton.addEventListener("click", oListener);
oListener.click = function():Void {
  delete my_mc.onEnterFrame;
};
// Keyリスナー設定
Key.addListener(oListener);
oListener.onKeyDown = function():Void {
  var nKey = Key.getCode();
  my_txt.text = nKey;
};

// 初期値設定
// TextField: my_txtを配置
var nRadian:Number = 0;
// ボタンMovieClip
button_mc.addEventListener(MouseEvent.CLICK, xRelease);
function xRelease(eventObject:MouseEvent):void {
  my_mc.addEventListener(Event.ENTER_FRAME, xAnimate);
}
function xAnimate(eventObject:Event):void {
  my_mc.scaleX = Math.cos(nRadian += 0.1);
}
// Buttonコンポーネント
myButton.addEventListener(MouseEvent.CLICK, xClick);
function xClick(eventObject:MouseEvent):void {
  my_mc.removeEventListener(Event.ENTER_FRAME, xAnimate);
}
// Keyリスナー設定
stage.addEventListener(KeyboardEvent.KEY_DOWN, xKeyDown);
function xKeyDown(eventObject:KeyboardEvent):void {
  var nKey:int = eventObject.keyCode;
  my_txt.text = nKey.toString();
}

// タイムライン: ボタンのMovieClip
// 第1フレームアクション
buttonMode = true;
hitArea = hitArea_mc;
hitArea_mc.visible = false;
stop();

// ボタンのMovieClipシンボル内に配置されたMovieClip // 第1フレームアクション mouseEnabled = false;

[*1] ボタンのMovieClipインスタンスにマウスイベントのリスナー関数を設定した場合、リスナー関数が受取る引数のイベントオブジェクトで、イベントに関わるインスタンスの情報が得られる。

ボタンのMovieClipシンボルに内包したMovieClipインスタンスのInteractiveObject.mouseEnabledプロパティの設定により、MouseEvent.targetプロパティの返す値が変わる。その内包されたインスタンスをクリックしたとき、InteractiveObject.mouseEnabledプロパティをfalseに設定していないと、その内包されたインスタンスの参照が返される。他方、falseに設定していると、ボタンのMovieClipインスタンスの参照が返されることになる。

なお、MouseEvent.currentTargetプロパティは、内包されたMovieClipのInteractiveObject.mouseEnabledプロパティの設定にかかわらず、イベントリスナーが登録されたボタンのMovieClipインスタンスの参照を返す。

// ActionScript 3.0クラス定義ファイル: MyButton.as
// ボタンのMovieClipシンボルの[クラス]に設定
package {
  import flash.display.MovieClip;
  import flash.events.MouseEvent;
  public class MyButton extends MovieClip {
    public function MyButton() {
      addEventListener(MouseEvent.MOUSE_DOWN, press);
    }
    private function press(eventObject:MouseEvent):void {
      trace("press");
      addEventListener(MouseEvent.MOUSE_UP, release);
      stage.addEventListener(MouseEvent.MOUSE_UP, releaseOutside);
    }
    private function release(eventObject:MouseEvent):void {
      trace("release");
      removeEventListener(MouseEvent.MOUSE_UP, release);
      stage.removeEventListener(MouseEvent.MOUSE_UP, releaseOutside);
    }
    private function releaseOutside(eventObject:MouseEvent):void {
      trace("releaseOutside");
      removeEventListener(MouseEvent.MOUSE_UP, release);
      stage.removeEventListener(MouseEvent.MOUSE_UP, releaseOutside);
    }
  }
}

// ActionScript 3.0クラス定義ファイル: MyButton.as
// ボタンのMovieClipシンボルの[クラス]に設定
package {
  import flash.display.MovieClip;
  import flash.events.MouseEvent;
  public class MyButton extends MovieClip {
    public var onPress:Function;
    public var onRelease:Function;
    public var onReleaseOutside:Function;
    public function MyButton() {
      addEventListener(MouseEvent.MOUSE_DOWN, press);
    }
    private function press(eventObject:MouseEvent):void {
      // trace("press");
      onPress();
      addEventListener(MouseEvent.MOUSE_UP, release);
      stage.addEventListener(MouseEvent.MOUSE_UP, releaseOutside);
    }
    private function release(eventObject:MouseEvent):void {
      // trace("release");
      onRelease();
      removeEventListener(MouseEvent.MOUSE_UP, release);
      stage.removeEventListener(MouseEvent.MOUSE_UP, releaseOutside);
    }
    private function releaseOutside(eventObject:MouseEvent):void {
      // trace("releaseOutside");
      onReleaseOutside();
      removeEventListener(MouseEvent.MOUSE_UP, release);
      stage.removeEventListener(MouseEvent.MOUSE_UP, releaseOutside);
    }
  }
}

[*2] 他方、ActionScript 3.0では、ダブルクリックをイベントとして受取ることができる。詳しくは、F-site「doubleClickを受取る」参照。

[*3]「Flash 9 ActionScript 3.0 Previewのイベントリスナーとクラス定義」の「03 ActionScript 3.0のマウスイベント」参照。

[*4] ActionScript 3.0では、クラスやプロパティ・メソッドに対するアクセス制御の指定が、2.0の2つから4つに増えた。デフォルト(グレー表示)が同じパッケージ内からのアクセスを許すinternalになったり、privateの仕様が変わるなど、2.0とは異なる部分がある。

[*5] コンストラクタにprivate属性が指定できないと、たとえばSingletonパターンの実装にひと工夫必要になる。Singletonパターンの実装例については、「ActionScript 3.0でプライベートなコンストラクタを定義する」参照。

[*6] スクリプト008では、クラスでイベントハンドラメソッド用に宣言したインスタンスプロパティにコールバック関数が設定されていないと、ランタイムエラーが発生する。コールバック関数が設定されているかどうかの判定を加え、より整理したサンプルは、「EventDispatcher.addEventListener()メソッド」の[訳者注*3]を参照。