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