java.awt.event

クラス FocusEvent

java.lang.Object

java.util.EventObject

java.awt.AWTEvent

java.awt.event.ComponentEvent

java.awt.event.FocusEvent

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

Serializable

public class FocusEvent
extends ComponentEvent

Component が入力フォーカスを取得または失ったことを示す、低レベルイベントです。この低レベルイベントは、TextField などの Component によって生成されます。イベントは、その Component の 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 までの範囲にない場合に、未指定の動作が発生します。

導入されたバージョン:

1.1

関連項目:

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 がフォーカス所有者でなくなったことを示します。

クラス java.awt.event.ComponentEvent から継承されるフィールド

COMPONENT_FIRST, COMPONENT_HIDDEN, COMPONENT_LAST, COMPONENT_MOVED, COMPONENT_RESIZED, COMPONENT_SHOWN

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

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

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

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() このイベントを特定するパラメータ文字列を返します。

クラス java.awt.event.ComponentEvent から継承されるメソッド

getComponent

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

consume, getID, isConsumed, setSource, toString

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

getSource

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

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

フィールドの詳細

FOCUS_FIRST

public static final int FOCUS_FIRST

フォーカスイベントに使用される ID の範囲内の最初の番号です。

関連項目:

定数フィールド値

FOCUS_LAST

public static final int FOCUS_LAST

フォーカスイベントに使用される ID の範囲内の最後の番号です。

関連項目:

定数フィールド値

FOCUS_GAINED

public static final int FOCUS_GAINED

このイベントは、この Component がフォーカス所有者になったことを示します。

関連項目:

定数フィールド値

FOCUS_LOST

public static final int FOCUS_LOST

このイベントは、この Component がフォーカス所有者でなくなったことを示します。

関連項目:

定数フィールド値

コンストラクタの詳細

FocusEvent

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 の場合

導入されたバージョン:

1.4

関連項目:

EventObject.getSource(), AWTEvent.getID(), isTemporary(), getOppositeComponent()

FocusEvent

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()

FocusEvent

public FocusEvent(Component source,
          int id)

FocusEvent オブジェクトを構築し、フォーカスのパーマネント変更として識別します。

このメソッドは source が null の場合に IllegalArgumentException をスローします。

パラメータ:

source - イベントを発生させた Component

id - イベントのタイプを示す整数。許容される値については、FocusEvent のクラスの説明を参照してください。

例外:

IllegalArgumentException - source が null の場合

関連項目:

EventObject.getSource(), AWTEvent.getID()

メソッドの詳細

isTemporary

public boolean isTemporary()

フォーカス変更イベントをテンポラリまたはパーマネントとして識別します。

戻り値:

フォーカス変更がテンポラリの場合は true、そうでない場合は false

getOppositeComponent

public Component getOppositeComponent()

このフォーカス変更に関係するもう一方の Component を返します。FOCUS_GAINED イベントの場合、これはフォーカスを失った Component です。FOCUS_LOST イベントの場合、これはフォーカスを取得した Component です。このフォーカス変更が、ネイティブアプリケーションで、異なる VM またはコンテキスト内の Java アプリケーションで、またはもう一方の Component なしで発生した場合、null が返されます。

戻り値:

フォーカス変更に関係するもう一方の Component、または null

導入されたバージョン:

1.4

paramString

public String paramString()

このイベントを特定するパラメータ文字列を返します。このメソッドは、イベントログの作成およびデバッグに便利です。

オーバーライド:

paramString、クラス: ComponentEvent

戻り値:

イベントを特定する文字列とその属性