getURL()

Availability

Flash 2. The GET and POST options are only available to Flash Player 4 and later versions of the player.

Usage

getURL(url [, window [, "variables"]])

Parameters

url The URL from which to obtain the document.

window An optional parameter specifying the window or HTML frame that the document should load into. You can enter the name of a specific window or choose 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 action, 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 a new URL into a blank browser window. The getURL() action targets the variable incomingAd as the url parameter so that you can change the loaded URL without having to edit the SWF file. The incomingAd variable's value is passed into Flash earlier in the SWF file using a loadVariables() action.

on(release) {
  getURL(incomingAd, "_blank");
}