User Guide

MovieClip.unloadMovie() 589

MovieClip.unloadMovie()

Availability

Flash Player 5.

Usage

my_mc.unloadMovie() : Void

Parameters

None.

Returns

Nothing.

Description

Method; removes the contents of a movie clip instance. The instance properties and clip

handlers remain.

To remove the instance, including its properties and clip handlers, use

MovieClip.removeMovieClip().

You can extend the methods and event handlers of the MovieClip class by creating a subclass. For

more information, see “Assigning a class to a movie clip symbol” in Using ActionScript in Flash.

Example

The following example unloads a movie clip instance called image_mc when a user clicks the

unloadMC_btn instance.

this.createEmptyMovieClip("image_mc", 1);

image_mc.loadMovie("http://www.macromedia.com/images/shared/product_boxes/

112x112/box_studio_112x112.jpg");

unloadMC_btn.onRelease = function() {

image_mc.unloadMovie();

};