java.lang.Object java.awt.FocusTraversalPolicy javax.swing.InternalFrameFocusTraversalPolicy javax.swing.SortingFocusTraversalPolicy
A FocusTraversalPolicy that determines traversal order by sorting the Components of a focus traversal cycle based on a given Comparator. Portions of the Component hierarchy that are not visible and displayable will not be included.
By default, SortingFocusTraversalPolicy implicitly transfers focus down- cycle. That is, during normal 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.
This policy takes into account focus traversal policy providers . When searching for first/last/next/previous Component, if a focus traversal policy provider is encountered, its focus traversal policy is used to perform the search operation.
Constructor Summary | |
---|---|
protected |
SortingFocusTraversalPolicy
() Constructs a SortingFocusTraversalPolicy without a Comparator. |
SortingFocusTraversalPolicy
(
Comparator
comparator) Constructs a SortingFocusTraversalPolicy with the specified Comparator. |
Method Summary | |
---|---|
protected boolean |
accept
(
Component
aComponent) Determines whether a Component is an acceptable choice as the new focus owner. |
protected Comparator |
getComparator
() Returns the Comparator which will be used to sort the Components in a focus traversal cycle. |
Component |
getComponentAfter
(
Container
aContainer,
Returns the Component that should receive the focus after aComponent. |
Component |
getComponentBefore
(
Container
aContainer,
Returns the Component that should receive the focus before aComponent. |
Component |
getDefaultComponent
(
Container
Returns the default Component to focus. |
Component |
getFirstComponent
(
Container
Returns the first Component in the traversal cycle. |
boolean |
getImplicitDownCycleTraversal
() Returns whether this SortingFocusTraversalPolicy transfers focus down- cycle implicitly. |
Component |
getLastComponent
(
Container
Returns the last Component in the traversal cycle. |
protected void |
setComparator
(
Comparator
comparator) Sets the Comparator which will be used to sort the Components in a focus traversal cycle. |
void |
setImplicitDownCycleTraversal
(boolean implicitDownCycleTraversal) Sets whether this SortingFocusTraversalPolicy transfers focus down-cycle implicitly. |
Methods inherited from class javax.swing. InternalFrameFocusTraversalPolicy |
---|
getInitialComponent |
Methods inherited from class java.awt. FocusTraversalPolicy |
---|
getInitialComponent |
Methods inherited from class java.lang. Object |
---|
clone , equals , finalize , getClass , hashCode , notify , notifyAll , toString , wait , wait , wait |
Constructor Detail |
---|
protected SortingFocusTraversalPolicy()
public SortingFocusTraversalPolicy(Comparator comparator)
Method Detail |
---|
public ComponentgetComponentAfter(Container aContainer,focusCycleRoot,Component aComponent)
By default, SortingFocusTraversalPolicy implicitly transfers focus down- cycle. That is, during normal 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.
If aContainer is focus traversal policy provider , the focus is always transferred down-cycle.
public ComponentgetComponentBefore(Container aContainer,focusCycleRoot,Component aComponent)
By default, SortingFocusTraversalPolicy implicitly transfers focus down- cycle. That is, during normal 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.
If aContainer is focus traversal policy provider , the focus is always transferred down-cycle.
public ComponentgetFirstComponent(Container aContainer)focusCycleRoot)
public ComponentgetLastComponent(Container aContainer)focusCycleRoot)
public ComponentgetDefaultComponent(Container aContainer)focusCycleRoot)
public void setImplicitDownCycleTraversal(boolean implicitDownCycleTraversal)
public boolean getImplicitDownCycleTraversal()
protected void setComparator(Comparator comparator)
protected Comparator getComparator()
protected boolean accept(Component aComponent)