クラス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, Set)
• Component.getFocusTraversalKeys(int)

フィールドのサマリー

クラスで宣言されたフィールド KeyboardFocusManager

BACKWARD_TRAVERSAL_KEYS, DOWN_CYCLE_TRAVERSAL_KEYS, FORWARD_TRAVERSAL_KEYS, UP_CYCLE_TRAVERSAL_KEYS

修飾子と型	フィールド	説明
static final int	BACKWARD_TRAVERSAL_KEYS	Backwardフォーカス・トラバーサル・キーの識別子です。
static final int	DOWN_CYCLE_TRAVERSAL_KEYS	Down Cycleフォーカス・トラバーサル・キーの識別子です。
static final int	FORWARD_TRAVERSAL_KEYS	Forwardフォーカス・トラバーサル・キーの識別子です。
static final int	UP_CYCLE_TRAVERSAL_KEYS	Up Cycleフォーカス・トラバーサル・キーの識別子です。

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

コンストラクタ

コンストラクタ	説明
DefaultKeyboardFocusManager()	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つ上のフォーカス・トラバーサル・サイクルに移動します。

クラスで宣言されたメソッド KeyboardFocusManager

addKeyEventDispatcher, addKeyEventPostProcessor, addPropertyChangeListener, addPropertyChangeListener, addVetoableChangeListener, addVetoableChangeListener, clearFocusOwner, 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

修飾子と型	メソッド	説明
void	addKeyEventDispatcher(KeyEventDispatcher dispatcher)	KeyEventDispatcherをこのKeyboardFocusManagerのディスパッチャ・チェーンに追加します。
void	addKeyEventPostProcessor(KeyEventPostProcessor processor)	このKeyboardFocusManagerのポストプロセッサ・チェーンにKeyEventPostProcessorを追加します。
void	addPropertyChangeListener(PropertyChangeListener listener)	PropertyChangeListenerをリスナー・リストに追加します。
void	addPropertyChangeListener(String propertyName, PropertyChangeListener listener)	特定のプロパティのリスナー・リストにPropertyChangeListenerを追加します。
void	addVetoableChangeListener(VetoableChangeListener listener)	VetoableChangeListenerをリスナー・リストに追加します。
void	addVetoableChangeListener(String propertyName, VetoableChangeListener listener)	特定のプロパティのリスナー・リストにVetoableChangeListenerを追加します。
void	clearFocusOwner()	フォーカスの所有者が存在し、呼出し側スレッドと同じコンテキストにある場合は、Javaレベルとネイティブ・レベルの両方でフォーカスの所有者をクリアします。それ以外の場合、このメソッドは何も行わずに復帰します。
void	clearGlobalFocusOwner()	Javaおよびネイティブ・レベルの両方で、グローバル・フォーカスの所有者をクリアします。
final void	downFocusCycle()	現在のフォーカスの所有者がフォーカス・サイクルのルートであるContainerの場合にのみ、フォーカスを現在のフォーカスの所有者から1つ下のフォーカス・トラバーサル・サイクルに移動します。
protected void	firePropertyChange(String propertyName, Object oldValue, Object newValue)	バウンド・プロパティの変更に応答してPropertyChangeEventをトリガーします。
protected void	fireVetoableChange(String propertyName, Object oldValue, Object newValue)	拒否可能プロパティの変更に応答してPropertyChangeEventをトリガーします。
final void	focusNextComponent()	現在のフォーカスの所有者のあとにComponentをフォーカスします。
final void	focusPreviousComponent()	現在のフォーカスの所有者の前にComponentをフォーカスします。
Window	getActiveWindow()	アクティブWindowが呼出し側スレッドと同じコンテキストにある場合、アクティブWindowを返します。
Container	getCurrentFocusCycleRoot()	現在のフォーカス・サイクルのルートが呼出し側スレッドと同じコンテキストにある場合、現在のフォーカス・サイクルのルートを返します。
static KeyboardFocusManager	getCurrentKeyboardFocusManager()	スレッドのコンテキストの呼出しに対して、現在のKeyboardFocusManagerインスタンスを返します。
Set<AWTKeyStroke>	getDefaultFocusTraversalKeys(int id)	指定されたトラバーサル操作に対して、デフォルトのフォーカス・トラバーサル・キーのSetを返します。
FocusTraversalPolicy	getDefaultFocusTraversalPolicy()	デフォルトのFocusTraversalPolicyを返します。
Window	getFocusedWindow()	フォーカスされたWindowが、同じ呼び出し側スレッドと同じコンテキストにある場合、フォーカスされたWindowを返します。
Component	getFocusOwner()	フォーカスの所有者が呼出し側と同じコンテキストにある場合、フォーカスの所有者を返します。
protected Window	getGlobalActiveWindow()	呼出し側スレッドがアクティブWindowと異なるコンテキストにある場合でも、アクティブWindowを返します。
protected Container	getGlobalCurrentFocusCycleRoot()	呼出し側スレッドが現在のフォーカス・サイクルのルートと異なるコンテキストにある場合でも、現在のフォーカス・サイクルのルートを返します。
protected Window	getGlobalFocusedWindow()	呼出し側スレッドがフォーカスされたWindowと異なるコンテキストにある場合でも、フォーカスされたWindowを返します。
protected Component	getGlobalFocusOwner()	呼出し側スレッドがフォーカスの所有者と異なるコンテキストにある場合でも、フォーカスの所有者を返します。
protected Component	getGlobalPermanentFocusOwner()	パーマネント・フォーカスの所有者が呼出し側スレッドと異なるコンテキストにある場合でも、パーマネント・フォーカス所有者を返します。
protected List<KeyEventDispatcher>	getKeyEventDispatchers()	このKeyboardFocusManagerのKeyEventDispatcherチェーンをListとして返します。
protected List<KeyEventPostProcessor>	getKeyEventPostProcessors()	このKeyboardFocusManagerのKeyEventPostProcessorチェーンをListとして返します。
Component	getPermanentFocusOwner()	パーマネント・フォーカスの所有者が呼出し側スレッドと同じコンテキストにある場合、パーマネント・フォーカスの所有者を返します。
PropertyChangeListener[]	getPropertyChangeListeners()	このキーボード・フォーカス・マネージャに登録されたすべてのプロパティ変更リスナーの配列を返します。
PropertyChangeListener[]	getPropertyChangeListeners(String propertyName)	名前付きプロパティに関連付けられたすべてのPropertyChangeListenerの配列を返します。
VetoableChangeListener[]	getVetoableChangeListeners()	このキーボード・フォーカス・マネージャに登録されたすべての拒否可能変更リスナーの配列を返します。
VetoableChangeListener[]	getVetoableChangeListeners(String propertyName)	名前付きプロパティに関連付けられたすべてのVetoableChangeListenerの配列を返します。
final void	redispatchEvent(Component target, AWTEvent e)	AWTイベント・ディスパッチャに対してKeyboardFocusManager、またはインストールされた任意のKeyEventDispatchersが再度イベントを再帰的にディスパッチすることを要求しないような方法でAWTEventを再ディスパッチします。
void	removeKeyEventDispatcher(KeyEventDispatcher dispatcher)	以前にこのKeyboardFocusManagerのディスパッチャ・チェーンに追加されたKeyEventDispatcherを削除します。
void	removeKeyEventPostProcessor(KeyEventPostProcessor processor)	このKeyboardFocusManagerのポストプロセッサのチェーンから、以前に追加されたKeyEventPostProcessorを削除します。
void	removePropertyChangeListener(PropertyChangeListener listener)	PropertyChangeListenerをリスナー・リストから削除します。
void	removePropertyChangeListener(String propertyName, PropertyChangeListener listener)	特定のプロパティのリスナー・リストからPropertyChangeListenerを削除します。
void	removeVetoableChangeListener(VetoableChangeListener listener)	リスナー・リストからVetoableChangeListenerを削除します。
void	removeVetoableChangeListener(String propertyName, VetoableChangeListener listener)	特定のプロパティのリスナー・リストからVetoableChangeListenerを削除します。
static void	setCurrentKeyboardFocusManager(KeyboardFocusManager newManager)	スレッドのコンテキストの呼出しに対して、現在のKeyboardFocusManagerインスタンスを設定します。
void	setDefaultFocusTraversalKeys(int id, Set<? extends AWTKeyStroke> keystrokes)	指定されたトラバーサル操作に対して、デフォルトのフォーカス・トラバーサル・キーを設定します。
void	setDefaultFocusTraversalPolicy(FocusTraversalPolicy defaultPolicy)	デフォルトのFocusTraversalPolicyを設定します。
protected void	setGlobalActiveWindow(Window activeWindow)	アクティブWindowを設定します。
void	setGlobalCurrentFocusCycleRoot(Container newFocusCycleRoot)	現在のフォーカス・サイクルのルートを設定します。
protected void	setGlobalFocusedWindow(Window focusedWindow)	フォーカスされたWindowを設定します。
protected void	setGlobalFocusOwner(Component focusOwner)	フォーカスの所有者を設定します。
protected void	setGlobalPermanentFocusOwner(Component permanentFocusOwner)	パーマネント・フォーカスの所有者を設定します。
final void	upFocusCycle()	フォーカスを現在のフォーカスの所有者から1つ上のフォーカス・トラバーサル・サイクルに移動します。

クラスオブジェクトで宣言されたメソッド

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

修飾子と型	メソッド	説明
protected Object	clone()	このオブジェクトのコピーを作成して、返します。
boolean	equals(Object obj)	このオブジェクトと他のオブジェクトが等しいかどうかを示します。
protected void	finalize()	削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。 最終決定は非推奨であり、将来のリリースで削除される可能性があります。
final Class<?>	getClass()	このObjectの実行時クラスを返します。
int	hashCode()	このオブジェクトに対するハッシュ・コード値を返します。
final void	notify()	このオブジェクトのモニターで待機中のスレッドを1つ再開します。
final void	notifyAll()	このオブジェクトのモニターで待機中のすべてのスレッドを再開します。
String	toString()	オブジェクトの文字列表現を返します。
final void	wait()	現在のスレッドが目覚めるまで待機します。通常、notifiedまたはinterruptedです。
final void	wait(long timeoutMillis)	現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
final void	wait(long timeoutMillis, int nanos)	現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

コンストラクタの詳細

DefaultKeyboardFocusManager

public DefaultKeyboardFocusManager()

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(Component, AWTEvent)
• KeyboardFocusManager.dispatchKeyEvent(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(AWTEvent)

postProcessKeyEvent

public boolean postProcessKeyEvent(KeyEvent e)

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

定義:

postProcessKeyEvent、インタフェースKeyEventPostProcessor

定義:

postProcessKeyEvent、クラスKeyboardFocusManager

パラメータ:

e - プロセス終了後のKeyEvent

戻り値:

true

関連項目:

• dispatchKeyEvent(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, Component)
• discardKeyEvents(Component)

dequeueKeyEvents

protected void dequeueKeyEvents(long after, Component untilFocused)

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

定義:

dequeueKeyEvents、クラスKeyboardFocusManager

パラメータ:

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

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

関連項目:

• enqueueKeyEvents(long, Component)
• discardKeyEvents(Component)

discardKeyEvents

protected void discardKeyEvents(Component comp)

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

定義:

discardKeyEvents、クラスKeyboardFocusManager

パラメータ:

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

関連項目:

• enqueueKeyEvents(long, Component)
• dequeueKeyEvents(long, 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()