/* * 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 * <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     * <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 <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 <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 <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     * <code>disableSwingFocusManager()</code>.     *     * @see #disableSwingFocusManager     * @deprecated As of 1.4, replaced by     *   <code>KeyboardFocusManager.getDefaultFocusTraversalPolicy()</code>     */    @Deprecated    public static boolean isFocusManagerEnabled() {        return enabled;    }}