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.