java.lang.Object | ||
↳ | java.awt.KeyboardFocusManager | |
↳ | java.awt.DefaultKeyboardFocusManager |
Known Direct Subclasses |
Known Indirect Subclasses |
The default KeyboardFocusManager for AWT applications. Focus traversal is done in response to a Component's focus traversal keys, and using a Container's FocusTraversalPolicy.
Please see How to Use the Focus Subsystem, a section in The Java Tutorial, and the Focus Specification for more information.
[Expand]
Inherited Constants | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
java.awt.KeyboardFocusManager
|
Public Constructors | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
This method is called by the AWT event dispatcher requesting that the
current KeyboardFocusManager dispatch the specified event on its behalf.
| |||||||||||
Called by
dispatchEvent if no other
KeyEventDispatcher in the dispatcher chain dispatched the KeyEvent, or
if no other KeyEventDispatchers are registered. | |||||||||||
Moves the focus down one focus traversal cycle.
| |||||||||||
Focuses the Component after aComponent, typically based on a
FocusTraversalPolicy.
| |||||||||||
Focuses the Component before aComponent, typically based on a
FocusTraversalPolicy.
| |||||||||||
This method will be called by
dispatchKeyEvent . | |||||||||||
This method initiates a focus traversal operation if and only if the
KeyEvent represents a focus traversal key for the specified
focusedComponent.
| |||||||||||
Moves the focus up one focus traversal cycle.
|
Protected Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Releases for normal dispatching to the current focus owner all
KeyEvents which were enqueued because of a call to
enqueueKeyEvents with the same timestamp and Component. | |||||||||||
Discards all KeyEvents which were enqueued because of one or more calls
to
enqueueKeyEvents with the specified Component, or one of
its descendants. | |||||||||||
Delays dispatching of KeyEvents until the specified Component becomes
the focus owner.
|
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
java.awt.KeyboardFocusManager
| |||||||||||
From class
java.lang.Object
| |||||||||||
From interface
java.awt.KeyEventDispatcher
| |||||||||||
From interface
java.awt.KeyEventPostProcessor
|
This method is called by the AWT event dispatcher requesting that the
current KeyboardFocusManager dispatch the specified event on its behalf.
DefaultKeyboardFocusManagers dispatch all FocusEvents, all WindowEvents
related to focus, and all KeyEvents. These events are dispatched based
on the KeyboardFocusManager's notion of the focus owner and the focused
and active Windows, sometimes overriding the source of the specified
AWTEvent. If this method returns false
, then the AWT event
dispatcher will attempt to dispatch the event itself.
e | the AWTEvent to be dispatched |
---|
true
if this method dispatched the event;
false
otherwise
Called by dispatchEvent
if no other
KeyEventDispatcher in the dispatcher chain dispatched the KeyEvent, or
if no other KeyEventDispatchers are registered. If the event has not
been consumed, its target is enabled, and the focus owner is not null,
this method dispatches the event to its target. This method will also
subsequently dispatch the event to all registered
KeyEventPostProcessors. After all this operations are finished,
the event is passed to peers for processing.
In all cases, this method returns true
, since
DefaultKeyboardFocusManager is designed so that neither
dispatchEvent
, nor the AWT event dispatcher, should take
further action on the event in any situation.
e | the KeyEvent to be dispatched |
---|
true
Moves the focus down one focus traversal cycle. If aContainer is a focus cycle root, then the focus owner is set to aContainer's default Component to focus, and the current focus cycle root is set to aContainer. If aContainer is not a focus cycle root, then no focus traversal operation occurs.
aContainer | the Container that is the basis for the focus traversal operation |
---|
Focuses the Component after aComponent, typically based on a FocusTraversalPolicy.
aComponent | the Component that is the basis for the focus traversal operation |
---|
Focuses the Component before aComponent, typically based on a FocusTraversalPolicy.
aComponent | the Component that is the basis for the focus traversal operation |
---|
This method will be called by dispatchKeyEvent
. It will
handle any unconsumed KeyEvents that map to an AWT
MenuShortcut
by consuming the event and activating the
shortcut.
e | the KeyEvent to post-process |
---|
true
This method initiates a focus traversal operation if and only if the KeyEvent represents a focus traversal key for the specified focusedComponent. It is expected that focusedComponent is the current focus owner, although this need not be the case. If it is not, focus traversal will nevertheless proceed as if focusedComponent were the focus owner.
focusedComponent | the Component that is the basis for a focus traversal operation if the specified event represents a focus traversal key for the Component |
---|---|
e | the event that may represent a focus traversal key |
Moves the focus up one focus traversal cycle. Typically, the focus owner is set to aComponent's focus cycle root, and the current focus cycle root is set to the new focus owner's focus cycle root. If, however, aComponent's focus cycle root is a Window, then the focus owner is set to the focus cycle root's default Component to focus, and the current focus cycle root is unchanged.
aComponent | the Component that is the basis for the focus traversal operation |
---|
Releases for normal dispatching to the current focus owner all
KeyEvents which were enqueued because of a call to
enqueueKeyEvents
with the same timestamp and Component.
If the given timestamp is less than zero, the outstanding enqueue
request for the given Component with the oldest timestamp (if
any) should be cancelled.
after | the timestamp specified in the call to
enqueueKeyEvents , or any value < 0 |
---|---|
untilFocused | the Component specified in the call to
enqueueKeyEvents |
Discards all KeyEvents which were enqueued because of one or more calls
to enqueueKeyEvents
with the specified Component, or one of
its descendants.
comp | the Component specified in one or more calls to
enqueueKeyEvents , or a parent of such a Component |
---|
Delays dispatching of KeyEvents until the specified Component becomes
the focus owner. KeyEvents with timestamps later than the specified
timestamp will be enqueued until the specified Component receives a
FOCUS_GAINED event, or the AWT cancels the delay request by invoking
dequeueKeyEvents
or discardKeyEvents
.
after | timestamp of current event, or the current, system time if the current event has no timestamp, or the AWT cannot determine which event is currently being handled |
---|---|
untilFocused | Component which will receive a FOCUS_GAINED event before any pending KeyEvents |