User Guide

632 Chapter 7: ActionScript for Flash
MovieClipLoader class
Availability
Flash Player 7.
Description
This class lets you implement listener callbacks that provide status information while SWF or
JPEG files are being loaded (downloaded) into movie clips. To use MovieClipLoader features, use
MovieClipLoader.loadClip() instead of loadMovie() or MovieClip.loadMovie() to load
SWF files.
After you issue the
MovieClipLoader.loadClip() command, the following events take place in
the order listed:
• When the first bytes of the downloaded file have been written to disk, the
MovieClipLoader.onLoadStart listener is invoked.
• If you have implemented the MovieClipLoader.onLoadProgress listener, it is invoked
during the loading process.
Note: You can call MovieClipLoader.getProgress() at any time during the load process.
• When the entire downloaded file has been written to disk, the
MovieClipLoader.onLoadComplete listener is invoked.
• After the downloaded file’s first frame actions have been executed, the
MovieClipLoader.onLoadInit listener is invoked.
After
MovieClipLoader.onLoadInit has been invoked, you can set properties, use methods,
and otherwise interact with the loaded movie.
If the file fails to load completely, the
MovieClipLoader.onLoadError listener is invoked.
Method summary for the MovieClipLoader class
Method Description
MovieClipLoader.addListener()
Registers an object to receive notification when a
MovieClipLoader event handler is invoked.
MovieClipLoader.getProgress()
Returns the number of bytes loaded and total number of bytes
for a file that is being loaded using
MovieClipLoader.loadClip().
MovieClipLoader.loadClip()
Loads a SWF or JPEG file into a movie clip in Flash Player
while the original movie is playing.
MovieClipLoader.removeListener()
Deletes an object that was registered using
MovieClipLoader.addListener().
MovieClipLoader.unloadClip()
Removes a movie clip that was loaded by means of
MovieClipLoader.loadClip().
CHAPTER 7
ActionScript for Flash