Name
removeMovieClip( ) Global Function — delete a movie clip from the Flash Player
Availability
Flash 4; enhanced in Flash 5 to apply to instances created with
attachMovie( )
Synopsis
removeMovieClip(target)
Arguments
- target
A string or reference indicating the path to the movie clip instance to be removed from the Player (references to movie clips are converted to paths when used in a string context).
Description
The removeMovieClip( )
function deletes the
specified movie clip from the Player, leaving no trace of the
clip’s contents or shell. Subsequent references to the clip or
any of its variables or properties yield
undefined
.
The removeMovieClip( )
function may be used only
on movie clip instances that were originally created via
duplicateMovieClip( )
or attachMovie(
)
. It has no effect on movie clips created in the
authoring tool.
See Also
attachMovie( )
, duplicateMovieClip(
)
, MovieClip( ).removeMovieClip( )
;
Section 13.6 in Chapter 13
Get ActionScript: The Definitive Guide now with the O’Reilly learning platform.
O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.