onLoadComplete = function([target_mc:MovieClip], [httpStatus:Number]) {}

Appelé lorsque le fichier qui a été chargé avec MovieClipLoader.loadClip() a fini son téléchargement. Appelle cet écouteur sur un objet d’écoute que vous ajoutez à l’aide de MovieClipLoader.addListener(). L’écouteur d’événement onLoadComplete est transmis par Flash Player à votre code, mais il n’est pas nécessaire d’implémenter tous les paramètres dans la fonction d’écouteur. La valeur target_mc identifie le clip pour lequel cet appel est effectué. Cette identification est particulièrement utile si plusieurs fichiers sont chargés avec le même jeu d’écouteurs.

Dans Flash Player 8, cet écouteur peut renvoyer un code d’état HTTP. Si Flash Player ne peut pas obtenir le code d’état du serveur, ou si Flash Player ne peut pas communiquer avec le serveur, la valeur par défaut (0) est transmise à votre code ActionScript. Une valeur de 0 peut être générée dans n’importe quel lecteur (par exemple, si une URL mal formulée est requise), et une valeur de 0 est toujours générée par le module Flash Player lorsqu’il est exécuté dans les navigateurs suivants, qui ne peuvent pas transmettre les codes d’état HTTP du serveur à Flash Player : Netscape, Mozilla, Safari, Opera et Internet Explorer pour Macintosh.

Il est important de comprendre la différence entre MovieClipLoader.onLoadComplete et MovieClipLoader.onLoadInit. L’événement onLoadComplete est appelé lorsque le chargement du fichier SWF, JPEG, GIF ou PNG est terminé, mais avant l’initialisation de l’application. À ce stade, il est impossible d’accéder aux méthodes et propriétés du clip chargé ; c’est la raison pour laquelle vous ne pouvez pas appeler de fonction, vous déplacer vers une image spécifique, etc. Dans la plupart des situations, il est préférable d’utiliser l’événement onLoadInit, qui est appelé une fois le contenu chargé et entièrement initialisé.

Disponibilité : ActionScript 1.0 ; Flash Player 7

target_mc:MovieClip [facultatif] - Clip chargé par la méthode MovieClipLoader.loadClip().

httpStatus:Number [facultatif] - (Flash Player 8 seulement) Code d’état HTTP renvoyé par le serveur. Par exemple, un code d’état de 404 indique que le serveur n’a trouvé aucune correspondance pour l’URL requise. Pour plus d’informations sur les codes d’état HTTP, consultez les sections 10.4 et 10.5 de la spécification HTTP à l’adresse ftp://ftp.isi.edu/in-notes/rfc2616.txt.

L’exemple suivant crée un clip, une nouvelle occurrence MovieClipLoader et un écouteur d’événement anonyme qui écoute l’événement onLoadComplete mais attend qu’un événement onLoadInit interagisse avec les propriétés de l’élément chargé.

var loadListener:Object = new Object();
 
loadListener.onLoadComplete = function(target_mc:MovieClip, httpStatus:Number):Void {
     trace(">> loadListener.onLoadComplete()");
     trace(">> =============================");
     trace(">> target_mc._width: " + target_mc._width); // 0
     trace(">> httpStatus: " + httpStatus);
}
 
loadListener.onLoadInit = function(target_mc:MovieClip):Void {
     trace(">> loadListener.onLoadInit()");
     trace(">> =============================");
     trace(">> target_mc._width: " + target_mc._width); // 315
}
 
var mcLoader:MovieClipLoader = new MovieClipLoader();
mcLoader.addListener(loadListener);
 
var mc:MovieClip = this.createEmptyMovieClip("mc", this.getNextHighestDepth());
mcLoader.loadClip("http://www.w3.org/Icons/w3c_main.png", mc);

Si votre fichier SWF comprend un composant de la version 2, utilisez les composants de la version 2 de la classe DepthManager au lieu de la méthode MovieClip.getNextHighestDepth(), utilisée dans cet exemple.

addListener (méthode MovieClipLoader.addListener), loadClip (méthode MovieClipLoader.loadClip), onLoadStart (écouteur événement MovieClipLoader.onLoadStart), onLoadError (écouteur événement MovieClipLoader.onLoadError), onLoadInit (écouteur événement MovieClipLoader.onLoadInit)