User Guide

550 Chapter 2: 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.loadVariables() or
MovieClip.loadMovie() call. You must define a function that executes when the event handler
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 onClipEvent() instead of this handler. The latter handler is invoked
when any movie clip receives data.
Example
The following example illustrates the correct use of MovieClip.onData() and
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.