/*
 * Copyright (c) 1997, 2004, Oracle and/or its affiliates. All rights reserved.
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
 *
 * This code is free software; you can redistribute it and/or modify it
 * under the terms of the GNU General Public License version 2 only, as
 * published by the Free Software Foundation.  Oracle designates this
 * particular file as subject to the "Classpath" exception as provided
 * by Oracle in the LICENSE file that accompanied this code.
 *
 * This code is distributed in the hope that it will be useful, but WITHOUT
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
 * version 2 for more details (a copy is included in the LICENSE file that
 * accompanied this code).
 *
 * You should have received a copy of the GNU General Public License version
 * 2 along with this work; if not, write to the Free Software Foundation,
 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
 *
 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
 * or visit www.oracle.com if you need additional information or have any
 * questions.
 */
package javax.swing;

import java.awt.*;


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

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

Author:Arnaud Weber, David Mendenhall
See Also:
/** * This class has been obsoleted by the 1.4 focus APIs. While client code may * still use this class, developers are strongly encouraged to use * <code>java.awt.KeyboardFocusManager</code> and * <code>java.awt.DefaultKeyboardFocusManager</code> instead. * <p> * Please see * <a href="http://java.sun.com/docs/books/tutorial/uiswing/misc/focus.html"> * How to Use the Focus Subsystem</a>, * a section in <em>The Java Tutorial</em>, and the * <a href="../../java/awt/doc-files/FocusSpec.html">Focus Specification</a> * for more information. * * @see <a href="../../java/awt/doc-files/FocusSpec.html">Focus Specification</a> * * @author Arnaud Weber * @author David Mendenhall */
public abstract class FocusManager extends DefaultKeyboardFocusManager {
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 using KeyboardFocusManager.getCurrentKeyboardFocusManager(). See the Focus Specification for more information.
See Also:
/** * 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 using * <code>KeyboardFocusManager.getCurrentKeyboardFocusManager()</code>. * See the Focus Specification for more information. * * @see java.awt.KeyboardFocusManager#getCurrentKeyboardFocusManager * @see <a href="../../java/awt/doc-files/FocusSpec.html">Focus Specification</a> */
public static final String FOCUS_MANAGER_CLASS_PROPERTY = "FocusManagerClassName"; private static boolean enabled = true;
Returns the current KeyboardFocusManager instance for the calling thread's context.
See Also:
Returns:this thread's context's KeyboardFocusManager
/** * Returns the current <code>KeyboardFocusManager</code> instance * for the calling thread's context. * * @return this thread's context's <code>KeyboardFocusManager</code> * @see #setCurrentManager */
public static FocusManager getCurrentManager() { KeyboardFocusManager manager = KeyboardFocusManager.getCurrentKeyboardFocusManager(); if (manager instanceof FocusManager) { return (FocusManager)manager; } else { return new DelegatingDefaultFocusManager(manager); } }
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.

Params:
  • aFocusManager – 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:
/** * Sets the current <code>KeyboardFocusManager</code> instance * for the calling thread's context. If <code>null</code> is * specified, then the current <code>KeyboardFocusManager</code> * is replaced with a new instance of * <code>DefaultKeyboardFocusManager</code>. * <p> * If a <code>SecurityManager</code> is installed, * the calling thread must be granted the <code>AWTPermission</code> * "replaceKeyboardFocusManager" in order to replace the * the current <code>KeyboardFocusManager</code>. * If this permission is not granted, * this method will throw a <code>SecurityException</code>, * and the current <code>KeyboardFocusManager</code> will be unchanged. * * @param aFocusManager the new <code>KeyboardFocusManager</code> * for this thread's context * @see #getCurrentManager * @see java.awt.DefaultKeyboardFocusManager * @throws SecurityException if the calling thread does not have permission * to replace the current <code>KeyboardFocusManager</code> */
public static void setCurrentManager(FocusManager aFocusManager) throws SecurityException { // Note: This method is not backward-compatible with 1.3 and earlier // releases. It now throws a SecurityException in an applet, whereas // in previous releases, it did not. This issue was discussed at // length, and ultimately approved by Hans. KeyboardFocusManager toSet = (aFocusManager instanceof DelegatingDefaultFocusManager) ? ((DelegatingDefaultFocusManager)aFocusManager).getDelegate() : aFocusManager; KeyboardFocusManager.setCurrentKeyboardFocusManager(toSet); }
Changes the current KeyboardFocusManager's default FocusTraversalPolicy to DefaultFocusTraversalPolicy.
See Also:
Deprecated:as of 1.4, replaced by KeyboardFocusManager.setDefaultFocusTraversalPolicy(FocusTraversalPolicy)
/** * Changes the current <code>KeyboardFocusManager</code>'s default * <code>FocusTraversalPolicy</code> to * <code>DefaultFocusTraversalPolicy</code>. * * @see java.awt.DefaultFocusTraversalPolicy * @see java.awt.KeyboardFocusManager#setDefaultFocusTraversalPolicy * @deprecated as of 1.4, replaced by * <code>KeyboardFocusManager.setDefaultFocusTraversalPolicy(FocusTraversalPolicy)</code> */
@Deprecated public static void disableSwingFocusManager() { if (enabled) { enabled = false; KeyboardFocusManager.getCurrentKeyboardFocusManager(). setDefaultFocusTraversalPolicy( new DefaultFocusTraversalPolicy()); } }
Returns whether the application has invoked disableSwingFocusManager().
See Also:
  • disableSwingFocusManager
Deprecated:As of 1.4, replaced by KeyboardFocusManager.getDefaultFocusTraversalPolicy()
/** * Returns whether the application has invoked * <code>disableSwingFocusManager()</code>. * * @see #disableSwingFocusManager * @deprecated As of 1.4, replaced by * <code>KeyboardFocusManager.getDefaultFocusTraversalPolicy()</code> */
@Deprecated public static boolean isFocusManagerEnabled() { return enabled; } }