| loadMovieNum( ) Global Function | Flash 3; Flash 6 adds .jpg loading and security restrictions |
| load an external .swf or .jpg file into a document level |
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.
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.
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.
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);
The global loadMovieNum( ) function replaces Flash 3's Load Movie action, which accepted level numbers only (Flash 4 added the method parameter).
loadMovie( ), MovieClip.loadMovie( )
