User Guide

MovieClipLoader 537
onLoadError (MovieClipLoader.onLoadError event
listener)
onLoadError = function(target_mc, errorCode) {}
Invoked when a file loaded with MovieClipLoader.loadClip() has failed to load. This
listener can be invoked for various reasons, including if the server is down, if the file is not
found, or if a security violation occurs.
Call this listener on a listener object that you add using
MovieClipLoader.addListener().
The value for
target_mc identifies the movie clip this call is being made for. This parameter
is useful if you are loading multiple files with the same set of listeners.
For the
errorCode parameter, the string "URLNotFound" is returned if neither the
MovieClipLoader.onLoadStart or MovieClipLoader.onLoadComplete listener is called,
for example, if a server is down or the file is not found. The string
"LoadNeverCompleted" is
returned if
MovieClipLoader.onLoadStart was called but
MovieClipLoader.onLoadComplete was not called, for example, if the download was
interrupted because of server overload, server crash, and so on.
Availability: ActionScript 1.0; Flash Lite 2.0
Parameters
target_mc: - A movie clip loaded by a MovieClipLoader.loadClip() method.
errorCode: - A string that explains the reason for the failure.
Example
The following example displays information in the Output panel when an image fails to load.
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");
};