getURL (MovieClip.getURL method)

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

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

Web pages that host Flash content 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, the default value is "sameDomain" for version 8 SWF files, and the default value is "always" for earlier version SWF files.

When using this method, consider the Flash Player security model. For Flash Player 8, the method is not allowed if the calling SWF file is in the local-with-file-system sandbox and the resource is nonlocal.

For more information, see the following:

"Understanding Security" in Learning ActionScript 2.0 in Flash
The Flash Player 9 Security white paper at http://www.adobe.com/go/fp9_0_security
The Flash Player 8 Security-Related API white paper at http://www.adobe.com/go/fp8_security_apis

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

Availability: ActionScript 1.0; Flash Player 5

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 movie clip instance and opens the Adobe website in a new browser window:

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

The getURL() method also allows you to send variables to a remote 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");

The MovieClip.getNextHighestDepth() method used in these examples requires Flash Player 7 or later. If your SWF file includes a version 2 component, use the version 2 components' DepthManager class instead of the MovieClip.getNextHighestDepth() method.

When using this method, consider the Flash Player security model.

For Flash Player 8, MovieClip.getURL() is not allowed if the calling SWF file is in the local-with-file-system sandbox and the resource is nonlocal.

For more information, see the following:

"Understanding Security" in Learning ActionScript 2.0 in Flash
The Flash Player 9 Security white paper at http://www.adobe.com/go/fp9_0_security
The Flash Player 8 Security-Related API white paper at http://www.adobe.com/go/fp8_security_apis

getURL (MovieClip.getURL method)

Parameters

Example

See also