Flash CS3 Documentation

ActionScript 2.0 Language Reference > ActionScript classes > MovieClip > focusEnabled (MovieClip.focusEnabled property)

focusEnabled (MovieClip.focusEnabled property)

Specifies whether you can programmatically assign focus to a movie clip using Selection.setFocus(). If the focusEnabled property is set to false or is undefined (the default), you cannot assign focus to a movie clip with Selection.setFocus() unless that movie clip has defined one of following event handlers: onDragOut, onDragOver, onPress, onRelease, onReleaseOutside, onRollOut, or onRollOver.

If the focusEnabled property is set to true, you can use Selection.setFocus() to assign focus to a movie clip even when none of the event handlers is defined.

Do not confuse the focusEnabled property with the tabEnabled property. The tabEnabled property controls whether a movie clip can be assigned focus with the Tab key, and has no effect on the Selection.setFocus() method, while the focusEnabled property has no effect on keyboard navigation.

Availability: ActionScript 1.0; Flash Player 6

Example

The following example sets the focusEnabled property for the movie clip my_mc to false:

my_mc.focusEnabled = false;

See also

setFocus (Selection.setFocus method)

Flash CS3