Removemovieclip (Movieclip.removemovieclip Method) - MACROMEDIA FLASH 8-FLASH LITE 2.X ACTIONSCRIPT LANGUAGE Reference

removeMovieClip (MovieClip.removeMovieClip
method)
public removeMovieClip() : Void
Removes a movie clip instance created with ,
duplicateMovieClip()
, , or
MovieClip.duplicateMovieClip() MovieClip.createEmptyMovieClip()
.
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 to move
MovieClip.swapDepths()
the movie clip to a positive depth value.
Note: If you are using V2 components, and use
MovieClip.getNextHighestDepth()
instead of the DepthManager class to assign depth values, you may find that
fails silently. When any V2 component is used, the DepthManager class
removeMovieClip()
automatically reserves the highest (1048575) and lowest (-16383) available depths for cursors
and tooltips. A subsequent call to returns 1048576, which is
getNextHighestDepth()
outside the valid range. The method fails silently if it encounters a
removeMovieClip()
depth value outside the valid range. If you must use with V2
getNextHighestDepth()
components, then you can use to assign a valid depth value or use
swapDepths()
to remove the contents of the movie clip. Alternatively, you can
MovieClip.unloadMovie()
use the DepthManager class to assign depth values within the valid range.
You can extend the methods and event handlers of the MovieClip class by creating a subclass.
Availability: ActionScript 1.0; Flash Lite 2.0
MovieClip 509