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, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Documentation Redistribution Policyも参照してください。

クラスContainerOrderFocusTraversalPolicy

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

メソッドのサマリー

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

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

コンストラクタの詳細

ContainerOrderFocusTraversalPolicy

メソッドの詳細

getComponentAfter

getComponentBefore

getFirstComponent

getLastComponent

getDefaultComponent

setImplicitDownCycleTraversal

getImplicitDownCycleTraversal

accept