attachMovie (MovieClip.attachMovie メソッド)

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

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

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

使用できるバージョン : ActionScript 1.0、Flash Lite 2.0

パラメータ

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 関数