public attachMovie(id:String, name:String, depth:Number, [initObject:Object]) : MovieClip

ライブラリからシンボルを取得し、ムービークリップに割り当てます。attachMovie() メソッドで割り当てた SWF ファイルを削除するには、MovieClip.removeMovieClip() または MovieClip.unloadMovie() を使用します。

サブクラスを作成することにより、MovieClip クラスのメソッドおよびイベントハンドラを拡張できます。

パラメータ

id:String - ステージ上のムービークリップに割り当てるライブラリ内のムービークリップシンボルのリンケージ名。これは、[リンケージプロパティ] ダイアログボックス内の [識別子] フィールドに入力した名前です。

name:String - ムービークリップに割り当てられる一意のインスタンス名。

depth:Number - SWF ファイルが配置される深度を指定する整数。

initObject:Object (オプション) - 新しく割り当てられたムービークリップに設定するプロパティを含むオブジェクト。このパラメータは、Flash Player 6 以降でのみサポートされています。このパラメータを使用すると、動的に作成したムービークリップは、クリップのパラメータを受け取ることができます。オブジェクトではない initObject は無視されます。initObject のすべてのプロパティが新しいインスタンスにコピーされます。initObject で指定されたプロパティは、コンストラクタ関数で使用できます。

戻り値

MovieClip - 新しく作成したインスタンスへの参照。

例

次の例では、リンケージ識別子が "circle" であるシンボルを SWF ファイルのステージ上にあるムービークリップインスタンスに割り当てます。

this.attachMovie("circle", "circle1_mc", this.getNextHighestDepth());
this.attachMovie("circle", "circle2_mc", this.getNextHighestDepth(), {_x:100, _y:100});

関連項目

removeMovieClip (MovieClip.removeMovieClip メソッド), unloadMovie (MovieClip.unloadMovie メソッド), removeMovieClip 関数