java.awt
クラス DefaultKeyboardFocusManager

java.lang.Object
  |
  +--java.awt.KeyboardFocusManager
        |
        +--java.awt.DefaultKeyboardFocusManager

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

KeyEventDispatcher, KeyEventPostProcessor

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

FocusManager

public class DefaultKeyboardFocusManager

extends KeyboardFocusManager

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

導入されたバージョン:

1.4

関連項目:

FocusTraversalPolicy, Component.setFocusTraversalKeys(int, java.util.Set), 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) 同じタイムスタンプとコンポーネントで enqueueKeyEvents が呼び出されたため、待ち行列のすべての KeyEvents を、通常のディスパッチの現在のフォーカス所有者に開放します。
protected void	discardKeyEvents(Component comp) 特定のコンポーネント、またはその下位コンポーネントを指定した enqueueKeyEvents 呼び出しが複数回行われているため、待ち行列のすべての KeyEvents を破棄します。
boolean	dispatchEvent(AWTEvent e) このメソッドは、現在の KeyboardFocusManager が指定されたイベントをそれ自身のためにディスパッチすることを要求するため、AWT イベントディスパッチャによって呼び出されます。
boolean	dispatchKeyEvent(KeyEvent e) ディスパッチャチェーンの他の KeyEventDispatcher がキーイベントをディスパッチしない場合、または他の KeyEventDispatcher が登録されていない場合に dispatchEvent によって呼び出されます。
void	downFocusCycle(Container aContainer) フォーカスを 1 フォーカストラバーサルサイクルだけ下位に移動します。
protected void	enqueueKeyEvents(long after, Component untilFocused) 指定されたコンポーネントがフォーカス所有者となるまで、KeyEvents のディスパッチを遅らせます。
void	focusNextComponent(Component aComponent) 通常 FocusTraversalPolicy に基づき、aComponent の後のコンポーネントにフォーカスを設定します。
void	focusPreviousComponent(Component aComponent) 通常 FocusTraversalPolicy に基づき、aComponent の前のコンポーネントにフォーカスを設定します。
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)

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

定義:

クラス KeyboardFocusManager 内の dispatchEvent

パラメータ:

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 がキーイベントをディスパッチしない場合、または他の KeyEventDispatcher が登録されていない場合に dispatchEvent によって呼び出されます。イベントが消費されておらず、そのターゲットが有効であり、フォーカス所有者が null でない場合は、このメソッドがイベントをそのターゲットにディスパッチします。このメソッドはまた、イベントをすべての登録された KeyEventPostProcessors にディスパッチする処理を続けて行います。

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

定義:

インタフェース KeyEventDispatcher 内の dispatchKeyEvent

定義:

クラス KeyboardFocusManager 内の dispatchKeyEvent

パラメータ:

e - ディスパッチする KeyEvent

戻り値:

true

関連項目:

Component.dispatchEvent(java.awt.AWTEvent)

postProcessKeyEvent

public boolean postProcessKeyEvent(KeyEvent e)

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

定義:

インタフェース KeyEventPostProcessor 内の postProcessKeyEvent

定義:

クラス KeyboardFocusManager 内の postProcessKeyEvent

パラメータ:

e - 後処理を行う KeyEvent

戻り値:

true

関連項目:

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

processKeyEvent

public void processKeyEvent(Component focusedComponent,
                            KeyEvent e)

KeyEvent が指定された focusedComponent のフォーカストラバーサルキーを表す場合だけ、このメソッドがフォーカストラバーサル操作を開始します。focusedComponent は現在のフォーカス所有者であることが予想されますが、そうでなくても構いません。現在のフォーカス所有者でない場合は、フォーカストラバーサルの進行が、focusedComponent がフォーカス所有者の場合とは異なってきます。

定義:

クラス KeyboardFocusManager 内の processKeyEvent

パラメータ:

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

e - フォーカストラバーサルキーを表すイベント

enqueueKeyEvents

protected void enqueueKeyEvents(long after,
                                Component untilFocused)

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

定義:

クラス KeyboardFocusManager 内の enqueueKeyEvents

パラメータ:

after - 現在のイベントのタイムスタンプ。現在のイベントがタイムスタンプを持たない場合、または現在処理中のイベントを AWT で判定できない場合は現在のシステム時刻

untilFocused - 待ち行列の KeyEvents のディスパッチ前に FOCUS_GAINED を受け取るコンポーネント

関連項目:

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

dequeueKeyEvents

protected void dequeueKeyEvents(long after,
                                Component untilFocused)

同じタイムスタンプとコンポーネントで enqueueKeyEvents が呼び出されたため、待ち行列のすべての KeyEvents を、通常のディスパッチの現在のフォーカス所有者に開放します。指定されたタイムスタンプがゼロよりも小さい場合、指定されたコンポーネントの未処理の待ち行列依頼の中で、タイムスタンプが最も古いものが取り消されます。

定義:

クラス KeyboardFocusManager 内の dequeueKeyEvents

パラメータ:

after - enqueueKeyEvents の呼び出しで指定されたタイムスタンプ、またはゼロよりも小さな値

untilFocused - enqueueKeyEvents の呼び出しで指定されたコンポーネント

関連項目:

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

discardKeyEvents

protected void discardKeyEvents(Component comp)

特定のコンポーネント、またはその下位コンポーネントを指定した enqueueKeyEvents 呼び出しが複数回行われているため、待ち行列のすべての KeyEvents を破棄します。

定義:

クラス KeyboardFocusManager 内の discardKeyEvents

パラメータ:

comp - enqueueKeyEvents の 1 つ以上の呼び出しで指定されているコンポーネント、またはそのコンポーネントの上位コンポーネント

関連項目:

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

focusPreviousComponent

public void focusPreviousComponent(Component aComponent)

通常 FocusTraversalPolicy に基づき、aComponent の前のコンポーネントにフォーカスを設定します。

定義:

クラス KeyboardFocusManager 内の focusPreviousComponent

パラメータ:

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

関連項目:

FocusTraversalPolicy, Component.transferFocusBackward()

focusNextComponent

public void focusNextComponent(Component aComponent)

通常 FocusTraversalPolicy に基づき、aComponent の後のコンポーネントにフォーカスを設定します。

定義:

クラス KeyboardFocusManager 内の focusNextComponent

パラメータ:

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

関連項目:

FocusTraversalPolicy, Component.transferFocus()

upFocusCycle

public void upFocusCycle(Component aComponent)

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

定義:

クラス KeyboardFocusManager 内の upFocusCycle

パラメータ:

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

関連項目:

Component.transferFocusUpCycle()

downFocusCycle

public void downFocusCycle(Container aContainer)

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

定義:

クラス KeyboardFocusManager 内の downFocusCycle

関連項目:

Container.transferFocusDownCycle()