duplicateMovieClip 函数

duplicateMovieClip(target:String, newname:String, depth:Number) : Void
duplicateMovieClip(target:MovieClip, newname:String, depth:Number) : Void

当 SWF 文件正在播放时，创建一个影片剪辑的实例。无论播放头在原始影片剪辑中处于什么位置，在重复的影片剪辑中，播放头始终从第 1 帧开始。原始影片剪辑中的变量不会复制到重复的影片剪辑中。使用 removeMovieClip() 函数或方法可以删除用 duplicateMovieClip() 创建的影片剪辑实例。

可用性：ActionScript 1.0、Flash Player 4

参数

target:Object ― 要复制的影片剪辑的目标路径。此参数可以是一个字符串（例如 "my_mc"），也可以是对影片剪辑实例的直接引用（例如 my_mc）。能够接受参数以 Object 类型在签名中列出的多种数据类型。

newname:String ― 所复制的影片剪辑的唯一标识符。

depth:Number ― 所复制的影片剪辑的唯一深度级别。深度级别是所复制的影片剪辑的堆叠顺序。这种堆叠顺序很像时间轴中图层的堆叠顺序；较低深度级别的影片剪辑隐藏在较高堆叠顺序的剪辑之下。必须为每个所复制的影片剪辑分配一个唯一的深度级别，以防止它替换已占用深度上的 SWF 文件。

示例

在下面的示例中，将创建一个名为 img_mc 的新影片剪辑实例。将一个图像加载到该影片剪辑中，然后复制 img_mc 剪辑。所复制的剪辑名为 newImg_mc，这个新剪辑将移至舞台上，因此它不会与原始剪辑重叠，并且将同一图像加载到第二个剪辑中。

this.createEmptyMovieClip("img_mc", this.getNextHighestDepth());
img_mc.loadMovie("http://www.helpexamples.com/flash/images/image1.jpg");
duplicateMovieClip(img_mc, "newImg_mc", this.getNextHighestDepth());
newImg_mc._x = 200;
newImg_mc.loadMovie("http://www.helpexamples.com/flash/images/image1.jpg");

要删除重复的影片剪辑，可为名为 myButton_btn 的按钮添加以下代码。

this.myButton_btn.onRelease = function(){
 removeMovieClip(newImg_mc);
};

请参阅

removeMovieClip 函数, duplicateMovieClip（MovieClip.duplicateMovieClip 方法）, removeMovieClip（MovieClip.removeMovieClip 方法）

在 LiveDocs 中查看评论