FocusManager (Java Platform SE 6) (original) (raw)



javax.swing

Class FocusManager

java.lang.Object extended by java.awt.KeyboardFocusManager extended by java.awt.DefaultKeyboardFocusManager extended by javax.swing.FocusManager

All Implemented Interfaces:

KeyEventDispatcher, KeyEventPostProcessor

Direct Known Subclasses:

DefaultFocusManager


public abstract class FocusManager

extends DefaultKeyboardFocusManager

This class has been obsoleted by the 1.4 focus APIs. While client code may still use this class, developers are strongly encouraged to usejava.awt.KeyboardFocusManager andjava.awt.DefaultKeyboardFocusManager instead.

Please see How to Use the Focus Subsystem, a section in The Java Tutorial, and theFocus Specification for more information.

See Also:

Focus Specification


Field Summary
static String FOCUS_MANAGER_CLASS_PROPERTY This field is obsolete, and its use is discouraged since its specification is incompatible with the 1.4 focus APIs.
Fields inherited from class java.awt.KeyboardFocusManager
BACKWARD_TRAVERSAL_KEYS, DOWN_CYCLE_TRAVERSAL_KEYS, FORWARD_TRAVERSAL_KEYS, UP_CYCLE_TRAVERSAL_KEYS
Constructor Summary
FocusManager()
Method Summary
static void disableSwingFocusManager() Deprecated. as of 1.4, replaced by KeyboardFocusManager.setDefaultFocusTraversalPolicy(FocusTraversalPolicy)
static FocusManager getCurrentManager() Returns the current KeyboardFocusManager instance for the calling thread's context.
static boolean isFocusManagerEnabled() Deprecated. As of 1.4, replaced byKeyboardFocusManager.getDefaultFocusTraversalPolicy()
static void setCurrentManager(FocusManager aFocusManager) Sets the current KeyboardFocusManager instance for the calling thread's context.
Methods inherited from class java.awt.DefaultKeyboardFocusManager
[dequeueKeyEvents](../../java/awt/DefaultKeyboardFocusManager.html#dequeueKeyEvents%28long, java.awt.Component%29), discardKeyEvents, dispatchEvent, dispatchKeyEvent, downFocusCycle, [enqueueKeyEvents](../../java/awt/DefaultKeyboardFocusManager.html#enqueueKeyEvents%28long, java.awt.Component%29), focusNextComponent, focusPreviousComponent, postProcessKeyEvent, [processKeyEvent](../../java/awt/DefaultKeyboardFocusManager.html#processKeyEvent%28java.awt.Component, java.awt.event.KeyEvent%29), upFocusCycle
Methods inherited from class java.awt.KeyboardFocusManager
addKeyEventDispatcher, addKeyEventPostProcessor, addPropertyChangeListener, [addPropertyChangeListener](../../java/awt/KeyboardFocusManager.html#addPropertyChangeListener%28java.lang.String, java.beans.PropertyChangeListener%29), [addVetoableChangeListener](../../java/awt/KeyboardFocusManager.html#addVetoableChangeListener%28java.lang.String, java.beans.VetoableChangeListener%29), addVetoableChangeListener, clearGlobalFocusOwner, downFocusCycle, [firePropertyChange](../../java/awt/KeyboardFocusManager.html#firePropertyChange%28java.lang.String, java.lang.Object, java.lang.Object%29), [fireVetoableChange](../../java/awt/KeyboardFocusManager.html#fireVetoableChange%28java.lang.String, java.lang.Object, java.lang.Object%29), focusNextComponent, focusPreviousComponent, getActiveWindow, getCurrentFocusCycleRoot, getCurrentKeyboardFocusManager, getDefaultFocusTraversalKeys, getDefaultFocusTraversalPolicy, getFocusedWindow, getFocusOwner, getGlobalActiveWindow, getGlobalCurrentFocusCycleRoot, getGlobalFocusedWindow, getGlobalFocusOwner, getGlobalPermanentFocusOwner, getKeyEventDispatchers, getKeyEventPostProcessors, getPermanentFocusOwner, getPropertyChangeListeners, getPropertyChangeListeners, getVetoableChangeListeners, getVetoableChangeListeners, [redispatchEvent](../../java/awt/KeyboardFocusManager.html#redispatchEvent%28java.awt.Component, java.awt.AWTEvent%29), removeKeyEventDispatcher, removeKeyEventPostProcessor, removePropertyChangeListener, [removePropertyChangeListener](../../java/awt/KeyboardFocusManager.html#removePropertyChangeListener%28java.lang.String, java.beans.PropertyChangeListener%29), [removeVetoableChangeListener](../../java/awt/KeyboardFocusManager.html#removeVetoableChangeListener%28java.lang.String, java.beans.VetoableChangeListener%29), removeVetoableChangeListener, setCurrentKeyboardFocusManager, [setDefaultFocusTraversalKeys](../../java/awt/KeyboardFocusManager.html#setDefaultFocusTraversalKeys%28int, java.util.Set%29), setDefaultFocusTraversalPolicy, setGlobalActiveWindow, setGlobalCurrentFocusCycleRoot, setGlobalFocusedWindow, setGlobalFocusOwner, setGlobalPermanentFocusOwner, upFocusCycle
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, [wait](../../java/lang/Object.html#wait%28long, int%29)
Field Detail

FOCUS_MANAGER_CLASS_PROPERTY

public static final String FOCUS_MANAGER_CLASS_PROPERTY

This field is obsolete, and its use is discouraged since its specification is incompatible with the 1.4 focus APIs. The current FocusManager is no longer a property of the UI. Client code must query for the current FocusManager usingKeyboardFocusManager.getCurrentKeyboardFocusManager(). See the Focus Specification for more information.

See Also:

KeyboardFocusManager.getCurrentKeyboardFocusManager(), Focus Specification, Constant Field Values

Constructor Detail

FocusManager

public FocusManager()

Method Detail

getCurrentManager

public static FocusManager getCurrentManager()

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

Returns:

this thread's context's KeyboardFocusManager

See Also:

setCurrentManager(javax.swing.FocusManager)


setCurrentManager

public static void setCurrentManager(FocusManager aFocusManager) throws SecurityException

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 ofDefaultKeyboardFocusManager.

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:

aFocusManager - the new KeyboardFocusManager for this thread's context

Throws:

[SecurityException](../../java/lang/SecurityException.html "class in java.lang") - if the calling thread does not have permission to replace the current KeyboardFocusManager

See Also:

getCurrentManager(), DefaultKeyboardFocusManager


disableSwingFocusManager

@Deprecated public static void disableSwingFocusManager()

Deprecated. as of 1.4, replaced by KeyboardFocusManager.setDefaultFocusTraversalPolicy(FocusTraversalPolicy)

Changes the current KeyboardFocusManager's defaultFocusTraversalPolicy toDefaultFocusTraversalPolicy.

See Also:

DefaultFocusTraversalPolicy, KeyboardFocusManager.setDefaultFocusTraversalPolicy(java.awt.FocusTraversalPolicy)


isFocusManagerEnabled

@Deprecated public static boolean isFocusManagerEnabled()

Deprecated. As of 1.4, replaced byKeyboardFocusManager.getDefaultFocusTraversalPolicy()

Returns whether the application has invokeddisableSwingFocusManager().

See Also:

disableSwingFocusManager()



Submit a bug or feature
For further API reference and developer documentation, see Java SE Developer Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.

Copyright © 1993, 2015, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.

Scripting on this page tracks web page traffic, but does not change the content in any way.