onLoadProgress = function([target_mc:MovieClip], loadedBytes:Number, totalBytes:Number) {}

Ecouteur : appelé à chaque fois que le contenu est écrit sur le disque dur au cours du processus de chargement (c’est-à-dire, entre MovieClipLoader.onLoadStart et MovieClipLoader.onLoadComplete). Appelle cet écouteur sur un objet d’écoute que vous ajoutez à l’aide de MovieClipLoader.addListener(). Vous pouvez utiliser cette méthode pour afficher les informations sur la progression du téléchargement, à l’aide des paramètres loadedBytes et totalBytes.

La valeur target_mc identifie le clip pour lequel cet appel est effectué. Cela est particulièrement utile lorsque vous chargez plusieurs fichiers avec le même jeu d’écouteurs.

Remarque : Si vous tentez d’utiliser onLoadProgress en mode test sur un fichier local résidant sur votre disque dur, il ne fonctionne pas correctement car, en mode test, Flash Player charge intégralement les fichiers locaux.

Disponibilité : ActionScript 1.0 ; Flash Player 7

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

loadedBytes:Number - Nombre d’octets chargés lorsque l’écouteur a été appelé.

totalBytes:Number - Nombre total d’octets dans le fichier chargé.

L’exemple suivant crée un clip, une nouvelle occurrence MovieClipLoader et un écouteur d’événement anonyme. Il affiche périodiquement la progression d’un chargement et envoie un signal lorsque le chargement est terminé et que l’actif est disponible pour ActionScript.

var container:MovieClip = this.createEmptyMovieClip("container", this.getNextHighestDepth());
var mcLoader:MovieClipLoader = new MovieClipLoader();
var listener:Object = new Object();
listener.onLoadProgress = function(target:MovieClip, bytesLoaded:Number, bytesTotal:Number):Void {
     trace(target + ".onLoadProgress with " + bytesLoaded + " bytes of " + bytesTotal);
}
listener.onLoadInit = function(target:MovieClip):Void {
     trace(target + ".onLoadInit");
}
mcLoader.addListener(listener);
mcLoader.loadClip("http://www.w3.org/Icons/w3c_main.png", container);

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), getProgress (méthode MovieClipLoader.getProgress)