User Guide

getURL() 319
getURL()
Availability
Flash 2. The GET and POST options are available only in Flash Player 4 and later versions.
Usage
getURL(url:String [, window:String [, "variables":String]]) : Void
Parameters
url
The URL from which to obtain the document.
window An optional parameter specifying the window or HTML frame into which the
document should load. You can enter the name of a specific window or select from the following
reserved target names:
• _self specifies the current frame in the current window.
• _blank specifies a new window.
• _parent specifies the parent of the current frame.
• _top specifies the top-level frame in the current window.
variables A GET or POST method for sending variables. If there are no variables, omit this
parameter. The
GET method appends the variables to the end of the URL, and is used for small
numbers of variables. The
POST method sends the variables in a separate HTTP header and is
used for sending long strings of variables.
Returns
Nothing.
Description
Function; loads a document from a specific URL into a window or passes variables to another
application at a defined URL. To test this function, make sure the file to be loaded is at the
specified location. To use an absolute URL (for example,
http://www.myserver.com), you need
a network connection.
Example
This example loads an image into a movie clip. When the image is clicked, a new URL is loaded
in a new browser window.
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.macromedia.com/images/shared/product_boxes/159x120/
159x120_box_flashpro.jpg", this.createEmptyMovieClip("macromedia_mc",
this.getNextHighestDepth()));
CHAPTER 2
ActionScript Language Reference