Duplicatemovieclip (Movieclip.duplicatemovieclip Method) - MACROMEDIA FLASH 8-FLASH LITE 2.X ACTIONSCRIPT LANGUAGE Reference

duplicateMovieClip (MovieClip.duplicateMovieClip
method)
public duplicateMovieClip(name:String, depth:Number, [initObject:Object]) :
MovieClip
Creates an instance of the specified movie clip while the SWF file is playing. Duplicated
movie clips always start playing at Frame 1, no matter what frame the original movie clip is on
when the method is called. Variables in the parent movie clip are not
duplicateMovieClip()
copied into the duplicate movie clip. Movie clips that are created with the
method are not duplicated if you call the
duplicateMovieClip() duplicateMovieClip()
method on their parent. If the parent movie clip is deleted, the duplicate movie clip is also
deleted. If you used or the MovieClipLoader class to load a movie
MovieClip.loadMovie()
clip, the contents of the SWF file are not duplicated. This means that you cannot save
bandwidth by loading a JPEG, GIF, PNG, or SWF file and then duplicating the movie clip.
Contrast this method with the global function version of . The
duplicateMovieClip()
global version of this method requires a parameter that specifies the target movie clip to
duplicate. Such a parameter is unnecessary for the MovieClip class version, because the target
of the method is the movie clip instance on which the method is invoked. Moreover, the
global version of supports neither the parameter nor
duplicateMovieClip() initobject
the return value of a reference to the newly created MovieClip instance.
Availability: ActionScript 1.0; Flash Lite 2.0
Parameters
- A unique identifier for the duplicate movie clip.
name:String
- A unique integer specifying the depth at which the new movie clip is placed.
depth:Number
Use depth -16384 to place the new movie clip instance beneath all content created in the
authoring environment. Values between -16383 and -1, inclusive, are reserved for use by the
authoring environment and should not be used with this method. The remaining valid depth
values range from 0 to 1048575, inclusive.
[optional] - (Supported for Flash Player 6 and later.) An object
initObject:Object
containing properties with which to populate the duplicated movie clip. This parameter
allows dynamically created movie clips to receive clip parameters. If is not an
initObject
object, it is ignored. All properties of are copied into the new instance. The
initObject
properties specified with are available to the constructor function.
initObject
Returns
- A reference to the duplicated movie clip (supported for Flash Player 6 and later).
MovieClip
MovieClip 461