public class FocusEvent extends ComponentEvent
addFocusListener
メソッドを使ってこれらのイベントを受け取るように登録されている、すべてのFocusListener
またはFocusAdapter
オブジェクトに渡されます。(FocusAdapter
オブジェクトはFocusListener
インタフェースを実装します。)各リスナー・オブジェクトは、イベントが発生したときにこのFocusEvent
を取得します。
フォーカス・イベントには、パーマネントとテンポラリの2つのレベルがあります。パーマネント・フォーカス変更イベントは、requestFocus()を呼び出したり、ユーザーがTabキーを使用してComponentをトラバースしたりなど、フォーカスが別のComponentに直接移動するときに発生します。テンポラリ・フォーカス変更イベントは、Windowの非アクティブ化やスクロール・バーのドラッグなど、別の操作の間接的な結果としてComponentのフォーカスが一時的に失われたときに発生します。この場合、その操作が終了すると元のフォーカス状態が自動的に復元されます(Windowの非アクティブ化の場合は再度アクティブ化されたとき)。パーマネントおよびテンポラリ・フォーカス・イベントは両方とも、FOCUS_GAINEDおよびFOCUS_LOSTイベントIDを使用して送信されます。レベルは、イベント内でisTemporary()メソッドを使用して識別できます。
特定のFocusEvent
インスタンスのid
パラメータがFOCUS_FIRST
からFOCUS_LAST
までの範囲にない場合に、未指定の動作が発生します。
FocusAdapter
, FocusListener
, Tutorial: Writing a Focus Listener, 直列化された形式修飾子と型 | フィールドと説明 |
---|---|
static int |
FOCUS_FIRST
フォーカス・イベントに使用されるIDの範囲内の最初の番号です。
|
static int |
FOCUS_GAINED
このイベントは、このComponentがフォーカス所有者になったことを示します。
|
static int |
FOCUS_LAST
フォーカス・イベントに使用されるIDの範囲内の最後の番号です。
|
static int |
FOCUS_LOST
このイベントは、このComponentがフォーカス所有者でなくなったことを示します。
|
COMPONENT_FIRST, COMPONENT_HIDDEN, COMPONENT_LAST, COMPONENT_MOVED, COMPONENT_RESIZED, COMPONENT_SHOWN
ACTION_EVENT_MASK, ADJUSTMENT_EVENT_MASK, COMPONENT_EVENT_MASK, consumed, CONTAINER_EVENT_MASK, FOCUS_EVENT_MASK, HIERARCHY_BOUNDS_EVENT_MASK, HIERARCHY_EVENT_MASK, id, INPUT_METHOD_EVENT_MASK, INVOCATION_EVENT_MASK, ITEM_EVENT_MASK, KEY_EVENT_MASK, MOUSE_EVENT_MASK, MOUSE_MOTION_EVENT_MASK, MOUSE_WHEEL_EVENT_MASK, PAINT_EVENT_MASK, RESERVED_ID_MAX, TEXT_EVENT_MASK, WINDOW_EVENT_MASK, WINDOW_FOCUS_EVENT_MASK, WINDOW_STATE_EVENT_MASK
source
コンストラクタと説明 |
---|
FocusEvent(Component source, int id)
FocusEvent オブジェクトを構築し、フォーカスのパーマネント変更として識別します。 |
FocusEvent(Component source, int id, boolean temporary)
FocusEvent オブジェクトを構築し、変更がテンポラリかどうかを識別します。 |
FocusEvent(Component source, int id, boolean temporary, Component opposite)
指定されたテンポラリ状態および反対
Component でFocusEvent オブジェクトを構築します。 |
修飾子と型 | メソッドと説明 |
---|---|
Component |
getOppositeComponent()
このフォーカス変更に関係するもう一方のComponentを返します。
|
boolean |
isTemporary()
フォーカス変更イベントをテンポラリまたはパーマネントとして識別します。
|
String |
paramString()
このイベントを特定するパラメータ文字列を返します。
|
getComponent
getSource
public static final int FOCUS_FIRST
public static final int FOCUS_LAST
public static final int FOCUS_GAINED
public static final int FOCUS_LOST
public FocusEvent(Component source, int id, boolean temporary, Component opposite)
Component
でFocusEvent
オブジェクトを構築します。反対Component
とは、フォーカス変更に関係するもう一方のComponent
のことです。FOCUS_GAINED
イベントの場合、これはフォーカスを失ったComponent
です。FOCUS_LOST
イベントの場合、これはフォーカスを取得したComponent
です。このフォーカス変更が、ネイティブ・アプリケーションで、異なるVM内のJavaアプリケーションで、またはもう一方のComponent
なしで発生した場合、反対Component
はnull
です。
このメソッドはsource
がnull
の場合にIllegalArgumentException
をスローします。
source
- イベントを発生させたComponent
id
- イベントのタイプを示す整数。許容される値については、FocusEvent
のクラスの説明を参照してください。temporary
- フォーカス変更がテンポラリの場合はtrue
、そうでない場合はfalse
opposite
- フォーカス変更に関係するもう一方のComponent、またはnull
IllegalArgumentException
- source
がnull
の場合EventObject.getSource()
, AWTEvent.getID()
, isTemporary()
, getOppositeComponent()
public FocusEvent(Component source, int id, boolean temporary)
FocusEvent
オブジェクトを構築し、変更がテンポラリかどうかを識別します。
このメソッドはsource
がnull
の場合にIllegalArgumentException
をスローします。
source
- イベントを発生させたComponent
id
- イベントのタイプを示す整数。許容される値については、FocusEvent
のクラスの説明を参照してください。temporary
- フォーカス変更がテンポラリの場合はtrue
、そうでない場合はfalse
IllegalArgumentException
- source
がnull
の場合EventObject.getSource()
, AWTEvent.getID()
, isTemporary()
public FocusEvent(Component source, int id)
FocusEvent
オブジェクトを構築し、フォーカスのパーマネント変更として識別します。
このメソッドはsource
がnull
の場合にIllegalArgumentException
をスローします。
source
- イベントを発生させたComponent
id
- イベントのタイプを示す整数。許容される値については、FocusEvent
のクラスの説明を参照してください。IllegalArgumentException
- source
がnull
の場合EventObject.getSource()
, AWTEvent.getID()
public boolean isTemporary()
true
、そうでない場合はfalse
public Component getOppositeComponent()
public String paramString()
paramString
、クラス: ComponentEvent
バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2016, Oracle and/or its affiliates. All rights reserved.Use is subject to license termsDocumentation Redistribution Policyも参照してください。