SortingFocusTraversalPolicy (Java Platform SE 7)

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

関連項目:
Comparator

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

コンストラクタ
修飾子	コンストラクタと説明
`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 を返します。
`Component`	`getComponentBefore(Container aContainer, Component aComponent)` aComponent の前にフォーカスを受け取る Component を返します。
`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 がフォーカスを暗黙にダウンサイクルで移動するかどうかを設定します。

クラス javax.swing.InternalFrameFocusTraversalPolicy から継承されたメソッド
getInitialComponent

クラス java.awt.FocusTraversalPolicy から継承されたメソッド
getInitialComponent

クラス java.lang.Object から継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- コンストラクタの詳細
  - SortingFocusTraversalPolicy
```
protected SortingFocusTraversalPolicy()
```
    Comparator を使わずに SortingFocusTraversalPolicy を構築します。サブクラスは、フォーカスサイクルのルートまたは KeyboardFocusManager にこの FocusTraversalPolicy をインストールする前に、setComparator で Comparator を設定する必要があります。
  - SortingFocusTraversalPolicy
```
public SortingFocusTraversalPolicy(Comparator<? super Component> comparator)
```
    指定された Comparator で SortingFocusTraversalPolicy を構築します。
- メソッドの詳細
  - 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 である場合
    関連項目:
    getFirstComponent(java.awt.Container)
  - setImplicitDownCycleTraversal
```
public void setImplicitDownCycleTraversal(boolean implicitDownCycleTraversal)
```
    この SortingFocusTraversalPolicy がフォーカスを暗黙にダウンサイクルで移動するかどうかを設定します。true の場合、通常のフォーカストラバーサルでは、フォーカスサイクルのルートのあとにトラバースされる Component が、フォーカスサイクルのルートからフォーカスを受け取るデフォルトの Component になります。false の場合は、指定されたフォーカスサイクルルートをルートとするフォーカストラバーサルサイクル内の次の Component が代わりにトラバースされます。このプロパティーのデフォルト値は true です。
    
    パラメータ:
    implicitDownCycleTraversal - この SortingFocusTraversalPolicy が暗黙的にフォーカスをダウンサイクルで移動するかどうか
    関連項目:
    getImplicitDownCycleTraversal(), getFirstComponent(java.awt.Container)
  - getImplicitDownCycleTraversal
```
public boolean getImplicitDownCycleTraversal()
```
    この SortingFocusTraversalPolicy がフォーカスを暗黙的にダウンサイクルで移動するかどうかを返します。true の場合、通常のフォーカストラバーサルでは、フォーカスサイクルのルートのあとにトラバースされる Component が、フォーカスサイクルのルートからフォーカスを受け取るデフォルトの Component になります。false の場合は、指定されたフォーカスサイクルルートをルートとするフォーカストラバーサルサイクル内の次の Component が代わりにトラバースされます。
    
    戻り値:
    この SortingFocusTraversalPolicy が暗黙的にフォーカスをダウンサイクルで移動するかどうか
    関連項目:
    setImplicitDownCycleTraversal(boolean), getFirstComponent(java.awt.Container)
  - 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

バグまたは機能を送信
詳細な API リファレンスおよび開発者ドキュメントについては、Java SE のドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.

クラス SortingFocusTraversalPolicy

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

メソッドのサマリー

クラス javax.swing.InternalFrameFocusTraversalPolicy から継承されたメソッド

クラス java.awt.FocusTraversalPolicy から継承されたメソッド

クラス java.lang.Object から継承されたメソッド

コンストラクタの詳細

SortingFocusTraversalPolicy

SortingFocusTraversalPolicy

メソッドの詳細

getComponentAfter

getComponentBefore

getFirstComponent

getLastComponent

getDefaultComponent

setImplicitDownCycleTraversal

getImplicitDownCycleTraversal

setComparator

getComparator

accept