クラスSortingFocusTraversalPolicy

java.lang.Object
java.awt.FocusTraversalPolicy
javax.swing.InternalFrameFocusTraversalPolicy
javax.swing.SortingFocusTraversalPolicy
直系の既知のサブクラス:
LayoutFocusTraversalPolicy
public class SortingFocusTraversalPolicy extends InternalFrameFocusTraversalPolicy
指定されたComparatorに基づいてフォーカス・トラバーサル・サイクルのComponentをソートすることによって、トラバーサル順序を決定するFocusTraversalPolicyです。 Componentの階層のうち、可視でも表示可能でもない部分は含まれません。

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

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

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

導入されたバージョン:
1.4
関連項目:

  • コンストラクタのサマリー

    コンストラクタ
    修飾子
    コンストラクタ
    説明
    protected
    SortingFocusTraversalPolicy()
    Comparatorを使わずにSortingFocusTraversalPolicyを構築します。
     
    SortingFocusTraversalPolicy(Comparator<? super Component> comparator)
    指定されたComparatorでSortingFocusTraversalPolicyを構築します。

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    protected boolean
    accept(Component aComponent)
    Componentが新しいフォーカス所有者として適切かどうかを判定します。
    protected Comparator<? super Component>
    getComparator()
    フォーカス・トラバーサル・サイクルでComponentsをソートするために使うComparatorを返します。
    Component
    getComponentAfter(Container aContainer, Component aComponent)
    aComponentのあとでフォーカスを受け取るComponentを返します。aContainerは、aComponentのフォーカス・サイクルのルートまたはフォーカス・トラバーサル・ポリシー・プロバイダである必要があります。
    Component
    getComponentBefore(Container aContainer, Component aComponent)
    aComponentの前にフォーカスを受け取るComponentを返します。aContainerはaComponentのフォーカス・サイクルのルートまたはフォーカス・トラバーサル・ポリシー・プロバイダである必要があります。
    Component
    getDefaultComponent(Container aContainer)
    フォーカスするデフォルトのComponentを返します。
    Component
    getFirstComponent(Container aContainer)
    トラバーサル・サイクルの最初のComponentを返します。
    boolean
    getImplicitDownCycleTraversal()
    このSortingFocusTraversalPolicyがフォーカスを暗黙的にダウンサイクルで移動するかどうかを返します。
    Component
    getLastComponent(Container aContainer)
    トラバーサル・サイクルの最後のComponentを返します。
    protected void
    setComparator(Comparator<? super Component> comparator)
    フォーカス・トラバーサル・サイクルでComponentsをソートするために使うComparatorを設定します。
    void
    setImplicitDownCycleTraversal(boolean implicitDownCycleTraversal)
    このSortingFocusTraversalPolicyがフォーカスを暗黙にダウンサイクルで移動するかどうかを設定します。

    クラスで宣言されたメソッド InternalFrameFocusTraversalPolicy

    getInitialComponent
    修飾子と型
    メソッド
    説明
    Component
    getInitialComponent(JInternalFrame frame)
    JinternalFrameが最初に選択されたときにフォーカスを受け取るComponentを返します。

    クラスで宣言されたメソッド FocusTraversalPolicy

    getInitialComponent
    修飾子と型
    メソッド
    説明
    Component
    getInitialComponent(Window window)
    ウィンドウがはじめて表示されたときにフォーカスを受信するべきComponentを返します。

    クラスオブジェクトで宣言されたメソッド

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    修飾子と型
    メソッド
    説明
    protected Object
    clone()
    このオブジェクトのコピーを作成して、返します。
    boolean
    equals(Object obj)
    このオブジェクトと他のオブジェクトが等しいかどうかを示します。
    protected void
    finalize()
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    最終決定は非推奨であり、将来のリリースで削除される可能性があります。
    final Class<?>
    getClass()
    このObjectの実行時クラスを返します。
    int
    hashCode()
    このオブジェクトに対するハッシュ・コード値を返します。
    final void
    notify()
    このオブジェクトのモニターで待機中のスレッドを1つ再開します。
    final void
    notifyAll()
    このオブジェクトのモニターで待機中のすべてのスレッドを再開します。
    String
    toString()
    オブジェクトの文字列表現を返します。
    final void
    wait()
    現在のスレッドが目覚めるまで待機します。通常、notifiedまたはinterruptedです。
    final void
    wait(long timeoutMillis)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
    final void
    wait(long timeoutMillis, int nanos)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

  • コンストラクタの詳細

    • SortingFocusTraversalPolicy

      protected SortingFocusTraversalPolicy()
      Comparatorを使わずにSortingFocusTraversalPolicyを構築します。 サブクラスは、フォーカス・サイクルのルートまたはKeyboardFocusManagerにこのFocusTraversalPolicyをインストールする前に、setComparatorでComparatorを設定する必要があります。

    • SortingFocusTraversalPolicy

      public SortingFocusTraversalPolicy(Comparator<? super Component> comparator)
      指定されたComparatorでSortingFocusTraversalPolicyを構築します。
      パラメータ:
      comparator - 並べ替えるComparator

  • メソッドの詳細

    • getComponentAfter

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

      デフォルトでは、SortingFocusTraversalPolicyは暗黙にフォーカスを下のサイクルに転送します。 つまり、通常のフォーカス・トラバーサルの場合、フォーカス・サイクルのルートのあとにトラバースされる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のフォーカス・サイクルのルートまたはフォーカス・トラバーサル・ポリシー・プロバイダである必要があります。

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

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

      定義:
      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が返されるaComponentのフォーカス・サイクル・ルートまたはフォーカス・トラバーサル・ポリシー・プロバイダ
      戻り値:
      aContainerのトラバーサル・サイクルの最初のComponent。適切なComponentが見つからない場合はnull
      スロー:
      IllegalArgumentException - aContainerがnullである場合

    • getLastComponent

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

    • getDefaultComponent

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

    • setImplicitDownCycleTraversal

      public void setImplicitDownCycleTraversal(boolean implicitDownCycleTraversal)
      このSortingFocusTraversalPolicyがフォーカスを暗黙にダウンサイクルで移動するかどうかを設定します。 trueの場合、通常のフォーカス・トラバーサルでは、フォーカス・サイクルのルートのあとにトラバースされるComponentが、フォーカス・サイクルのルートからフォーカスを受け取るデフォルトのComponentになります。 falseの場合は、指定されたフォーカス・サイクル・ルートをルートとするフォーカス・トラバーサル・サイクル内の次のComponentが代わりにトラバースされます。 このプロパティのデフォルト値はtrueです。
      パラメータ:
      implicitDownCycleTraversal - このSortingFocusTraversalPolicyが暗黙的にフォーカスをダウンサイクルで移動するかどうか
      関連項目:

    • getImplicitDownCycleTraversal

      public boolean getImplicitDownCycleTraversal()
      このSortingFocusTraversalPolicyがフォーカスを暗黙的にダウンサイクルで移動するかどうかを返します。 trueの場合、通常のフォーカス・トラバーサルでは、フォーカス・サイクルのルートのあとにトラバースされるComponentが、フォーカス・サイクルのルートからフォーカスを受け取るデフォルトのComponentになります。 falseの場合は、指定されたフォーカス・サイクル・ルートをルートとするフォーカス・トラバーサル・サイクル内の次のComponentが代わりにトラバースされます。
      戻り値:
      このSortingFocusTraversalPolicyが暗黙的にフォーカスをダウンサイクルで移動するかどうか
      関連項目:

    • setComparator

      protected void setComparator(Comparator<? super Component> comparator)
      フォーカス・トラバーサル・サイクルでComponentsをソートするために使うComparatorを設定します。
      パラメータ:
      comparator - ソートに使うComparator

    • getComparator

      protected Comparator<? super Component> getComparator()
      フォーカス・トラバーサル・サイクルでComponentsをソートするために使うComparatorを返します。
      戻り値:
      ソートに使うComparator

    • accept

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