User Guide

ManualsBrandsMacromedia ManualsOtherFLASH MX 2004-ACTIONSCRIPT LANGUAGE REFERENCE

521

522

523

524

525

526

527

528

529

530

MovieClip.getURL() 527

MovieClip.getURL()

Availability

Flash Player 5.

Usage

my_mc.getURL(URL:String [,window:String, variables:String]) : Void

Parameters

URL

String; the URL from which to obtain the document.

window String; an optional 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.

variables String (either "GET" or "POST"); an optional parameter specifying a method for

sending variables associated with the SWF file to load. If there are no variables, 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 numbers of variables.

POST sends the

variables in a separate HTTP header and is used for long strings of variables.

Returns

Nothing.

Description

Method; 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 using a

GET

POST method.

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

more information, see “Assigning a class to a movie clip symbol” in Using ActionScript in Flash.

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