- すべての実装されたインタフェース:
Serializable
- 直系の既知のサブクラス:
DefaultFocusTraversalPolicy
Container.getComponents()
によって返された配列の順序に従ってContainerの子をトラバースします。 階層の非表示部分は検索されません。
デフォルトでは、ContainerOrderFocusTraversalPolicyは暗黙にフォーカスを下のサイクルに転送します。 つまり通常のフォワード・フォーカス・トラバーサルでは、フォーカス・サイクル・ルートのあとでトラバースされるComponentが、フォーカス・サイクル・ルートのデフォルト・フォーカスComponentになります。 この動作は、setImplicitDownCycleTraversal
メソッドを使用して無効にできます。
デフォルトでは、このクラスのメソッドは、可視性、表示可能性、使用可能性、フォーカス可能性のすべてを満たす場合にのみ、Componentを返します。 サブクラスでこの動作を変更するには、accept
メソッドをオーバーライドします。
このポリシーは、フォーカス・トラバーサル・ポリシー・プロバイダを考慮しています。 最初/最後/次/前のComponentを検索する際に、フォーカス・トラバーサル・ポリシー・プロバイダが検出された場合は、そのフォーカス・トラバーサル・ポリシーを使用して検索操作が行われます。
- 導入されたバージョン:
- 1.4
- 関連項目:
-
コンストラクタのサマリー
-
メソッドのサマリー
修飾子と型メソッド説明protected boolean
Componentが新しいフォーカス所有者として適切かどうかを判定します。getComponentAfter
(Container aContainer, Component aComponent) aComponentのあとでフォーカスを受け取るComponentを返します。getComponentBefore
(Container aContainer, Component aComponent) aComponentの前にフォーカスを受け取るComponentを返します。getDefaultComponent
(Container aContainer) フォーカスするデフォルトのComponentを返します。getFirstComponent
(Container aContainer) トラバーサル・サイクルの最初のComponentを返します。boolean
このContainerOrderFocusTraversalPolicyがフォーカス・ダウン・サイクルを暗黙的に転送するかどうかを返します。getLastComponent
(Container aContainer) トラバーサル・サイクルの最後のComponentを返します。void
setImplicitDownCycleTraversal
(boolean implicitDownCycleTraversal) このContainerOrderFocusTraversalPolicyがフォーカス・ダウン・サイクルを暗黙的に転送するかどうかを設定します。クラス java.awt.FocusTraversalPolicyで宣言されたメソッド
getInitialComponent
-
コンストラクタの詳細
-
ContainerOrderFocusTraversalPolicy
public ContainerOrderFocusTraversalPolicy()ContainerOrderFocusTraversalPolicy
を構築します。
-
-
メソッドの詳細
-
getComponentAfter
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
aComponentの前にフォーカスを受け取るComponentを返します。aContainerはaComponentのフォーカス・サイクルのルートまたはフォーカス・トラバーサル・ポリシー・プロバイダである必要があります。- 定義:
getComponentBefore
、クラスFocusTraversalPolicy
- パラメータ:
aContainer
- aComponentのフォーカス・サイクル・ルートまたはフォーカス・トラバーサル・ポリシー・プロバイダaComponent
- aContainerの(おそらく間接的な)子、またはaContainer自身- 戻り値:
- aComponentの前にフォーカスを受け取るComponent。適切なComponentが見つからない場合はnull
- 例外:
IllegalArgumentException
- aContainerがaComponentのフォーカス・サイクル・ルートでもフォーカス・トラバーサル・ポリシー・プロバイダでもない場合、またはaContainerとaComponentのどちらかがnullである場合
-
getFirstComponent
トラバーサル・サイクルの最初のComponentを返します。 このメソッドは、順方向のトラバーサルがラップするときに、次にフォーカスするComponentを判定するために使用します。- 定義:
getFirstComponent
、クラスFocusTraversalPolicy
- パラメータ:
aContainer
- 最初のComponentが返されるフォーカス・サイクル・ルートまたはフォーカス・トラバーサル・ポリシー・プロバイダ- 戻り値:
- aContainerのトラバーサル・サイクルの最初のComponent。適切なComponentが見つからない場合はnull
- 例外:
IllegalArgumentException
- aContainerがnullである場合
-
getLastComponent
トラバーサル・サイクルの最後のComponentを返します。 このメソッドは、逆方向のトラバーサルがラップするときに、次にフォーカスするComponentを判定するために使用します。- 定義:
getLastComponent
、クラスFocusTraversalPolicy
- パラメータ:
aContainer
- 最後のComponentが返されるフォーカス・サイクル・ルートまたはフォーカス・トラバーサル・ポリシー・プロバイダ- 戻り値:
- aContainerのトラバーサル・サイクルの最後のComponent。適切なComponentが見つからない場合はnull
- 例外:
IllegalArgumentException
- aContainerがnullである場合
-
getDefaultComponent
フォーカスするデフォルトのComponentを返します。 aContainerにルートがある新しいフォーカス・トラバーサル・サイクルにトラバースするとき、このComponentは最初にフォーカスを受け取ります。 このメソッドのデフォルトの実装は、getFirstComponent
と同じComponentを返します。- 定義:
getDefaultComponent
、クラスFocusTraversalPolicy
- パラメータ:
aContainer
- デフォルトのComponentが返されるフォーカス・サイクル・ルートまたはフォーカス・トラバーサル・ポリシー・プロバイダ- 戻り値:
- aContainerのトラバーサル・サイクルのデフォルトのComponent。適切なComponentが見つからない場合はnull
- 例外:
IllegalArgumentException
- aContainerがnullである場合- 関連項目:
-
setImplicitDownCycleTraversal
public void setImplicitDownCycleTraversal(boolean implicitDownCycleTraversal) このContainerOrderFocusTraversalPolicyがフォーカス・ダウン・サイクルを暗黙的に転送するかどうかを設定します。true
の場合は、通常のフォワード・フォーカス・トラバーサル中、フォーカス・サイクル・ルートのあとにトラバースされたComponentが、そのフォーカス・サイクル・ルートのフォーカスするデフォルトのComponentになります。false
の場合は、指定されたフォーカス・サイクル・ルートをルートとするフォーカス・トラバーサル・サイクル内の次のComponentが代わりにトラバースされます。 このプロパティのデフォルト値はtrue
です。- パラメータ:
implicitDownCycleTraversal
- このContainerOrderFocusTraversalPolicyが、フォーカス・ダウン・サイクルを暗黙的に転送するかどうか- 関連項目:
-
getImplicitDownCycleTraversal
public boolean getImplicitDownCycleTraversal()このContainerOrderFocusTraversalPolicyがフォーカス・ダウン・サイクルを暗黙的に転送するかどうかを返します。true
の場合は、通常のフォワード・フォーカス・トラバーサル中、フォーカス・サイクル・ルートのあとにトラバースされたComponentが、そのフォーカス・サイクル・ルートのフォーカスするデフォルトのComponentになります。false
の場合は、指定されたフォーカス・サイクル・ルートをルートとするフォーカス・トラバーサル・サイクル内の次のComponentが代わりにトラバースされます。- 戻り値:
- このContainerOrderFocusTraversalPolicyが、フォーカス・ダウン・サイクルを暗黙的に転送するかどうか
- 関連項目:
-
accept
protected boolean accept(Component aComponent) Componentが新しいフォーカス所有者として適切かどうかを判定します。 デフォルトでは、可視性、表示可能性、使用可能性、フォーカス可能性のすべてを満たす場合だけ、Componentを受け入れます。- パラメータ:
aComponent
- フォーカス所有者としての適合性がテストされるComponent- 戻り値:
- aComponentが可視、表示可能、使用可能、フォーカス可能な場合は
true
、そうでない場合はfalse
-