F-site

[AS3] MovieClipインスタンスとインスタンス名 [Edit]

ActionScript 3.0でも、MovieClipインスタンスに名前をつけて、参照したり管理することができます。しかし、インスタンス名の果たす役割は、ActionScript 2.0/1.0とは少し変わりました。

オーサリング時に配置したMovieClipインスタンス

Flashムービーを作成する際、つまりオーサリング時にタイムラインに配置したMovieClipインスタンスには、従来のバージョンと同じように、[プロパティ]インスペクタでインスタンス名を設定できます(図001)。

図001■[プロパティ]インスペクタでインスタンス名を設定

そして、スクリプトでインスタンス名を参照することにより、MovieClipインスタンスのコントロールが可能です。たとえば、タイムラインに配置したMovieClipインスタンスの水平座標を0に設定するには、つぎのようなフレームアクションを記述します。

// フレームアクション
// MovieClipインスタンスmy_mcを配置
my_mc.x = 0;

文字列としてのインスタンス名を調べるには、DisplayObject.nameプロパティの値を取出します(図002)。

// フレームアクション
// MovieClipインスタンスmy_mcを配置
var name_str:String = my_mc.name;
trace(name_str);   // 出力: my_mc

図002■インスタンス名はDisplayObject.nameプロパティで取得する

スクリプトで動的に配置したMovieClipインスタンス

ActionScript 3.0でMovieClipインスタンスを動的に配置するには、インスタンスはコンストラクタで生成し、タイムラインの子インスタンスとして加える(DisplayObjectContainer.addChild()メソッドを使う)ことによりステージに表示します。

たとえば、[ライブラリ]のMovieClipシンボルに[クラス]として"Pen"という識別子を設定したとすると(図003。 MovieClipシンボルへの[クラス]の設定については、「クラスを文字列で参照したい」参照)、以下のようなフレームアクションでインスタンスを配置することができます(なお、[ライブラリ]のビットマップやSpriteインスタンスの動的な配置について、「ビットマップをダイナミックに配置する」および「new演算子でビジュアルオブジェクトをつくる」参照)。

図003■[リンケージプロパティ]で[クラス]に名前を指定する

// フレームアクション
// MovieClipシンボルに[クラス]として"Pen"を設定
var my_mc:MovieClip = new Pen();
addChild(my_mc);
trace(my_mc.name);   // 出力: instance1

上記フレームアクションは最後のステートメントで、DisplayObject.nameプロパティの値を[出力]しています。すると、"instance1"という文字列が返されました(図004)。これは、インスタンス名がない場合に自動的に設定される名前です。

図004■動的に配置したインスタンスには自動的に名前が設定される

特定のインスタンス名をつけたいときは、以下のフレームアクションのようにDisplayObject.nameプロパティにその文字列を設定する必要があります。ただし、注意しなければならないのは、インスタンス名は文字列ですので、スクリプトでその名前を参照してインスタンスは操作できないということです(図005)。

// フレームアクション
// MovieClipシンボルに[クラス]として"Pen"を設定
var my_mc:MovieClip = new Pen();
addChild(my_mc);
my_mc.name = "myName";
trace(my_mc.name);   // 出力: myName

図005■文字列のインスタンス名でインスタンスは参照できない

もっとも、動的に生成したインスタンスは、上記スクリプトのmy_mcのように変数に納めておくのが通常です。そうすれば、その変数を参照して、インスタンスのコントロールは可能になります。もし、タイムラインに配置したインスタンスの名前からインスタンスを参照する必要があるときには、つぎのフレームアクションのようにDisplayObjectContainer.getChildByName()メソッドにより文字列から参照を取得します。

// フレームアクション
// MovieClipシンボルに[クラス]として"Pen"を設定
var my_mc:MovieClip = new Pen();
addChild(my_mc);
my_mc.name = "myName";
// インスタンス名から参照を取得して操作
var target_mc:MovieClip = MovieClip(getChildByName("myName"));
trace(target_mc.name);   // 出力: myName
target_mc.x = 0;

ただし、DisplayObjectContainer.getChildByName()メソッドの戻り値がDisplayObjectだということに、注意が必要です。取得した参照をMovieClipインスタンスとして、そのプロパティやメソッドにアクセスするためには、MovieClipにキャストしなければなりません(キャストについては、「rootプロパティでメインタイムラインの関数にアクセスできない」参照)。

インスタンス名と変数

上述のとおりActionScript 3.0では、インスタンス名は参照のためにはあまり使いやすいとはいえず、インスタンスを変数に格納して制御する方がよさそうです。インスタンス名は、他のインスタンスと区別して特定するためのプロパティだと思われます。

けれども、前述「オーサリング時に配置したMovieClipインスタンス」では、タイムラインに予め配置して[プロパティ]インスペクタで設定したインスタンス名は、そのまま変数のように参照として扱うことができました。これは、ActionScript 3.0では、Flashがインスタンス名と同じ名前の変数を自動的に宣言して、そこにインスタンスの参照を格納する仕組みになっているからです^[*1]。したがって、やはり変数によりインスタンスを参照するというのが、ActionScript 3.0の基本だといえます。

---

[*1] ヘルプの[ActionScript 3.0 のプログラミング] > [ActionScriptの使用について] > [オブジェクトの操作] > [オブジェクトインスタンスの作成]には、つぎのように説明されています。

Flashでは、ムービークリップシンボル、ボタンシンボル、またはテキストフィールドをステージに配置し、プロパティインスペクタでインスタンス名を割り当てた場合、自動的にそのインスタンス名で変数が宣言され、オブジェクトインスタンスが作成され、そのオブジェクトが変数に格納されます。

• kinectFaceTrakingANE
• Flash用Away3D 4.2
• Feathers 1.2.0が公開される
• 【連載】Starlingフレームワークを用いたStage3Dによる2Dアニメーション 第8回 Starlingフレームワークの実装に見るオブジェクトのリサイクル
• 【連載】Starlingフレームワークを用いたStage3Dによる2Dアニメーション 第7回 StarlingフレームワークとBox2Dで物理演算シミュレーションを行う
• 【連載】Starlingフレームワークを用いたStage3Dによる2Dアニメーション 第6回 Starlingフレームワーク1.3の新たなフィルタのクラスとトゥイーンのメソッド
• 【連載】Starlingフレームワークを用いたStage3Dによる2Dアニメーション 第5回 Starlingフレームワークでイベントリスナーを扱う
• 【連載】Starlingフレームワークを用いたStage3Dによる2Dアニメーション 第4回 StarlingフレームワークのTweenクラスにおける最適化とJugglerクラスの実装
• 【連載】Starlingフレームワークを用いたStage3Dによる2Dアニメーション 第3回 StarlingフレームワークのTweenクラスによるアニメーション
• Starlingフレームワーク1.3が公開