< prev index next >

src/java.desktop/share/classes/java/awt/Component.java

Print this page




7220                 transferFocus(true);
7221             }
7222             KeyboardFocusManager.clearMostRecentFocusOwner(this);
7223         }
7224     }
7225 
7226     final boolean isFocusTraversableOverridden() {
7227         return (isFocusTraversableOverridden != FOCUS_TRAVERSABLE_DEFAULT);
7228     }
7229 
7230     /**
7231      * Sets the focus traversal keys for a given traversal operation for this
7232      * Component.
7233      * <p>
7234      * The default values for a Component's focus traversal keys are
7235      * implementation-dependent. Sun recommends that all implementations for a
7236      * particular native platform use the same default values. The
7237      * recommendations for Windows and Unix are listed below. These
7238      * recommendations are used in the Sun AWT implementations.
7239      *
7240      * <table border=1 summary="Recommended default values for a Component's focus traversal keys">



7241      * <tr>
7242      *    <th>Identifier</th>
7243      *    <th>Meaning</th>
7244      *    <th>Default</th>
7245      * </tr>


7246      * <tr>
7247      *    <td>KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS</td>
7248      *    <td>Normal forward keyboard traversal</td>
7249      *    <td>TAB on KEY_PRESSED, CTRL-TAB on KEY_PRESSED</td>
7250      * </tr>
7251      * <tr>
7252      *    <td>KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS</td>
7253      *    <td>Normal reverse keyboard traversal</td>
7254      *    <td>SHIFT-TAB on KEY_PRESSED, CTRL-SHIFT-TAB on KEY_PRESSED</td>
7255      * </tr>
7256      * <tr>
7257      *    <td>KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS</td>
7258      *    <td>Go up one focus traversal cycle</td>
7259      *    <td>none</td>
7260      * </tr>

7261      * </table>
7262      *
7263      * To disable a traversal key, use an empty Set; Collections.EMPTY_SET is
7264      * recommended.
7265      * <p>
7266      * Using the AWTKeyStroke API, client code can specify on which of two
7267      * specific KeyEvents, KEY_PRESSED or KEY_RELEASED, the focus traversal
7268      * operation will occur. Regardless of which KeyEvent is specified,
7269      * however, all KeyEvents related to the focus traversal key, including the
7270      * associated KEY_TYPED event, will be consumed, and will not be dispatched
7271      * to any Component. It is a runtime error to specify a KEY_TYPED event as
7272      * mapping to a focus traversal operation, or to map the same event to
7273      * multiple default focus traversal operations.
7274      * <p>
7275      * If a value of null is specified for the Set, this Component inherits the
7276      * Set from its parent. If all ancestors of this Component have null
7277      * specified for the Set, then the current KeyboardFocusManager's default
7278      * Set is used.
7279      * <p>
7280      * This method may throw a {@code ClassCastException} if any {@code Object}




7220                 transferFocus(true);
7221             }
7222             KeyboardFocusManager.clearMostRecentFocusOwner(this);
7223         }
7224     }
7225 
7226     final boolean isFocusTraversableOverridden() {
7227         return (isFocusTraversableOverridden != FOCUS_TRAVERSABLE_DEFAULT);
7228     }
7229 
7230     /**
7231      * Sets the focus traversal keys for a given traversal operation for this
7232      * Component.
7233      * <p>
7234      * The default values for a Component's focus traversal keys are
7235      * implementation-dependent. Sun recommends that all implementations for a
7236      * particular native platform use the same default values. The
7237      * recommendations for Windows and Unix are listed below. These
7238      * recommendations are used in the Sun AWT implementations.
7239      *
7240      * <table class="striped">
7241      * <caption style="display:none">Recommended default values for a
7242      * Component's focus traversal keys</caption>
7243      * <thead>
7244      * <tr>
7245      *    <th>Identifier</th>
7246      *    <th>Meaning</th>
7247      *    <th>Default</th>
7248      * </tr>
7249      * </thead>
7250      * <tbody>
7251      * <tr>
7252      *    <td>KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS</td>
7253      *    <td>Normal forward keyboard traversal</td>
7254      *    <td>TAB on KEY_PRESSED, CTRL-TAB on KEY_PRESSED</td>
7255      * </tr>
7256      * <tr>
7257      *    <td>KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS</td>
7258      *    <td>Normal reverse keyboard traversal</td>
7259      *    <td>SHIFT-TAB on KEY_PRESSED, CTRL-SHIFT-TAB on KEY_PRESSED</td>
7260      * </tr>
7261      * <tr>
7262      *    <td>KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS</td>
7263      *    <td>Go up one focus traversal cycle</td>
7264      *    <td>none</td>
7265      * </tr>
7266      * </tbody>
7267      * </table>
7268      *
7269      * To disable a traversal key, use an empty Set; Collections.EMPTY_SET is
7270      * recommended.
7271      * <p>
7272      * Using the AWTKeyStroke API, client code can specify on which of two
7273      * specific KeyEvents, KEY_PRESSED or KEY_RELEASED, the focus traversal
7274      * operation will occur. Regardless of which KeyEvent is specified,
7275      * however, all KeyEvents related to the focus traversal key, including the
7276      * associated KEY_TYPED event, will be consumed, and will not be dispatched
7277      * to any Component. It is a runtime error to specify a KEY_TYPED event as
7278      * mapping to a focus traversal operation, or to map the same event to
7279      * multiple default focus traversal operations.
7280      * <p>
7281      * If a value of null is specified for the Set, this Component inherits the
7282      * Set from its parent. If all ancestors of this Component have null
7283      * specified for the Set, then the current KeyboardFocusManager's default
7284      * Set is used.
7285      * <p>
7286      * This method may throw a {@code ClassCastException} if any {@code Object}


< prev index next >