loadMovieNum 関数

loadMovieNum(url:String, level:Number, [method:String]) : Void

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

ヒント : ダウンロードの進捗状況を監視するには、この関数の代わりに MovieClipLoader.loadClip() を使用してください。

通常、Flash Player は 1 つの SWF ファイルを表示した後に閉じます。loadMovieNum() アクションを使用すると、複数の SWF ファイルを同時に表示し、別の HTML ドキュメントをロードせずに SWF ファイルを切り替えることができます。

レベルではなくターゲットを指定するには、loadMovieNum() の代わりに loadMovie() を使います。

Flash Player では、レベル 0 からレベルが積み重ねられます。これらのレベルは各レベルのオブジェクト以外は透明であり、フィルムのレイヤーに似ています。loadMovieNum() を使用する場合は、SWF ファイルをロードする先の Flash Player のレベルを指定します。SWF ファイルをレベル内にロードすると、シンタックス _level N を使用できます。N は SWF ファイルのターゲットとなるレベル番号です。

SWF ファイルをロードするときは、任意のレベル番号を指定できます。SWF ファイルが既にロードされているレベルに SWF ファイルをロードすることもできます。その場合は、新しい SWF ファイルによって既存の SWF ファイルが置き換えられます。SWF ファイルをレベル 0 内にロードすると、Flash Player の各レベルはアンロードされ、レベル 0 は新しいファイルに置き換えられます。レベル 0 の SWF ファイルによって、ロードした他のすべての SWF ファイルのフレームレート、背景色、およびフレームサイズが設定されます。

loadMovieNum() アクションを使用すると、JPEG ファイルを再生中の SWF にロードすることもできます。イメージと SWF ファイルのいずれの場合でも、ファイルのロード時にイメージの左上隅がステージの左上隅に位置合わせされます。また、どちらの場合でも、ロードしたファイルは回転と拡大・縮小を継承し、元の内容が指定されたレベルで上書きされます。

注意 : プログレッシブ形式で保存された JPEG ファイルはサポートされていません。

loadMovieNum() を使ってロードした SWF ファイルやイメージを削除するには、unloadMovieNum() を使用します。

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

Flash Player 8 :

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

Flash Player 7 以降 :

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

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

『ActionScript 2.0 の学習』の第 17 章「セキュリティについて」
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)

対応バージョン : ActionScript 1.0、Flash Player 4 - Flash 5 以降で開いた Flash 4 ファイルは、正しいシンタックスを使用するように変換されます。JPEG ファイルのロードは、Flash Player 6 で使用可能になった機能です。非アニメーション GIF ファイル、PNG ファイル、またはプログレッシブ JPEG ファイルのロードは、Flash Player 8 で使用可能になった機能です。

パラメータ

url:String - ロードする SWF ファイルまたは JPEG ファイルの絶対 URL または相対 URL。相対パスの場合は、レベル 0 の SWF ファイルを基準にする必要があります。スタンドアローンの Flash Player 内で使用する際、または Flash オーサリングアプリケーション内のプレビューモードでテストする際には、すべての SWF ファイルを同じフォルダに置く必要があり、ファイル名にフォルダやディスクドライブの指定を含めることはできません。

level:Number - SWF ファイルをロードする先の Flash Player のレベルを指定する整数。

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

例

次の例では、JPEG イメージ tim.jpg を Flash Player のレベル 2 内にロードします。

loadMovieNum("http://www.helpexamples.com/flash/images/image1.jpg", 2);

loadMovieNum 関数

パラメータ

例

関連項目