duplicateMovieClip-Funktion

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

Erstellt während der Wiedergabe der SWF-Datei eine Instanz eines Movieclips. Der Abspielkopf im duplizierten Movieclip steht anfänglich immer in Bild 1, unabhängig davon, wo er sich im ursprünglichen Movieclip befindet. Im ursprünglichen Movieclip enthaltene Variablen werden nicht in den duplizierten Movieclip kopiert. Mithilfe der Funktion bzw. der Methode removeMovieClip() können Sie eine Movieclip-Instanz löschen, die mit duplicateMovieClip() erstellt wurde.

Verfügbarkeit: ActionScript 1.0, Flash Lite 1.0

Parameter

target:Object - Der Zielpfad des zu duplizierenden Movieclips. Dieser Parameter kann entweder ein String (z. B. "my_mc") oder eine direkte Referenz auf die Instanz eines Movieclips sein (z. B. my_mc). Parameter, die mehrere Datentypen annehmen können, werden als Object-Typ hinzugefügt.

newname:String - Ein eindeutiger Bezeichner für den duplizierten Movieclip.

depth:Number - Eine eindeutige Tiefenebene für den duplizierten Movieclip. Die Tiefenebene legt die Stapelanordnung der duplizierten Movieclips fest. Diese Stapelanordnung ist der Stapelanordnung von Ebenen in der Zeitleiste sehr ähnlich. Movieclips mit einer niedrigeren Tiefenebene werden von Movieclips mit einer höheren Tiefenebene verdeckt. Sie müssen jedem duplizierten Movieclip eine eindeutige Tiefenebene zuordnen, damit SWF-Dateien auf bereits belegten Tiefenebenen nicht überschrieben werden.

Beispiel

Im folgenden Beispiel wird eine neue Movieclip-Instanz mit dem Namen img_mc erstellt. In diesen Movieclip wird ein Bild geladen, anschließend wird der Clip img_mc dupliziert. Der duplizierte Movieclip wird mit newImg_mc bezeichnet und so auf der Bühne platziert, dass er den ursprünglichen Movieclip nicht überschneidet. Dann wird das gleiche Bild in den zweiten Movieclip geladen.

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

Wenn Sie den duplizierten Movieclip wieder entfernen möchten, können Sie für eine Schaltfläche mit dem Namen myButton_btn folgenden Code hinzufügen:

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

Siehe auch

removeMovieClip-Funktion, duplicateMovieClip (MovieClip.duplicateMovieClip-Methode), removeMovieClip (MovieClip.removeMovieClip-Methode)