Packagemx.managers
Interfacepublic interface IFocusManagerComponent
SubinterfacesIFocusManagerComplexComponent
ImplementorsAccordion, Button, ButtonBar, ListBase, TabNavigator, TextArea, TextInput

The IFocusManagerComponent interface defines the interface that focusable components must implement in order to receive focus from the FocusManager. The base implementations of this interface are in the UIComponent class, but UIComponent does not implement the full IFocusManagerComponent interface since some UIComponents are not intended to receive focus. Therefore, to make a UIComponent-derived component be a valid focusable component, you simply add "implements IFocusManagerComponent" to the class definition.



Public Properties
 PropertyDefined by
  focusEnabled : Boolean
A flag that indicates whether the component can receive focus when selected.
IFocusManagerComponent
  mouseFocusEnabled : Boolean
[read-only] A flag that indicates whether the component can receive focus when selected with the mouse.
IFocusManagerComponent
  tabEnabled : Boolean
[read-only] A flag that indicates whether pressing the Tab key eventually moves focus to this component.
IFocusManagerComponent
  tabIndex : int
[read-only] If tabEnabled, the order in which the component receives focus.
IFocusManagerComponent
Public Methods
 MethodDefined by
  
drawFocus(isFocused:Boolean):void
Called by the FocusManager when the component receives focus.
IFocusManagerComponent
  
setFocus():void
Called by the FocusManager when the component receives focus.
IFocusManagerComponent
Property detail
focusEnabledproperty
focusEnabled:Boolean  [read-write]

A flag that indicates whether the component can receive focus when selected.

As an optimization, if a child component in your component implements the IFocusManagerComponent interface, and you never want it to receive focus, you can set focusEnabled to false before calling addChild() on the child component.

This will cause the FocusManager to ignore this component and not monitor it for changes to the tabEnabled, tabChildren, and mouseFocusEnabled properties. This also means you cannot change this value after addChild() and expect the FocusManager to notice.

Note: It does not mean that you cannot give this object focus programmatically in your setFocus() method; it just tells the FocusManager to ignore this IFocusManagerComponent component in the Tab and mouse searches.

Implementation
    public function get focusEnabled():Boolean
    public function set focusEnabled(value:Boolean):void
mouseFocusEnabledproperty 
mouseFocusEnabled:Boolean  [read-only]

A flag that indicates whether the component can receive focus when selected with the mouse. If false, focus will be transferred to the first parent that is mouseFocusEnabled.

Implementation
    public function get mouseFocusEnabled():Boolean
tabEnabledproperty 
tabEnabled:Boolean  [read-only]

A flag that indicates whether pressing the Tab key eventually moves focus to this component. Even if false, you can still be given focus by being selected with the mouse or via a call to setFocus()

Implementation
    public function get tabEnabled():Boolean
tabIndexproperty 
tabIndex:int  [read-only]

If tabEnabled, the order in which the component receives focus. If -1, then the component receives focus based on z-order.

Implementation
    public function get tabIndex():int
Method detail
drawFocus()method
public function drawFocus(isFocused:Boolean):void

Called by the FocusManager when the component receives focus. The component should draw or hide a graphic that indicates that the component has focus.

Parameters
isFocused:Boolean — If true, draw the focus indicator, otherwise hide it.
setFocus()method 
public function setFocus():void

Called by the FocusManager when the component receives focus. The component may in turn set focus to an internal component.