View comments | RSS feed

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

See also

getURL(), LoadVars.sendAndLoad(), LoadVars.send()

Comments


No screen name said on Mar 27, 2005 at 12:12 AM :
i'm trying to submit a variable called ".done"...but when getURL submits it, it escapes the name, turning it to "%2Edone"...which, the server doesn't recognize, because it only unescapes the parameter values, not the parameter names.

is there a way to prevent the parameter name from being escaped?

 

RSS feed | Send me an e-mail when comments are added to this page | Comment Report

Current page: http://livedocs.adobe.com/flash/mx2004/main_7_2/00001510.html