attachMovie (MovieClip.attachMovie メソッド)

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 で指定されたプロパティは、コンストラクタ関数で使用できます。

戻り値

例

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

this.attachMovie("linkageName", "instance1", this.getNextHighestDepth());
this.attachMovie("linkageName", "instance2", this.getNextHighestDepth(), {_x:100, _y:100});

この例で使用している MovieClip.getNextHighestDepth() メソッドには Flash Player 7 以降が必要です。SWF ファイルにバージョン 2 のコンポーネントがある場合は、MovieClip.getNextHighestDepth() メソッドではなく、バージョン 2 のコンポーネントの DepthManager クラスを使用します。

attachMovie (MovieClip.attachMovie メソッド)

パラメータ

戻り値

例

関連項目