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 から別の Component へ直接移動するときに発生します。テンポラリフォーカス変更イベントは、Window がアクティブでなくなったり、スクロールバーをドラッグする場合など、別の操作の間接的な結果として Component に対するフォーカスを一時的に失う場合に発生します。この場合、その操作が終了すると元のフォーカスの状態が自動的に復元されます。また、Window がアクティブでなくなった場合には、再びアクティブになったときに元のフォーカスの状態が自動的に復元されます。パーマネントフォーカス変更イベントとテンポラリフォーカス変更イベントは両方とも、FOCUS_GAINED と FOCUS_LOST イベント識別子を使用して発行されます。イベントのレベルの違いは、isTemporary() メソッドを使用して区別できます。

導入されたバージョン:

1.1

関連項目:

FocusAdapter, FocusListener, Tutorial: Writing a Focus Listener, Reference: The Java Class Libraries (update file), 直列化された形式

フィールドの概要

static int	FOCUS_FIRST フォーカスイベント識別子に使う整数の範囲にある、最初の番号です。
static int	FOCUS_GAINED このイベントは、現在 Component がフォーカスの所有者であることを示します。
static int	FOCUS_LAST フォーカスイベント識別子に使う整数の範囲にある、最後の番号です。
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

フォーカスイベント識別子に使う整数の範囲にある、最初の番号です。

関連項目:

定数フィールド値

FOCUS_LAST

public static final int FOCUS_LAST

フォーカスイベント識別子に使う整数の範囲にある、最後の番号です。

関連項目:

定数フィールド値

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 になります。

無効な id を渡すと、特定できない動作が発生します。このメソッドは source が null の場合に IllegalArgumentException をスローします。

パラメータ:

source - イベントの発生元の Component

id - FOCUS_GAINED または FOCUS_LOST

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

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

例外:

IllegalArgumentException - source が null の場合

FocusEvent

public FocusEvent(Component source,
                  int id,
                  boolean temporary)

FocusEvent オブジェクトを構築し、変更がテンポラリかどうかを判定します。

無効な id を渡すと、特定できない動作が発生します。このメソッドは source が null の場合に IllegalArgumentException をスローします。

パラメータ:

source - イベントの発生元の Component

id - イベントの型を示す整数

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

例外:

IllegalArgumentException - source が null の場合

FocusEvent

public FocusEvent(Component source,
                  int id)

FocusEvent オブジェクトを構築し、フォーカスの変更がパーマネントかどうかを判定します。

無効な id を渡すと、特定できない動作が発生します。このメソッドは source が null の場合に IllegalArgumentException をスローします。

パラメータ:

source - イベントの発生元の Component

id - イベントの型を示す整数

例外:

IllegalArgumentException - source が null の場合

メソッドの詳細

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

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

オーバーライド:

クラス ComponentEvent 内の paramString

戻り値:

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