モジュール java.desktop
パッケージ 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(), 直列化された形式

    • コンストラクタの詳細

      • ContainerOrderFocusTraversalPolicy

        public ContainerOrderFocusTraversalPolicy()

    • メソッドの詳細

      • 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