User Guide

640 Chapter 7: ActionScript for Flash
// your statements here
}
Parameters
listenerObject
A listener object that was added using MovieClipLoader.addListener().
target_mc A movie clip loaded by a MovieClipLoader.loadClip() method.
errorCode A string that explains the reason for the failure.
Returns
One of two strings: "URLNotFound" or "LoadNeverCompleted".
Description
Listener; invoked when a file loaded with MovieClipLoader.loadClip() has failed to load.
The string
"URLNotFound" is returned if neither the MovieClipLoader.onLoadStart or
MovieClipLoader.onLoadComplete listener has been called. For example, if a server is down or
the file is not found, these listeners are not called.
The string
"LoadNeverCompleted" is returned if MovieClipLoader.onLoadStart was called
but
MovieClipLoader.onLoadComplete was not called. For example, if
MovieClipLoader.onLoadStart is called but the download is interrupted due to server
overload, server crash, and so on,
MovieClipLoader.onLoadComplete will not be called.
The value for
target_mc identifies the movie clip this call is being made for. This is useful if you
are loading multiple files with the same set of listeners. This optional parameter is passed to your
ActionScript.
Example
The following example writes information to the log file when an image fails to load. This occurs
when you test the following ActionScript, because the image does not exist in the specified
location.
this.createEmptyMovieClip("image_mc", this.getNextHighestDepth());
var mclListener:Object = new Object();
mclListener.onLoadError = function(target_mc:MovieClip, errorCode:String) {
trace("ERROR!");
switch (errorCode) {
case 'URLNotFound' :
trace("\t Unable to connect to URL: "+target_mc._url);
break;
case 'LoadNeverCompleted' :
trace("\t Unable to complete download: "+target_mc);
break;
}
};
mclListener.onLoadInit = function(target_mc:MovieClip) {
trace("success");
trace(image_mcl.getProgress(target_mc).bytesTotal+" bytes loaded");
};
var image_mcl:MovieClipLoader = new MovieClipLoader();