Flash CS3 Documentation

Flash Lite 2.x ActionScript Language Reference > ActionScript classes > Sound > onLoad (Sound.onLoad handler)

onLoad (Sound.onLoad handler)

Invoked automatically when a sound loads. You must create a function that executes when the this handler is invoked. You can use either an anonymous function or a named function (for an example of each, see Sound.onSoundComplete). You should define this handler before you call mySound.loadSound().

Parameters

success:Boolean - A Boolean value of true if my_sound is loaded successfully, false otherwise.

Example

The following example creates a new Sound object, and loads a sound. Loading the sound is handled by the onLoad handler, which allows you to start the song after it is successfully loaded. Create a new FLA file, and add the following ActionScript to your FLA or AS file. For this example to work, you must have an MP3 called song1.mp3 in the same directory as your FLA or AS file.

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

See also

loadSound (Sound.loadSound method)

Flash CS3