Guide de reference du langage ActionScript 2.0 - PowWeb

onLoad (gestionnaire Sound.onLoad)
onLoad = function(success:Boolean) {}
Appelé automatiquement lorsqu'un son est en cours de chargement. Vous devez créer une
fonction qui s'exécute lorsque ce gestionnaire est appelé. Vous pouvez utiliser une fonction
anonyme ou une fonction nommée (vous trouverez un exemple de chacune de ces fonctions
dans Sound.onSoundComplete). Il est recommandé de définir ce gestionnaire avant d'appeler
mySound.loadSound().
Disponibilité : ActionScript 1.0 ; Flash Player 6
Paramètres
success:Boolean - Valeur booléenne true si my_sound a été chargé avec succès, et false
dans tous les autres cas.
Exemple
L'exemple suivant crée un nouvel objet Sound et charge un son. Le chargement du son est
traité par le gestionnaire onLoad, qui permet également de diffuser le morceau à l'issue de son
chargement. Créez un nouveau fichier FLA et ajoutez le code ActionScript suivant à votre
fichier FLA ou AS. Pour que cet exemple fonctionne, vous devez disposer d'un fichier MP3
appelé song1.mp3 et situé dans le même répertoire que votre fichier FLA ou AS.
this.createTextField("status_txt", this.getNextHighestDepth(), 0,0,100,22);
// create a new Sound object
var my_sound:Sound = new Sound();
// if the sound loads, play it; if not, trace failure loading
my_sound.onLoad = function(success:Boolean) {
if (success) {
my_sound.start();
status_txt.text = "Sound loaded";
} else {
status_txt.text = "Sound failed";
}
};
// load the sound
my_sound.loadSound("song1.mp3", true);
La méthode MovieClip.getNextHighestDepth() utilisée dans cet exemple requiert Flash
Player 7 ou version ultérieure. Si votre fichier SWF comporte un composant de la version 2,
utilisez la classe DepthManager des composants de la version 2 au lieu de la méthode
MovieClip.getNextHighestDepth().
1150 Chapitre 2: Classes ActionScript