User Guide

484 ActionScript classes
See also
beginFill (MovieClip.beginFill method), createEmptyMovieClip
(MovieClip.createEmptyMovieClip method)
, endFill (MovieClip.endFill method),
lineStyle (MovieClip.lineStyle method), moveTo (MovieClip.moveTo method)
loadMovie (MovieClip.loadMovie method)
public loadMovie(url:String, [method:String]) : Void
Loads SWF or JPEG files into a movie clip in Flash Player while the original SWF file is
playing.
Tip: To monitor the progress of the download, use the
MovieClipLoader.loadClip()
method instead of the
loadMovie() method.
Without the
loadMovie() method, Flash Player displays a single SWF file and then closes.
The
loadMovie() method lets you display several SWF files at once and switch between SWF
files without loading another HTML document.
A SWF file or image loaded into a movie clip inherits the position, rotation, and scale
properties of the movie clip. You can use the target path of the movie clip to target the loaded
SWF file.
When you call the
loadMovie() method, set the MovieClip._lockroot property to true in
the loader movie, as shown in the following code example. If you don't set
_lockroot to
true in the loader movie, any references to _root in the loaded movie point to the _root of
the loader instead of the
_root of the loaded movie.
myMovieClip._lockroot = true;
Use the MovieClip.unloadMovie() method to remove SWF files or images loaded with the
loadMovie() method.
Use the
MovieClip.loadVariables() method, the XML object, Flash Remoting, or Runtime
Shared Objects to keep the active SWF file and load new data into it.
Using event handlers with
MovieClip.loadMovie() can be unpredictable. If you attach an
event handler to a button by using
on(), or if you create a dynamic handler by using an event
handler method such as
MovieClip.onPress, and then you call loadMovie(), the event
handler does not remain after the new content is loaded. However, if you attach an event
handler to a movie clip by using
onClipEvent() or on(), and then call loadMovie() on that
movie clip, the event handler remains after the new content is loaded.
You can extend the methods and event handlers of the MovieClip class by creating a subclass.
Availability: ActionScript 1.0; Flash Lite 2.0