getURL 関数

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

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

使用できるバージョン : ActionScript 1.0、Flash Lite 1.0 - GET オプションと POST オプションは、これ以降のバージョンでのみ使用できます。

パラメータ

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

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.macromedia.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("macromedia_mc", this.getNextHighestDepth()));

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

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

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

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

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

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

関連項目

loadVariables 関数, send (XML.send メソッド), sendAndLoad (XML.sendAndLoad メソッド)