loadMovieNum 関数

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

ロードした元の SWF ファイルの再生中に SWF ファイルまたは JPEG ファイルを Flash Player のレベル内にロードします。

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

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

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

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

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

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

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

loadMovieNum() を使用してロードしたムービーやイメージを削除するには、unloadMovieNum() を使用します。

使用できるバージョン : ActionScript 1.0、Flash Lite 1.1 - Flash 5 以降で開いた Flash 4 ファイルは、正しいシンタックスを使用するように変換されます。JPEG ファイルをロードするには、Flash Player 6 以降が必要です。

パラメータ

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

関連項目

unloadMovieNum 関数, loadMovie 関数, loadClip (MovieClipLoader.loadClip メソッド), _level プロパティ