onEnterFrame (MovieClip.onEnterFrame handler)

onEnterFrame = function() {}

Invoked repeatedly at the frame rate of the SWF file. The function that you assign to the onEnterFrame event handler is processed before any other ActionScript code that is attached to the affected frames.

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 that is linked to a symbol in the library.

Set the value of the onEnterFrame event handler to null once the condition is met to stop Flash Player from invoking the defined function.

Availability: ActionScript 1.0; Flash Player 6

Example

The following example defines a function for the onEnterFrame event handler that sends a trace() action to the Output panel:

my_mc.onEnterFrame = function () {
    trace("onEnterFrame called");
}

Flash CS3

Comments

No screen name said on Jul 18, 2008 at 11:04 PM :

How exactly do we set the value of the onEnterFrame event handler to null? Could someone spell that out for me?

extdw_doc said on Jul 19, 2008 at 11:10 AM :

This code sets onEnterFrame to null, causing it to terminate
after one iteration. It assumes you've created a movie clip instance
named my_mc:

my_mc.onEnterFrame = function () {
trace("onEnterFrame called; my_mc._currentframe = " + my_mc._currentframe);
my_mc.onEnterFrame = null;
}

RSS feed | Send me an e-mail when comments are added to this page | Comment Report

Current page: http://livedocs.adobe.com/flash/9.0/main/00001945.html