Module java.desktop
Package java.awt

Class ContainerOrderFocusTraversalPolicy

java.lang.Object
java.awt.FocusTraversalPolicy
java.awt.ContainerOrderFocusTraversalPolicy
所有已实现的接口:
Serializable
直接已知的子类:
DefaultFocusTraversalPolicy
public class ContainerOrderFocusTraversalPolicy extends FocusTraversalPolicy implements Serializable
基于容器中子组件的顺序确定遍历顺序的焦点遍历策略。从特定的焦点循环根开始，该策略对组件层次结构进行先序遍历，并根据Container.getComponents()返回的数组的顺序遍历容器的子组件。不会搜索不可见和不可显示的部分。

默认情况下，ContainerOrderFocusTraversalPolicy隐式地向下传递焦点循环。也就是说，在正常的向前焦点遍历期间，焦点循环根之后遍历的组件将是焦点循环根的默认要聚焦的组件。可以使用setImplicitDownCycleTraversal方法禁用此行为。

默认情况下，此类的方法仅在组件可见、可显示、已启用和可聚焦时才返回组件。子类可以通过覆盖accept方法来修改此行为。

此策略考虑到焦点遍历策略提供者。在搜索第一个/最后一个/下一个/上一个组件时，如果遇到焦点遍历策略提供者，则使用其焦点遍历策略执行搜索操作。

自 JDK 版本:
1.4
另请参阅:

  • Constructor Details

    • ContainerOrderFocusTraversalPolicy

      public ContainerOrderFocusTraversalPolicy()
      构造一个ContainerOrderFocusTraversalPolicy。

  • Method Details

    • getComponentAfter

      public Component getComponentAfter(Container aContainer, Component aComponent)
      返回在aComponent之后应该接收焦点的组件。aContainer必须是aComponent的焦点循环根或焦点遍历策略提供者。

      默认情况下，ContainerOrderFocusTraversalPolicy隐式地向下传递焦点循环。也就是说，在正常的向前焦点遍历期间，焦点循环根之后遍历的组件将是焦点循环根的默认要聚焦的组件。可以使用setImplicitDownCycleTraversal方法禁用此行为。

      如果aContainer是焦点遍历策略提供者，则焦点总是向下传递。

      指定者:
      getComponentAfter 在类中 FocusTraversalPolicy
      参数:
      aContainer - aComponent的焦点循环根或焦点遍历策略提供者
      aComponent - aContainer的（可能间接的）子组件，或aContainer本身
      返回:
      在aComponent之后应该接收焦点的组件，如果找不到合适的组件则返回null
      抛出:
      IllegalArgumentException - 如果aContainer不是aComponent的焦点循环根或焦点遍历策略提供者，或者aContainer或aComponent为null

    • getComponentBefore

      public Component getComponentBefore(Container aContainer, Component aComponent)
      返回在aComponent之前应该接收焦点的组件。aContainer必须是aComponent的焦点循环根或焦点遍历策略提供者。
      指定者:
      getComponentBefore 在类中 FocusTraversalPolicy
      参数:
      aContainer - aComponent的焦点循环根或焦点遍历策略提供者
      aComponent - aContainer的（可能间接的）子组件，或aContainer本身
      返回:
      在aComponent之前应该接收焦点的组件，如果找不到合适的组件则返回null
      抛出:
      IllegalArgumentException - 如果aContainer不是aComponent的焦点循环根或焦点遍历策略提供者，或者aContainer或aComponent为null

    • getFirstComponent

      public Component getFirstComponent(Container aContainer)
      返回遍历循环中的第一个组件。此方法用于确定在向前方向遍历包装时要聚焦的下一个组件。
      指定者:
      getFirstComponent 在类中 FocusTraversalPolicy
      参数:
      aContainer - 要返回其第一个组件的焦点循环根或焦点遍历策略提供者
      返回:
      aContainer遍历循环中的第一个组件，如果找不到合适的组件则返回null
      抛出:
      IllegalArgumentException - 如果aContainer为null

    • getLastComponent

      public Component getLastComponent(Container aContainer)
      返回遍历循环中的最后一个组件。此方法用于确定在向反向方向遍历包装时要聚焦的下一个组件。
      指定者:
      getLastComponent 在类中 FocusTraversalPolicy
      参数:
      aContainer - 要返回其最后一个组件的焦点循环根或焦点遍历策略提供者
      返回:
      aContainer遍历循环中的最后一个组件，如果找不到合适的组件则返回null
      抛出:
      IllegalArgumentException - 如果aContainer为null

    • getDefaultComponent

      public Component getDefaultComponent(Container aContainer)
      返回默认要聚焦的组件。当进入以aContainer为根的新焦点遍历循环时，此组件将首先接收焦点。此方法的默认实现返回与getFirstComponent相同的组件。
      指定者:
      getDefaultComponent 在类中 FocusTraversalPolicy
      参数:
      aContainer - 要返回其默认组件的焦点循环根或焦点遍历策略提供者
      返回:
      aContainer遍历循环中的默认组件，如果找不到合适的组件则返回null
      抛出:
      IllegalArgumentException - 如果aContainer为null
      另请参阅:

    • setImplicitDownCycleTraversal

      public void setImplicitDownCycleTraversal(boolean implicitDownCycleTraversal)
      设置此ContainerOrderFocusTraversalPolicy是否隐式传递焦点向下循环。如果为true，在正常的向前焦点遍历期间，焦点循环根之后遍历的组件将是焦点循环根的默认要聚焦的组件。如果为false，则将遍历指定焦点循环根的焦点遍历循环中的下一个组件。此属性的默认值为true。
      参数:
      implicitDownCycleTraversal - 此ContainerOrderFocusTraversalPolicy是否隐式传递焦点向下循环
      另请参阅:

    • getImplicitDownCycleTraversal

      public boolean getImplicitDownCycleTraversal()
      返回此ContainerOrderFocusTraversalPolicy是否隐式传递焦点向下循环。如果为true，在正常的向前焦点遍历期间，焦点循环根之后遍历的组件将是焦点循环根的默认要聚焦的组件。如果为false，则将遍历指定焦点循环根的焦点遍历循环中的下一个组件。
      返回:
      此ContainerOrderFocusTraversalPolicy是否隐式传递焦点向下循环
      另请参阅:

    • accept

      protected boolean accept(Component aComponent)
      确定组件是否适合作为新的焦点所有者。默认情况下，仅当组件可见、可显示、已启用和可聚焦时，此方法才会接受组件。
      参数:
      aComponent - 要测试其作为焦点所有者的适合性的组件
      返回:
      如果aComponent可见、可显示、已启用和可聚焦，则返回true；否则返回false