MACROMEDIA FLASH MX 2004 - ACTIONSCRIPT - Moviecliploader Class

544 Chapter 12: ActionScript Dictionary
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().