Language Version: | ActionScript 3.0 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
The IFocusManager interface defines the interface that components must implement
to manage the focus on components in response to mouse activity or
keyboard activity (Tab key), and to support a default button.
defaultButton:IButton
Language Version: | ActionScript 3.0 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
A reference to the original default Button control.
Pressing the Enter key while the focus is on any control
activates the Button control by dispatching a click
event
on the Button control, just as if it was clicked with the mouse.
The actual default Button control changes if focus is given to another
Button control, but switches back to the original if focus is not
on a button.
This property is managed by Flex containers; do not set it directly
to specify the default button.
The defaultButton
must be of class
mx.controls.Button
even though this property
is of type IUIComponent
.
Implementation public function get defaultButton():IButton
public function set defaultButton(value:IButton):void
defaultButtonEnabled:Boolean
Language Version: | ActionScript 3.0 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
A flag that indicates whether the FocusManager should
check for the Enter key being pressed to activate the default button.
TextArea and other components that want to recognize
the Enter
key
set this property to false
to disable the Enter
key from dispatching a click
event on the
default button, if it exists.
Implementation public function get defaultButtonEnabled():Boolean
public function set defaultButtonEnabled(value:Boolean):void
focusPane:Sprite
Language Version: | ActionScript 3.0 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
A single Sprite that is moved from container to container
as the focus moves to those containers.
The Sprite is used as the parent of the visual indicator
that a component has focus.
Implementation public function get focusPane():Sprite
public function set focusPane(value:Sprite):void
nextTabIndex:int
[read-only]
Language Version: | ActionScript 3.0 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
The next unique tab index to use in this tab loop.
Implementation public function get nextTabIndex():int
showFocusIndicator:Boolean
Language Version: | ActionScript 3.0 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
A flag that indicates whether to display an indicator that
a component has focus.
If true
a component receiving focus
draws a visible indicator that it has focus.
By default, this is false
until the user uses
the Tab key, then it is set to true
.
In general it is better to use
the showFocus()
and hideFocus()
methods
to change this property as those methods also update the
visual indicator that a component has focus.
Implementation public function get showFocusIndicator():Boolean
public function set showFocusIndicator(value:Boolean):void
public function activate():void
Language Version: | ActionScript 3.0 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
The SystemManager activates and deactivates a FocusManager
if more than one IFocusManagerContainer is visible at the same time.
If the mouse is clicked in an IFocusManagerContainer with a deactivated
FocusManager, the SystemManager will call
the activate()
method on that FocusManager.
The FocusManager that was activated will have its deactivate()
method
called prior to the activation of another FocusManager.
public function deactivate():void
Language Version: | ActionScript 3.0 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
The SystemManager activates and deactivates a FocusManager
if more than one IFocusManagerContainer is visible at the same time.
If the mouse is clicked in an IFocusManagerContainer with a deactivated
FocusManager, the SystemManager will call
the activate()
method on that FocusManager.
The FocusManager that was activated will have its deactivate()
method
called prior to the activation of another FocusManager.
public function findFocusManagerComponent(o:InteractiveObject):IFocusManagerComponent
Language Version: | ActionScript 3.0 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Returns the IFocusManagerComponent that contains the given object, if any.
Because the player can set focus to a subcomponent of a Flex component
this method determines which IFocusManagerComponent has focus from
the component perspective.
Parameters
Returns public function getFocus():IFocusManagerComponent
Language Version: | ActionScript 3.0 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Gets the IFocusManagerComponent component that currently has the focus.
Calling this method is recommended instead of using the Stage object
because it indicates which component has focus.
The Stage might return a subcomponent in that component.
Returns public function getNextFocusManagerComponent(backward:Boolean = false):IFocusManagerComponent
Language Version: | ActionScript 3.0 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Returns the IFocusManagerComponent that would receive focus
if the user pressed the Tab key to navigate to another component.
It will return the same component as the current focused component
if there are no other valid components in the application.
Parameters
| backward:Boolean (default = false ) — If true , return the object
as if the Shift-Tab keys were pressed.
|
Returns public function hideFocus():void
Language Version: | ActionScript 3.0 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Sets showFocusIndicator
to false
and removes the visual focus indicator from the focused object, if any.
public function setFocus(o:IFocusManagerComponent):void
Language Version: | ActionScript 3.0 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Sets focus to an IFocusManagerComponent component. Does not check for
the components visibility, enabled state, or any other conditions.
Parameters
public function showFocus():void
Language Version: | ActionScript 3.0 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Sets showFocusIndicator
to true
and draws the visual focus indicator on the focused object, if any.