32 * of a Component hierarchy change.
33 * <p>
34 * The core responsibility of a FocusTraversalPolicy is to provide algorithms
35 * determining the next and previous Components to focus when traversing
36 * forward or backward in a UI. Each FocusTraversalPolicy must also provide
37 * algorithms for determining the first, last, and default Components in a
38 * traversal cycle. First and last Components are used when normal forward and
39 * backward traversal, respectively, wraps. The default Component is the first
40 * to receive focus when traversing down into a new focus traversal cycle.
41 * A FocusTraversalPolicy can optionally provide an algorithm for determining
42 * a Window's initial Component. The initial Component is the first to receive
43 * focus when a Window is first made visible.
44 * <p>
45 * FocusTraversalPolicy takes into account <a
46 * href="doc-files/FocusSpec.html#FocusTraversalPolicyProviders">focus traversal
47 * policy providers</a>. When searching for first/last/next/previous Component,
48 * if a focus traversal policy provider is encountered, its focus traversal
49 * policy is used to perform the search operation.
50 * <p>
51 * Please see
52 * <a href="http://java.sun.com/docs/books/tutorial/uiswing/misc/focus.html">
53 * How to Use the Focus Subsystem</a>,
54 * a section in <em>The Java Tutorial</em>, and the
55 * <a href="../../java/awt/doc-files/FocusSpec.html">Focus Specification</a>
56 * for more information.
57 *
58 * @author David Mendenhall
59 *
60 * @see Container#setFocusTraversalPolicy
61 * @see Container#getFocusTraversalPolicy
62 * @see Container#setFocusCycleRoot
63 * @see Container#isFocusCycleRoot
64 * @see Container#setFocusTraversalPolicyProvider
65 * @see Container#isFocusTraversalPolicyProvider
66 * @see KeyboardFocusManager#setDefaultFocusTraversalPolicy
67 * @see KeyboardFocusManager#getDefaultFocusTraversalPolicy
68 * @since 1.4
69 */
70 public abstract class FocusTraversalPolicy {
71
72 /**
|
32 * of a Component hierarchy change.
33 * <p>
34 * The core responsibility of a FocusTraversalPolicy is to provide algorithms
35 * determining the next and previous Components to focus when traversing
36 * forward or backward in a UI. Each FocusTraversalPolicy must also provide
37 * algorithms for determining the first, last, and default Components in a
38 * traversal cycle. First and last Components are used when normal forward and
39 * backward traversal, respectively, wraps. The default Component is the first
40 * to receive focus when traversing down into a new focus traversal cycle.
41 * A FocusTraversalPolicy can optionally provide an algorithm for determining
42 * a Window's initial Component. The initial Component is the first to receive
43 * focus when a Window is first made visible.
44 * <p>
45 * FocusTraversalPolicy takes into account <a
46 * href="doc-files/FocusSpec.html#FocusTraversalPolicyProviders">focus traversal
47 * policy providers</a>. When searching for first/last/next/previous Component,
48 * if a focus traversal policy provider is encountered, its focus traversal
49 * policy is used to perform the search operation.
50 * <p>
51 * Please see
52 * <a href="http://docs.oracle.com/javase/tutorial/uiswing/misc/focus.html">
53 * How to Use the Focus Subsystem</a>,
54 * a section in <em>The Java Tutorial</em>, and the
55 * <a href="../../java/awt/doc-files/FocusSpec.html">Focus Specification</a>
56 * for more information.
57 *
58 * @author David Mendenhall
59 *
60 * @see Container#setFocusTraversalPolicy
61 * @see Container#getFocusTraversalPolicy
62 * @see Container#setFocusCycleRoot
63 * @see Container#isFocusCycleRoot
64 * @see Container#setFocusTraversalPolicyProvider
65 * @see Container#isFocusTraversalPolicyProvider
66 * @see KeyboardFocusManager#setDefaultFocusTraversalPolicy
67 * @see KeyboardFocusManager#getDefaultFocusTraversalPolicy
68 * @since 1.4
69 */
70 public abstract class FocusTraversalPolicy {
71
72 /**
|