Flash CS3 ドキュメンテーション

ActionScript 2.0 リファレンスガイド > ActionScript クラス > MovieClip > loadMovie (MovieClip.loadMovie メソッド)

loadMovie (MovieClip.loadMovie メソッド)

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

元の SWF ファイルの再生中に SWF、JPEG、GIF、または PNG の各ファイルを Flash Player のムービークリップ内にロードします。■レビューにより訳変更(8ball)■非アニメーション GIF ファイル、PNG ファイル、およびプログレッシブ JPEG ファイルのサポートが Flash Player 8 で追加されました。アニメーション GIF を読み込むと、先頭のフレームのみ表示されます。非プログレッシブ JPEG ファイルは、Flash Player 6 以降でサポートされます。

ヒント : ダウンロードの進捗状況を監視するには、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() を呼び出すと、新しいコンテンツがロードされた後にイベントハンドラが維持されます。

このメソッドを使用するときは、Flash Player セキュリティモデルを考慮してください。

Flash Player 8 :

呼び出し元のムービークリップがローカルファイルシステムのサンドボックスにあり、ロードするムービークリップがネットワーク上のサンドボックスにある場合、ロードできません。
呼び出し元 SWF ファイルがネットワーク上のサンドボックスにあり、ロードするムービークリップがローカルにある場合、ロードできません。
信頼できるローカルのサンドボックスまたはネットワーク接続したローカルのサンドボックスからネットワーク上のサンドボックスにアクセスするには、クロスドメインポリシーファイルを使用して Web サイトで許可する必要があります。
ローカルファイルシステムのサンドボックスにあるムービークリップでは、ネットワーク接続したローカルのサンドボックスにあるムービークリップをスクリプト処理できません。その逆も同様です。

Flash Player 7 以降 :

Web サイトでクロスドメインポリシーファイルを使用して、リソースへのクロスドメインアクセスを許可できます。
SWF ファイル間のスクリプト処理は、SWF ファイルが置かれているドメインに基づいて制限されます。これらの制限を調整するには、System.security.allowDomain() メソッドを使用します。

詳細については、次の参照先を参照してください。

『ActionScript 2.0 の学習』の「セキュリティについて」
Flash Player 9 セキュリティに関するホワイトペーパー (http://www.adobe.com/go/fp9_0_security_jp)
Flash Player 8 セキュリティ関連 API に関するホワイトペーパー (http://www.adobe.com/go/fp8_security_apis_jp)

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

対応バージョン : ActionScript 1.0、Flash Player 5 - JPEG ファイルのロードは、Flash Player 6 で使用可能になった機能です。非アニメーション GIF ファイル、PNG ファイル、またはプログレッシブ JPEG ファイルのロードは、Flash Player 8 で使用可能になった機能です。

パラメータ

url:String - ロードする単一の SWF ファイル、JPEGファイル、GIF ファイル、または PNG ファイルの絶対 URL または相対 URL。相対パスは、レベル 0 の SWF ファイルが埋め込まれた HTML ファイルを基準にする必要があります。絶対 URL の場合は http:// や file:/// などのプロトコル参照を含めて指定します。SWF、JPEG、GIF、または PNG ファイルが複数ある場合は、loadMovie() を続けて呼び出します。

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");

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

loadMovie (MovieClip.loadMovie メソッド)

パラメータ

例

関連項目