loadMovieNum( ) Global Function

ActionScript for Flash MX: The Definitive Guide, 2nd Edition
By Colin Moock
Chapter 18.  ActionScript Language Reference
loadMovieNum( ) Global Function Flash 3; Flash 6 adds .jpg loading and security restrictions

load an external .swf or .jpg file into a document level
loadMovieNum(url, level) loadMovieNum(url, level, method)

Arguments

url

A string specifying the absolute or relative file path of the external .swf movie or .jpg image file to load. All URLs must use forward slashes, and absolute URLs must include the protocol reference (e.g., http:// or file:///). Relative URLs are resolved relative to the URL of the movie on _level0 (i.e., _level0._url) and use the http:// protocol by default.

level

A nonnegative integer, or an expression that yields one, indicating the number of the document level that will host the external .swf or .jpg file.

method

An optional string indicating the method by which to send variables to an external script. The legal values for method are "GET" and "POST". This parameter must be a literal, not a variable or other expression. On Windows, prior to Flash 6, the Standalone Player always used the "GET" method, regardless of the method specified. As of Flash 6, both "GET" and "POST" are supported. See Appendix F.

Description

The loadMovieNum( ) function is nearly identical to loadMovie( ) used with a document level as its target, except that the target level is specified as a number rather than as a string. This means that loadMovieNum( ) can load movies only into document levels, not host clips. The loadMovieNum( ) function is safer than loadMovie( ), insofar as there is no chance of inadvertently replacing the current clip or movie; if the specified level doesn't exist, it will be created. If the specified level does exist, its occupant is replaced by the new .swf or .jpg file. It is valid to load a movie into _level2 even if _level1 hasn't been created.

The loadMovieNum( ) function can be used when we wish to assign the level of a loaded movie or image dynamically, as in:

var x = 3; loadMovieNum("myMovie.swf", x);

which could also be achieved via a string concatenation expression with the regular loadMovie( ) function:

loadMovie("myMovie.swf", "_level" + x);

Usage

The global loadMovieNum( ) function replaces Flash 3's Load Movie action, which accepted level numbers only (Flash 4 added the method parameter).

See Also

loadMovie( ), MovieClip.loadMovie( )



    ActionScript for Flash MX. The Definitive Guide
    ActionScript for Flash MX: The Definitive Guide, Second Edition
    ISBN: 059600396X
    EAN: 2147483647
    Year: 2002
    Pages: 780
    Authors: Colin Moock

    flylib.com © 2008-2017.
    If you may any questions please contact us: flylib@qtcs.net