JavaTM 2
Platform
Std. Ed. v1.4.0

java.awt
クラス FocusTraversalPolicy

java.lang.Object
  |
  +--java.awt.FocusTraversalPolicy
直系の既知のサブクラス:
ContainerOrderFocusTraversalPolicy, InternalFrameFocusTraversalPolicy

public abstract class FocusTraversalPolicy
extends Object

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

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

導入されたバージョン:
1.4
関連項目:
Container.setFocusTraversalPolicy(java.awt.FocusTraversalPolicy), Container.getFocusTraversalPolicy(), KeyboardFocusManager.setDefaultFocusTraversalPolicy(java.awt.FocusTraversalPolicy), KeyboardFocusManager.getDefaultFocusTraversalPolicy()

コンストラクタの概要
FocusTraversalPolicy()
           
 
メソッドの概要
abstract  Component getComponentAfter(Container focusCycleRoot, Component aComponent)
          aComponent の後にフォーカスを取得するコンポーネントを返します。
abstract  Component getComponentBefore(Container focusCycleRoot, Component aComponent)
          aComponent の前にフォーカスを取得するコンポーネントを返します。
abstract  Component getDefaultComponent(Container focusCycleRoot)
          フォーカスを設定するデフォルトコンポーネントを返します。
abstract  Component getFirstComponent(Container focusCycleRoot)
          トラバーサルサイクルの最初のコンポーネントを返します。
 Component getInitialComponent(Window window)
          ウィンドウが最初に表示された時にフォーカスが設定されるコンポーネントを返します。
abstract  Component getLastComponent(Container focusCycleRoot)
          トラバーサルサイクルの最後のコンポーネントを返します。
 
クラス java.lang.Object から継承したメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

コンストラクタの詳細

FocusTraversalPolicy

public FocusTraversalPolicy()
メソッドの詳細

getComponentAfter

public abstract Component getComponentAfter(Container focusCycleRoot,
                                            Component aComponent)
aComponent の後にフォーカスを取得するコンポーネントを返します。FocusCycleRoot は aComponent のフォーカスサイクルルートである必要があります。

パラメータ:
focusCycleRoot - aComponent のフォーカスサイクルルート
aComponent - focusCycleRoot の子 (間接的な子の場合あり)、または focusCycleRoot 自身
戻り値:
aComponent の後でフォーカスを取得するコンポーネント。適切なコンポーネントが見つからない場合は null
例外:
IllegalArgumentException - focusCycleRoot が aComponent のフォーカスサイクルルートでない場合、またはfocusCycleRoot か aComponent が null の場合

getComponentBefore

public abstract Component getComponentBefore(Container focusCycleRoot,
                                             Component aComponent)
aComponent の前にフォーカスを取得するコンポーネントを返します。FocusCycleRoot は aComponent のフォーカスサイクルルートである必要があります。

パラメータ:
focusCycleRoot - aComponent のフォーカスサイクルルート
aComponent - focusCycleRoot の子 (間接的な子の場合あり)、または focusCycleRoot 自身
戻り値:
aComponent の前にフォーカスを取得するコンポーネント。適切なコンポーネントが見つからない場合は null
例外:
IllegalArgumentException - focusCycleRoot が aComponent のフォーカスサイクルルートでない場合、またはfocusCycleRoot か aComponent が null の場合

getFirstComponent

public abstract Component getFirstComponent(Container focusCycleRoot)
トラバーサルサイクルの最初のコンポーネントを返します。このメソッドはフォワードトラバーサルで最後のコンポーネントに到達した時に、次のコンポーネントにフォーカス設定するために使用されます。

パラメータ:
focusCycleRoot - 最初のコンポーネントを返すフォーカスサイクルルート
戻り値:
focusCycleRoot がフォーカスサイクルルートの時はトラバーサルサイクルの最初のコンポーネント。適切なコンポーネントを検索できない時は null
例外:
IllegalArgumentException - focusCycleRoot が null の場合

getLastComponent

public abstract Component getLastComponent(Container focusCycleRoot)
トラバーサルサイクルの最後のコンポーネントを返します。このメソッドは逆方向のトラバーサルで最初のコンポーネントに到達した時に、次のコンポーネントにフォーカス設定するために使用されます。

パラメータ:
focusCycleRoot - 最後のコンポーネントを返すフォーカスサイクルルート
戻り値:
focusCycleRoot がフォーカスサイクルルートの時はトラバーサルサイクルの最後のコンポーネント。適切なコンポーネントを検索できない時は null
例外:
IllegalArgumentException - focusCycleRoot が null の場合

getDefaultComponent

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

パラメータ:
focusCycleRoot - デフォルトコンポーネントを返すフォーカスサイクルルート
戻り値:
focusCycleRoot がフォーカスサイクルルートの時はトラバーサルサイクルのデフォルトコンポーネント。適切なコンポーネントを検索できない時は null
例外:
IllegalArgumentException - focusCycleRoot が null の場合

getInitialComponent

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

パラメータ:
window - 初期コンポーネントが返されるウィンドウ
戻り値:
最初にウィンドウが表示される時にフォーカス設定されるコンポーネント。適切なコンポーネントがない場合は null
例外:
IllegalArgumentException - ウィンドウが null の場合
関連項目:
getDefaultComponent(java.awt.Container), Window.getMostRecentFocusOwner()

JavaTM 2
Platform
Std. Ed. v1.4.0

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

Java、Java 2D、および JDBC は米国ならびにその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.