Fonction loadMovie

loadMovie(url:String, target:Object [, method:String]) : VoidloadMovie(url:String, target:String [, method:String]) : Void

Charge un fichier SWF ou JPEG dans Flash Player pendant la lecture du fichier SWF d'origine. Les fichiers JPEG enregistrés au format progressif ne sont pas pris en charge.

Conseil : Si vous souhaitez contrôler la progression du téléchargement, utilisez MovieClipLoader.loadClip() à la place de cette fonction.

La fonction loadMovie() permet d'afficher plusieurs fichiers SWF à la fois et de basculer vers l'un de ces derniers sans avoir à charger un autre document HTML. En l'absence de la fonction loadMovie(), Flash Player affiche un seul fichier SWF.

Si vous souhaitez charger un fichier SWF ou JPEG à un niveau spécifique, utilisez loadMovieNum() à la place de loadMovie().

Lorsqu'un fichier SWF est chargé dans un clip cible, vous pouvez utiliser le chemin cible de ce clip pour cibler le fichier SWF chargé. Un fichier SWF ou une image chargé dans une cible hérite de la position, des propriétés de rotation et d'échelle du clip ciblé. Le coin supérieur gauche de l'image chargée ou du fichier SWF s'aligne sur le point de référence du clip ciblé. Sinon, lorsque la cible correspond au scénario racine, le coin supérieur gauche de l'image ou du fichier SWF s'aligne sur le coin supérieur gauche de la scène.

La fonction unloadMovie() permet de supprimer les fichiers SWF chargés avec loadMovie().

Disponibilité : ActionScript 1.0 ; Flash Lite 1.1 - Le chargement de fichiers JPEG nécessite Flash Player 6 ou une version plus récente.

Paramètres

url:String - L'URL absolue ou relative du fichier SWF ou JPEG à charger. Un chemin relatif doit être relatif au fichier SWF au niveau 0. Les URL absolues doivent inclure la référence de protocole, telle que http:// ou file:///.

target:Object - Une référence à un objet clip ou une chaîne représentant le chemin d'un clip cible. Le clip cible est remplacé par le fichier SWF chargé ou l'image.

method:String [facultatif] - Spécifie une méthode HTTP d'envoi des variables. Ce paramètre doit correspondre à la chaîne GET ou POST. En l'absence de variable à envoyer, omettez ce paramètre. La méthode GET ajoute les variables à la fin de l'URL et est utilisée lorsque les variables sont peu nombreuses. La méthode POST place les variables dans un en-tête HTTP distinct et s'applique aux variables longues de type chaîne.

Exemple

Utilisation 1 : l'exemple suivant charge le fichier SWF circle.swf à partir du même répertoire et remplace un clip intitulé mySquare qui existe déjà sur la scène :

loadMovie("circle.swf", mySquare);
// Instruction équivalente (Utilisation 1) : 
// loadMovie("circle.swf", _level0.mySquare);
// instruction équivalente (Utilisation 2) : 
// loadMovie("circle.swf", "mySquare");

L'exemple suivant charge le fichier SWF circle.swf à partir du même répertoire, mais remplace le clip principal au lieu du clip mySquare :

loadMovie("circle.swf", this);
// L'utilisation de "this" en tant que chaîne pour le paramètre cible 
// ne fonctionne pas
// instruction équivalente (Utilisation 2) : 
// loadMovie("circle.swf", "_level0");

L'instruction loadMovie() suivante charge le fichier SWF sub.swf à partir du même répertoire dans un nouveau clip intitulé logo_mc, créé à l'aide de createEmptyMovieClip() :

this.createEmptyMovieClip("logo_mc", 999);
loadMovie("sub.swf", logo_mc);

Vous pouvez ajouter le code suivant pour charger une image JPEG intitulée image1.jpg à partir du même répertoire que le fichier SWF chargeant sub.swf. L'image JPEG est chargée lorsque vous cliquez sur un bouton intitulé myBtn_btn. Ce code charge l'image JPEG dans logo_mc. Par conséquent, il remplace sub.swf par l'image JPEG.

myBtn_btn.onRelease = function(){
 loadMovie("image1.jpg", logo_mc);
};

Utilisation 2 : l'exemple suivant charge le fichier SWF circle.swf à partir du même répertoire et remplace un clip intitulé mySquare qui existe déjà sur la scène :

loadMovie("circle.swf", "mySquare");

Fonction loadMovie

Paramètres

Exemple

Voir aussi