duplicateMovieClip()

可用性

Flash Lite 1.0。

用法

duplicateMovieClip(target, newname, depth)

Operands

target 要直接复制的影片剪辑的目标路径。

newname 已直接复制的影片剪辑的唯一标识符。

depth 已直接复制的影片剪辑的唯一深度级别。深度级别表示直接复制的影片剪辑的堆叠顺序。这种堆叠顺序很像时间轴中图层的堆叠顺序；较低深度级别的影片剪辑隐藏在较高深度级别的剪辑之下。您必须为每个直接复制的影片剪辑指定唯一的深度级别，使其不会覆盖已占用的深度级别上的现有影片剪辑。

说明

函数；在播放 SWF 文件时创建影片剪辑的一个实例。不返回任何内容。无论播放头在原始（父级）影片剪辑中处于什么位置，直接复制的影片剪辑的播放头始终从第 1 帧开始。父级影片剪辑中的变量不复制到直接复制的影片剪辑中。如果删除父级影片剪辑，则直接复制的影片剪辑也被删除。使用 removeMovieClip() 函数或方法可以删除用 duplicateMovieClip() 创建的影片剪辑实例。使用作为 newname 操作数传入的字符串引用新的影片剪辑。

示例

以下示例在级别为 10 的深度上直接复制一个名为 originalClip 的影片剪辑，来创建名为 newClip 的新剪辑。新剪辑的 x 位置设置为 100 像素。

duplicateMovieClip("originalClip", "newClip", 10);
setProperty("newClip", _x, 100);

以下示例在一个 for 循环中使用 duplicateMovieClip()，以一次创建多个新影片剪辑。索引变量会保持跟踪已占用的最高堆叠深度。每个直接复制的影片剪辑的名称都包含一个与其堆叠深度相对应的数字后缀（clip1、clip2、clip3）。

for (i = 1; i <= 3; i++) {
    newName = "clip" add i;
    duplicateMovieClip("originalClip", newName); }

另请参见

removeMovieClip()

查看 LiveDocs 上的注释