MACROMEDIA FLASH MX 2004-ACTIONSCRIPT LANGUAGE, Reference, Page: 609 / 1104

MovieClipLoader.onLoadError 609
MovieClipLoader.onLoadError
Availability
Flash Player 7.
Usage
listenerObject .onLoadError = function( target_mc:Object , errorCode:String ) {
// 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 displays information in the Output panel 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;