unloadClip (MovieClipLoader.unloadClip method)

public unloadClip(target:Object) : Boolean

Removes a movie clip that was loaded by using MovieClipLoader.loadClip(). If you issue this command while a movie is loading, MovieClipLoader.onLoadError is invoked.

Availability: ActionScript 1.0; Flash Player 7

Parameters

target:Object - The string or integer that is passed to the corresponding call to my_mcl.loadClip().

Returns

Boolean - A Boolean value. Returns true if the movie clip was removed successfully; otherwise false.

Example

The following example loads an image into a movie clip called image_mc. When you click the movie clip, the movie clip is removed and information is displayed in the Output panel.

this.createEmptyMovieClip("image_mc", this.getNextHighestDepth());
var mclListener:Object = new Object();
mclListener.onLoadInit = function(target_mc:MovieClip) {
    target_mc._x = 100;
    target_mc._y = 100;
    target_mc.onRelease = function() {
    trace("Unloading clip...");
    trace("\t name: "+target_mc._name);
    trace("\t url: "+target_mc._url);
    image_mcl.unloadClip(target_mc);
    };
};
var image_mcl:MovieClipLoader = new MovieClipLoader();
image_mcl.addListener(mclListener);
image_mcl.loadClip("http://www.helpexamples.com/flash/images/image1.jpg", image_mc);

If your SWF file includes a version 2 component, use the version 2 component's DepthManager class instead of the MovieClip.getNextHighestDepth() method, which is used in this example.

See also

loadClip (MovieClipLoader.loadClip method), onLoadError (MovieClipLoader.onLoadError event listener)