Flash 8 Documentation

Components Language Reference > FocusManager class > FocusManager class (API)

FocusManager class (API)

Inheritance MovieClip > UIObject class > UIComponent class > FocusManager

ActionScript Class Name mx.managers.FocusManager

You can use the Focus Manager to specify the order in which components receive focus when a user presses the Tab key to navigate in an application. You can also use the FocusManager class to set a button in your document that receives keyboard input when a user presses Enter (Windows) or Return (Macintosh).

TIP

In a class file that inherits from UIComponent, it is not good practice to refer to _root.focusManager. Every UIComponent instance inherits a getFocusManager() method, which returns a reference to the FocusManager instance responsible for controlling that component's focus scheme.

Method summary for the FocusManager class

The following table lists the methods of the FocusManager class.

Method	Description
FocusManager.getFocus()	Returns a reference to the object that has focus.
FocusManager.sendDefaultPushButtonEvent()	Sends a `click` event to listener objects registered to the default push button.
FocusManager.setFocus()	Sets focus to the specified object.

Methods inherited from the UIObject class

The following table lists the methods the FocusManager class inherits from the UIObject class.

Method	Description
UIObject.createClassObject()	Creates an object on the specified class.
UIObject.createObject()	Creates a subobject on an object.
UIObject.destroyObject()	Destroys a component instance.
UIObject.doLater()	Calls a function when parameters have been set in the Property and Component inspectors.
UIObject.getStyle()	Gets the style property from the style declaration or object.
UIObject.invalidate()	Marks the object so it is redrawn on the next frame interval.
UIObject.move()	Moves the object to the requested position.
UIObject.redraw()	Forces validation of the object so it is drawn in the current frame.
UIObject.setSize()	Resizes the object to the requested size.
UIObject.setSkin()	Sets a skin in the object.
UIObject.setStyle()	Sets the style property on the style declaration or object.

Methods inherited from the UIComponent class

The following table lists the methods the FocusManager class inherits from the UIComponent class.

Method	Description
UIComponent.getFocus()	Returns a reference to the object that has focus.
UIComponent.setFocus()	Sets focus to the component instance.

Property summary for the FocusManager class

The following table lists the properties of the FocusManager class.

Property	Description
FocusManager.defaultPushButton	The object that receives a `click` event when a user presses the Return or Enter key.
FocusManager.defaultPushButtonEnabled	Indicates whether keyboard handling for the default push button is turned on (`true`) or off (`false`). The default value is `true.`
FocusManager.enabled	Indicates whether tab handling is turned on (`true`) or off (`false`). The default value is `true`.
FocusManager.nextTabIndex	The next value of the `tabIndex` property.

Properties inherited from the UIObject class

The following table lists the properties the FocusManager class inherits from the UIObject class.

Property	Description
UIObject.bottom	The position of the bottom edge of the object, relative to the bottom edge of its parent. Read-only.
UIObject.height	The height of the object, in pixels. Read-only.
UIObject.left	The left edge of the object, in pixels. Read-only.
UIObject.right	The position of the right edge of the object, relative to the right edge of its parent. Read-only.
UIObject.scaleX	A number indicating the scaling factor in the x direction of the object, relative to its parent.
UIObject.scaleY	A number indicating the scaling factor in the y direction of the object, relative to its parent.
UIObject.top	The position of the top edge of the object, relative to its parent. Read-only.
UIObject.visible	A Boolean value indicating whether the object is visible (`true`) or not (`false`).
UIObject.width	The width of the object, in pixels. Read-only.
UIObject.x	The left edge of the object, in pixels. Read-only.
UIObject.y	The top edge of the object, in pixels. Read-only.

Properties inherited from the UIComponent class

The following table lists the properties the FocusManager class inherits from the UIComponent class.

Property	Description
UIComponent.enabled	Indicates whether the component can receive focus and input.
UIComponent.tabIndex	A number indicating the tab order for a component in a document.

Event summary for the FocusManager class

There are no events exclusive to the FocusManager class.

Events inherited from the UIObject class

The following table lists the events the FocusManager class inherits from the UIObject class.

Event	Description
UIObject.draw	Broadcast when an object is about to draw its graphics.
UIObject.hide	Broadcast when an object's state changes from visible to invisible.
UIObject.load	Broadcast when subobjects are being created.
UIObject.move	Broadcast when the object has moved.
UIObject.resize	Broadcast when an object has been resized.
UIObject.reveal	Broadcast when an object's state changes from invisible to visible.
UIObject.unload	Broadcast when the subobjects are being unloaded.

Events inherited from the UIComponent class

The following table lists the events the FocusManager class inherits from the UIComponent class.

Event	Description
UIComponent.focusIn	Broadcast when an object receives focus.
UIComponent.focusOut	Broadcast when an object loses focus.
UIComponent.keyDown	Broadcast when a key is pressed.
UIComponent.keyUp	Broadcast when a key is released.

Version 8

Send me an e-mail when comments are added to this page | Comment Report

Current page: http://livedocs.adobe.com/flash/8/main/00003660.html