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 メソッドをオーバーライドします。

このポリシーはフォーカストラバーサルポリシープロバイダを考慮します。最初 / 最後 / 次 / 前のコンポーネントを検索する際に、フォーカストラバーサルポリシープロバイダが検出された場合、そのフォーカストラバーサルポリシーを使用して、検索処理が実行されます。

導入されたバージョン:

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 のトラバーサルサイクルの先頭の Componet、または適切な Component が見つからない場合は null

例外:

IllegalArgumentException - aContainer が null の場合

getLastComponent

public Component getLastComponent(Container aContainer)

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

定義:

クラス FocusTraversalPolicy 内の getLastComponent

パラメータ:

aContainer - 最後の Component を返すフォーカスサイクルのルートまたはフォーカストラバーサルポリシープロバイダ

戻り値:

aContainer のトラバーサルサイクルの最後の Componet、または適切な Component が見つからない場合は null

例外:

IllegalArgumentException - aContainer が null の場合

getDefaultComponent

public Component getDefaultComponent(Container aContainer)

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

定義:

クラス FocusTraversalPolicy 内の getDefaultComponent

パラメータ:

aContainer - デフォルトの Component を返すフォーカスサイクルのルートまたはフォーカストラバーサルポリシープロバイダ

戻り値:

aContainer のトラバーサルサイクルのデフォルトの Componet、または適切な Component が見つからない場合は null

例外:

IllegalArgumentException - aContainer が null の場合

関連項目:

getFirstComponent(java.awt.Container)

setImplicitDownCycleTraversal

public void setImplicitDownCycleTraversal(boolean implicitDownCycleTraversal)

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

パラメータ:

implicitDownCycleTraversal - この ContainerOrderFocusTraversalPolicy がフォーカスダウンサイクルを暗黙に転送するかどうか

関連項目:

getImplicitDownCycleTraversal(), getFirstComponent(java.awt.Container)

getImplicitDownCycleTraversal

public boolean getImplicitDownCycleTraversal()

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

戻り値:

この ContainerOrderFocusTraversalPolicy がフォーカスダウンサイクルを暗黙に転送するかどうか

関連項目:

setImplicitDownCycleTraversal(boolean), getFirstComponent(java.awt.Container)

accept

protected boolean accept(Component aComponent)

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

パラメータ:

aComponent - フォーカスオーナとして適切かどうかを判定する Component

戻り値:

aComponent が可視、表示可能、使用可能、フォーカス可能な場合は true、そうでない場合は false