java.awt
クラス FocusTraversalPolicy

java.lang.Object
  java.awt.FocusTraversalPolicy

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

ContainerOrderFocusTraversalPolicy, InternalFrameFocusTraversalPolicy

public abstract class FocusTraversalPolicy
extends Object

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

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

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

詳細は「How to Use the Focus Subsystem」、「The Java Tutorial」のセクション、「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) フォーカスを設定するデフォルトコンポーネントを返します。
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 のトラバーサルサイクルの先頭の Componet、または適切な Component が見つからない場合は null

例外:

IllegalArgumentException - aContainer が null の場合

getLastComponent

public abstract Component getLastComponent(Container aContainer)

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

パラメータ:

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

戻り値:

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

例外:

IllegalArgumentException - aContainer が null の場合

getDefaultComponent

public abstract Component getDefaultComponent(Container aContainer)

フォーカスを設定するデフォルトコンポーネントを返します。aContainer をルートとするフォーカストラバーサルサイクルが新しく開始されたときに、このコンポーネントに最初にフォーカスが設定されます。

パラメータ:

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

戻り値:

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

例外:

IllegalArgumentException - aContainer が null の場合

getInitialComponent

public Component getInitialComponent(Window window)

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

パラメータ:

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

戻り値:

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

例外:

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

関連項目:

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