getURL 関数

特定の URL からウィンドウにドキュメントをロードしたり、定義済みの URL に存在する別のアプリケーションに変数を渡したりします。この関数をテストするには、ロードするファイルが指定した場所にあることを確認します。絶対 URL (http://www.myserver.com など) を使用するには、ネットワーク接続が確立されている必要があります。

セキュリティ上の注意: Flash Player 8 以降では、ブラウザ内で実行されるローカルコンテンツの場合、"javascript:" 疑似プロトコルを指定する getURL() 呼び出し (たとえば getURL("javascript:someFunction()")) は、ローカルに信頼されたセキュリティサンドボックス内に SWF ファイルおよびそれを含む Web ページ (存在する場合) がある場合にのみ可能です。

セキュリティ上の注意 : Flash Player 9 以降では、ローカルファイルシステムのサンドボックスで実行される SWF ファイル内のコードが getURL() 関数を呼び出し、window パラメータにカスタムウィンドウ名を指定する場合、ウィンドウ名はランダムな名前に変換されます。名前の形式は "_flashXXXXXXXX" で、それぞれの X はランダムな 16 進数です。それを含むブラウザウィンドウを閉じるまでの同じセッション内では、関数を再び呼び出して window パラメータに同じ名前を指定した場合、同じランダムストリングが使用されます。

対応バージョン : ActionScript 1.0、Flash Player 2 - GET オプションと POST オプションは、Flash Player 4 以降のバージョンでのみ使用できます。

パラメータ

window:String (オプション) - ドキュメントのロード先のウィンドウまたは HTML フレームを指定します。特定のウィンドウの名前を入力するか、次の予約されたターゲット名から選択します。

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

例

次の例では、イメージをムービークリップにロードします。イメージがクリックされると、新しいブラウザウィンドウに新しい URL がロードされます。

var listenerObject:Object = new Object();
listenerObject.onLoadInit = function(target_mc:MovieClip) {
 target_mc.onRelease = function() {
 getURL("http://www.adobe.com/software/flash/flashpro/", "_blank");
 };
};
var logo:MovieClipLoader = new MovieClipLoader();
logo.addListener(listenerObject);
logo.loadClip("http://www.helpexamples.com/flash/images/image1.jpg",
 this.createEmptyMovieClip("adobe_mc", this.getNextHighestDepth()));

次の例では、getURL() を使用して、電子メールメッセージを送信します。

myBtn_btn.onRelease = function(){
 getURL("mailto:you@somedomain.com");
};

次の ActionScript では、SWF ファイルがブラウザウィンドウに埋め込まれているときに JavaScript を使用してアラートウィンドウを開きます。getURL() を使って JavaScript を呼び出す場合、url パラメータの長さは最大 508 文字に制限されます。

myBtn_btn.onRelease = function(){
 getURL("javascript:alert('you clicked me')");
};

GET や POST を使用して変数を送信することもできます。次の例では、GET を使用して、変数を URL に追加します。

var firstName:String = "Gus";
var lastName:String = "Richardson";
var age:Number = 92;
myBtn_btn.onRelease = function() {
 getURL("http://www.adobe.com", "_blank", "GET");
};

次の ActionScript では、POST を使用して、HTTP ヘッダ内で変数を送信します。ブラウザウィンドウでドキュメントをテストしてください。そうでないと、変数は GET を使って送信されます。

var firstName:String = "Gus";
var lastName:String = "Richardson";
var age:Number = 92;
getURL("http://www.adobe.com", "_blank", "POST");

getURL 関数

パラメータ

例

関連項目