Fonction duplicateMovieClip

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

Crée une occurrence de clip pendant la lecture du fichier SWF. La tête de lecture des clips dupliqués commence toujours à l'image 1, quelle que soit la position de la tête de lecture dans le clip d'origine. Les variables du clip d'origine ne sont pas copiées dans le clip dupliqué. Utilisez la fonction ou la méthode removeMovieClip() pour supprimer une occurrence de clip créée avec duplicateMovieClip().

Disponibilité : ActionScript 1.0 ; Flash Lite 1.0

Paramètres

target:Object - Le chemin cible du clip à dupliquer. Ce paramètre peut être de type String (tel que « my_mc ») ou une référence directe à l'occurrence de clip (par exemple my_mc). Les paramètres qui peuvent accepter plusieurs types de données sont répertoriés sous le type Object.

newname:String - Un identificateur unique pour le clip dupliqué.

depth:Number - Un niveau de profondeur unique pour le clip dupliqué. Le niveau de profondeur correspond à l'ordre d'empilement des clips dupliqués. Cet ordre d'empilement correspond à l'ordre d'empilement des calques dans le scénario ; les clips dont le niveau de profondeur est inférieur sont masqués par les clips de niveau supérieur. Vous devez associer un niveau de profondeur à chaque clip pour ne pas remplacer les fichiers SWF figurant à des profondeurs non utilisées.

Exemple

Dans l'exemple suivant, une nouvelle occurrence de clip intitulée img_mc. est créée. Une image est chargée dans le clip, puis le clip img_mc est dupliqué. Le clip dupliqué est intitulé newImg_mc ; ce nouveau clip est déplacé sur la scène afin de ne pas recouvrir le clip d'origine et la même image est chargée dans le deuxième clip.

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

Pour supprimer le clip dupliqué, vous pouvez ajouter ce code pour un bouton intitulé myButton_btn.

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

Voir aussi

Fonction removeMovieClip, duplicateMovieClip (méthode MovieClip.duplicateMovieClip), removeMovieClip (méthode MovieClip.removeMovieClip)