User Guide

MovieClip 917
See also
_quality property
removeMovieClip (MovieClip.removeMovieClip
method)
public removeMovieClip() : Void
Removes a movie clip instance created with duplicateMovieClip(),
MovieClip.duplicateMovieClip(), MovieClip.createEmptyMovieClip(), or
MovieClip.attachMovie().
This method does not remove a movie clip assigned to a negative depth value. Movie clips
created in the authoring tool are assigned negative depth values by default. To remove a movie
clip that is assigned to a negative depth value, first use the
MovieClip.swapDepths() method
to move the movie clip to a positive depth value.
You can extend the methods and event handlers of the MovieClip class by creating a subclass.
Availability: ActionScript 1.0; Flash Player 5
Example
Each time you click a button in the following example, you attach a movie clip instance to the
Stage in a random position. When you click a movie clip instance, you remove that instance
from the SWF file.
function randRange(min:Number, max:Number):Number {
NOTE
If you are using version 2 components, do not use this method. If you place a version 2
component either on the Stage or in the Library, the
getNextHighestDepth() method can
sometimes return depth 1048676, which is outside the valid range. If you are using
version 2 components, you should always use version 2 components DepthManager
class.
NOTE
If you are using version 2 components, and use MovieClip.getNextHighestDepth()
instead of the version 2 components DepthManager class to assign depth values, you
may find that
removeMovieClip() fails silently. When any version 2 component is used,
the DepthManager class automatically reserves the highest (1048575) and lowest (-
16383) available depths for cursors and tooltips. A subsequent call to
getNextHighestDepth() returns 1048576, which is outside the valid range. The
removeMovieClip() method fails silently if it encounters a depth value outside the valid
range. If you must use
getNextHighestDepth() with version 2 components, you can use
swapDepths() to assign a valid depth value or use MovieClip.unloadMovie() to remove the
contents of the movie clip. Alternatively, you can use the
DepthManager class to assign
depth values within the valid range.