MACROMEDIA FLASH MX 2004 - ACTIONSCRIPT, Reference Manual

Page: 394 / 816

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()