モジュール java.desktop
パッケージ java.awt

クラスContainerOrderFocusTraversalPolicy

java.lang.Object
java.awt.FocusTraversalPolicy
java.awt.ContainerOrderFocusTraversalPolicy
すべての実装されたインタフェース:
Serializable
直系の既知のサブクラス:
DefaultFocusTraversalPolicy
public class ContainerOrderFocusTraversalPolicy
extends FocusTraversalPolicy
implements Serializable
Containerの子Componentの順序を基準に、トラバーサル順序を決定するFocusTraversalPolicyです。 特定のフォーカス・サイクル・ルートから、このポリシーはComponent階層のトラバーサルを事前に決定し、Container.getComponents()によって返された配列の順序に従ってContainerの子をトラバースします。 階層の非表示部分は検索されません。

デフォルトでは、ContainerOrderFocusTraversalPolicyは暗黙にフォーカスを下のサイクルに転送します。 つまり通常のフォワード・フォーカス・トラバーサルでは、フォーカス・サイクル・ルートのあとでトラバースされるComponentが、フォーカス・サイクル・ルートのデフォルト・フォーカスComponentになります。 この動作は、setImplicitDownCycleTraversalメソッドを使用して無効にできます。

デフォルトでは、このクラスのメソッドは、可視性、表示可能性、使用可能性、フォーカス可能性のすべてを満たす場合にのみ、Componentを返します。 サブクラスでこの動作を変更するには、acceptメソッドをオーバーライドします。

このポリシーは、フォーカス・トラバーサル・ポリシー・プロバイダを考慮しています。 最初/最後/次/前のComponentを検索する際に、フォーカス・トラバーサル・ポリシー・プロバイダが検出された場合は、そのフォーカス・トラバーサル・ポリシーを使用して検索操作が行われます。

導入されたバージョン:
1.4
関連項目:
Container.getComponents(), 直列化された形式

  • コンストラクタの詳細

  • メソッドの詳細

    • getComponentAfter

      public Component getComponentAfter​(Container aContainer, Component aComponent)
      aComponentのあとでフォーカスを受け取るComponentを返します。aContainerは、aComponentのフォーカス・サイクルのルートまたはフォーカス・トラバーサル・ポリシー・プロバイダである必要があります。

      デフォルトでは、ContainerOrderFocusTraversalPolicyは暗黙にフォーカスを下のサイクルに転送します。 つまり通常のフォワード・フォーカス・トラバーサルでは、フォーカス・サイクル・ルートのあとでトラバースされるComponentが、フォーカス・サイクル・ルートのデフォルト・フォーカスComponentになります。 この動作は、setImplicitDownCycleTraversalメソッドを使用して無効にできます。

      aContainerがフォーカス・トラバーサル・ポリシー・プロバイダである場合、フォーカスは常にダウンサイクルで転送されます。

      定義:
      getComponentAfter、クラス: FocusTraversalPolicy
      パラメータ:
      aContainer - aComponentのフォーカス・サイクル・ルートまたはフォーカス・トラバーサル・ポリシー・プロバイダ
      aComponent - aContainerの(おそらく間接的な)子、またはaContainer自身
      戻り値:
      aComponentのあとにフォーカスを受け取るComponent。適切なComponentが見つからない場合はnull
      例外:
      IllegalArgumentException - aContainerがaComponentのフォーカス・サイクル・ルートでもフォーカス・トラバーサル・ポリシー・プロバイダでもない場合、またはaContainerとaComponentのどちらかがnullである場合

    • getComponentBefore

      public Component getComponentBefore​(Container aContainer, Component aComponent)
      aComponentの前にフォーカスを受け取るComponentを返します。aContainerはaComponentのフォーカス・サイクルのルートまたはフォーカス・トラバーサル・ポリシー・プロバイダである必要があります。
      定義:
      getComponentBefore、クラス: FocusTraversalPolicy
      パラメータ:
      aContainer - aComponentのフォーカス・サイクル・ルートまたはフォーカス・トラバーサル・ポリシー・プロバイダ
      aComponent - aContainerの(おそらく間接的な)子、またはaContainer自身
      戻り値:
      aComponentの前にフォーカスを受け取るComponent。適切なComponentが見つからない場合はnull
      例外:
      IllegalArgumentException - aContainerがaComponentのフォーカス・サイクル・ルートでもフォーカス・トラバーサル・ポリシー・プロバイダでもない場合、またはaContainerとaComponentのどちらかがnullである場合

    • getFirstComponent

      public Component getFirstComponent​(Container aContainer)
      トラバーサル・サイクルの最初のComponentを返します。 このメソッドは、順方向のトラバーサルがラップするときに、次にフォーカスするComponentを判定するために使用します。
      定義:
      getFirstComponent、クラス: FocusTraversalPolicy
      パラメータ:
      aContainer - 最初のComponentが返されるフォーカス・サイクル・ルートまたはフォーカス・トラバーサル・ポリシー・プロバイダ
      戻り値:
      aContainerのトラバーサル・サイクルの最初のComponent。適切なComponentが見つからない場合はnull
      例外:
      IllegalArgumentException - aContainerがnullである場合

    • getLastComponent

      public Component getLastComponent​(Container aContainer)
      トラバーサル・サイクルの最後のComponentを返します。 このメソッドは、逆方向のトラバーサルがラップするときに、次にフォーカスするComponentを判定するために使用します。
      定義:
      getLastComponent、クラス: FocusTraversalPolicy
      パラメータ:
      aContainer - 最後のComponentが返されるフォーカス・サイクル・ルートまたはフォーカス・トラバーサル・ポリシー・プロバイダ
      戻り値:
      aContainerのトラバーサル・サイクルの最後のComponent。適切なComponentが見つからない場合はnull
      例外:
      IllegalArgumentException - aContainerがnullである場合

    • getDefaultComponent

      public Component getDefaultComponent​(Container aContainer)
      フォーカスするデフォルトのComponentを返します。 aContainerにルートがある新しいフォーカス・トラバーサル・サイクルにトラバースするとき、このComponentは最初にフォーカスを受け取ります。 このメソッドのデフォルトの実装は、getFirstComponentと同じComponentを返します。
      定義:
      getDefaultComponent、クラス: FocusTraversalPolicy
      パラメータ:
      aContainer - デフォルトのComponentが返されるフォーカス・サイクル・ルートまたはフォーカス・トラバーサル・ポリシー・プロバイダ
      戻り値:
      aContainerのトラバーサル・サイクルのデフォルトのComponent。適切なComponentが見つからない場合はnull
      例外:
      IllegalArgumentException - aContainerがnullである場合
      関連項目:
      getFirstComponent(java.awt.Container)

    • setImplicitDownCycleTraversal

      public void setImplicitDownCycleTraversal​(boolean implicitDownCycleTraversal)
      このContainerOrderFocusTraversalPolicyがフォーカス・ダウン・サイクルを暗黙的に転送するかどうかを設定します。 trueの場合は、通常のフォワード・フォーカス・トラバーサル中、フォーカス・サイクル・ルートのあとにトラバースされたComponentが、そのフォーカス・サイクル・ルートのフォーカスするデフォルトのComponentになります。 falseの場合は、指定されたフォーカス・サイクル・ルートをルートとするフォーカス・トラバーサル・サイクル内の次のComponentが代わりにトラバースされます。 このプロパティのデフォルト値はtrueです。
      パラメータ:
      implicitDownCycleTraversal - このContainerOrderFocusTraversalPolicyが、フォーカス・ダウン・サイクルを暗黙的に転送するかどうか
      関連項目:
      getImplicitDownCycleTraversal(), getFirstComponent(java.awt.Container)

    • getImplicitDownCycleTraversal

      public boolean getImplicitDownCycleTraversal()
      このContainerOrderFocusTraversalPolicyがフォーカス・ダウン・サイクルを暗黙的に転送するかどうかを返します。 trueの場合は、通常のフォワード・フォーカス・トラバーサル中、フォーカス・サイクル・ルートのあとにトラバースされたComponentが、そのフォーカス・サイクル・ルートのフォーカスするデフォルトのComponentになります。 falseの場合は、指定されたフォーカス・サイクル・ルートをルートとするフォーカス・トラバーサル・サイクル内の次のComponentが代わりにトラバースされます。
      戻り値:
      このContainerOrderFocusTraversalPolicyが、フォーカス・ダウン・サイクルを暗黙的に転送するかどうか
      関連項目:
      setImplicitDownCycleTraversal(boolean), getFirstComponent(java.awt.Container)

    • accept

      protected boolean accept​(Component aComponent)
      Componentが新しいフォーカス所有者として適切かどうかを判定します。 デフォルトでは、可視性、表示可能性、使用可能性、フォーカス可能性のすべてを満たす場合だけ、Componentを受け入れます。
      パラメータ:
      aComponent - フォーカス所有者としての適合性がテストされるComponent
      戻り値:
      aComponentが可視、表示可能、使用可能、フォーカス可能な場合はtrue、そうでない場合はfalse