< prev index next >
src/java.desktop/share/classes/javax/swing/FocusManager.java
Print this page
*** 28,39 ****
/**
* 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://docs.oracle.com/javase/tutorial/uiswing/misc/focus.html">
* How to Use the Focus Subsystem</a>,
* a section in <em>The Java Tutorial</em>, and the
--- 28,39 ----
/**
* 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} and
! * {@code java.awt.DefaultKeyboardFocusManager} instead.
* <p>
* Please see
* <a href="http://docs.oracle.com/javase/tutorial/uiswing/misc/focus.html">
* How to Use the Focus Subsystem</a>,
* a section in <em>The Java Tutorial</em>, and the
*** 51,61 ****
/**
* 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>
*/
--- 51,61 ----
/**
* 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()}.
* See the Focus Specification for more information.
*
* @see java.awt.KeyboardFocusManager#getCurrentKeyboardFocusManager
* @see <a href="../../java/awt/doc-files/FocusSpec.html">Focus Specification</a>
*/
*** 63,76 ****
"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();
--- 63,76 ----
"FocusManagerClassName";
private static boolean enabled = true;
/**
! * Returns the current {@code KeyboardFocusManager} instance
* for the calling thread's context.
*
! * @return this thread's context's {@code KeyboardFocusManager}
* @see #setCurrentManager
*/
public static FocusManager getCurrentManager() {
KeyboardFocusManager manager =
KeyboardFocusManager.getCurrentKeyboardFocusManager();
*** 80,109 ****
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
--- 80,109 ----
return new DelegatingDefaultFocusManager(manager);
}
}
/**
! * Sets the current {@code KeyboardFocusManager} instance
! * for the calling thread's context. If {@code null} is
! * specified, then the current {@code KeyboardFocusManager}
* is replaced with a new instance of
! * {@code DefaultKeyboardFocusManager}.
* <p>
! * If a {@code SecurityManager} is installed,
! * the calling thread must be granted the {@code AWTPermission}
* "replaceKeyboardFocusManager" in order to replace the
! * the current {@code KeyboardFocusManager}.
* If this permission is not granted,
! * this method will throw a {@code SecurityException},
! * and the current {@code KeyboardFocusManager} will be unchanged.
*
! * @param aFocusManager the new {@code KeyboardFocusManager}
* 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}
*/
public static void setCurrentManager(FocusManager aFocusManager)
throws SecurityException
{
// Note: This method is not backward-compatible with 1.3 and earlier
*** 116,133 ****
: 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;
--- 116,133 ----
: aFocusManager;
KeyboardFocusManager.setCurrentKeyboardFocusManager(toSet);
}
/**
! * Changes the current {@code KeyboardFocusManager}'s default
! * {@code FocusTraversalPolicy} to
! * {@code DefaultFocusTraversalPolicy}.
*
* @see java.awt.DefaultFocusTraversalPolicy
* @see java.awt.KeyboardFocusManager#setDefaultFocusTraversalPolicy
* @deprecated as of 1.4, replaced by
! * {@code KeyboardFocusManager.setDefaultFocusTraversalPolicy(FocusTraversalPolicy)}
*/
@Deprecated
public static void disableSwingFocusManager() {
if (enabled) {
enabled = false;
*** 137,152 ****
}
}
/**
* Returns whether the application has invoked
! * <code>disableSwingFocusManager()</code>.
*
* @return {@code true} if focus manager is enabled.
* @see #disableSwingFocusManager
* @deprecated As of 1.4, replaced by
! * <code>KeyboardFocusManager.getDefaultFocusTraversalPolicy()</code>
*/
@Deprecated
public static boolean isFocusManagerEnabled() {
return enabled;
}
--- 137,152 ----
}
}
/**
* Returns whether the application has invoked
! * {@code disableSwingFocusManager()}.
*
* @return {@code true} if focus manager is enabled.
* @see #disableSwingFocusManager
* @deprecated As of 1.4, replaced by
! * {@code KeyboardFocusManager.getDefaultFocusTraversalPolicy()}
*/
@Deprecated
public static boolean isFocusManagerEnabled() {
return enabled;
}
< prev index next >