< prev index next >

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

Print this page




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




7231 
7232     final boolean isFocusTraversableOverridden() {
7233         return (isFocusTraversableOverridden != FOCUS_TRAVERSABLE_DEFAULT);
7234     }
7235 
7236     /**
7237      * Sets the focus traversal keys for a given traversal operation for this
7238      * Component.
7239      * <p>
7240      * The default values for a Component's focus traversal keys are
7241      * implementation-dependent. Sun recommends that all implementations for a
7242      * particular native platform use the same default values. The
7243      * recommendations for Windows and Unix are listed below. These
7244      * recommendations are used in the Sun AWT implementations.
7245      *
7246      * <table class="striped">
7247      * <caption>Recommended default values for a Component's focus traversal
7248      * keys</caption>
7249      * <thead>
7250      *   <tr>
7251      *     <th scope="col">Identifier
7252      *     <th scope="col">Meaning
7253      *     <th scope="col">Default

7254      * </thead>
7255      * <tbody>
7256      *   <tr>
7257      *     <th scope="row">KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS
7258      *     <td>Normal forward keyboard traversal
7259      *     <td>TAB on KEY_PRESSED, CTRL-TAB on KEY_PRESSED

7260      *   <tr>
7261      *     <th scope="row">KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS
7262      *     <td>Normal reverse keyboard traversal
7263      *     <td>SHIFT-TAB on KEY_PRESSED, CTRL-SHIFT-TAB on KEY_PRESSED

7264      *   <tr>
7265      *     <th scope="row">KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS
7266      *     <td>Go up one focus traversal cycle
7267      *     <td>none

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


< prev index next >