ActionScript: The Definitive Guide

Name

MovieClip._url Property — the network address from which a clip or movie was loaded

Availability

Flash 4 and later

Synopsis

mc._url

Access

Read-only

Description

The _url property represents the URL (Uniform Resource Locator) indicating the Internet or local disk location from which the content of mc was loaded, as a string. The _url property is always an absolute URL, never a relative one. For main movies, _url is simply the location of the current .swf file. The _url of all movie clips in a .swf file is the same as the main movie of that file unless external .swf files have been loaded into individual clips via MovieClip.loadMovie( ). The _url of a clip that hosts an externally loaded .swf file is the location of the externally loaded file.

The _url property is sometimes used to create simple security systems that prevent a movie from playing when displayed in a unwanted location.

Example

The value of _url in a movie loaded from a web site looks like this:

"http://www.moock.org/gwen/meetgwen.swf"

The value of _url in a movie loaded from a local PC hard drive looks like this:

"file:///C|/data/flashfiles/movie.swf"

Here we check whether a movie is hosted in the desired location (if not, we display a frame that contains an error):

if (_url != "http://www.moock.org/gwen/meetgwen.swf") {
  trace ("This movie is not running from its intended location.";
  gotoAndStop("accessDenied");
}

See Also

MovieClip.loadMovie( )