Movieclip.ondata - MACROMEDIA FLASH MX 2004-ACTIONSCRIPT LANGUAGE Reference

MovieClip.onData

Availability
Flash Player 6.
Usage
my_mc.onData = function() {
// your statements here
}
Parameters
None.
Returns
Nothing.
Description
Event handler; invoked when a movie clip receives data from a
MovieClip.loadMovie()
is invoked. You can define the function on the Timeline or in a class file that extends the
MovieClip class or is linked to a symbol in the library. For more information, see "Assigning a
class to a movie clip symbol" in Using ActionScript in Flash.
This handler can be used only with movie clips for which you have a symbol in the library that is
associated with a class. If you want an event handler to be invoked when a specific movie clip
receives data, you must use
when any movie clip receives data.
Example
The following example illustrates the correct use of
onClipEvent(data)
// symbol_mc is a movie clip symbol in the library.
// It is linked to the MovieClip class.
// The following function is triggered for each instance of symbol_mc
// when it receives data.
symbol_mc.onData = function() {
trace("The movie clip has received data");
}
// dynamic_mc is a movie clip that is being loaded with MovieClip.loadMovie().
// This code attempts to call a function when the clip is loaded,
// but it will not work, because the loaded SWF is not a symbol
// in the library associated with the MovieClip class.
function output()
{
trace("Will never be called.");
}
dynamic_mc.onData = output;
dynamic_mc.loadMovie("replacement.swf");
// The following function is invoked for any movie clip that
// receives data, whether it is in the library or not.
550 Chapter 2: ActionScript Language Reference
call. You must define a function that executes when the event handler
onClipEvent() instead of this handler. The latter handler is invoked
:
MovieClip.loadVariables()
MovieClip.onData()
or
and