User Guide

ManualsBrandsMacromedia ManualsOtherFLEX-FLEX ACTIONSCRIPT LANGUAGE REFERENCE

631

632

633

634

635

636

637

638

639

640

MovieClipLoader.onLoadError 639

Description

Listener; invoked when a file loaded with MovieClipLoader.loadClip() has completely

downloaded. The value for

target_mc identifies the movie clip for which this call is being made.

This is useful if multiple files are being loaded with the same set of listeners.

This parameter is passed by Flash to your code, but you do not have to implement all of the

parameters in the listener function.

When you use the

onLoadComplete and onLoadInit events with the MovieClipLoader class, it’s

important to understand how this differs from the way they work with your SWF file. The

onLoadComplete event is called after the SWF or JPEG file has loaded, but before the application

has been initialized. At this point it is impossible to access the loaded movie clip’s methods and

properties, and because of this you cannot call a function, move to a specific frame, and so on. In

most situations, it’s better to use the

onLoadInit event instead, which is called after the content

has loaded and is fully initialized.

Example

The following example loads an image into a movie clip instance called image_mc. The

onLoadInit and onLoadComplete events are used to determine how long it takes to load the

image. The information displays in a dynamically created text field called

timer_txt.

this.createEmptyMovieClip("image_mc", this.getNextHighestDepth());

var mclListener:Object = new Object();

mclListener.onLoadStart = function(target_mc:MovieClip) {

target_mc.startTimer = getTimer();

};

mclListener.onLoadComplete = function(target_mc:MovieClip) {

target_mc.completeTimer = getTimer();

};

mclListener.onLoadInit = function(target_mc:MovieClip) {

var timerMS:Number = target_mc.completeTimer-target_mc.startTimer;

target_mc.createTextField("timer_txt", target_mc.getNextHighestDepth(), 0,

target_mc._height, target_mc._width, 22);

target_mc.timer_txt.text = "loaded in "+timerMS+" ms.";

};

var image_mcl:MovieClipLoader = new MovieClipLoader();

image_mcl.addListener(mclListener);

image_mcl.loadClip("http://www.macromedia.com/images/shared/product_boxes/

112x112/box_studio_112x112.jpg", image_mc);