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

Loads a document from the specified URL into the specified window. The getURL() method can also be used to pass variables to another application defined at the URL by using a GET or POST method.

Web pages that host Flash movies must explicitly set the allowScriptAccess attribute to allow or deny scripting for the Flash Player from the HTML code (in the PARAM tag for Internet Explorer or the EMBED tag for Netscape Navigator):

• When allowScriptAccess is "never", outbound scripting always fails.
• When allowScriptAccess is "always", outbound scripting always succeeds.
• When allowScriptAccess is "sameDomain" (supported by SWF files starting with version 8 ), outbound scripting is allowed if the SWF file is from the same domain as the hosting web page.
• If allowScriptAccess is not specified by an HTML page, it defaults to "sameDomain" for version 8 SWF files, and it defaults to "always" for earlier version SWF files.

You can extend the methods and event handlers of the MovieClip class by creating a subclass.

Parameters

url:String - The URL from which to obtain the document.

window:String [optional] - A parameter specifying the name, frame, or expression that specifies the window or HTML frame that the document is loaded into. You can also use one of 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, and _top specifies the top-level frame in the current window.

method:String [optional] - A String (either "GET" or "POST") that specifies a method for sending variables associated with the SWF file to load. If no variables are present, omit this parameter; otherwise, specify whether to load variables using a GET or POST method. GET appends the variables to the end of the URL and is used for a small number of variables. POST sends the variables in a separate HTTP header and is used for long strings of variables.

Example

The following ActionScript creates a new movie clip instance and opens the Macromedia website in a new browser window:

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

The getURL() method also allows you to send variables to a remove server-side script, as seen in the following code:

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");

See also

getURL function, sendAndLoad (LoadVars.sendAndLoad method), send (LoadVars.send method)