MACROMEDIA FLASH 8-ACTIONSCRIPT 2.0 LANGUAGE, Reference

Page: 917 / 1378

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 {
NO
TE
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.
NO
TE
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.