java.awt

クラス KeyboardFocusManager

java.lang.Object

java.awt.KeyboardFocusManager

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

KeyEventDispatcher, KeyEventPostProcessor

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

DefaultKeyboardFocusManager

public abstract class KeyboardFocusManager
extends Object
implements KeyEventDispatcher, KeyEventPostProcessor

KeyboardFocusManager は、アクティブとなりフォーカスされた Window および現在のフォーカスの所有者の管理を制御します。フォーカスの所有者は、通常ユーザーによって生成されるすべての KeyEvents を受け取るアプリケーションの Component として定義されます。フォーカスされた Window は、フォーカスの所有者であるかまたはフォーカスの所有者を含む Window です。Frame または Dialog のみがアクティブ Window になります。ネイティブのウィンドウ処理システムは、アクティブ Window またはハイライトされたタイトルバーなど特別な装飾を持つその子を表します。アクティブ Window は、常に、フォーカスされた Window か、またはフォーカスされた Window のオーナーである最初の Frame または Dialog のいずれかです。

KeyboardFocusManager は、クライアントコードがフォーカスの所有者を照会し、フォーカスの変更を開始する中央配置のロケーションであり、フォーカスに関連するすべての FocusEvents、WindowEvents、および KeyEvents のイベントディスパッチャーです。

一部のブラウザは、異なるコードベースのアプレットを別のコンテキストに分割し、これらのコンテキストの間に壁を構築します。このようなシナリオでは、コンテキストごとに 1 つの KeyboardFocusManager があります。別のブラウザは、すべてのアプレットを同じコンテキストに配置します。これは、すべてのアプレットに対して単一でグローバルな KeyboardFocusManager のみがあることを示します。この動作は実装に依存します。詳細はブラウザのマニュアルを参照してください。ただし、存在するコンテキストの数にかかわらず、ClassLoader あたり複数のフォーカスの所有者、フォーカスされた Window、またはアクティブ Window が存在することはありません。

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

導入されたバージョン:

1.4

関連項目:

Window, Frame, Dialog, FocusEvent, WindowEvent, KeyEvent

フィールドのサマリー

フィールド

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

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

コンストラクタ

コンストラクタと説明
KeyboardFocusManager() KeyboardFocusManager を初期化します。

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
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(String propertyName, VetoableChangeListener listener) 特定のプロパティーのリスナーリストに VetoableChangeListener を追加します。
void	addVetoableChangeListener(VetoableChangeListener listener) VetoableChangeListener をリスナーリストに追加します。
void	clearGlobalFocusOwner() Java およびネイティブレベルの両方で、グローバルフォーカスの所有者をクリアします。
protected abstract void	dequeueKeyEvents(long after, Component untilFocused) 遅延した KeyEvents のディスパッチを取り消すよう KeyboardFocusManager に通知するために AWT によって呼び出されます。
protected abstract void	discardKeyEvents(Component comp) 遅延した KeyEvents のディスパッチを取り消すよう KeyboardFocusManager に通知するために AWT によって呼び出されます。
abstract boolean	dispatchEvent(AWTEvent e) このメソッドは AWT イベントディスパッチャーによって呼び出され、現在の KeyboardFocusManager がそのメソッドの代わりに指定されたイベントをディスパッチするよう要求します。
abstract boolean	dispatchKeyEvent(KeyEvent e) このメソッドは通常、ディスパッチャーチェーン内のほかの KeyEventDispatcher が KeyEvent をディスパッチしなかった場合、またはほかの KeyEventDispatchers が登録されていない場合に dispatchEvent から呼び出されます。
void	downFocusCycle() 現在のフォーカスの所有者がフォーカスサイクルのルートである Container の場合にのみ、フォーカスを現在のフォーカスの所有者から 1 つ下のフォーカストラバーサルサイクルに移動します。
abstract void	downFocusCycle(Container aContainer) フォーカスを 1 つ下のフォーカストラバーサルサイクルに移動します。
protected abstract void	enqueueKeyEvents(long after, Component untilFocused) 指定された Component がフォーカスの所有者になるまで、KeyEvents のディスパッチを遅延させる必要があることを KeyboardFocusManager に通知するために AWT によって呼び出されます。
protected void	firePropertyChange(String propertyName, Object oldValue, Object newValue) バウンドプロパティーの変更に応答して PropertyChangeEvent をトリガーします。
protected void	fireVetoableChange(String propertyName, Object oldValue, Object newValue) 拒否可能プロパティーの変更に応答して PropertyChangeEvent をトリガーします。
void	focusNextComponent() 現在のフォーカスの所有者のあとに Component をフォーカスします。
abstract void	focusNextComponent(Component aComponent) 通常 FocusTraversalPolicy に基づいて、aComponent のあとで Component をフォーカスします。
void	focusPreviousComponent() 現在のフォーカスの所有者の前に Component をフォーカスします。
abstract void	focusPreviousComponent(Component aComponent) 通常 FocusTraversalPolicy に基づいて、aComponent の前に 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 の配列を返します。
abstract boolean	postProcessKeyEvent(KeyEvent e) このメソッドは dispatchKeyEvent から呼び出されます。
abstract void	processKeyEvent(Component focusedComponent, KeyEvent e) KeyEvent が指定された focusedComponent に対してフォーカストラバーサルキーを示す場合にのみ、このメソッドはフォーカストラバーサル操作を初期化します。
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(String propertyName, VetoableChangeListener listener) 特定のプロパティーのリスナーリストから VetoableChangeListener を削除します。
void	removeVetoableChangeListener(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) パーマネントフォーカスの所有者を設定します。
void	upFocusCycle() フォーカスを現在のフォーカスの所有者から 1 つ上のフォーカストラバーサルサイクルに移動します。
abstract void	upFocusCycle(Component aComponent) フォーカスを 1 つ上のフォーカストラバーサルサイクルに移動します。

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

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

フィールドの詳細

FORWARD_TRAVERSAL_KEYS

public static final int FORWARD_TRAVERSAL_KEYS

Forward フォーカストラバーサルキーの識別子です。

関連項目:

setDefaultFocusTraversalKeys(int, java.util.Set<? extends java.awt.AWTKeyStroke>), getDefaultFocusTraversalKeys(int), Component.setFocusTraversalKeys(int, java.util.Set<? extends java.awt.AWTKeyStroke>), Component.getFocusTraversalKeys(int), 定数フィールド値

BACKWARD_TRAVERSAL_KEYS

public static final int BACKWARD_TRAVERSAL_KEYS

Backward フォーカストラバーサルキーの識別子です。

関連項目:

setDefaultFocusTraversalKeys(int, java.util.Set<? extends java.awt.AWTKeyStroke>), getDefaultFocusTraversalKeys(int), Component.setFocusTraversalKeys(int, java.util.Set<? extends java.awt.AWTKeyStroke>), Component.getFocusTraversalKeys(int), 定数フィールド値

UP_CYCLE_TRAVERSAL_KEYS

public static final int UP_CYCLE_TRAVERSAL_KEYS

Up Cycle フォーカストラバーサルキーの識別子です。

関連項目:

setDefaultFocusTraversalKeys(int, java.util.Set<? extends java.awt.AWTKeyStroke>), getDefaultFocusTraversalKeys(int), Component.setFocusTraversalKeys(int, java.util.Set<? extends java.awt.AWTKeyStroke>), Component.getFocusTraversalKeys(int), 定数フィールド値

DOWN_CYCLE_TRAVERSAL_KEYS

public static final int DOWN_CYCLE_TRAVERSAL_KEYS

Down Cycle フォーカストラバーサルキーの識別子です。

関連項目:

setDefaultFocusTraversalKeys(int, java.util.Set<? extends java.awt.AWTKeyStroke>), getDefaultFocusTraversalKeys(int), Component.setFocusTraversalKeys(int, java.util.Set<? extends java.awt.AWTKeyStroke>), Component.getFocusTraversalKeys(int), 定数フィールド値

コンストラクタの詳細

KeyboardFocusManager

public KeyboardFocusManager()

KeyboardFocusManager を初期化します。

メソッドの詳細

getCurrentKeyboardFocusManager

public static KeyboardFocusManager getCurrentKeyboardFocusManager()

スレッドのコンテキストの呼び出しに対して、現在の KeyboardFocusManager インスタンスを返します。

戻り値:

このスレッドのコンテキストの KeyboardFocusManager

関連項目:

setCurrentKeyboardFocusManager(java.awt.KeyboardFocusManager)

setCurrentKeyboardFocusManager

public static void setCurrentKeyboardFocusManager(KeyboardFocusManager newManager)
                                           throws SecurityException

スレッドのコンテキストの呼び出しに対して、現在の KeyboardFocusManager インスタンスを設定します。null が指定された場合、現在の KeyboardFocusManager は DefaultKeyboardFocusManager の新しいインスタンスに置き換えられます。

SecurityManager がインストールされている場合、呼び出し側スレッドは現在の KeyboardFocusManager を置き換えるために AWTPermission "replaceKeyboardFocusManager" によりアクセス権が許可されている必要があります。このアクセス権が許可されていない場合、このメソッドは SecurityException をスローして、現在の KeyboardFocusManager は変更されません。

パラメータ:

newManager - このスレッドのコンテキストに対する新しい KeyboardFocusManager

例外:

SecurityException - 呼び出し側スレッドに、現在の KeyboardFocusManager を置き換えるために必要なアクセス権がない場合

関連項目:

getCurrentKeyboardFocusManager(), DefaultKeyboardFocusManager

getFocusOwner

public Component getFocusOwner()

フォーカスの所有者が呼び出し側と同じコンテキストにある場合、フォーカスの所有者を返します。フォーカスの所有者は、通常ユーザーによって生成されるすべての KeyEvents を受け取るアプリケーションの Component として定義されます。フォーカスの所有者に対してフォーカストラバーサルキーが有効である場合、フォーカスの所有者のトラバーサルキーにマッピングされる KeyEvents は転送されません。さらに、KeyEventDispatchers は、フォーカスの所有者に到達する前に、KeyEvents をターゲット変更するかまたは消費できます。

戻り値:

フォーカスの所有者、またはフォーカスの所有者が呼び出し側スレッドのコンテキストのメンバーではない場合は null

関連項目:

getGlobalFocusOwner(), setGlobalFocusOwner(java.awt.Component)

getGlobalFocusOwner

protected Component getGlobalFocusOwner()
                                 throws SecurityException

呼び出し側スレッドがフォーカスの所有者と異なるコンテキストにある場合でも、フォーカスの所有者を返します。フォーカスの所有者は、通常ユーザーによって生成されるすべての KeyEvents を受け取るアプリケーションの Component として定義されます。フォーカスの所有者に対してフォーカストラバーサルキーが有効である場合、フォーカスの所有者のトラバーサルキーにマッピングされる KeyEvents は転送されません。さらに、KeyEventDispatchers は、フォーカスの所有者に到達する前に、KeyEvents をターゲット変更するかまたは消費できます。

この KeyboardFocusManager が呼び出し側スレッドのコンテキストに対する現在の KeyboardFocusManager でない場合、このメソッドは SecurityException をスローします。

戻り値:

フォーカスの所有者

例外:

SecurityException - この KeyboardFocusManager が、呼び出し元スレッドのコンテキストに対する現在の KeyboardFocusManager でない場合

関連項目:

getFocusOwner(), setGlobalFocusOwner(java.awt.Component)

setGlobalFocusOwner

protected void setGlobalFocusOwner(Component focusOwner)

フォーカスの所有者を設定します。この操作は Component がフォーカス不可能である場合、取り消されます。フォーカスの所有者は、通常ユーザーによって生成されるすべての KeyEvents を受け取るアプリケーションの Component として定義されます。フォーカスの所有者に対してフォーカストラバーサルキーが有効である場合、フォーカスの所有者のトラバーサルキーにマッピングされる KeyEvents は転送されません。さらに、KeyEventDispatchers は、フォーカスの所有者に到達する前に、KeyEvents をターゲット変更するかまたは消費できます。

このメソッドは、実際に指定された Component に対するフォーカスを設定しません。これは、あとで getFocusOwner() によって返される値を単に格納するだけです。Component.requestFocus() または Component.requestFocusInWindow() を使用して、プラットフォームの制限に従ってフォーカス所有者を変更します。

パラメータ:

focusOwner - フォーカスの所有者

関連項目:

getFocusOwner(), getGlobalFocusOwner(), Component.requestFocus(), Component.requestFocusInWindow(), Component.isFocusable()

clearGlobalFocusOwner

public void clearGlobalFocusOwner()

Java およびネイティブレベルの両方で、グローバルフォーカスの所有者をクリアします。フォーカスの所有者が存在する場合、そのような Component はパーマネント FOCUS_LOST イベントを受け取ります。 この操作が完了すると、ネイティブのウィンドウ処理システムは、ユーザーが新しい Component を選択してフォーカスを受け取るか、または Component が requestFocus() への呼び出しにより明示的にフォーカスを付与されるまで、ユーザーが生成したすべての KeyEvents を破棄します。この操作はフォーカスされた Window またはアクティブな Window を変更しません。

関連項目:

Component.requestFocus(), FocusEvent.FOCUS_LOST

getPermanentFocusOwner

public Component getPermanentFocusOwner()

パーマネントフォーカスの所有者が呼び出し側スレッドと同じコンテキストにある場合、パーマネントフォーカスの所有者を返します。パーマネントフォーカスの所有者は、パーマネント FOCUS_GAINED イベントを受け取るアプリケーションの最後の Component として定義されます。フォーカスの所有者とパーマネントフォーカスの所有者は、テンポラリフォーカスの変更が現在有効でない場合にかぎり同等です。このような場合、パーマネントフォーカスの所有者はテンポラリフォーカスの変更が終了するとふたたびフォーカスの所有者になります。

戻り値:

パーマネントフォーカスの所有者、またはパーマネントフォーカスの所有者が呼び出し側スレッドのコンテキストのメンバーではない場合は null

関連項目:

getGlobalPermanentFocusOwner(), setGlobalPermanentFocusOwner(java.awt.Component)

getGlobalPermanentFocusOwner

protected Component getGlobalPermanentFocusOwner()
                                          throws SecurityException

パーマネントフォーカスの所有者が呼び出し側スレッドと異なるコンテキストにある場合でも、パーマネントフォーカスの所有者を返します。パーマネントフォーカスの所有者は、パーマネント FOCUS_GAINED イベントを受け取るアプリケーションの最後の Component として定義されます。フォーカスの所有者とパーマネントフォーカスの所有者は、テンポラリフォーカスの変更が現在有効でない場合にかぎり同等です。このような場合、パーマネントフォーカスの所有者はテンポラリフォーカスの変更が終了するとふたたびフォーカスの所有者になります。

この KeyboardFocusManager が呼び出し側スレッドのコンテキストに対する現在の KeyboardFocusManager でない場合、このメソッドは SecurityException をスローします。

戻り値:

パーマネントフォーカスの所有者

例外:

SecurityException - この KeyboardFocusManager が、呼び出し元スレッドのコンテキストに対する現在の KeyboardFocusManager でない場合

関連項目:

getPermanentFocusOwner(), setGlobalPermanentFocusOwner(java.awt.Component)

setGlobalPermanentFocusOwner

protected void setGlobalPermanentFocusOwner(Component permanentFocusOwner)

パーマネントフォーカスの所有者を設定します。この操作は Component がフォーカス不可能である場合、取り消されます。パーマネントフォーカスの所有者は、パーマネント FOCUS_GAINED イベントを受け取るアプリケーションの最後の Component として定義されます。フォーカスの所有者とパーマネントフォーカスの所有者は、テンポラリフォーカスの変更が現在有効でない場合にかぎり同等です。このような場合、パーマネントフォーカスの所有者はテンポラリフォーカスの変更が終了するとふたたびフォーカスの所有者になります。

このメソッドは、実際に指定された Component に対するフォーカスを設定しません。これは、あとで getPermanentFocusOwner() によって返される値を単に格納するだけです。Component.requestFocus() または Component.requestFocusInWindow() を使用して、プラットフォームの制限に従ってフォーカス所有者を変更します。

パラメータ:

permanentFocusOwner - パーマネントフォーカスの所有者

関連項目:

getPermanentFocusOwner(), getGlobalPermanentFocusOwner(), Component.requestFocus(), Component.requestFocusInWindow(), Component.isFocusable()

getFocusedWindow

public Window getFocusedWindow()

フォーカスされた Window が、同じ呼び出し側スレッドと同じコンテキストにある場合、フォーカスされた Window を返します。フォーカスされた Window は、フォーカスの所有者であるかまたはフォーカスの所有者を含む Window です。

戻り値:

フォーカスされた Window、またはフォーカスされた Window が呼び出し側スレッドのコンテキストのメンバーではない場合は null

関連項目:

getGlobalFocusedWindow(), setGlobalFocusedWindow(java.awt.Window)

getGlobalFocusedWindow

protected Window getGlobalFocusedWindow()
                                 throws SecurityException

呼び出し側スレッドがフォーカスされた Window と異なるコンテキストにある場合でも、フォーカスされた Window を返します。フォーカスされた Window は、フォーカスの所有者であるかまたはフォーカスの所有者を含む Window です。

この KeyboardFocusManager が呼び出し側スレッドのコンテキストに対する現在の KeyboardFocusManager でない場合、このメソッドは SecurityException をスローします。

戻り値:

フォーカスされた Window

例外:

SecurityException - この KeyboardFocusManager が、呼び出し元スレッドのコンテキストに対する現在の KeyboardFocusManager でない場合

関連項目:

getFocusedWindow(), setGlobalFocusedWindow(java.awt.Window)

setGlobalFocusedWindow

protected void setGlobalFocusedWindow(Window focusedWindow)

フォーカスされた Window を設定します。フォーカスされた Window は、フォーカスの所有者であるかまたはフォーカスの所有者を含む Window です。フォーカスを指定された Window がフォーカス不可能な Window の場合、この操作は取り消されます。

このメソッドは、ネイティブのウィンドウ処理システムに関するかぎり、実際にフォーカスされた Window の変更を行いません。これは、あとで getFocusedWindow() によって返される値を単に格納するだけです。 Component.requestFocus() または Component.requestFocusInWindow() を使用して、プラットフォームの制限に従ってフォーカスされた Window を変更します。

パラメータ:

focusedWindow - フォーカスされた Window

関連項目:

getFocusedWindow(), getGlobalFocusedWindow(), Component.requestFocus(), Component.requestFocusInWindow(), Window.isFocusableWindow()

getActiveWindow

public Window getActiveWindow()

アクティブ Window が呼び出し側スレッドと同じコンテキストにある場合、アクティブ Window を返します。Frame または Dialog のみがアクティブ Window になります。ネイティブのウィンドウ処理システムは、アクティブ Window またはハイライトされたタイトルバーなど特別な装飾を持つその子を表します。アクティブ Window は、常に、フォーカスされた Window か、またはフォーカスされた Window のオーナーである最初の Frame または Dialog のいずれかです。

戻り値:

アクティブ Window、またはアクティブ Window が呼び出し側スレッドのコンテキストのメンバーではない場合は null

関連項目:

getGlobalActiveWindow(), setGlobalActiveWindow(java.awt.Window)

getGlobalActiveWindow

protected Window getGlobalActiveWindow()
                                throws SecurityException

呼び出し側スレッドがアクティブ Window と異なるコンテキストにある場合でも、アクティブ Window を返します。Frame または Dialog のみがアクティブ Window になります。ネイティブのウィンドウ処理システムは、アクティブ Window またはハイライトされたタイトルバーなど特別な装飾を持つその子を表します。アクティブ Window は、常に、フォーカスされた Window か、またはフォーカスされた Window のオーナーである最初の Frame または Dialog のいずれかです。

この KeyboardFocusManager が呼び出し側スレッドのコンテキストに対する現在の KeyboardFocusManager でない場合、このメソッドは SecurityException をスローします。

戻り値:

アクティブ Window

例外:

SecurityException - この KeyboardFocusManager が、呼び出し元スレッドのコンテキストに対する現在の KeyboardFocusManager でない場合

関連項目:

getActiveWindow(), setGlobalActiveWindow(java.awt.Window)

setGlobalActiveWindow

protected void setGlobalActiveWindow(Window activeWindow)

アクティブ Window を設定します。Frame または Dialog のみがアクティブ Window になります。ネイティブのウィンドウ処理システムは、アクティブ Window またはハイライトされたタイトルバーなど特別な装飾を持つその子を表します。アクティブ Window は、常に、フォーカスされた Window か、またはフォーカスされた Window のオーナーである最初の Frame または Dialog のいずれかです。

このメソッドは、ネイティブのウィンドウ処理システムに関するかぎり、実際にアクティブ Window の変更を行いません。これは、あとで getActiveWindow() によって返される値を単に格納するだけです。 Component.requestFocus() または Component.requestFocusInWindow() を使用して、プラットフォームの制限に従ってアクティブ Window を変更します。

パラメータ:

activeWindow - アクティブ Window

関連項目:

getActiveWindow(), getGlobalActiveWindow(), Component.requestFocus(), Component.requestFocusInWindow()

getDefaultFocusTraversalPolicy

public FocusTraversalPolicy getDefaultFocusTraversalPolicy()

デフォルトの FocusTraversalPolicy を返します。トップレベルのコンポーネントは、作成時にこの値を使って Container.setFocusTraversalPolicy を明示的に呼び出し、自分自身のフォーカストラバーサルポリシーを初期化します。

戻り値:

デフォルトの FocusTraversalPolicy。null を返すことはない

関連項目:

setDefaultFocusTraversalPolicy(java.awt.FocusTraversalPolicy), Container.setFocusTraversalPolicy(java.awt.FocusTraversalPolicy), Container.getFocusTraversalPolicy()

setDefaultFocusTraversalPolicy

public void setDefaultFocusTraversalPolicy(FocusTraversalPolicy defaultPolicy)

デフォルトの FocusTraversalPolicy を設定します。トップレベルのコンポーネントは、作成時にこの値を使って Container.setFocusTraversalPolicy を明示的に呼び出し、自分自身のフォーカストラバーサルポリシーを初期化します。注:この呼び出しは、ポリシーが初期化されているため、すでに作成済みのコンポーネントに影響しません。新しいコンポーネントのみがデフォルトポリシーとしてこのポリシーを使用します。

パラメータ:

defaultPolicy - 新しいデフォルトの FocusTraversalPolicy

例外:

IllegalArgumentException - defaultPolicy が null の場合

関連項目:

getDefaultFocusTraversalPolicy(), Container.setFocusTraversalPolicy(java.awt.FocusTraversalPolicy), Container.getFocusTraversalPolicy()

setDefaultFocusTraversalKeys

public void setDefaultFocusTraversalKeys(int id,
                                Set<? extends AWTKeyStroke> keystrokes)

指定されたトラバーサル操作に対して、デフォルトのフォーカストラバーサルキーを設定します。 このトラバーサルキー Set は、このような明示的に定義された自分自身の Set を持たないすべての Window で有効です。 また、この Set は、明示的に定義された自分自身の Set を持たないこれらの Windows の任意の子 Component によって再帰的に継承されます。

デフォルトのフォーカストラバーサルキーのデフォルト値は実装に依存します。Sun は特定のネイティブなプラットフォームに対するすべての実装で同じデフォルト値を使用することをお勧めします。Windows および Unix に対する推奨は次にリストされています。これらの推奨は Sun AWT の実装で使用されます。

識別子	意味	デフォルト
KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS	通常の順方向キーボードトラバーサル	TAB の KEY_PRESSED、CTRL-TAB の KEY_PRESSED
KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS	通常のリバースキーボードトラバーサル	SHIFT-TAB の KEY_PRESSED、CTRL-SHIFT-TAB の KEY_PRESSED
KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS	1 つ上のフォーカストラバーサルサイクルに移動	なし
KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS	1 つ下のフォーカストラバーサルサイクルに移動	なし

トラバーサルキーを無効化するためには、空の Set を使用します。Collections.EMPTY_SET の使用をお勧めします。

AWTKeyStroke API を使用すると、クライアントコードで KEY_PRESSED と KEY_RELEASED の 2 つの KeyEvent を指定できるようになり、フォーカストラバーサルを操作できるようになります。 ただし、指定される KeyEvent に関係なく、関連付けられる KEY_TYPED イベントを含む、フォーカストラバーサルキーに関連するすべての KeyEvent は消費され、ほかの Component へのディスパッチは行われません。 KEY_TYPED イベントのフォーカストラバーサル操作へのマッピング、1 つのイベントの複数のデフォルトフォーカストラバーサル操作へのマッピングは実行時エラーになります。

パラメータ:

id - KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS、KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS、KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS、または KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS のいずれか

keystrokes - 指定された操作に対する AWTKeyStroke のセット

例外:

IllegalArgumentException - id が KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS、KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS、KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS、KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS のいずれでもない場合、keystrokes が null の場合、keystrokes に null が含まれる場合、keystrokes 内の Object が AWTKeyStroke ではない場合、キーストロークが KEY_TYPED イベントを表している場合、またはキーストロークがすでにほかのデフォルトのフォーカストラバーサル操作にマップされている場合

関連項目:

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

getDefaultFocusTraversalKeys

public Set<AWTKeyStroke> getDefaultFocusTraversalKeys(int id)

指定されたトラバーサル操作に対して、デフォルトのフォーカストラバーサルキーの Set を返します。このトラバーサルキーの Set は、明示的に定義された自分自身の Window のうち、このような Set を持たないすべての Window で有効です。また、この Set は、明示的に定義された自分自身の Set を持たないこれらの Windows の任意の子 Component によって再帰的に継承されます。 (各操作の完全な説明については、setDefaultFocusTraversalKeys を参照してください。)

パラメータ:

id - KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS、KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS、KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS、KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS のいずれか

戻り値:

指定された操作に対する AWTKeyStroke の Set。この Set は変更できない。また空の可能性もある。null が返されることはない

例外:

IllegalArgumentException - id が KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS、KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS、KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS、KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS のいずれでもない場合

関連項目:

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

getCurrentFocusCycleRoot

public Container getCurrentFocusCycleRoot()

現在のフォーカスサイクルのルートが呼び出し側スレッドと同じコンテキストにある場合、現在のフォーカスサイクルのルートを返します。フォーカスの所有者自体がフォーカスサイクルのルートの場合、通常のフォーカストラバースの間にどの Component が次または直前の Component を表すかについて、あいまいになる場合があります。この場合は、現在のフォーカスサイクルのルートを使用して、可能性のある Component から識別します。

このメソッドは、KeyboardFocusManagers およびフォーカスの実装専用です。一般的なクライアントが使用するものではありません。

戻り値:

現在のフォーカスサイクルのルート、または現在のフォーカスサイクルのルートが呼び出し側スレッドのコンテキストのメンバーではない場合は null

関連項目:

getGlobalCurrentFocusCycleRoot(), setGlobalCurrentFocusCycleRoot(java.awt.Container)

getGlobalCurrentFocusCycleRoot

protected Container getGlobalCurrentFocusCycleRoot()
                                            throws SecurityException

呼び出し側スレッドが現在のフォーカスサイクルのルートと異なるコンテキストにある場合でも、現在のフォーカスサイクルのルートを返します。フォーカスの所有者自体がフォーカスサイクルのルートの場合、通常のフォーカストラバースの間にどの Component が次または直前の Component を表すかについて、あいまいになる場合があります。この場合は、現在のフォーカスサイクルのルートを使用して、可能性のある Component から識別します。

この KeyboardFocusManager が呼び出し側スレッドのコンテキストに対する現在の KeyboardFocusManager でない場合、このメソッドは SecurityException をスローします。

戻り値:

現在のフォーカスサイクルのルート、または現在のフォーカスサイクルのルートが呼び出し側スレッドのコンテキストのメンバーではない場合は null

例外:

SecurityException - この KeyboardFocusManager が、呼び出し元スレッドのコンテキストに対する現在の KeyboardFocusManager でない場合

関連項目:

getCurrentFocusCycleRoot(), setGlobalCurrentFocusCycleRoot(java.awt.Container)

setGlobalCurrentFocusCycleRoot

public void setGlobalCurrentFocusCycleRoot(Container newFocusCycleRoot)

現在のフォーカスサイクルのルートを設定します。フォーカスの所有者自体がフォーカスサイクルのルートの場合、通常のフォーカストラバースの間にどの Component が次または直前の Component を表すかについて、あいまいになる場合があります。この場合は、現在のフォーカスサイクルのルートを使用して、可能性のある Component から識別します。

このメソッドは、KeyboardFocusManagers およびフォーカスの実装専用です。一般的なクライアントが使用するものではありません。

パラメータ:

newFocusCycleRoot - 新しいフォーカスサイクルのルート

関連項目:

getCurrentFocusCycleRoot(), getGlobalCurrentFocusCycleRoot()

addPropertyChangeListener

public void addPropertyChangeListener(PropertyChangeListener listener)

PropertyChangeListener をリスナーリストに追加します。このリスナーは、次のような、このクラスのすべてのバウンドプロパティーに登録されます。

• KeyboardFocusManager が現在このアプリケーションまたはアプレットのブラウザコンテキストのフォーカスを管理しているかどうか ("managingFocus")
• フォーカスの所有者 ("focusOwner")
• パーマネントフォーカスの所有者 ("permanentFocusOwner")
• フォーカスされた Window ("focusedWindow")
• アクティブ Window ("activeWindow")
• デフォルトのフォーカストラバーサルポリシー ("defaultFocusTraversalPolicy")
• デフォルトの FORWARD_TRAVERSAL_KEYS の Set ("forwardDefaultFocusTraversalKeys")
• デフォルトの BACKWARD_TRAVERSAL_KEYS の Set ("backDefaultFocusTraversalKeys")
• デフォルトの UP_CYCLE_TRAVERSAL_KEYS の Set ("upCycleDefaultFocusTraversalKeys")
• デフォルトの DOWN_CYCLE_TRAVERSAL_KEYS の Set ("downCycleDefaultFocusTraversalKeys")
• 現在のフォーカスサイクルのルート ("currentFocusCycleRoot")

listener が null の場合、例外はスローされず、何も処理は行われません。

パラメータ:

listener - 追加される PropertyChangeListener

関連項目:

removePropertyChangeListener(java.beans.PropertyChangeListener), getPropertyChangeListeners(), addPropertyChangeListener(java.lang.String,java.beans.PropertyChangeListener)

removePropertyChangeListener

public void removePropertyChangeListener(PropertyChangeListener listener)

PropertyChangeListener をリスナーリストから削除します。このメソッドはこのクラスのすべてのバウンドプロパティーに登録された PropertyChangeListeners を削除するために使用する必要があります。

listener が null の場合、例外はスローされず、何も処理は行われません。

パラメータ:

listener - 削除される PropertyChangeListener

関連項目:

addPropertyChangeListener(java.beans.PropertyChangeListener), getPropertyChangeListeners(), removePropertyChangeListener(java.lang.String,java.beans.PropertyChangeListener)

getPropertyChangeListeners

public PropertyChangeListener[] getPropertyChangeListeners()

このキーボードフォーカスマネージャーに登録されたすべてのプロパティー変更リスナーの配列を返します。

戻り値:

このキーボードフォーカスマネージャーのすべての PropertyChangeListener。プロパティー変更リスナーが現在登録されていない場合は空の配列

導入されたバージョン:

1.4

関連項目:

addPropertyChangeListener(java.beans.PropertyChangeListener), removePropertyChangeListener(java.beans.PropertyChangeListener), getPropertyChangeListeners(java.lang.String)

addPropertyChangeListener

public void addPropertyChangeListener(String propertyName,
                             PropertyChangeListener listener)

特定のプロパティーのリスナーリストに PropertyChangeListener を追加します。指定されたプロパティーはユーザー定義の場合か、または次のいずれかです。

• KeyboardFocusManager が現在このアプリケーションまたはアプレットのブラウザコンテキストのフォーカスを管理しているかどうか ("managingFocus")
• フォーカスの所有者 ("focusOwner")
• パーマネントフォーカスの所有者 ("permanentFocusOwner")
• フォーカスされた Window ("focusedWindow")
• アクティブ Window ("activeWindow")
• デフォルトのフォーカストラバーサルポリシー ("defaultFocusTraversalPolicy")
• デフォルトの FORWARD_TRAVERSAL_KEYS の Set ("forwardDefaultFocusTraversalKeys")
• デフォルトの BACKWARD_TRAVERSAL_KEYS の Set ("backDefaultFocusTraversalKeys")
• デフォルトの UP_CYCLE_TRAVERSAL_KEYS の Set ("upCycleDefaultFocusTraversalKeys")
• デフォルトの DOWN_CYCLE_TRAVERSAL_KEYS の Set ("downCycleDefaultFocusTraversalKeys")
• 現在のフォーカスサイクルのルート ("currentFocusCycleRoot")

listener が null の場合、例外はスローされず、何も処理は行われません。

パラメータ:

propertyName - 上記のプロパティー名のいずれか

listener - 追加される PropertyChangeListener

関連項目:

addPropertyChangeListener(java.beans.PropertyChangeListener), removePropertyChangeListener(java.lang.String,java.beans.PropertyChangeListener), getPropertyChangeListeners(java.lang.String)

removePropertyChangeListener

public void removePropertyChangeListener(String propertyName,
                                PropertyChangeListener listener)

特定のプロパティーのリスナーリストから PropertyChangeListener を削除します。このメソッドは特定のバウンドプロパティーに登録された PropertyChangeListeners を削除するために使用する必要があります。

listener が null の場合、例外はスローされず、何も処理は行われません。

パラメータ:

propertyName - 有効なプロパティー名

listener - 削除される PropertyChangeListener

関連項目:

addPropertyChangeListener(java.lang.String,java.beans.PropertyChangeListener), getPropertyChangeListeners(java.lang.String), removePropertyChangeListener(java.beans.PropertyChangeListener)

getPropertyChangeListeners

public PropertyChangeListener[] getPropertyChangeListeners(String propertyName)

名前付きプロパティーに関連付けられたすべての PropertyChangeListener の配列を返します。

戻り値:

名前付きプロパティーに関連付けられたすべての PropertyChangeListener、またはこのようなリスナーが追加されていない場合は空の配列。

導入されたバージョン:

1.4

関連項目:

addPropertyChangeListener(java.lang.String,java.beans.PropertyChangeListener), removePropertyChangeListener(java.lang.String,java.beans.PropertyChangeListener)

firePropertyChange

protected void firePropertyChange(String propertyName,
                      Object oldValue,
                      Object newValue)

バウンドプロパティーの変更に応答して PropertyChangeEvent をトリガーします。このイベントは登録されたすべての PropertyChangeListeners に送信されます。oldValue と newValue が同じ場合はイベントは送信されません。

パラメータ:

propertyName - 変更されたプロパティーの名前

oldValue - プロパティーの以前の値

newValue - プロパティーの新しい値

addVetoableChangeListener

public void addVetoableChangeListener(VetoableChangeListener listener)

VetoableChangeListener をリスナーリストに追加します。このリスナーは、次のようなクラスを含むこのクラスのすべての拒否可能プロパティーに登録されます。

• フォーカスの所有者 ("focusOwner")
• パーマネントフォーカスの所有者 ("permanentFocusOwner")
• フォーカスされた Window ("focusedWindow")
• アクティブ Window ("activeWindow")

listener が null の場合、例外はスローされず、何も処理は行われません。

パラメータ:

listener - 追加される VetoableChangeListener

関連項目:

removeVetoableChangeListener(java.beans.VetoableChangeListener), getVetoableChangeListeners(), addVetoableChangeListener(java.lang.String,java.beans.VetoableChangeListener)

removeVetoableChangeListener

public void removeVetoableChangeListener(VetoableChangeListener listener)

リスナーリストから VetoableChangeListener を削除します。このメソッドはこのクラスのすべての拒否可能プロパティーに登録された VetoableChangeListeners を削除するために使用する必要があります。

listener が null の場合、例外はスローされず、何も処理は行われません。

パラメータ:

listener - 削除される VetoableChangeListener

関連項目:

addVetoableChangeListener(java.beans.VetoableChangeListener), getVetoableChangeListeners(), removeVetoableChangeListener(java.lang.String,java.beans.VetoableChangeListener)

getVetoableChangeListeners

public VetoableChangeListener[] getVetoableChangeListeners()

このキーボードフォーカスマネージャーに登録されたすべての拒否可能変更リスナーの配列を返します。

戻り値:

このキーボードフォーカスマネージャーのすべての VetoableChangeListener。拒否可能変更リスナーが現在登録されていない場合は空の配列

導入されたバージョン:

1.4

関連項目:

addVetoableChangeListener(java.beans.VetoableChangeListener), removeVetoableChangeListener(java.beans.VetoableChangeListener), getVetoableChangeListeners(java.lang.String)

addVetoableChangeListener

public void addVetoableChangeListener(String propertyName,
                             VetoableChangeListener listener)

特定のプロパティーのリスナーリストに VetoableChangeListener を追加します。指定されたプロパティーはユーザー定義の場合か、または次のいずれかです。

• フォーカスの所有者 ("focusOwner")
• パーマネントフォーカスの所有者 ("permanentFocusOwner")
• フォーカスされた Window ("focusedWindow")
• アクティブ Window ("activeWindow")

listener が null の場合、例外はスローされず、何も処理は行われません。

パラメータ:

propertyName - 上記のプロパティー名のいずれか

listener - 追加される VetoableChangeListener

関連項目:

addVetoableChangeListener(java.beans.VetoableChangeListener), removeVetoableChangeListener(java.beans.VetoableChangeListener), getVetoableChangeListeners()

removeVetoableChangeListener

public void removeVetoableChangeListener(String propertyName,
                                VetoableChangeListener listener)

特定のプロパティーのリスナーリストから VetoableChangeListener を削除します。このメソッドは特定のバウンドプロパティーに登録された VetoableChangeListeners を削除するために使用する必要があります。

listener が null の場合、例外はスローされず、何も処理は行われません。

パラメータ:

propertyName - 有効なプロパティー名

listener - 削除される VetoableChangeListener

関連項目:

addVetoableChangeListener(java.beans.VetoableChangeListener), getVetoableChangeListeners(), removeVetoableChangeListener(java.beans.VetoableChangeListener)

getVetoableChangeListeners

public VetoableChangeListener[] getVetoableChangeListeners(String propertyName)

名前付きプロパティーに関連付けられたすべての VetoableChangeListener の配列を返します。

戻り値:

名前付きプロパティーに関連付けられたすべての VetoableChangeListener、またはこのようなリスナーが追加されていない場合は空の配列。

導入されたバージョン:

1.4

関連項目:

addVetoableChangeListener(java.lang.String,java.beans.VetoableChangeListener), removeVetoableChangeListener(java.lang.String,java.beans.VetoableChangeListener), getVetoableChangeListeners()

fireVetoableChange

protected void fireVetoableChange(String propertyName,
                      Object oldValue,
                      Object newValue)
                           throws PropertyVetoException

拒否可能プロパティーの変更に応答して PropertyChangeEvent をトリガーします。このイベントは登録されたすべての VetoableChangeListeners に送信されます。VetoableChangeListener が PropertyVetoException をスローする場合、新しいイベントがトリガーされ、すべての VetoableChangeListeners が古い値に戻され、例外が再スローされます。oldValue と newValue が同じ場合はイベントは送信されません。

パラメータ:

propertyName - 変更されたプロパティーの名前

oldValue - プロパティーの以前の値

newValue - プロパティーの新しい値

例外:

PropertyVetoException - VetoableChangeListener が PropertyVetoException をスローした場合

addKeyEventDispatcher

public void addKeyEventDispatcher(KeyEventDispatcher dispatcher)

KeyEventDispatcher をこの KeyboardFocusManager のディスパッチャーチェーンに追加します。この KeyboardFocusManager は、各 KeyEventDispatcher が最終的に KeyEvent 自体をディスパッチする前にユーザーによって生成された KeyEvents をディスパッチするよう要求します。KeyEventDispatchers は追加された順序で通知されます。 通知は 1 つの KeyEventDispatcher がその dispatchKeyEvent メソッドから true を返すとすぐに停止します。追加される KeyEventDispatchers の総数に制限はありません。また、特定の KeyEventDispatcher インスタンスに追加される回数にも制限はありません。

ディスパッチャーが null に指定されると、処理は行われず、例外はスローされません。

マルチスレッドアプリケーションでは、KeyEventDispatcher は、ほかの AWT リスナーと同じように動作します。詳細は、「AWT スレッドの問題」を参照してください。

パラメータ:

dispatcher - ディスパッチャーチェーンに追加する KeyEventDispatcher

関連項目:

removeKeyEventDispatcher(java.awt.KeyEventDispatcher)

removeKeyEventDispatcher

public void removeKeyEventDispatcher(KeyEventDispatcher dispatcher)

以前にこの KeyboardFocusManager のディスパッチャーチェーンに追加された KeyEventDispatcher を削除します。 この KeyboardFocusManager 自体は、addKeyEventDispatcher への呼び出しを通じて明示的に再登録された場合以外は削除されることはありません。

ディスパッチャーが null に指定された場合、指定されたディスパッチャーがディスパッチャーチェーンにない場合、またはこの KeyboardFocusManager が明示的に再登録されずに指定された場合、処理は行われず、例外はスローされません。

マルチスレッドアプリケーションでは、KeyEventDispatcher は、ほかの AWT リスナーと同じように動作します。詳細は、「AWT スレッドの問題」を参照してください。

パラメータ:

dispatcher - ディスパッチャーチェーンから削除する KeyEventDispatcher

関連項目:

addKeyEventDispatcher(java.awt.KeyEventDispatcher)

getKeyEventDispatchers

protected List<KeyEventDispatcher> getKeyEventDispatchers()

この KeyboardFocusManager の KeyEventDispatcher チェーンを List として返します。 この List には、addKeyEventDispatcher への呼び出しを通じて明示的に再登録された場合以外は、この KeyboardFocusManager は含まれません。その他の KeyEventDispatchers が登録されない場合、実装は null または長さ 0 の List を自由に返します。クライアントコードは別の動作をある動作と想定したり、いったん確立された動作は変更されないと想定したりしてはいけません。

戻り値:

null または空の可能性のある KeyEventDispatchers の List

関連項目:

addKeyEventDispatcher(java.awt.KeyEventDispatcher), removeKeyEventDispatcher(java.awt.KeyEventDispatcher)

addKeyEventPostProcessor

public void addKeyEventPostProcessor(KeyEventPostProcessor processor)

この KeyboardFocusManager のポストプロセッサチェーンに KeyEventPostProcessor を追加します。KeyEvent がディスパッチされ、そのターゲットによって処理されると、KeyboardFocusManager は、各 KeyEventPostProcessor が KeyEvent の最終変換の一部として必要な事後処理を実行するよう要求します。KeyEventPostProcessors は追加された順序で通知されます。現在の KeyboardFocusManager は最後に通知されます。 通知は 1 つの KeyEventPostProcessor がその postProcessKeyEvent メソッドから true を返すとすぐに停止します。追加される KeyEventPostProcessors の総数に制限はありません。また、特定の KeyEventPostProcessor インスタンスに追加される回数にも制限はありません。

ポストプロセッサが null に指定されると、処理は行われず、例外はスローされません。

マルチスレッドアプリケーションでは、KeyEventPostProcessor は、ほかの AWT リスナーと同じように動作します。詳細は、「AWT スレッドの問題」を参照してください。

パラメータ:

processor - ポストプロセッサのチェーンに追加する KeyEventPostProcessor

関連項目:

removeKeyEventPostProcessor(java.awt.KeyEventPostProcessor)

removeKeyEventPostProcessor

public void removeKeyEventPostProcessor(KeyEventPostProcessor processor)

この KeyboardFocusManager のポストプロセッサのチェーンから、以前に追加された KeyEventPostProcessor を削除します。この KeyboardFocusManager 自体はチェーンから完全には削除できません。 addKeyEventPostProcessor を通じて追加された参照のみが削除されます。

ポストプロセッサが null に指定された場合、指定されたポストプロセッサがポストプロセッサチェーンにない場合、またはこの KeyboardFocusManager が明示的に追加されずに指定された場合、処理は行われず、例外はスローされません。

マルチスレッドアプリケーションでは、KeyEventPostProcessor は、ほかの AWT リスナーと同じように動作します。詳細は、「AWT スレッドの問題」を参照してください。

パラメータ:

processor - ポストプロセッサのチェーンから削除する KeyEventPostProcessor

関連項目:

addKeyEventPostProcessor(java.awt.KeyEventPostProcessor)

getKeyEventPostProcessors

protected List<KeyEventPostProcessor> getKeyEventPostProcessors()

この KeyboardFocusManager の KeyEventPostProcessor チェーンを List として返します。 この List には、addKeyEventPostProcessor への呼び出しを通じて明示的に追加された場合以外は、この KeyboardFocusManager は含まれません。その他の KeyEventPostProcessor が登録されない場合、実装は null または長さ 0 の List を自由に返します。クライアントコードは別の動作をある動作であると想定したり、いったん確立された動作は変更されないと想定したりしてはいけません。

戻り値:

null または空の可能性のある KeyEventPostProcessors の List

関連項目:

addKeyEventPostProcessor(java.awt.KeyEventPostProcessor), removeKeyEventPostProcessor(java.awt.KeyEventPostProcessor)

dispatchEvent

public abstract boolean dispatchEvent(AWTEvent e)

このメソッドは AWT イベントディスパッチャーによって呼び出され、現在の KeyboardFocusManager がそのメソッドの代わりに指定されたイベントをディスパッチするよう要求します。すべての KeyboardFocusManagers は、すべての FocusEvents、フォーカスに関連したすべての WindowEvents、およびすべての KeyEvents をディスパッチするものと想定されています。これらのイベントは、フォーカスの所有者およびフォーカスされたアクティブな Windows についての KeyboardFocusManager の概念に基づきディスパッチされる必要があります。これにより、指定された AWTEvent のソースが上書きされる場合があります。 AWT イベントディスパッチャーが KeyboardFocusManager にイベントのディスパッチを再帰的に要求することを防ぐために、ディスパッチは redispatchEvent を使用して実行する必要があります。このメソッドが false を返した場合、AWT イベントディスパッチャーはイベント自体をディスパッチしようとします。

パラメータ:

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

戻り値:

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

関連項目:

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

redispatchEvent

public final void redispatchEvent(Component target,
                   AWTEvent e)

AWT イベントディスパッチャーに対して KeyboardFocusManager、またはインストールされた任意の KeyEventDispatchers が再度イベントを再帰的にディスパッチすることを要求しないような方法で AWTEvent を再ディスパッチします。 dispatchEvent のクライアント実装およびクライアント定義の KeyEventDispatcher は、target.dispatchEvent(e) の代わりに redispatchEvent(target, e) を呼び出してイベントをディスパッチする必要があります。

このメソッドは、KeyboardFocusManagers および KeyEventDispatchers 専用です。一般的なクライアントが使用するものではありません。

パラメータ:

target - イベントをディスパッチする Component

e - ディスパッチするイベント

関連項目:

dispatchEvent(java.awt.AWTEvent), KeyEventDispatcher

dispatchKeyEvent

public abstract boolean dispatchKeyEvent(KeyEvent e)

このメソッドは通常、ディスパッチャーチェーン内のほかの KeyEventDispatcher が KeyEvent をディスパッチしなかった場合、またはほかの KeyEventDispatchers が登録されていない場合に dispatchEvent から呼び出されます。 このメソッドの実装が false を返す場合、dispatchEvent は KeyEvent 自体をディスパッチしようとするか、または単に false を返します。 true が返される場合、dispatchEvent は同様に true を返します。

定義:

dispatchKeyEvent、インタフェース: KeyEventDispatcher

パラメータ:

e - 現在の KeyboardFocusManager でこの KeyEventDispatcher がディスパッチすることを要求した KeyEvent

戻り値:

KeyEvent がディスパッチされた場合は true、そうでない場合は false

関連項目:

dispatchEvent(java.awt.AWTEvent)

postProcessKeyEvent

public abstract boolean postProcessKeyEvent(KeyEvent e)

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

定義:

postProcessKeyEvent、インタフェース: KeyEventPostProcessor

パラメータ:

e - プロセス終了後の KeyEvent

戻り値:

true の場合、ほかの KeyEventPostProcessor が KeyEvent について通知されないことを示す。

関連項目:

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

processKeyEvent

public abstract void processKeyEvent(Component focusedComponent,
                   KeyEvent e)

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

パラメータ:

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

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

enqueueKeyEvents

protected abstract void enqueueKeyEvents(long after,
                    Component untilFocused)

指定された Component がフォーカスの所有者になるまで、KeyEvents のディスパッチを遅延させる必要があることを KeyboardFocusManager に通知するために AWT によって呼び出されます。クライアントコードがフォーカスの変更を要求する場合、および AWT がこの要求はネイティブのウィンドウ処理システムによって許可されるものであると判定する場合は、AWT はこのメソッドを呼び出します。 指定された時刻表示よりも遅い時刻表示を持つ KeyEvents のディスパッチを、指定された Component が FOCUS_GAINED イベントを受け取るか、または AWT が dequeueKeyEvents または discardKeyEvents を呼び出して遅延要求を取り消すまで遅延させるのは KeyboardFocusManager の責任です。

パラメータ:

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

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

関連項目:

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

dequeueKeyEvents

protected abstract void dequeueKeyEvents(long after,
                    Component untilFocused)

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

パラメータ:

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

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

関連項目:

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

discardKeyEvents

protected abstract void discardKeyEvents(Component comp)

遅延した KeyEvents のディスパッチを取り消すよう KeyboardFocusManager に通知するために AWT によって呼び出されます。 同じ Component を持つ enqueueKeyEvents への 1 回以上の呼び出しのためにキューに入れられたすべての KeyEvents は破棄される必要があります。

パラメータ:

comp - enqueueKeyEvents への 1 回以上の呼び出しで指定された Component

関連項目:

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

focusNextComponent

public abstract void focusNextComponent(Component aComponent)

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

パラメータ:

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

関連項目:

FocusTraversalPolicy

focusPreviousComponent

public abstract void focusPreviousComponent(Component aComponent)

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

パラメータ:

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

関連項目:

FocusTraversalPolicy

upFocusCycle

public abstract void upFocusCycle(Component aComponent)

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

パラメータ:

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

downFocusCycle

public abstract void downFocusCycle(Container aContainer)

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

パラメータ:

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

focusNextComponent

public final void focusNextComponent()

現在のフォーカスの所有者のあとに Component をフォーカスします。

focusPreviousComponent

public final void focusPreviousComponent()

現在のフォーカスの所有者の前に Component をフォーカスします。

upFocusCycle

public final void upFocusCycle()

フォーカスを現在のフォーカスの所有者から 1 つ上のフォーカストラバーサルサイクルに移動します。通常、新しいフォーカスの所有者は、現在のフォーカスの所有者のフォーカスサイクルのルートに設定され、現在のフォーカスサイクルのルートは新しいフォーカスの所有者のフォーカスサイクルのルートに設定されます。ただし、現在のフォーカスの所有者のフォーカスサイクルのルートが Window の場合、通常フォーカスの所有者はフォーカスするフォーカスサイクルのルートのデフォルト Component に設定され、現在のフォーカスサイクルのルートは変更されません。

downFocusCycle

public final void downFocusCycle()

現在のフォーカスの所有者がフォーカスサイクルのルートである Container の場合にのみ、フォーカスを現在のフォーカスの所有者から 1 つ下のフォーカストラバーサルサイクルに移動します。通常、フォーカスの所有者はフォーカスする現在のフォーカスの所有者のデフォルトの Component に設定され、現在のフォーカスサイクルのルートは現在のフォーカスの所有者に設定されます。現在のフォーカスの所有者がフォーカスサイクルのルートである Container でない場合は、フォーカストラバーサル操作は行われません。