User Guide

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;