JavaTM Platform
Standard Ed. 6

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」, 直列化された形式

フィールドの概要
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 をまったく使わずに行われる場合は、反対の Componentnull になります。  

無効な id を渡して、特定できない動作を発生させないようにしてください。このメソッドは sourcenull の場合に IllegalArgumentException をスローします。

パラメータ:
source - イベントの発生元の Component
id - FOCUS_GAINED または FOCUS_LOST
temporary - フォーカス変更がテンポラリの場合は true、 そうでない場合は false
opposite - フォーカス変更に関係するもう一方の Component、 または null
例外:
IllegalArgumentException - source が null の場合
導入されたバージョン:
1.4

FocusEvent

public FocusEvent(Component source,
                  int id,
                  boolean temporary)
FocusEvent オブジェクトを構築し、変更がテンポラリかどうかを判定します。  

無効な id を渡して、特定できない動作を発生させないようにしてください。このメソッドは sourcenull の場合に IllegalArgumentException をスローします。

パラメータ:
source - イベントの発生元の Component
id - イベントの型を示す整数
temporary - フォーカス変更がテンポラリの場合は true、 そうでない場合は false
例外:
IllegalArgumentException - source が null の場合

FocusEvent

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

無効な id を渡して、特定できない動作を発生させないようにしてください。このメソッドは sourcenull の場合に 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
戻り値:
イベントを特定する文字列とその属性

JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。