< prev index next >

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

Print this page




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>Recommended default values for a Component's focus traversal
7242      * 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>




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>Recommended default values for a Component's focus traversal
7242      * keys</caption>
7243      * <thead>
7244      *   <tr>
7245      *     <th scope="col">Identifier
7246      *     <th scope="col">Meaning
7247      *     <th scope="col">Default

7248      * </thead>
7249      * <tbody>
7250      *   <tr>
7251      *     <th scope="row">KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS
7252      *     <td>Normal forward keyboard traversal
7253      *     <td>TAB on KEY_PRESSED, CTRL-TAB on KEY_PRESSED

7254      *   <tr>
7255      *     <th scope="row">KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS
7256      *     <td>Normal reverse keyboard traversal
7257      *     <td>SHIFT-TAB on KEY_PRESSED, CTRL-SHIFT-TAB on KEY_PRESSED

7258      *   <tr>
7259      *     <th scope="row">KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS
7260      *     <td>Go up one focus traversal cycle
7261      *     <td>none

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


< prev index next >