MACROMEDIA FLASH MX 2004 - ACTIONSCRIPT - Page 394

394 Chapter 12: ActionScript Dictionary
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");
}
See also
loadVariables()
, XML.send(), XML.sendAndLoad(), XMLSocket.send()