User Guide

512 Chapter 2: ActionScript Language Reference
MovieClip.enabled
Availability
Flash Player 6.
Usage
my_mc.enabled:Boolean
Description
Property; a Boolean value that indicates whether a movie clip is enabled. The default value of
enabled is true. If enabled is set to false, the movie clip’s callback methods and on action
event handlers are no longer invoked, and the Over, Down, and Up frames are disabled. The
enabled property does not affect the Timeline of the movie clip; if a movie clip is playing, it
continues to play. The movie clip continues to receive movie clip events (for example,
mouseDown,
mouseUp, keyDown, and keyUp).
The
enabled property only governs the button-like properties of a movie clip. You can change
the
enabled property at any time; the modified movie clip is immediately enabled or disabled.
The
enabled property can be read out of a prototype object. If enabled is set to false, the
object is not included in automatic tab ordering.
Example
The following example disables the circle_mc movie clip when the user clicks it.
circle_mc.onRelease = function() {
trace("disabling the "+this._name+" movie clip.");
this.enabled = false;
};