Package | mx.managers |
Interface | public interface IFocusManagerComponent |
Implementors | Accordion, AdvancedListBase, Button, ButtonBar, ChartBase, ComboBase, DateChooser, DateField, HTML, ListBase, MenuBar, NumericStepper, TabNavigator, TextArea, TextInput, UIMovieClip |
Property | Defined 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 |
Method | Defined By | ||
---|---|---|---|
Called by the FocusManager when the component receives focus. | IFocusManagerComponent | ||
Called by the FocusManager when the component receives focus. | IFocusManagerComponent |
focusEnabled | property |
focusEnabled:Boolean
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.
public function get focusEnabled():Boolean
public function set focusEnabled(value:Boolean):void
mouseFocusEnabled | property |
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
.
public function get mouseFocusEnabled():Boolean
tabEnabled | property |
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()
public function get tabEnabled():Boolean
tabIndex | property |
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.
public function get tabIndex():int
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.