java.awt
クラス FocusTraversalPolicy

java.lang.Object
  java.awt.FocusTraversalPolicy

直系の既知のサブクラス:

ContainerOrderFocusTraversalPolicy, InternalFrameFocusTraversalPolicy

public abstract class FocusTraversalPolicy
extends Object

FocusTraversalPolicy は、あるフォーカスサイクルルートを持つコンポーネントのトラバース順序を定義します。インスタンスは任意のフォーカスサイクルルートにこのポリシーを適用でき、コンテナ間での共有を可能にします。コンポーネント階層のフォーカスサイクルルートが変わっても初期化をもう一度する必要はありません。

FocusTraversalPolicy の主な役割は、UI でフォワードトラバーサルやバックワードトラバーサルが発生するときに、フォーカス対象となるコンポーネント決定のアルゴリズムの提供です。各 FocusTraversalPolicy は、トラバーサルサイクルの最初のコンポーネント、最後のコンポーネント、およびデフォルトコンポーネント決定のアルゴリズムも提供しなければなりません。最初のコンポーネントと最後のコンポーネントは、通常のフォワードトラバーサルとバックワードトラバーサルを循環させるために使用されます。デフォルトコンポーネントは、新しいフォーカストラバーサルサイクルが開始されたときに、最初にフォーカスが設定されるコンポーネントです。FocusTraversalPolicy はまた、ウィンドウの初期コンポーネント決定のアルゴリズムもオプションで提供しています。初期コンポーネントにはウィンドウが最初に表示されるときにフォーカスが設定されます。

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

詳細については、「The Java Tutorial」の「How to Use the Focus Subsystem」および「Focus Specification」 を参照してください。

導入されたバージョン:

1.4

関連項目:

Container.setFocusTraversalPolicy(java.awt.FocusTraversalPolicy), Container.getFocusTraversalPolicy(), Container.setFocusCycleRoot(boolean), Container.isFocusCycleRoot(java.awt.Container), Container.setFocusTraversalPolicyProvider(boolean), Container.isFocusTraversalPolicyProvider(), KeyboardFocusManager.setDefaultFocusTraversalPolicy(java.awt.FocusTraversalPolicy), KeyboardFocusManager.getDefaultFocusTraversalPolicy()

コンストラクタの概要

FocusTraversalPolicy()

メソッドの概要

abstract Component	getComponentAfter(Container aContainer, Component aComponent) aComponent のあとでフォーカスを受け取る Component を返します。
abstract Component	getComponentBefore(Container aContainer, Component aComponent) aComponent の前にフォーカスを受け取る Component を返します。
abstract Component	getDefaultComponent(Container aContainer) フォーカスするデフォルトの Component を返します。
abstract Component	getFirstComponent(Container aContainer) トラバーサルサイクルの最初の Component を返します。
Component	getInitialComponent(Window window) ウィンドウが最初に表示されたときにフォーカスが設定されるコンポーネントを返します。
abstract Component	getLastComponent(Container aContainer) トラバーサルサイクルの最後の Component を返します。

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

コンストラクタの詳細

FocusTraversalPolicy

public FocusTraversalPolicy()

メソッドの詳細

getComponentAfter

public abstract Component getComponentAfter(Container aContainer,
                                            Component aComponent)

aComponent のあとでフォーカスを受け取る Component を返します。 aContainer には、aComponent のフォーカスサイクルのルートまたはフォーカストラバーサルポリシープロバイダを指定する必要があります。

パラメータ:

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

aComponent - aContainer の (場合によっては間接的な) 子、 または aContainer 自身

戻り値:

aComponent のあとにフォーカスを受け取る Component。 適切な Component が見つからない場合は null

例外:

IllegalArgumentException - aContainer が aComponent のフォーカスサイクルの ルートまたはフォーカストラバーサルポリシープロバイダでない場合、 あるいは aContainer または aComponent が null の場合

getComponentBefore

public abstract Component getComponentBefore(Container aContainer,
                                             Component aComponent)

aComponent の前にフォーカスを受け取る Component を返します。 aContainer には、aComponent のフォーカスサイクルのルートまたはフォーカストラバーサルポリシープロバイダを指定する必要があります。

パラメータ:

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

aComponent - aContainer の (場合によっては間接的な) 子、 または aContainer 自身

戻り値:

aComponent の前にフォーカスを受け取る Component。 適切な Component が見つからない場合は null

例外:

IllegalArgumentException - aContainer が aComponent のフォーカスサイクルの ルートまたはフォーカストラバーサルポリシープロバイダでない場合、 あるいは aContainer または aComponent が null の場合

getFirstComponent

public abstract Component getFirstComponent(Container aContainer)

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

パラメータ:

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

戻り値:

aContainer のトラバーサルサイクルの最初の Component。 適切な Component が見つからない場合は null

例外:

IllegalArgumentException - aContainer が null の場合

getLastComponent

public abstract Component getLastComponent(Container aContainer)

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

パラメータ:

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

戻り値:

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

例外:

IllegalArgumentException - aContainer が null の場合

getDefaultComponent

public abstract Component getDefaultComponent(Container aContainer)

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

パラメータ:

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

戻り値:

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

例外:

IllegalArgumentException - aContainer が null の場合

getInitialComponent

public Component getInitialComponent(Window window)

ウィンドウが最初に表示されたときにフォーカスが設定されるコンポーネントを返します。show() または setVisible(true) の呼び出しで一度ウィンドウが表示されると、初期化コンポーネントはそれ以降使用されません。一度別のウィンドウに移ったフォーカスが再び設定された場合、または、一度非表示状態になったウィンドウが再び表示された場合は、そのウィンドウの最後にフォーカスが設定されたコンポーネントがフォーカス所有者になります。このメソッドのデフォルト実装ではデフォルトコンポーネントを返します。

パラメータ:

window - 初期コンポーネントが返されるウィンドウ

戻り値:

最初にウィンドウが表示される時にフォーカス設定されるコンポーネント。 適切なコンポーネントがない場合は null

例外:

IllegalArgumentException - ウィンドウが null の場合

関連項目:

getDefaultComponent(java.awt.Container), Window.getMostRecentFocusOwner()