public getURL(url:String, [window:String], [method:String]) : Void

指定された URL から、指定されたウィンドウにドキュメントを読み込みます。getURL() メソッドでは、GET メソッドまたは POST メソッドを使用して、URL で定義されている別のアプリケーションに変数を渡すこともできます。

Flash ムービーをホストする Web ページでは、allowScriptAccess 属性を明示的に設定して、Flash Player のスクリプトを HTML コードから許可または拒否する必要があります。この HTML コードは、Internet Explorer では PARAM タグに、Netscape Navigator では EMBED タグにあります。

• allowScriptAccess が "never" の場合、送信スクリプトは常に失敗します。
• allowScriptAccess が "always" の場合、送信スクリプトは常に成功します。
• allowScriptAccess が "sameDomain" (バージョン 8 以降の SWF ファイルでサポート) の場合、SWF ファイルがホスト側 Web ページと同じドメインに存在すれば、送信スクリプトが許可されます。
• HTML ページで allowScriptAccess が指定されていない場合、デフォルト値は、バージョン 8 の SWF ファイルでは "sameDomain"、バージョン 8 より前の SWF ファイルでは "always" です。

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

パラメータ

url:String - ドキュメントを取得するための URL。

window:String (オプション) - ドキュメントのロード先のウィンドウまたは HTML フレームを指定する名前、フレーム、または式を指定するパラメータ。次の予約済みターゲット名のいずれかを使用することもできます。_self は現在のウィンドウ内の現在のフレームを指定します。_blank は新しいウィンドウを指定します。_parent は現在のフレームの親を指定します。_top は現在のウィンドウ内のトップレベルのフレームを指定します。

method:String (オプション) - ロード対象の SWF ファイルに関連付けられた変数を送信するためのメソッドを指定するストリング。"GET" または "POST" のいずれかを指定します。変数が存在しない場合は、このパラメータを省略します。それ以外の場合は、変数のロードに GET メソッドと POST メソッドのどちらを使用するかを指定します。GET メソッドは、変数を URL の最後に追加します。このメソッドは、変数のデータ量が少ないときに使用します。POST メソッドは、別の HTTP ヘッダで変数を送信します。このメソッドは、変数のデータ量が多いときに使用します。

例

次の ActionScript は、新しいムービークリップインスタンスを作成し、新しいブラウザウィンドウで Adobe Web サイトを開きます。

this.createEmptyMovieClip("loader_mc", this.getNextHighestDepth());
loader_mc.getURL("http://www.adobe.com", "_blank");

getURL() メソッドでは、次のようにリモートのサーバー側のスクリプトに変数を送信することもできます。

this.createEmptyMovieClip("loader_mc", this.getNextHighestDepth());
loader_mc.username = "some user input";
loader_mc.password = "random string";
loader_mc.getURL("http://www.flash-mx.com/mm/viewscope.cfm", "_blank", "GET");

関連項目

getURL 関数, sendAndLoad (LoadVars.sendAndLoad メソッド), send (LoadVars.send メソッド)