- 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
-
-
-
-
コンストラクタの詳細
-
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である場合- 関連項目:
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
-
-