JavaTM Platform
Standard Ed. 6

java.awt
クラス ContainerOrderFocusTraversalPolicy

java.lang.Object
  上位を拡張 java.awt.FocusTraversalPolicy
      上位を拡張 java.awt.ContainerOrderFocusTraversalPolicy
すべての実装されたインタフェース:
Serializable
直系の既知のサブクラス:
DefaultFocusTraversalPolicy

public class ContainerOrderFocusTraversalPolicy
extends FocusTraversalPolicy
implements Serializable

コンテナの子コンポーネントの順序を基準に、トラバーサル順序を決定する FocusTraversalPolicy です。特定のフォーカスサイクルルートから、コンポーネント階層のトラバーサルを事前に決定し、Container.getComponents() で返された配列の順序に従ってコンテナの子をトラバースします。階層の非表示部分は検索されません。

デフォルトでは、ContainerOrderFocusTraversalPolicy はフォーカスをダウンサイクル転送します。つまり通常のフォワードフォーカストラバーサルでは、フォーカスサイクルルートのあとでトラバースされるコンポーネントが、フォーカスサイクルルートのデフォルトフォーカスコンポーネントになります。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
 
クラス 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 はフォーカスをダウンサイクル転送します。つまり通常のフォワードフォーカストラバーサルでは、フォーカスサイクルルートのあとでトラバースされるコンポーネントが、フォーカスサイクルルートのデフォルトフォーカスコンポーネントになります。setImplicitDownCycleTraversal メソッドでこの動作を無効にすることができます。

aContainer がフォーカストラバーサルポリシープロバイダである場合、フォーカスは常にダウンサイクルで転送されます。

定義:
クラス FocusTraversalPolicy 内の getComponentAfter
パラメータ:
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 のフォーカスサイクルのルートまたはフォーカストラバーサルポリシープロバイダである必要があります。

定義:
クラス FocusTraversalPolicy 内の getComponentBefore
パラメータ:
aContainer - aComponent のフォーカスサイクルのルートまたはフォーカストラバーサルポリシープロバイダ
aComponent - aContainer の (場合によっては間接的な) 子、または aContainer 自身
戻り値:
aComponent の前にフォーカスを受け取る Component。適切な Component が見つからない場合は null
例外:
IllegalArgumentException - aContainer が aComponent のフォーカスサイクルのルートまたはフォーカストラバーサルポリシープロバイダでない場合、あるいは aContainer または aComponent が null の場合

getFirstComponent

public Component getFirstComponent(Container aContainer)
トラバーサルサイクルの最初の Component を返します。このメソッドは、順方向のトラバーサルがラップするときに、次にフォーカスする Component を判定するために使用します。

定義:
クラス FocusTraversalPolicy 内の getFirstComponent
パラメータ:
aContainer - 先頭の Component を返すフォーカスサイクルのルートまたはフォーカストラバーサルポリシープロバイダ
戻り値:
aContainer のトラバーサルサイクルの最初の Component。適切な Component が見つからない場合は null
例外:
IllegalArgumentException - aContainer が null の場合

getLastComponent

public Component getLastComponent(Container aContainer)
トラバーサルサイクルの最後の Component を返します。このメソッドは、逆方向のトラバーサルがラップするときに、次にフォーカスする Component を判定するために使用します。

定義:
クラス FocusTraversalPolicy 内の getLastComponent
パラメータ:
aContainer - 最後の Component を返すフォーカスサイクルのルートまたはフォーカストラバーサルポリシープロバイダ
戻り値:
aContainer のトラバーサルサイクルの最後の Component。適切な Component が見つからない場合は null
例外:
IllegalArgumentException - aContainer が null の場合

getDefaultComponent

public Component getDefaultComponent(Container aContainer)
フォーカスするデフォルトの Component を返します。aContainer にルートがある新しいフォーカストラバーサルサイクルにトラバースするとき、この Component は最初にフォーカスを受け取ります。このメソッドのデフォルトの実装は、getFirstComponent と同じ Component を返します。

定義:
クラス FocusTraversalPolicy 内の getDefaultComponent
パラメータ:
aContainer - デフォルトの Component を返すフォーカスサイクルのルートまたはフォーカストラバーサルポリシープロバイダ
戻り値:
aContainer のトラバーサルサイクルのデフォルトの Component。適切な Component が見つからない場合は null
例外:
IllegalArgumentException - aContainer が null の場合
関連項目:
getFirstComponent(java.awt.Container)

setImplicitDownCycleTraversal

public void setImplicitDownCycleTraversal(boolean implicitDownCycleTraversal)
この ContainerOrderFocusTraversalPolicy が、フォーカスダウンサイクルを暗黙に転送するかどうかを設定します。true の場合、通常のフォワードフォーカストラバーサルでは、フォーカスサイクルルートのあとにトラバースされるコンポーネントは、フォーカスサイクルルートのデフォルトフォーカスコンポーネントになります。false の場合、指定されたフォーカスサイクルをルートにするフォーカストラバーサルサイクル内の、次の Component が代わりにトラバースされます。このプロパティーのデフォルト値は true です。

パラメータ:
implicitDownCycleTraversal - この ContainerOrderFocusTraversalPolicy が、フォーカスダウンサイクルを暗黙に転送するかどうか
関連項目:
getImplicitDownCycleTraversal(), getFirstComponent(java.awt.Container)

getImplicitDownCycleTraversal

public boolean getImplicitDownCycleTraversal()
この ContainerOrderFocusTraversalPolicy が、フォーカスダウンサイクルを暗黙に転送するかどうかを返します。true の場合、通常のフォワードフォーカストラバーサルでは、フォーカスサイクルルートのあとにトラバースされるコンポーネントは、フォーカスサイクルルートのデフォルトフォーカスコンポーネントになります。false の場合、指定されたフォーカスサイクルをルートにするフォーカストラバーサルサイクル内の、次の Component が代わりにトラバースされます。

戻り値:
この ContainerOrderFocusTraversalPolicy が、フォーカスダウンサイクルを暗黙に転送するかどうか
関連項目:
setImplicitDownCycleTraversal(boolean), getFirstComponent(java.awt.Container)

accept

protected boolean accept(Component aComponent)
Component が新しいフォーカスオーナとして適切かどうかを判定します。デフォルトでは、可視性、表示可能性、使用可能性、フォーカス可能性のすべてを満たす場合だけ、Component を受け入れます。

パラメータ:
aComponent - フォーカス所有者として適切かどうかを判定する Component
戻り値:
aComponent が可視、表示可能、使用可能、フォーカス可能な場合は true、そうでない場合は false

JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2009 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。