java.awt.event.FocusEvent

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

public class FocusEvent extends ComponentEvent

Componentが入力フォーカスを取得または失ったことを示す、低レベル・イベントです。この低レベル・イベントは、TextFieldなどのComponentによって生成されます。イベントは、そのコンポーネントのaddFocusListenerメソッドを使ってこれらのイベントを受け取るように登録されている、すべてのFocusListenerまたはFocusAdapterオブジェクトに渡されます。 (FocusAdapterオブジェクトは、FocusListenerインタフェースを実装します。) 各リスナー・オブジェクトは、イベントが発生したときにこのFocusEventを取得します。

フォーカス・イベントには、パーマネントとテンポラリの2つのレベルがあります。パーマネント・フォーカス変更イベントは、requestFocus()を呼び出したり、ユーザーがTabキーを使用してComponentをトラバースしたりなど、フォーカスが別のComponentに直接移動するときに発生します。テンポラリ・フォーカス変更イベントは、Windowの非アクティブ化やスクロール・バーのドラッグなど、別の操作の間接的な結果としてComponentのフォーカスが一時的に失われたときに発生します。この場合、その操作が終了すると元のフォーカス状態が自動的に復元されます(Windowの非アクティブ化の場合は再度アクティブ化されたとき)。パーマネントおよびテンポラリ・フォーカス・イベントは両方とも、FOCUS_GAINEDおよびFOCUS_LOSTイベントIDを使用して送信されます。レベルは、イベント内でisTemporary()メソッドを使用して識別できます。

すべてのFocusEventが原因を記録 - このイベントが生成された理由。原因は、フォーカス・イベントの作成時に割り当てられ、getCause()を呼び出すことで取得できます。

特定のFocusEventインスタンスのidパラメータがFOCUS_FIRSTからFOCUS_LASTまでの範囲にない場合に、未指定の動作が発生します。

導入されたバージョン:

1.1

関連項目:

ネストされたクラスのサマリー

ネストされたクラス

修飾子と型

クラス

説明

static enum

FocusEvent.Cause

この列挙型は、FocusEventの原因を表します。- それが起こった理由。
フィールドのサマリー

フィールド

修飾子と型

フィールド

説明

static final int

FOCUS_FIRST

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

static final int

FOCUS_GAINED

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

static final int

FOCUS_LAST

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

static final 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とCause.UNKNOWNの原因の反対)を持つFocusEventオブジェクトを構築します。

FocusEvent(Component source, int id, boolean temporary, Component opposite, FocusEvent.Cause cause)

指定された一時状態(反対のComponentおよび原因)でFocusEventオブジェクトを構築します。
メソッドのサマリー

修飾子と型

メソッド

説明

final FocusEvent.Cause

getCause()

イベントの原因を返します。

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とCause.UNKNOWNの原因の反対)を持つ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.Cause.UNKNOWN
- FocusEvent
  public FocusEvent(Component source, int id, boolean temporary, Component opposite, FocusEvent.Cause cause)
  
  指定された一時状態(反対のComponentおよび原因)でFocusEventオブジェクトを構築します。反対Componentとは、フォーカス変更に関係するもう一方のComponentのことです。 FOCUS_GAINEDイベントの場合、これはフォーカスを失ったComponentです。 FOCUS_LOSTイベントの場合、これはフォーカスを取得したComponentです。このフォーカス変更が、ネイティブ・アプリケーションで、異なるVM内のJavaアプリケーションで、またはもう一方のComponentなしで発生した場合、反対Componentはnullです。
  sourceまたはcauseがnullの場合、このメソッドはIllegalArgumentExceptionをスローします。
  
  パラメータ:
  
  source - イベントを発生させたComponent
  
  id - イベントのタイプを示す整数。許容される値については、FocusEventのクラスの説明を参照してください。
  
  temporary - フォーカス変更がテンポラリの場合はtrue、そうでない場合はfalse
  
  opposite - フォーカス変更に関係するもう一方のComponent、またはnull
  
  cause - フォーカス・イベントの原因。
  
  例外:
  
  IllegalArgumentException - sourceがnullと等しい場合、またはcauseがnullと等しい場合
  
  導入されたバージョン:
  
  9
  
  関連項目:
  
  EventObject.getSource()
  
  AWTEvent.getID()
  
  isTemporary()
  
  getOppositeComponent()
  
  FocusEvent.Cause
- 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
  
  戻り値:
  
  イベントを特定する文字列とその属性
- getCause
  
  public final FocusEvent.Cause getCause()
  
  イベントの原因を返します。
  
  戻り値:
  
  FocusEvent.Cause値の1つ
  
  導入されたバージョン:
  
  9

クラスFocusEvent

ネストされたクラスのサマリー

フィールドのサマリー

クラスjava.awt.event.ComponentEventで宣言されたフィールド

クラスjava.awt.AWTEventで宣言されたフィールド

クラスjava.util.EventObjectで宣言されたフィールド

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

メソッドのサマリー

クラスjava.awt.event.ComponentEventで宣言されたメソッド

クラスjava.awt.AWTEventで宣言されたメソッド

クラスjava.util.EventObjectで宣言されたメソッド

クラスjava.lang.Objectで宣言されたメソッド

フィールド詳細

FOCUS_FIRST

FOCUS_LAST

FOCUS_GAINED

FOCUS_LOST

コンストラクタの詳細

FocusEvent

FocusEvent

FocusEvent

FocusEvent

メソッドの詳細

isTemporary

getOppositeComponent

paramString

getCause