MovieClip
461
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
duplicateMovieClip()
method is called. Variables in the parent movie clip are not
copied into the duplicate movie clip. Movie clips that are created with the
duplicateMovieClip()
method are not duplicated if you call the
duplicateMovieClip()
method on their parent. If the parent movie clip is deleted, the duplicate movie clip is also
deleted. If you used
MovieClip.loadMovie()
or the MovieClipLoader class to load a movie
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
duplicateMovieClip()
. The
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
duplicateMovieClip()
supports neither the
initobject
parameter nor
the return value of a reference to the newly created MovieClip instance.
Availability:
ActionScript 1.0; Flash Lite 2.0
Parameters
name
:
String
- A unique identifier for the duplicate movie clip.
depth
:
Number
- A unique integer specifying the depth at which the new movie clip is placed.
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.
initObject
:
Object
[optional] - (Supported for Flash Player 6 and later.) An object
containing properties with which to populate the duplicated movie clip. This parameter
allows dynamically created movie clips to receive clip parameters. If
initObject
is not an
object, it is ignored. All properties of
initObject
are copied into the new instance. The
properties specified with
initObject
are available to the constructor function.
Returns
MovieClip
- A reference to the duplicated movie clip (supported for Flash Player 6 and later).
Summary of Contents for FLASHLITE2 ACTIONSCRIPT-LANGUAGE
Page 1: ...Flash Lite 2 x ActionScript Language Reference...
Page 22: ...22 Contents...
Page 244: ...244 ActionScript language elements...
Page 760: ...760 ActionScript classes...
