< prev index next >

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

Print this page




3053                 }
3054             }
3055         }
3056     }
3057 
3058     /**
3059      * Sets the focus traversal keys for a given traversal operation for this
3060      * Container.
3061      * <p>
3062      * The default values for a Container's focus traversal keys are
3063      * implementation-dependent. Sun recommends that all implementations for a
3064      * particular native platform use the same default values. The
3065      * recommendations for Windows and Unix are listed below. These
3066      * recommendations are used in the Sun AWT implementations.
3067      *
3068      * <table class="striped">
3069      * <caption>Recommended default values for a Container's focus traversal
3070      * keys</caption>
3071      * <thead>
3072      * <tr>
3073      *    <th>Identifier</th>
3074      *    <th>Meaning</th>
3075      *    <th>Default</th>
3076      * </tr>
3077      * </thead>
3078      * <tbody>
3079      * <tr>
3080      *    <td>KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS</td>
3081      *    <td>Normal forward keyboard traversal</td>
3082      *    <td>TAB on KEY_PRESSED, CTRL-TAB on KEY_PRESSED</td>
3083      * </tr>
3084      * <tr>
3085      *    <td>KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS</td>
3086      *    <td>Normal reverse keyboard traversal</td>
3087      *    <td>SHIFT-TAB on KEY_PRESSED, CTRL-SHIFT-TAB on KEY_PRESSED</td>
3088      * </tr>
3089      * <tr>
3090      *    <td>KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS</td>
3091      *    <td>Go up one focus traversal cycle</td>
3092      *    <td>none</td>
3093      * </tr>
3094      * <tr>
3095      *    <td>KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS</td>
3096      *    <td>Go down one focus traversal cycle</td>
3097      *    <td>none</td>
3098      * </tr>
3099      * </tbody>
3100      * </table>
3101      *
3102      * To disable a traversal key, use an empty Set; Collections.EMPTY_SET is
3103      * recommended.
3104      * <p>
3105      * Using the AWTKeyStroke API, client code can specify on which of two
3106      * specific KeyEvents, KEY_PRESSED or KEY_RELEASED, the focus traversal
3107      * operation will occur. Regardless of which KeyEvent is specified,
3108      * however, all KeyEvents related to the focus traversal key, including the
3109      * associated KEY_TYPED event, will be consumed, and will not be dispatched
3110      * to any Container. It is a runtime error to specify a KEY_TYPED event as
3111      * mapping to a focus traversal operation, or to map the same event to
3112      * multiple default focus traversal operations.
3113      * <p>
3114      * If a value of null is specified for the Set, this Container inherits the
3115      * Set from its parent. If all ancestors of this Container have null
3116      * specified for the Set, then the current KeyboardFocusManager's default
3117      * Set is used.
3118      * <p>




3053                 }
3054             }
3055         }
3056     }
3057 
3058     /**
3059      * Sets the focus traversal keys for a given traversal operation for this
3060      * Container.
3061      * <p>
3062      * The default values for a Container's focus traversal keys are
3063      * implementation-dependent. Sun recommends that all implementations for a
3064      * particular native platform use the same default values. The
3065      * recommendations for Windows and Unix are listed below. These
3066      * recommendations are used in the Sun AWT implementations.
3067      *
3068      * <table class="striped">
3069      * <caption>Recommended default values for a Container's focus traversal
3070      * keys</caption>
3071      * <thead>
3072      *   <tr>
3073      *     <th scope="col">Identifier
3074      *     <th scope="col">Meaning
3075      *     <th scope="col">Default

3076      * </thead>
3077      * <tbody>
3078      *   <tr>
3079      *     <th scope="row">KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS
3080      *     <td>Normal forward keyboard traversal
3081      *     <td>TAB on KEY_PRESSED, CTRL-TAB on KEY_PRESSED

3082      *   <tr>
3083      *     <th scope="row">KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS
3084      *     <td>Normal reverse keyboard traversal
3085      *     <td>SHIFT-TAB on KEY_PRESSED, CTRL-SHIFT-TAB on KEY_PRESSED

3086      *   <tr>
3087      *     <th scope="row">KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS
3088      *     <td>Go up one focus traversal cycle
3089      *     <td>none

3090      *   <tr>
3091      *     <th scope="row">KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS
3092      *     <td>Go down one focus traversal cycle
3093      *     <td>none

3094      * </tbody>
3095      * </table>
3096      *
3097      * To disable a traversal key, use an empty Set; Collections.EMPTY_SET is
3098      * recommended.
3099      * <p>
3100      * Using the AWTKeyStroke API, client code can specify on which of two
3101      * specific KeyEvents, KEY_PRESSED or KEY_RELEASED, the focus traversal
3102      * operation will occur. Regardless of which KeyEvent is specified,
3103      * however, all KeyEvents related to the focus traversal key, including the
3104      * associated KEY_TYPED event, will be consumed, and will not be dispatched
3105      * to any Container. It is a runtime error to specify a KEY_TYPED event as
3106      * mapping to a focus traversal operation, or to map the same event to
3107      * multiple default focus traversal operations.
3108      * <p>
3109      * If a value of null is specified for the Set, this Container inherits the
3110      * Set from its parent. If all ancestors of this Container have null
3111      * specified for the Set, then the current KeyboardFocusManager's default
3112      * Set is used.
3113      * <p>


< prev index next >