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