java.awt

クラス DefaultKeyboardFocusManager

java.lang.Object

java.awt.KeyboardFocusManager

java.awt.DefaultKeyboardFocusManager

すべての実装されたインタフェース:

KeyEventDispatcher, KeyEventPostProcessor

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

FocusManager

public class DefaultKeyboardFocusManager
extends KeyboardFocusManager

AWT アプリケーションのデフォルト KeyboardFocusManager です。フォーカストラバーサルはコンポーネントのフォーカストラバーサルキーに対応し、コンテナの FocusTraversalPolicy を使って実行されます。

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

導入されたバージョン:

1.4

関連項目:

FocusTraversalPolicy, Component.setFocusTraversalKeys(int, java.util.Set<? extends java.awt.AWTKeyStroke>), Component.getFocusTraversalKeys(int)

フィールドのサマリー

クラス java.awt.KeyboardFocusManager から継承されたフィールド

BACKWARD_TRAVERSAL_KEYS, DOWN_CYCLE_TRAVERSAL_KEYS, FORWARD_TRAVERSAL_KEYS, UP_CYCLE_TRAVERSAL_KEYS

コンストラクタのサマリー

コンストラクタ

コンストラクタと説明
DefaultKeyboardFocusManager()

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
protected void	dequeueKeyEvents(long after, Component untilFocused) 同じタイムスタンプと Component を使用した enqueueKeyEvents の呼び出しのためにキューに入れられたすべての KeyEvent を、現在のフォーカス所有者への通常のディスパッチのために解放します。
protected void	discardKeyEvents(Component comp) 指定された Component、またはそのいずれかの下位コンポーネントを使用した enqueueKeyEvents の 1 回以上の呼び出しのためにキューに入れられたすべての KeyEvent を破棄します。
boolean	dispatchEvent(AWTEvent e) このメソッドは AWT イベントディスパッチャーによって呼び出され、現在の KeyboardFocusManager がそのメソッドの代わりに指定されたイベントをディスパッチするよう要求します。
boolean	dispatchKeyEvent(KeyEvent e) ディスパッチャーチェーン内のほかの KeyEventDispatcher が KeyEvent をディスパッチしなかった場合、またはほかの KeyEventDispatchers が登録されていない場合に dispatchEvent から呼び出されます。
void	downFocusCycle(Container aContainer) フォーカスを 1 つ下のフォーカストラバーサルサイクルに移動します。
protected void	enqueueKeyEvents(long after, Component untilFocused) 指定されたコンポーネントがフォーカス所有者となるまで、KeyEvents のディスパッチを遅らせます。
void	focusNextComponent(Component aComponent) 通常 FocusTraversalPolicy に基づいて、aComponent のあとで Component をフォーカスします。
void	focusPreviousComponent(Component aComponent) 通常 FocusTraversalPolicy に基づいて、aComponent の前に Component をフォーカスします。
boolean	postProcessKeyEvent(KeyEvent e) このメソッドは dispatchKeyEvent から呼び出されます。
void	processKeyEvent(Component focusedComponent, KeyEvent e) KeyEvent が指定された focusedComponent に対してフォーカストラバーサルキーを示す場合にのみ、このメソッドはフォーカストラバーサル操作を初期化します。
void	upFocusCycle(Component aComponent) フォーカスを 1 つ上のフォーカストラバーサルサイクルに移動します。

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

addKeyEventDispatcher, addKeyEventPostProcessor, addPropertyChangeListener, addPropertyChangeListener, addVetoableChangeListener, addVetoableChangeListener, clearGlobalFocusOwner, downFocusCycle, firePropertyChange, fireVetoableChange, focusNextComponent, focusPreviousComponent, getActiveWindow, getCurrentFocusCycleRoot, getCurrentKeyboardFocusManager, getDefaultFocusTraversalKeys, getDefaultFocusTraversalPolicy, getFocusedWindow, getFocusOwner, getGlobalActiveWindow, getGlobalCurrentFocusCycleRoot, getGlobalFocusedWindow, getGlobalFocusOwner, getGlobalPermanentFocusOwner, getKeyEventDispatchers, getKeyEventPostProcessors, getPermanentFocusOwner, getPropertyChangeListeners, getPropertyChangeListeners, getVetoableChangeListeners, getVetoableChangeListeners, redispatchEvent, removeKeyEventDispatcher, removeKeyEventPostProcessor, removePropertyChangeListener, removePropertyChangeListener, removeVetoableChangeListener, removeVetoableChangeListener, setCurrentKeyboardFocusManager, setDefaultFocusTraversalKeys, setDefaultFocusTraversalPolicy, setGlobalActiveWindow, setGlobalCurrentFocusCycleRoot, setGlobalFocusedWindow, setGlobalFocusOwner, setGlobalPermanentFocusOwner, upFocusCycle

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

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

コンストラクタの詳細

DefaultKeyboardFocusManager

public DefaultKeyboardFocusManager()

メソッドの詳細

dispatchEvent

public boolean dispatchEvent(AWTEvent e)

このメソッドは AWT イベントディスパッチャーによって呼び出され、現在の KeyboardFocusManager がそのメソッドの代わりに指定されたイベントをディスパッチするよう要求します。DefaultKeyboardFocusManagers はすべての FocusEvents、フォーカス関連のすべての WindowEvents、そしてすべての KeyEvents をディスパッチします。これらのイベントは、KeyboardFocusManager がフォーカス所有者、およびフォーカス設定された有効なウィンドウをどのように認識しているかを基準にディスパッチされます。指定された AWTEvent のソースをオーバーライドすることもあります。このメソッドが false を返した場合、AWT イベントディスパッチャーはイベント自体をディスパッチしようとします。

定義:

dispatchEvent、クラス: KeyboardFocusManager

パラメータ:

e - ディスパッチされる AWTEvent

戻り値:

このメソッドがイベントをディスパッチした場合は true、それ以外の場合は false

関連項目:

KeyboardFocusManager.redispatchEvent(java.awt.Component, java.awt.AWTEvent), KeyboardFocusManager.dispatchKeyEvent(java.awt.event.KeyEvent)

dispatchKeyEvent

public boolean dispatchKeyEvent(KeyEvent e)

ディスパッチャーチェーン内のほかの KeyEventDispatcher が KeyEvent をディスパッチしなかった場合、またはほかの KeyEventDispatchers が登録されていない場合に dispatchEvent から呼び出されます。イベントが消費されておらず、そのターゲットが有効であり、フォーカス所有者が null でない場合は、このメソッドがイベントをそのターゲットにディスパッチします。このメソッドはまた、イベントをすべての登録された KeyEventPostProcessors にディスパッチする処理を続けて行います。このすべての処理が終了すると、イベントがピアに渡され処理されます。

DefaultKeyboardFocusManager は、dispatchEvent または AWT イベントディスパッチャーのどちらでも、あらゆる状況でイベントに対するこれ以上のアクションを実行しないように設計されているため、常に true を返します。

定義:

dispatchKeyEvent、インタフェース: KeyEventDispatcher

定義:

dispatchKeyEvent、クラス: KeyboardFocusManager

パラメータ:

e - ディスパッチする KeyEvent

戻り値:

true

関連項目:

Component.dispatchEvent(java.awt.AWTEvent)

postProcessKeyEvent

public boolean postProcessKeyEvent(KeyEvent e)

このメソッドは dispatchKeyEvent から呼び出されます。 AWT MenuShortcut にマップされるすべての未消費 KeyEvent を消費し、ショートカットを有効化します。

定義:

postProcessKeyEvent、インタフェース: KeyEventPostProcessor

定義:

postProcessKeyEvent、クラス: KeyboardFocusManager

パラメータ:

e - プロセス終了後の KeyEvent

戻り値:

true

関連項目:

dispatchKeyEvent(java.awt.event.KeyEvent), MenuShortcut

processKeyEvent

public void processKeyEvent(Component focusedComponent,
                   KeyEvent e)

KeyEvent が指定された focusedComponent に対してフォーカストラバーサルキーを示す場合にのみ、このメソッドはフォーカストラバーサル操作を初期化します。focusedComponent が現在のフォーカスの所有者であると想定されますが、必ずしもこのとおりである必要はありません。現在のフォーカス所有者でない場合は、フォーカストラバーサルの進行が、focusedComponent がフォーカス所有者の場合とは異なってきます。

定義:

processKeyEvent、クラス: KeyboardFocusManager

パラメータ:

focusedComponent - 指定されたイベントがコンポーネントのフォーカストラバーサルキーを表す場合、フォーカストラバーサル操作の基本となるコンポーネント

e - フォーカストラバーサルキーを表す可能性のあるイベント

enqueueKeyEvents

protected void enqueueKeyEvents(long after,
                    Component untilFocused)

指定されたコンポーネントがフォーカス所有者となるまで、KeyEvents のディスパッチを遅らせます。 指定されたタイムスタンプよりもあとのタイムスタンプを持つ KeyEvent は、指定されたコンポーネントが FOCUS_GAINED イベントを受け取るまで、または AWT が遅延要求を dequeueKeyEvents または discardKeyEvents を呼び出して取り消すまでキューに入れられます。

定義:

enqueueKeyEvents、クラス: KeyboardFocusManager

パラメータ:

after - 現在のイベントのタイムスタンプ、または現在のイベントにタイムスタンプがない場合や、どのイベントが現在処理されているかを AWT が判定できない場合は現在のシステム時間

untilFocused - 保留状態にある KeyEvent を受け取る前に FOCUS_GAINED イベントを受け取る Component

関連項目:

dequeueKeyEvents(long, java.awt.Component), discardKeyEvents(java.awt.Component)

dequeueKeyEvents

protected void dequeueKeyEvents(long after,
                    Component untilFocused)

同じタイムスタンプと Component を使用した enqueueKeyEvents の呼び出しのためにキューに入れられたすべての KeyEvent を、現在のフォーカス所有者への通常のディスパッチのために解放します。特定のタイムスタンプが 0 より小さい場合は、もっとも古いタイムスタンプを含む特定の Component に対する未処理のエンキュー要求 (存在する場合) を取り消すようにしてください。

定義:

dequeueKeyEvents、クラス: KeyboardFocusManager

パラメータ:

after - enqueueKeyEvents の呼び出しで指定されたタイムスタンプ、または 0 より小さい任意の値

untilFocused - 次に対する呼び出しで指定された Component: enqueueKeyEvents

関連項目:

enqueueKeyEvents(long, java.awt.Component), discardKeyEvents(java.awt.Component)

discardKeyEvents

protected void discardKeyEvents(Component comp)

指定された Component、またはそのいずれかの下位コンポーネントを使用した enqueueKeyEvents の 1 回以上の呼び出しのためにキューに入れられたすべての KeyEvent を破棄します。

定義:

discardKeyEvents、クラス: KeyboardFocusManager

パラメータ:

comp - enqueueKeyEvents への 1 回以上の呼び出しで指定されたコンポーネント、またはそのコンポーネントの親

関連項目:

enqueueKeyEvents(long, java.awt.Component), dequeueKeyEvents(long, java.awt.Component)

focusPreviousComponent

public void focusPreviousComponent(Component aComponent)

通常 FocusTraversalPolicy に基づいて、aComponent の前に Component をフォーカスします。

定義:

focusPreviousComponent、クラス: KeyboardFocusManager

パラメータ:

aComponent - フォーカストラバーサル操作の基準となる Component

関連項目:

FocusTraversalPolicy, Component.transferFocusBackward()

focusNextComponent

public void focusNextComponent(Component aComponent)

通常 FocusTraversalPolicy に基づいて、aComponent のあとで Component をフォーカスします。

定義:

focusNextComponent、クラス: KeyboardFocusManager

パラメータ:

aComponent - フォーカストラバーサル操作の基準となる Component

関連項目:

FocusTraversalPolicy, Component.transferFocus()

upFocusCycle

public void upFocusCycle(Component aComponent)

フォーカスを 1 つ上のフォーカストラバーサルサイクルに移動します。通常、フォーカスの所有者は aComponent のフォーカスサイクルのルートに設定され、現在のフォーカスサイクルのルートは新しいフォーカスの所有者のフォーカスサイクルのルートに設定されます。aComponent のフォーカスサイクルルートがウィンドウの場合、フォーカス所有者はフォーカスサイクルルートのデフォルトフォーカスコンポーネントに設定され、現在のフォーカスサイクルルートは変更されません。

定義:

upFocusCycle、クラス: KeyboardFocusManager

パラメータ:

aComponent - フォーカストラバーサル操作の基準となる Component

関連項目:

Component.transferFocusUpCycle()

downFocusCycle

public void downFocusCycle(Container aContainer)

フォーカスを 1 つ下のフォーカストラバーサルサイクルに移動します。aContainer がフォーカスサイクルルートの場合、フォーカス所有者は aContainer のデフォルトフォーカスコンポーネントになり、現在のフォーカスサイクルルートが aContainer に設定されます。aContainer がフォーカスサイクルのルートでない場合、フォーカストラバーサル操作は行われません。

定義:

downFocusCycle、クラス: KeyboardFocusManager

パラメータ:

aContainer - フォーカストラバーサル操作の基準となる Container

関連項目:

Container.transferFocusDownCycle()