- java.lang.Object
-
- java.awt.FocusTraversalPolicy
-
- 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()
-
メソッドのサマリー
修飾子と型 メソッド 説明 protected boolean
accept(Component aComponent)
Componentが新しいフォーカス所有者として適切かどうかを判定します。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()
このContainerOrderFocusTraversalPolicyがフォーカス・ダウン・サイクルを暗黙的に転送するかどうかを返します。Component
getLastComponent(Container aContainer)
トラバーサル・サイクルの最後のComponentを返します。void
setImplicitDownCycleTraversal(boolean implicitDownCycleTraversal)
このContainerOrderFocusTraversalPolicyがフォーカス・ダウン・サイクルを暗黙的に転送するかどうかを設定します。-
クラス java.awt.FocusTraversalPolicyで宣言されたメソッド
getInitialComponent
-
-
-
-
メソッドの詳細
-
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
-
-