|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectjava.awt.FocusTraversalPolicy
java.awt.ContainerOrderFocusTraversalPolicy
public class ContainerOrderFocusTraversalPolicy
A FocusTraversalPolicy that determines traversal order based on the order
of child Components in a Container. From a particular focus cycle root, the
policy makes a pre-order traversal of the Component hierarchy, and traverses
a Container's children according to the ordering of the array returned by
Container.getComponents()
. Portions of the hierarchy that are
not visible and displayable will not be searched.
By default, ContainerOrderFocusTraversalPolicy implicitly transfers focus
down-cycle. That is, during normal forward focus traversal, the Component
traversed after a focus cycle root will be the focus-cycle-root's default
Component to focus. This behavior can be disabled using the
setImplicitDownCycleTraversal
method.
By default, methods of this class with return a Component only if it is
visible, displayable, enabled, and focusable. Subclasses can modify this
behavior by overriding the accept
method.
Container.getComponents()
,
Serialized FormConstructor Summary | |
---|---|
ContainerOrderFocusTraversalPolicy()
|
Method Summary | |
---|---|
Component |
getComponentAfter(Container focusCycleRoot,
Component aComponent)
Returns the Component that should receive the focus after aComponent. |
Component |
getComponentBefore(Container focusCycleRoot,
Component aComponent)
Returns the Component that should receive the focus before aComponent. |
Component |
getDefaultComponent(Container focusCycleRoot)
Returns the default Component to focus. |
Component |
getFirstComponent(Container focusCycleRoot)
Returns the first Component in the traversal cycle. |
boolean |
getImplicitDownCycleTraversal()
Returns whether this ContainerOrderFocusTraversalPolicy transfers focus down-cycle implicitly. |
Component |
getLastComponent(Container focusCycleRoot)
Returns the last Component in the traversal cycle. |
void |
setImplicitDownCycleTraversal(boolean implicitDownCycleTraversal)
Sets whether this ContainerOrderFocusTraversalPolicy transfers focus down-cycle implicitly. |
Methods inherited from class java.awt.FocusTraversalPolicy |
---|
getInitialComponent |
Methods inherited from class java.lang.Object |
---|
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public ContainerOrderFocusTraversalPolicy()
Method Detail |
---|
public Component getComponentAfter(Container focusCycleRoot, Component aComponent)
By default, ContainerOrderFocusTraversalPolicy implicitly transfers
focus down-cycle. That is, during normal forward focus traversal, the
Component traversed after a focus cycle root will be the focus-cycle-
root's default Component to focus. This behavior can be disabled using
the setImplicitDownCycleTraversal
method.
getComponentAfter
in class FocusTraversalPolicy
focusCycleRoot
- a focus cycle root of aComponentaComponent
- a (possibly indirect) child of focusCycleRoot, or
focusCycleRoot itself
IllegalArgumentException
- if focusCycleRoot is not a focus cycle
root of aComponent, or if either focusCycleRoot or aComponent is
nullpublic Component getComponentBefore(Container focusCycleRoot, Component aComponent)
getComponentBefore
in class FocusTraversalPolicy
focusCycleRoot
- a focus cycle root of aComponentaComponent
- a (possibly indirect) child of focusCycleRoot, or
focusCycleRoot itself
IllegalArgumentException
- if focusCycleRoot is not a focus cycle
root of aComponent, or if either focusCycleRoot or aComponent is
nullpublic Component getFirstComponent(Container focusCycleRoot)
getFirstComponent
in class FocusTraversalPolicy
focusCycleRoot
- the focus cycle root whose first Component is to
be returned
IllegalArgumentException
- if focusCycleRoot is nullpublic Component getLastComponent(Container focusCycleRoot)
getLastComponent
in class FocusTraversalPolicy
focusCycleRoot
- the focus cycle root whose last Component is to be
returned
IllegalArgumentException
- if focusCycleRoot is nullpublic Component getDefaultComponent(Container focusCycleRoot)
getFirstComponent
.
getDefaultComponent
in class FocusTraversalPolicy
focusCycleRoot
- the focus cycle root whose default Component is to
be returned
IllegalArgumentException
- if focusCycleRoot is nullgetFirstComponent(java.awt.Container)
public void setImplicitDownCycleTraversal(boolean implicitDownCycleTraversal)
true
, during normal forward focus
traversal, the Component traversed after a focus cycle root will be the
focus-cycle-root's default Component to focus. If false
,
the next Component in the focus traversal cycle rooted at the specified
focus cycle root will be traversed instead. The default value for this
property is true
.
implicitDownCycleTraversal
- whether this
ContainerOrderFocusTraversalPolicy transfers focus down-cycle
implicitlygetImplicitDownCycleTraversal()
,
getFirstComponent(java.awt.Container)
public boolean getImplicitDownCycleTraversal()
true
, during normal forward focus
traversal, the Component traversed after a focus cycle root will be the
focus-cycle-root's default Component to focus. If false
,
the next Component in the focus traversal cycle rooted at the specified
focus cycle root will be traversed instead.
setImplicitDownCycleTraversal(boolean)
,
getFirstComponent(java.awt.Container)
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |