User Guide

70 ActionScript language elements
loadMovieNum function
loadMovieNum(url:String, level:Number, [method:String]) : Void
L o a d s a S W F, J P E G , G I F, o r P N G f i l e i n t o a l e vel while the original SWF file is playing.
Support for unanimated GIF files, PNG files, and progressive JPEG files is added in Flash
Player 8. If you load an animated GIF, only the first frame is displayed.
Normally, Flash Player displays a single SWF file and then closes. The
loadMovieNum()
action lets you display several SWF files at once and switch among SWF files without loading
another HTML document.
If you want to specify a target instead of a level, use
loadMovie() instead of
loadMovieNum().
Flash Player has a stacking order of levels starting with level 0. These levels are like layers of
acetate; they are transparent except for the objects on each level. When you use
loadMovieNum(), you must specify a level in Flash Player into which the SWF file will load.
When a SWF file is loaded into a level, you can use the syntax,
_levelN, where N is the level
number, to target the SWF file.
When you load a SWF file, you can specify any level number and you can load SWF files into
a level that already has a SWF file loaded into it. If you do, the new SWF file will replace the
existing SWF file. If you load a SWF file into level 0, every level in Flash Player is unloaded,
and level 0 is replaced with the new file. The SWF file in level 0 sets the frame rate,
background color, and frame size for all other loaded SWF files.
The
loadMovieNum() action also lets you load JPEG files into a SWF file while it plays. For
images and SWF files, the upper left corner of the image aligns with the upper left corner of
the Stage when the file loads. Also in both cases, the loaded file inherits rotation and scaling,
and the original content is overwritten in the specified level.
Use
unloadMovieNum() to remove SWF files or images that were loaded with
loadMovieNum().
When using this method, consider the Flash Player security model.
TIP
If you want to monitor the progress of the download, use
MovieClipLoader.loadClip() instead of this function.
NOTE
JPEG files saved in progressive format are not supported.