duplicateMovieClip 関数

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

SWF ファイルの再生中にムービークリップのインスタンスを作成します。複製ムービークリップの再生ヘッドは、元のムービークリップでの再生ヘッドの位置に関係なく、常にフレーム 1 から始まります。元のムービークリップ内の変数は、複製されたムービークリップにコピーされません。duplicateMovieClip() で作成されたムービークリップインスタンスを削除するには、removeMovieClip() 関数またはメソッドを使用します。

パラメータ

target:Object - 複製するムービークリップのターゲットパス。このパラメータには、String ("my_mc" など)、またはムービークリップインスタンス (my_mc など) への直接参照のいずれかを指定できます。複数のデータ型を指定できるパラメータは、Object としてリストされます。

newname:String - 複製したムービークリップのインスタンス名。

depth:Number - 複製したムービークリップ固有の深度。深度は、複製したムービークリップの重ね順です。この重ね順は、タイムラインの重ね順に似ています。深度の低いムービークリップは、より高い重ね順のクリップの下に隠されます。既に占有されている深度の SWF ファイルが置き換えられるのを避けるため、複製したムービークリップには、それぞれ固有の深度を割り当てます。

例

次の例では、新しいムービークリップインスタンス img_mc を作成します。イメージをムービークリップにロードした後、img_mc クリップを複製します。複製されたクリップの名前は newImg_mc です。この新しいクリップを元のクリップと重ならないようにステージに移動し、同じイメージを 2 番目のクリップにロードします。

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);
};

duplicateMovieClip 関数

パラメータ

例

関連項目