loadClip (MovieClipLoader.loadClip メソッド)

public loadClip(url:String, target:Object) : Boolean

元のムービーの再生中に、SWF、JPEG、プログレッシブ JPEG、非アニメーション GIF、または PNG の各ファイルを Flash Player のムービークリップ内にロードします。アニメーション GIF を読み込むと、先頭のフレームのみ表示されます。このメソッドを使用すると、複数の SWF ファイルを同時に表示し、別の HTML ドキュメントをロードせずに SWF ファイルを切り替えることができます。

loadClip() メソッドを loadMovie() や MovieClip.loadMovie() の代わりに使用することには有利な点がいくつかあります。次のハンドラは、リスナーオブジェクトの使用によって実装されます。リスナーをアクティブにするには、MovieClipLoader.addListener(listenerObject) を使用して、MovieClipLoader クラスでリスナーを登録します。

ロードが開始されたときに MovieClipLoader.onLoadStart ハンドラが呼び出される。
クリップをロードできなかった場合に MovieClipLoader.onLoadError ハンドラが呼び出される。
ロードプロセスの進行時にリアルタイムに MovieClipLoader.onLoadProgress ハンドラが呼び出される。
ファイルのダウンロードが終了し、ロードされたムービークリップのメソッドとプロパティが使用可能になる前に、MovieClipLoader.onLoadComplete ハンドラが呼び出される。このハンドラは、onLoadInit ハンドラの前に呼び出されます。
クリップの先頭フレームのアクションが実行された後に MovieClipLoader.onLoadInit ハンドラが呼び出される。そのため、ロード済みのクリップに対して各種の操作を開始できます。このハンドラは、onLoadComplete ハンドラの後に呼び出されます。ほとんどの場合、onLoadInit ハンドラを使用します。

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

loadClip() メソッドは、単一のムービークリップまたはレベルに対して 1 つまたは複数のファイルをロードするときに使用できます。MovieClipLoader リスナーオブジェクトは、ロード中のターゲットムービークリップのインスタンスにパラメータとして渡されます。代わりに、ロードするファイルごとに異なる MovieClipLoader オブジェクトを作成することもできます。

このメソッドを使用してロードされたムービーまたはイメージを削除したり、進行中のロード処理をキャンセルするには、MovieClipLoader.unloadClip() を使用します。

MovieClipLoader.getProgress() および MovieClipLoaderListener.onLoadProgress は、ファイルがローカルである場合、オーサリングプレーヤーの実際の bytesLoaded および bytesTotal の値を報告しません。オーサリング環境でプロファイラ機能を使用すると、MovieClipLoader.getProgress() および MovieClipLoaderListener.onLoadProgress は、プロファイラで提供される減少した帯域幅レートではなく、実際のダウンロードレートでダウンロードを報告します。

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

Flash Player 8 :

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

Flash Player 7 以降 :

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

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

『ActionScript 2.0 の学習』の第 17 章「セキュリティについて」
Flash Player 8 セキュリティに関するホワイトペーパー
Flash Player 8 セキュリティ関連 API に関するホワイトペーパー

使用できるバージョン : ActionScript 1.0、Flash Player 7

パラメータ

url:String - ロードする SWF、JPEG、GIF、または PNG の各ファイルの絶対 URL または相対 URL。相対パスは、レベル 0 の SWF ファイルが埋め込まれた HTML ファイルを基準にする必要があります。絶対 URL の場合は http:// や file:// などのプロトコル参照を含めて指定します。ファイル名には、ドライブ指定を含めることはできません。

target:Object - ムービークリップのターゲットパス、またはムービーのロード先となる、Flash Player のレベルを指定する整数。ターゲットムービークリップは、ロードした SWF ファイルまたはイメージに置き換えられます。

戻り値

Boolean - ブール値。URL リクエストが正常に送信された場合は true、それ以外の場合は false を返します。

例

次の例では、onLoadInit イベント用のハンドラを作成し要求を行うことで、MovieClipLoader.loadClip() メソッドの使用方法を示します。

次のコードを、タイムラインのフレームアクションに直接配置するか、MovieClip を拡張するクラスに貼り付ける必要があります。また、このコードでは、コンパイル済みの SWF ファイルと同じディレクトリに YourImage.jpg という名前のイメージがあると想定します。

var container:MovieClip = createEmptyMovieClip("container", getNextHighestDepth());
var mcLoader:MovieClipLoader = new MovieClipLoader();
mcLoader.addListener(this);
mcLoader.loadClip("YourImage.jpg", container);

function onLoadInit(mc:MovieClip) {
    trace("onLoadInit: " + mc);
}

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

loadClip (MovieClipLoader.loadClip メソッド)

パラメータ

戻り値

例

関連項目