Gets or sets a Boolean value that indicates whether a selected component can receive focus from the focus manager.

To make a component capable of receiving focus from the focus manager, set this property to true. To make the component incapable of receiving focus, set this property to false. When focusEnabled is set to false, the focus manager ignores the component over the component's lifetime and does not monitor it for changes in the following properties: tabEnabled, tabChildren, and mouseFocusEnabled.

You can use the focusEnabled property to prevent the child component of a component that implements the IFocusManagerComponent interface from receiving focus from the focus manager. To do so, set this property to false before using the addChild() method to add the child component to the display list. Note that if you set this property to false before adding the component to the display list, the focus manager will continue to ignore the component even if you set this property to true later on.

Note: Even if you set this property to false, you can still set focus programmatically by using the setFocus() method.

Gets a Boolean value that indicates whether a component that is selected by using a mouse device can receive focus.

Set this property to true to give focus to components that are selected by using a mouse device. Set this property to false to prevent focus from being given to components that are selected by using a mouse device. If this property is set to false when a component is selected by using a mouse device, focus is transferred to the first parent component for which this property is set to true.

Gets a Boolean value that indicates whether pressing the Tab key can move focus to this component. A value of true indicates that pressing the Tab key can cause focus to be moved to this component; a value of false indicates that the Tab key cannot be used to give this component focus.

Even if this value is set to false, the component can still receive focus when it is selected by a mouse device or through a call to the setFocus() method.

Gets the order in which the component receives focus, if tabEnabledis set to true. The tabIndex property is -1 by default, meaning that no tab index is set for the object and that the object receives focus based on z-order.

The tabIndex property can also be a non-negative integer. In this case, the objects are ordered according to their tabIndex properties, in ascending order. An object with a tabIndex value of 1 precedes an object with a tabIndex value of 2. If two objects have the same tabIndex value, the one that comes first in the default tab ordering precedes the other.

The default value is -1.

Draws a visual focus indicator.

This method is called by the focus manager when the component receives focus. The component should draw or hide a graphic that indicates that the component has focus.

Parameters

Sets focus for a component.

This method is called by the focus manager when the component receives focus. The component may in turn set focus to an internal component.