Adds a KeyEventDispatcher to this KeyboardFocusManager's dispatcher chain.

  Adds a KeyEventDispatcher to this KeyboardFocusManager's dispatcher chain. This KeyboardFocusManager will request that each KeyEventDispatcher dispatch KeyEvents generated by the user before finally dispatching the KeyEvent itself. KeyEventDispatchers will be notified in the order in which they were added. Notifications will halt as soon as one KeyEventDispatcher returns true from its dispatchKeyEvent method. There is no limit to the total number of KeyEventDispatchers which can be added, nor to the number of times which a particular KeyEventDispatcher instance can be added.

If a null dispatcher is specified, no action is taken and no exception is thrown.

In a multithreaded application, KeyEventDispatcher behaves the same as other AWT listeners. See AWT Threading Issues for more details.
Parameters:
- dispatcher - the KeyEventDispatcher to add to the dispatcher chain
See Also: KeyboardFocusManager.removeKeyEventDispatcher(java.awt.KeyEventDispatcher),

  Adds a KeyEventPostProcessor to this KeyboardFocusManager's post- processor chain.

  Adds a KeyEventPostProcessor to this KeyboardFocusManager's post- processor chain. After a KeyEvent has been dispatched to and handled by its target, KeyboardFocusManager will request that each KeyEventPostProcessor perform any necessary post-processing as part of the KeyEvent's final resolution. KeyEventPostProcessors will be notified in the order in which they were added; the current KeyboardFocusManager will be notified last. Notifications will halt as soon as one KeyEventPostProcessor returns true from its postProcessKeyEvent method. There is no limit to the the total number of KeyEventPostProcessors that can be added, nor to the number of times that a particular KeyEventPostProcessor instance can be added.

If a null post-processor is specified, no action is taken and no exception is thrown.

In a multithreaded application, KeyEventPostProcessor behaves the same as other AWT listeners. See AWT Threading Issues for more details.
Parameters:
- processor - the KeyEventPostProcessor to add to the post-processor chain
See Also: KeyboardFocusManager.removeKeyEventPostProcessor(java.awt.KeyEventPostProcessor),

  Adds a PropertyChangeListener to the listener list.

  Adds a PropertyChangeListener to the listener list. The listener is
registered for all bound properties of this class, including the
following:

• whether the KeyboardFocusManager is currently managing focus
  for this application or applet's browser context
  ("managingFocus")


• the focus owner ("focusOwner")


• the permanent focus owner ("permanentFocusOwner")


• the focused Window ("focusedWindow")


• the active Window ("activeWindow")


• the default focus traversal policy
  ("defaultFocusTraversalPolicy")


• the Set of default FORWARD_TRAVERSAL_KEYS
  ("forwardDefaultFocusTraversalKeys")


• the Set of default BACKWARD_TRAVERSAL_KEYS
  ("backwardDefaultFocusTraversalKeys")


• the Set of default UP_CYCLE_TRAVERSAL_KEYS
  ("upCycleDefaultFocusTraversalKeys")


• the Set of default DOWN_CYCLE_TRAVERSAL_KEYS
  ("downCycleDefaultFocusTraversalKeys")


• the current focus cycle root ("currentFocusCycleRoot")

If listener is null, no exception is thrown and no action is performed.
Parameters:
- listener - the PropertyChangeListener to be added
See Also: KeyboardFocusManager.removePropertyChangeListener(java.beans.PropertyChangeListener), KeyboardFocusManager.getPropertyChangeListeners(), KeyboardFocusManager.addPropertyChangeListener(java.lang.String,java.beans.PropertyChangeListener),

  Adds a PropertyChangeListener to the listener list for a specific property.

  Adds a PropertyChangeListener to the listener list for a specific
property. The specified property may be user-defined, or one of the
following:

• whether the KeyboardFocusManager is currently managing focus
  for this application or applet's browser context
  ("managingFocus")


• the focus owner ("focusOwner")


• the permanent focus owner ("permanentFocusOwner")


• the focused Window ("focusedWindow")


• the active Window ("activeWindow")


• the default focus traversal policy
  ("defaultFocusTraversalPolicy")


• the Set of default FORWARD_TRAVERSAL_KEYS
  ("forwardDefaultFocusTraversalKeys")


• the Set of default BACKWARD_TRAVERSAL_KEYS
  ("backwardDefaultFocusTraversalKeys")


• the Set of default UP_CYCLE_TRAVERSAL_KEYS
  ("upCycleDefaultFocusTraversalKeys")


• the Set of default DOWN_CYCLE_TRAVERSAL_KEYS
  ("downCycleDefaultFocusTraversalKeys")


• the current focus cycle root ("currentFocusCycleRoot")

If listener is null, no exception is thrown and no action is performed.
Parameters:
- propertyName - one of the property names listed above
- listener - the PropertyChangeListener to be added
See Also: KeyboardFocusManager.addPropertyChangeListener(java.beans.PropertyChangeListener), KeyboardFocusManager.removePropertyChangeListener(java.lang.String,java.beans.PropertyChangeListener), KeyboardFocusManager.getPropertyChangeListeners(java.lang.String),

  Adds a VetoableChangeListener to the listener list for a specific property.

  Adds a VetoableChangeListener to the listener list for a specific
property. The specified property may be user-defined, or one of the
following:

• the focus owner ("focusOwner")


• the permanent focus owner ("permanentFocusOwner")


• the focused Window ("focusedWindow")


• the active Window ("activeWindow")

If listener is null, no exception is thrown and no action is performed.
Parameters:
- propertyName - one of the property names listed above
- listener - the VetoableChangeListener to be added
See Also: KeyboardFocusManager.addVetoableChangeListener(java.beans.VetoableChangeListener), KeyboardFocusManager.removeVetoableChangeListener(java.beans.VetoableChangeListener), KeyboardFocusManager.getVetoableChangeListeners(),

  Adds a VetoableChangeListener to the listener list.

  Adds a VetoableChangeListener to the listener list. The listener is
registered for all vetoable properties of this class, including the
following:

• the focus owner ("focusOwner")


• the permanent focus owner ("permanentFocusOwner")


• the focused Window ("focusedWindow")


• the active Window ("activeWindow")

If listener is null, no exception is thrown and no action is performed.
Parameters:
- listener - the VetoableChangeListener to be added
See Also: KeyboardFocusManager.removeVetoableChangeListener(java.beans.VetoableChangeListener), KeyboardFocusManager.getVetoableChangeListeners(), KeyboardFocusManager.addVetoableChangeListener(java.lang.String,java.beans.VetoableChangeListener),

  Clears the global focus owner at both the Java and native levels.

  Clears the global focus owner at both the Java and native levels. If
there exists a focus owner, that Component will receive a permanent
FOCUS_LOST event. After this operation completes, the native windowing
system will discard all user-generated KeyEvents until the user selects
a new Component to receive focus, or a Component is given focus
explicitly via a call to requestFocus(). This operation
does not change the focused or active Windows.
See Also: Component.requestFocus(), FocusEvent.FOCUS_LOST,

  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.

  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.
Parameters:
- after - the timestamp specified in the call to enqueueKeyEvents, or any value < 0
- untilFocused - the Component specified in the call to enqueueKeyEvents
See Also: DefaultKeyboardFocusManager.enqueueKeyEvents(long, java.awt.Component), DefaultKeyboardFocusManager.discardKeyEvents(java.awt.Component),

  Discards all KeyEvents which were enqueued because of one or more calls to enqueueKeyEvents with the specified Component, or one of its descendants.

  Discards all KeyEvents which were enqueued because of one or more calls
to enqueueKeyEvents with the specified Component, or one of
its descendants.
Parameters:
- comp - the Component specified in one or more calls to enqueueKeyEvents, or a parent of such a Component
See Also: DefaultKeyboardFocusManager.enqueueKeyEvents(long, java.awt.Component), DefaultKeyboardFocusManager.dequeueKeyEvents(long, java.awt.Component),

  This method is called by the AWT event dispatcher requesting that the current KeyboardFocusManager dispatch the specified event on its behalf.

  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.
Returns: true if this method dispatched the event; false otherwise
Parameters:
- e - the AWTEvent to be dispatched

  Called by dispatchEvent if no other KeyEventDispatcher in the dispatcher chain dispatched the KeyEvent, or if no other KeyEventDispatchers are registered.

  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.
Returns: true
Parameters:
- e - the KeyEvent to be dispatched
See Also: Component.dispatchEvent(java.awt.AWTEvent),

  Moves the focus down one focus traversal cycle from the current focus owner, if and only if the current focus owner is a Container that is a focus cycle root.

  Moves the focus down one focus traversal cycle from the current focus
owner, if and only if the current focus owner is a Container that is a
focus cycle root. Typically, the focus owner is set to the current focus
owner's default Component to focus, and the current focus cycle root is
set to the current focus owner. If the current focus owner is not a
Container that is a focus cycle root, then no focus traversal operation
occurs.

  Moves the focus down one focus traversal cycle.

  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.
Parameters:
- aContainer - the Container that is the basis for the focus traversal operation
See Also: Container.transferFocusDownCycle(),

  Delays dispatching of KeyEvents until the specified Component becomes the focus owner.

  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.
Parameters:
- 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
See Also: DefaultKeyboardFocusManager.dequeueKeyEvents(long, java.awt.Component), DefaultKeyboardFocusManager.discardKeyEvents(java.awt.Component),

  Fires a PropertyChangeEvent in response to a change in a bound property.

  Fires a PropertyChangeEvent in response to a change in a bound property.
The event will be delivered to all registered PropertyChangeListeners.
No event will be delivered if oldValue and newValue are the same.
Parameters:
- propertyName - the name of the property that has changed
- oldValue - the property's previous value
- newValue - the property's new value

  Fires a PropertyChangeEvent in response to a change in a vetoable property.

  Fires a PropertyChangeEvent in response to a change in a vetoable
property. The event will be delivered to all registered
VetoableChangeListeners. If a VetoableChangeListener throws a
PropertyVetoException, a new event is fired reverting all
VetoableChangeListeners to the old value and the exception is then
rethrown. No event will be delivered if oldValue and newValue are the
same.
Parameters:
- propertyName - the name of the property that has changed
- oldValue - the property's previous value
- newValue - the property's new value
Throws:
- java.beans.PropertyVetoException - if a VetoableChangeListener threw PropertyVetoException

Focuses the Component after the current focus owner.

  Focuses the Component after aComponent, typically based on a FocusTraversalPolicy.

  Focuses the Component after aComponent, typically based on a
FocusTraversalPolicy.
Parameters:
- aComponent - the Component that is the basis for the focus traversal operation
See Also: FocusTraversalPolicy, Component.transferFocus(),

Focuses the Component before the current focus owner.

  Focuses the Component before aComponent, typically based on a FocusTraversalPolicy.

  Focuses the Component before aComponent, typically based on a
FocusTraversalPolicy.
Parameters:
- aComponent - the Component that is the basis for the focus traversal operation
See Also: FocusTraversalPolicy, Component.transferFocusBackward(),

  Returns the active Window, if the active Window is in the same context as the calling thread.

  Returns the active Window, if the active Window is in the same context
as the calling thread. Only a Frame or a Dialog can be the active
Window. The native windowing system may denote the active Window or its
children with special decorations, such as a highlighted title bar.
The active Window is always either the focused Window, or the first
Frame or Dialog that is an owner of the focused Window.
Returns: the active Window, or null if the active Window is not a member of the calling thread's context
See Also: KeyboardFocusManager.getGlobalActiveWindow(), KeyboardFocusManager.setGlobalActiveWindow(java.awt.Window),

  Returns the current focus cycle root, if the current focus cycle root is in the same context as the calling thread.

  Returns the current focus cycle root, if the current focus cycle root is in the same context as the calling thread. If the focus owner is itself a focus cycle root, then it may be ambiguous as to which Components represent the next and previous Components to focus during normal focus traversal. In that case, the current focus cycle root is used to differentiate among the possibilities.

This method is intended to be used only by KeyboardFocusManagers and focus implementations. It is not for general client use.
Returns: the current focus cycle root, or null if the current focus cycle root is not a member of the calling thread's context
See Also: KeyboardFocusManager.getGlobalCurrentFocusCycleRoot(), KeyboardFocusManager.setGlobalCurrentFocusCycleRoot(java.awt.Container),

  Returns the current KeyboardFocusManager instance for the calling thread's context.

  Returns the current KeyboardFocusManager instance for the calling
thread's context.
Returns: this thread's context's KeyboardFocusManager
See Also: KeyboardFocusManager.setCurrentKeyboardFocusManager(java.awt.KeyboardFocusManager),

  Returns a Set of default focus traversal keys for a given traversal operation.

  Returns a Set of default focus traversal keys for a given traversal
operation. This traversal key Set will be in effect on all Windows that
have no such Set of their own explicitly defined. This Set will also be
inherited, recursively, by any child Component of those Windows that has
no such Set of its own explicitly defined. (See
setDefaultFocusTraversalKeys for a full description of each
operation.)
Returns: the Set of AWTKeyStrokes for the specified operation; the Set will be unmodifiable, and may be empty; null will never be returned
Parameters:
- id - one of KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS, KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS, or KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS
Throws:
- IllegalArgumentException - if id is not one of KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS, KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS, or KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS
See Also: KeyboardFocusManager.setDefaultFocusTraversalKeys(int, java.util.Set), Component.setFocusTraversalKeys(int, java.util.Set), Component.getFocusTraversalKeys(int),

  Returns the default FocusTraversalPolicy.

  Returns the default FocusTraversalPolicy. Top-level components
use this value on their creation to initialize their own focus traversal
policy by explicit call to Container.setFocusTraversalPolicy.
Returns: the default FocusTraversalPolicy. null will never be returned.
See Also: KeyboardFocusManager.setDefaultFocusTraversalPolicy(java.awt.FocusTraversalPolicy), Container.setFocusTraversalPolicy(java.awt.FocusTraversalPolicy), Container.getFocusTraversalPolicy(),

  Returns the focused Window, if the focused Window is in the same context as the calling thread.

  Returns the focused Window, if the focused Window is in the same context
as the calling thread. The focused Window is the Window that is or
contains the focus owner.
Returns: the focused Window, or null if the focused Window is not a member of the calling thread's context
See Also: KeyboardFocusManager.getGlobalFocusedWindow(), KeyboardFocusManager.setGlobalFocusedWindow(java.awt.Window),

  Returns the focus owner, if the focus owner is in the same context as the calling thread.

  Returns the focus owner, if the focus owner is in the same context as
the calling thread. The focus owner is defined as the Component in an
application that will typically receive all KeyEvents generated by the
user. KeyEvents which map to the focus owner's focus traversal keys will
not be delivered if focus traversal keys are enabled for the focus
owner. In addition, KeyEventDispatchers may retarget or consume
KeyEvents before they reach the focus owner.
Returns: the focus owner, or null if the focus owner is not a member of the calling thread's context
See Also: KeyboardFocusManager.getGlobalFocusOwner(), KeyboardFocusManager.setGlobalFocusOwner(java.awt.Component),

  Returns the active Window, even if the calling thread is in a different context than the active Window.

  Returns the active Window, even if the calling thread is in a different context than the active Window. Only a Frame or a Dialog can be the active Window. The native windowing system may denote the active Window or its children with special decorations, such as a highlighted title bar. The active Window is always either the focused Window, or the first Frame or Dialog that is an owner of the focused Window.

This method will throw a SecurityException if this KeyboardFocusManager is not the current KeyboardFocusManager for the calling thread's context.
Returns: the active Window
Throws:
- SecurityException - if this KeyboardFocusManager is not the current KeyboardFocusManager for the calling thread's context
See Also: KeyboardFocusManager.getActiveWindow(), KeyboardFocusManager.setGlobalActiveWindow(java.awt.Window),

  Returns the current focus cycle root, even if the calling thread is in a different context than the current focus cycle root.

  Returns the current focus cycle root, even if the calling thread is in a different context than the current focus cycle root. If the focus owner is itself a focus cycle root, then it may be ambiguous as to which Components represent the next and previous Components to focus during normal focus traversal. In that case, the current focus cycle root is used to differentiate among the possibilities.

This method will throw a SecurityException if this KeyboardFocusManager is not the current KeyboardFocusManager for the calling thread's context.
Returns: the current focus cycle root, or null if the current focus cycle root is not a member of the calling thread's context
Throws:
- SecurityException - if this KeyboardFocusManager is not the current KeyboardFocusManager for the calling thread's context
See Also: KeyboardFocusManager.getCurrentFocusCycleRoot(), KeyboardFocusManager.setGlobalCurrentFocusCycleRoot(java.awt.Container),

  Returns the focused Window, even if the calling thread is in a different context than the focused Window.

  Returns the focused Window, even if the calling thread is in a different context than the focused Window. The focused Window is the Window that is or contains the focus owner.

This method will throw a SecurityException if this KeyboardFocusManager is not the current KeyboardFocusManager for the calling thread's context.
Returns: the focused Window
Throws:
- SecurityException - if this KeyboardFocusManager is not the current KeyboardFocusManager for the calling thread's context
See Also: KeyboardFocusManager.getFocusedWindow(), KeyboardFocusManager.setGlobalFocusedWindow(java.awt.Window),

  Returns the focus owner, even if the calling thread is in a different context than the focus owner.

  Returns the focus owner, even if the calling thread is in a different context than the focus owner. The focus owner is defined as the Component in an application that will typically receive all KeyEvents generated by the user. KeyEvents which map to the focus owner's focus traversal keys will not be delivered if focus traversal keys are enabled for the focus owner. In addition, KeyEventDispatchers may retarget or consume KeyEvents before they reach the focus owner.

This method will throw a SecurityException if this KeyboardFocusManager is not the current KeyboardFocusManager for the calling thread's context.
Returns: the focus owner
Throws:
- SecurityException - if this KeyboardFocusManager is not the current KeyboardFocusManager for the calling thread's context
See Also: KeyboardFocusManager.getFocusOwner(), KeyboardFocusManager.setGlobalFocusOwner(java.awt.Component),

  Returns the permanent focus owner, even if the calling thread is in a different context than the permanent focus owner.

  Returns the permanent focus owner, even if the calling thread is in a different context than the permanent focus owner. The permanent focus owner is defined as the last Component in an application to receive a permanent FOCUS_GAINED event. The focus owner and permanent focus owner are equivalent unless a temporary focus change is currently in effect. In such a situation, the permanent focus owner will again be the focus owner when the temporary focus change ends.

This method will throw a SecurityException if this KeyboardFocusManager is not the current KeyboardFocusManager for the calling thread's context.
Returns: the permanent focus owner
Throws:
- SecurityException - if this KeyboardFocusManager is not the current KeyboardFocusManager for the calling thread's context
See Also: KeyboardFocusManager.getPermanentFocusOwner(), KeyboardFocusManager.setGlobalPermanentFocusOwner(java.awt.Component),

  Returns this KeyboardFocusManager's KeyEventDispatcher chain as a List.

  Returns this KeyboardFocusManager's KeyEventDispatcher chain as a List.
The List will not include this KeyboardFocusManager unless it was
explicitly re-registered via a call to
addKeyEventDispatcher. If no other KeyEventDispatchers are
registered, implementations are free to return null or a List of length
0. Client code should not assume one behavior over another, nor should
it assume that the behavior, once established, will not change.
Returns: a possibly null or empty List of KeyEventDispatchers
See Also: KeyboardFocusManager.addKeyEventDispatcher(java.awt.KeyEventDispatcher), KeyboardFocusManager.removeKeyEventDispatcher(java.awt.KeyEventDispatcher),

  Returns this KeyboardFocusManager's KeyEventPostProcessor chain as a List.

  Returns this KeyboardFocusManager's KeyEventPostProcessor chain as a
List. The List will not include this KeyboardFocusManager unless it was
explicitly added via a call to addKeyEventPostProcessor. If
no KeyEventPostProcessors are registered, implementations are free to
return null or a List of length 0. Client code should not assume one
behavior over another, nor should it assume that the behavior, once
established, will not change.
Returns: a possibly null or empty List of KeyEventPostProcessors
See Also: KeyboardFocusManager.addKeyEventPostProcessor(java.awt.KeyEventPostProcessor), KeyboardFocusManager.removeKeyEventPostProcessor(java.awt.KeyEventPostProcessor),

  Returns the permanent focus owner, if the permanent focus owner is in the same context as the calling thread.

  Returns the permanent focus owner, if the permanent focus owner is in
the same context as the calling thread. The permanent focus owner is
defined as the last Component in an application to receive a permanent
FOCUS_GAINED event. The focus owner and permanent focus owner are
equivalent unless a temporary focus change is currently in effect. In
such a situation, the permanent focus owner will again be the focus
owner when the temporary focus change ends.
Returns: the permanent focus owner, or null if the permanent focus owner is not a member of the calling thread's context
See Also: KeyboardFocusManager.getGlobalPermanentFocusOwner(), KeyboardFocusManager.setGlobalPermanentFocusOwner(java.awt.Component),

  Returns an array of all the property change listeners registered on this keyboard focus manager.

  Returns an array of all the property change listeners
registered on this keyboard focus manager.
Returns: all of this keyboard focus manager's PropertyChangeListeners or an empty array if no property change listeners are currently registered
Since: 1.4
See Also: KeyboardFocusManager.addPropertyChangeListener(java.beans.PropertyChangeListener), KeyboardFocusManager.removePropertyChangeListener(java.beans.PropertyChangeListener), KeyboardFocusManager.getPropertyChangeListeners(java.lang.String),

  Returns an array of all the PropertyChangeListeners associated with the named property.

  Returns an array of all the PropertyChangeListeners
associated with the named property.
Returns: all of the PropertyChangeListeners associated with the named property or an empty array if no such listeners have been added.
Since: 1.4
See Also: KeyboardFocusManager.addPropertyChangeListener(java.lang.String,java.beans.PropertyChangeListener), KeyboardFocusManager.removePropertyChangeListener(java.lang.String,java.beans.PropertyChangeListener),

  Returns an array of all the vetoable change listeners registered on this keyboard focus manager.

  Returns an array of all the vetoable change listeners
registered on this keyboard focus manager.
Returns: all of this keyboard focus manager's VetoableChangeListeners or an empty array if no vetoable change listeners are currently registered
Since: 1.4
See Also: KeyboardFocusManager.addVetoableChangeListener(java.beans.VetoableChangeListener), KeyboardFocusManager.removeVetoableChangeListener(java.beans.VetoableChangeListener), KeyboardFocusManager.getVetoableChangeListeners(java.lang.String),

  Returns an array of all the VetoableChangeListeners associated with the named property.

  Returns an array of all the VetoableChangeListeners
associated with the named property.
Returns: all of the VetoableChangeListeners associated with the named property or an empty array if no such listeners have been added.
Since: 1.4
See Also: KeyboardFocusManager.addVetoableChangeListener(java.lang.String,java.beans.VetoableChangeListener), KeyboardFocusManager.removeVetoableChangeListener(java.lang.String,java.beans.VetoableChangeListener), KeyboardFocusManager.getVetoableChangeListeners(),

  This method will be called by dispatchKeyEvent.

  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.
Returns: true
Parameters:
- e - the KeyEvent to post-process
See Also: DefaultKeyboardFocusManager.dispatchKeyEvent(java.awt.event.KeyEvent), MenuShortcut,

  This method initiates a focus traversal operation if and only if the KeyEvent represents a focus traversal key for the specified focusedComponent.

  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.
Parameters:
- 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

  Redispatches an AWTEvent in such a way that the AWT event dispatcher will not recursively request that the KeyboardFocusManager, or any installed KeyEventDispatchers, dispatch the event again.

  Redispatches an AWTEvent in such a way that the AWT event dispatcher will not recursively request that the KeyboardFocusManager, or any installed KeyEventDispatchers, dispatch the event again. Client implementations of dispatchEvent and client-defined KeyEventDispatchers must call redispatchEvent(target, e) instead of target.dispatchEvent(e) to dispatch an event.

This method is intended to be used only by KeyboardFocusManagers and KeyEventDispatchers. It is not for general client use.
Parameters:
- target - the Component to which the event should be dispatched
- e - the event to dispatch
See Also: KeyboardFocusManager.dispatchEvent(java.awt.AWTEvent), KeyEventDispatcher,

  Removes a KeyEventDispatcher which was previously added to this KeyboardFocusManager's dispatcher chain.

  Removes a KeyEventDispatcher which was previously added to this KeyboardFocusManager's dispatcher chain. This KeyboardFocusManager cannot itself be removed, unless it was explicitly re-registered via a call to addKeyEventDispatcher.

If a null dispatcher is specified, if the specified dispatcher is not in the dispatcher chain, or if this KeyboardFocusManager is specified without having been explicitly re-registered, no action is taken and no exception is thrown.

In a multithreaded application, KeyEventDispatcher behaves the same as other AWT listeners. See AWT Threading Issues for more details.
Parameters:
- dispatcher - the KeyEventDispatcher to remove from the dispatcher chain
See Also: KeyboardFocusManager.addKeyEventDispatcher(java.awt.KeyEventDispatcher),

  Removes a previously added KeyEventPostProcessor from this KeyboardFocusManager's post-processor chain.

  Removes a previously added KeyEventPostProcessor from this KeyboardFocusManager's post-processor chain. This KeyboardFocusManager cannot itself be entirely removed from the chain. Only additional references added via addKeyEventPostProcessor can be removed.

If a null post-processor is specified, if the specified post-processor is not in the post-processor chain, or if this KeyboardFocusManager is specified without having been explicitly added, no action is taken and no exception is thrown.

In a multithreaded application, KeyEventPostProcessor behaves the same as other AWT listeners. See AWT Threading Issues for more details.
Parameters:
- processor - the KeyEventPostProcessor to remove from the post- processor chain
See Also: KeyboardFocusManager.addKeyEventPostProcessor(java.awt.KeyEventPostProcessor),

  Removes a PropertyChangeListener from the listener list.

  Removes a PropertyChangeListener from the listener list. This method should be used to remove the PropertyChangeListeners that were registered for all bound properties of this class.

If listener is null, no exception is thrown and no action is performed.
Parameters:
- listener - the PropertyChangeListener to be removed
See Also: KeyboardFocusManager.addPropertyChangeListener(java.beans.PropertyChangeListener), KeyboardFocusManager.getPropertyChangeListeners(), KeyboardFocusManager.removePropertyChangeListener(java.lang.String,java.beans.PropertyChangeListener),

  Removes a PropertyChangeListener from the listener list for a specific property.

  Removes a PropertyChangeListener from the listener list for a specific property. This method should be used to remove PropertyChangeListeners that were registered for a specific bound property.

If listener is null, no exception is thrown and no action is performed.
Parameters:
- propertyName - a valid property name
- listener - the PropertyChangeListener to be removed
See Also: KeyboardFocusManager.addPropertyChangeListener(java.lang.String,java.beans.PropertyChangeListener), KeyboardFocusManager.getPropertyChangeListeners(java.lang.String), KeyboardFocusManager.removePropertyChangeListener(java.beans.PropertyChangeListener),

  Removes a VetoableChangeListener from the listener list for a specific property.

  Removes a VetoableChangeListener from the listener list for a specific property. This method should be used to remove VetoableChangeListeners that were registered for a specific bound property.

If listener is null, no exception is thrown and no action is performed.
Parameters:
- propertyName - a valid property name
- listener - the VetoableChangeListener to be removed
See Also: KeyboardFocusManager.addVetoableChangeListener(java.beans.VetoableChangeListener), KeyboardFocusManager.getVetoableChangeListeners(), KeyboardFocusManager.removeVetoableChangeListener(java.beans.VetoableChangeListener),

  Removes a VetoableChangeListener from the listener list.

  Removes a VetoableChangeListener from the listener list. This method should be used to remove the VetoableChangeListeners that were registered for all vetoable properties of this class.

If listener is null, no exception is thrown and no action is performed.
Parameters:
- listener - the VetoableChangeListener to be removed
See Also: KeyboardFocusManager.addVetoableChangeListener(java.beans.VetoableChangeListener), KeyboardFocusManager.getVetoableChangeListeners(), KeyboardFocusManager.removeVetoableChangeListener(java.lang.String,java.beans.VetoableChangeListener),

  Sets the current KeyboardFocusManager instance for the calling thread's context.

  Sets the current KeyboardFocusManager instance for the calling thread's context. If null is specified, then the current KeyboardFocusManager is replaced with a new instance of DefaultKeyboardFocusManager.

If a SecurityManager is installed, the calling thread must be granted the AWTPermission "replaceKeyboardFocusManager" in order to replace the the current KeyboardFocusManager. If this permission is not granted, this method will throw a SecurityException, and the current KeyboardFocusManager will be unchanged.
Parameters:
- newManager - the new KeyboardFocusManager for this thread's context
Throws:
- SecurityException - if the calling thread does not have permission to replace the current KeyboardFocusManager
See Also: KeyboardFocusManager.getCurrentKeyboardFocusManager(), DefaultKeyboardFocusManager,

  Sets the default focus traversal keys for a given traversal operation.

  Sets the default focus traversal keys for a given traversal operation. This traversal key Set will be in effect on all Windows that have no such Set of their own explicitly defined. This Set will also be inherited, recursively, by any child Component of those Windows that has no such Set of its own explicitly defined.

The default values for the default focus traversal keys are implementation-dependent. Sun recommends that all implementations for a particular native platform use the same default values. The recommendations for Windows and Unix are listed below. These recommendations are used in the Sun AWT implementations.

Identifier	Meaning	Default
KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS	Normal forward keyboard traversal	TAB on KEY_PRESSED, CTRL-TAB on KEY_PRESSED
KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS	Normal reverse keyboard traversal	SHIFT-TAB on KEY_PRESSED, CTRL-SHIFT-TAB on KEY_PRESSED
KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS	Go up one focus traversal cycle	none
KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS	Go down one focus traversal cycle	none

To disable a traversal key, use an empty Set; Collections.EMPTY_SET is recommended.

Using the AWTKeyStroke API, client code can specify on which of two specific KeyEvents, KEY_PRESSED or KEY_RELEASED, the focus traversal operation will occur. Regardless of which KeyEvent is specified, however, all KeyEvents related to the focus traversal key, including the associated KEY_TYPED event, will be consumed, and will not be dispatched to any Component. It is a runtime error to specify a KEY_TYPED event as mapping to a focus traversal operation, or to map the same event to multiple default focus traversal operations.
Parameters:
- id - one of KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS, KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS, or KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS
- keystrokes - the Set of AWTKeyStrokes for the specified operation
Throws:
- IllegalArgumentException - if id is not one of KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS, KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS, or KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS, or if keystrokes is null, or if keystrokes contains null, or if any Object in keystrokes is not an AWTKeyStroke, or if any keystroke represents a KEY_TYPED event, or if any keystroke already maps to another default focus traversal operation
See Also: KeyboardFocusManager.getDefaultFocusTraversalKeys(int), Component.setFocusTraversalKeys(int, java.util.Set), Component.getFocusTraversalKeys(int),

  Sets the default FocusTraversalPolicy.

  Sets the default FocusTraversalPolicy. Top-level components
use this value on their creation to initialize their own focus traversal
policy by explicit call to Container.setFocusTraversalPolicy.
Note: this call doesn't affect already created components as they have
their policy initialized. Only new components will use this policy as
their default policy.
Parameters:
- defaultPolicy - the new, default FocusTraversalPolicy
Throws:
- IllegalArgumentException - if defaultPolicy is null
See Also: KeyboardFocusManager.getDefaultFocusTraversalPolicy(), Container.setFocusTraversalPolicy(java.awt.FocusTraversalPolicy), Container.getFocusTraversalPolicy(),

  Sets the active Window.

  Sets the active Window. Only a Frame or a Dialog can be the active Window. The native windowing system may denote the active Window or its children with special decorations, such as a highlighted title bar. The active Window is always either the focused Window, or the first Frame or Dialog that is an owner of the focused Window.

This method does not actually change the active Window as far as the native windowing system is concerned. It merely stores the value to be subsequently returned by getActiveWindow(). Use Component.requestFocus() or Component.requestFocusInWindow()to change the active Window, subject to platform limitations.
Parameters:
- activeWindow - the active Window
See Also: KeyboardFocusManager.getActiveWindow(), KeyboardFocusManager.getGlobalActiveWindow(), Component.requestFocus(), Component.requestFocusInWindow(),

  Sets the current focus cycle root.

  Sets the current focus cycle root. If the focus owner is itself a focus cycle root, then it may be ambiguous as to which Components represent the next and previous Components to focus during normal focus traversal. In that case, the current focus cycle root is used to differentiate among the possibilities.

This method is intended to be used only by KeyboardFocusManagers and focus implementations. It is not for general client use.
Parameters:
- newFocusCycleRoot - the new focus cycle root
See Also: KeyboardFocusManager.getCurrentFocusCycleRoot(), KeyboardFocusManager.getGlobalCurrentFocusCycleRoot(),

  Sets the focused Window.

  Sets the focused Window. The focused Window is the Window that is or contains the focus owner. The operation will be cancelled if the specified Window to focus is not a focusable Window.

This method does not actually change the focused Window as far as the native windowing system is concerned. It merely stores the value to be subsequently returned by getFocusedWindow(). Use Component.requestFocus() or Component.requestFocusInWindow() to change the focused Window, subject to platform limitations.
Parameters:
- focusedWindow - the focused Window
See Also: KeyboardFocusManager.getFocusedWindow(), KeyboardFocusManager.getGlobalFocusedWindow(), Component.requestFocus(), Component.requestFocusInWindow(), Window.isFocusableWindow(),

  Sets the focus owner.

  Sets the focus owner. The operation will be cancelled if the Component is not focusable. The focus owner is defined as the Component in an application that will typically receive all KeyEvents generated by the user. KeyEvents which map to the focus owner's focus traversal keys will not be delivered if focus traversal keys are enabled for the focus owner. In addition, KeyEventDispatchers may retarget or consume KeyEvents before they reach the focus owner.

This method does not actually set the focus to the specified Component. It merely stores the value to be subsequently returned by getFocusOwner(). Use Component.requestFocus() or Component.requestFocusInWindow() to change the focus owner, subject to platform limitations.
Parameters:
- focusOwner - the focus owner
See Also: KeyboardFocusManager.getFocusOwner(), KeyboardFocusManager.getGlobalFocusOwner(), Component.requestFocus(), Component.requestFocusInWindow(), Component.isFocusable(),

  Sets the permanent focus owner.

  Sets the permanent focus owner. The operation will be cancelled if the Component is not focusable. The permanent focus owner is defined as the last Component in an application to receive a permanent FOCUS_GAINED event. The focus owner and permanent focus owner are equivalent unless a temporary focus change is currently in effect. In such a situation, the permanent focus owner will again be the focus owner when the temporary focus change ends.

This method does not actually set the focus to the specified Component. It merely stores the value to be subsequently returned by getPermanentFocusOwner(). Use Component.requestFocus() or Component.requestFocusInWindow() to change the focus owner, subject to platform limitations.
Parameters:
- permanentFocusOwner - the permanent focus owner
See Also: KeyboardFocusManager.getPermanentFocusOwner(), KeyboardFocusManager.getGlobalPermanentFocusOwner(), Component.requestFocus(), Component.requestFocusInWindow(), Component.isFocusable(),

  Moves the focus up one focus traversal cycle from the current focus owner.

  Moves the focus up one focus traversal cycle from the current focus
owner. Typically, the new focus owner is set to the current focus
owner's focus cycle root, and the current focus cycle root is set to the
new focus owner's focus cycle root. If, however, the current focus
owner's focus cycle root is a Window, then typically the focus owner is
set to the focus cycle root's default Component to focus, and the
current focus cycle root is unchanged.

  Moves the focus up one focus traversal cycle.

  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.
Parameters:
- aComponent - the Component that is the basis for the focus traversal operation
See Also: Component.transferFocusUpCycle(),