public loadMovie(url:String, [method:String]) : Void

元の SWF ファイルの再生中に、SWF または JPEG ファイルを Flash Player のムービークリップ内にロードします。

ヒント : ダウンロードの進捗状況を監視するには、loadMovie() メソッドではなく、MovieClipLoader.loadClip() メソッドを使用します。

loadMovie() メソッドを使用しない場合は、Flash Player が 1 つの SWF ファイルを表示して終了します。loadMovie() メソッドを使用すると、複数の SWF ファイルを同時に表示し、別の HTML ドキュメントをロードせずに SWF ファイルを切り替えることができます。

ムービークリップ内にロードした SWF ファイルまたはイメージは、そのムービークリップの位置、回転、および拡大 / 縮小の各プロパティを継承します。ムービークリップのターゲットパスを使用して、ロードした SWF ファイルをターゲットとして設定できます。

loadMovie() メソッドを呼び出すときは、次のサンプルコードに示すように、ロード先のムービー内で MovieClip._lockroot プロパティを true に設定します。ロード先のムービー内で _lockroot を true に設定しない場合、ロードされたムービー内の _root への参照は、ロードされたムービーの _root ではなく、ロード先の _root をポイントします。

myMovieClip._lockroot = true;

loadMovie() メソッドでロードした SWF ファイルまたはイメージを削除するには、MovieClip.unloadMovie() メソッドを使用します。

アクティブな SWF ファイルを保持して、新しいデータをその中にロードするには、MovieClip.loadVariables() メソッド、XML オブジェクト、Flash Remoting オブジェクトまたは Runtime Shared オブジェクトを使用します。

イベントハンドラと MovieClip.loadMovie() を併用すると、予期しない結果が生じる可能性があります。on() を使用してイベントハンドラをボタンに割り当てるか、MovieClip.onPress のようなイベントハンドラメソッドを使用してダイナミックハンドラを作成した後、loadMovie() を呼び出すと、新しいコンテンツがロードされた後にイベントハンドラが維持されません。一方、onClipEvent() または on() を使用してイベントハンドラをムービークリップに割り当てた後、そのムービークリップで loadMovie() を呼び出すと、新しいコンテンツがロードされた後にイベントハンドラが維持されます。

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

パラメータ

url:String - ロードする SWF ファイルまたは JPEG ファイルの絶対 URL または相対 URL。相対パスは、レベル 0 の SWF ファイルを基準にする必要があります。絶対 URL の場合は http:// や file:/// などのプロトコル参照を含める必要があります。

method:String (オプション) - 変数を送信またはロードするための HTTP メソッドを指定します。パラメータはストリング GET または POST でなければなりません。送信する変数がない場合は、このパラメータを省略します。GET メソッドは、変数を URL の最後に追加します。このメソッドは、変数のデータ量が少ないときに使用します。POST メソッドは、別の HTTP ヘッダで変数を送信します。このメソッドは、変数のデータ量が多いときに使用します。

例

次の例では、新しいムービークリップを作成した後、その中に子を作成し、子に PNG イメージをロードします。この場合、loadMovie の呼び出し前に親に割り当てられていたインスタンスの値がすべて保持されます。

var mc:MovieClip = this.createEmptyMovieClip("mc", this.getNextHighestDepth());
mc.onRelease = function():Void {
    trace(this.image._url); // http://www.w3.org/Icons/w3c_main.png
}
var image:MovieClip = mc.createEmptyMovieClip("image", mc.getNextHighestDepth());
image.loadMovie("http://www.w3.org/Icons/w3c_main.png");

関連項目

_lockroot (MovieClip._lockroot プロパティ), unloadMovie (MovieClip.unloadMovie メソッド), loadVariables (MovieClip.loadVariables メソッド), loadMovie (MovieClip.loadMovie メソッド), onPress (MovieClip.onPress ハンドラ), MovieClipLoader, onClipEvent ハンドラ, 定数, loadMovieNum 関数, unloadMovie 関数, unloadMovieNum 関数