ContainerOrderFocusTraversalPolicy (Java Platform SE 8)

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()

コンストラクタ
コンストラクタと説明
`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

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

- コンストラクタの詳細
  - ContainerOrderFocusTraversalPolicy
```
public ContainerOrderFocusTraversalPolicy()
```
- メソッドの詳細
  - 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

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

クラスContainerOrderFocusTraversalPolicy

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

メソッドのサマリー

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

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

コンストラクタの詳細

ContainerOrderFocusTraversalPolicy

メソッドの詳細

getComponentAfter

getComponentBefore

getFirstComponent

getLastComponent

getDefaultComponent

setImplicitDownCycleTraversal

getImplicitDownCycleTraversal

accept