クラス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によって生成されます。 イベントは、そのコンポーネントの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がフォーカス所有者でなくなったことを示します。

    クラスで宣言されたフィールド ComponentEvent

    COMPONENT_FIRST, COMPONENT_HIDDEN, COMPONENT_LAST, COMPONENT_MOVED, COMPONENT_RESIZED, COMPONENT_SHOWN
    修飾子と型
    フィールド
    説明
    static final int
    COMPONENT_FIRST
    コンポーネント・イベントに使用されるIDの範囲内の最初の番号です。
    static final int
    COMPONENT_HIDDEN
    このイベントは、コンポーネントが不可視になったことを示します。
    static final int
    COMPONENT_LAST
    コンポーネント・イベントに使用されるIDの範囲内の最後の番号です。
    static final int
    COMPONENT_MOVED
    このイベントは、コンポーネントの位置が変更されたことを示します。
    static final int
    COMPONENT_RESIZED
    このイベントは、コンポーネントのサイズが変更されたことを示します。
    static final int
    COMPONENT_SHOWN
    このイベントは、コンポーネントが可視になったことを示します。

    クラスで宣言されたフィールド 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
    修飾子と型
    フィールド
    説明
    static final long
    ACTION_EVENT_MASK
    アクション・イベント選択用イベント・マスクです。
    static final long
    ADJUSTMENT_EVENT_MASK
    調整イベント選択用イベント・マスクです。
    static final long
    COMPONENT_EVENT_MASK
    コンポーネント・イベント選択用イベント・マスクです。
    protected boolean
    consumed
    転送元の処理後にイベントをピアに送り返すかどうかを制御します。trueの場合は送り返されず、falseの場合は送り返されます。
    static final long
    CONTAINER_EVENT_MASK
    コンテナ・イベント選択用イベント・マスクです。
    static final long
    FOCUS_EVENT_MASK
    フォーカス・イベント選択用イベント・マスクです。
    static final long
    HIERARCHY_BOUNDS_EVENT_MASK
    階層境界イベント選択用イベント・マスクです。
    static final long
    HIERARCHY_EVENT_MASK
    階層イベント選択用イベント・マスクです。
    protected int
    id
    イベントのID
    static final long
    INPUT_METHOD_EVENT_MASK
    インプット・メソッド・イベント選択用イベント・マスクです。
    static final long
    INVOCATION_EVENT_MASK
    呼出しイベント選択用イベント・マスクです。
    static final long
    ITEM_EVENT_MASK
    項目イベント選択用イベント・マスクです。
    static final long
    KEY_EVENT_MASK
    キー・イベント選択用イベント・マスクです。
    static final long
    MOUSE_EVENT_MASK
    マウス・イベント選択用イベント・マスクです。
    static final long
    MOUSE_MOTION_EVENT_MASK
    マウス・モーション・イベント選択用イベント・マスクです。
    static final long
    MOUSE_WHEEL_EVENT_MASK
    マウス・ホイール・イベント選択用イベント・マスクです。
    static final long
    PAINT_EVENT_MASK
    ペイント・イベント選択用イベント・マスクです。
    static final int
    RESERVED_ID_MAX
    予約済みAWTイベントIDの最大値です。
    static final long
    TEXT_EVENT_MASK
    テキスト・イベント選択用イベント・マスクです。
    static final long
    WINDOW_EVENT_MASK
    ウィンドウ・イベント選択用イベント・マスクです。
    static final long
    WINDOW_FOCUS_EVENT_MASK
    ウィンドウ・フォーカス・イベント選択用イベント・マスクです。
    static final long
    WINDOW_STATE_EVENT_MASK
    ウィンドウ状態イベント選択用イベント・マスクです。

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

    source
    修飾子と型
    フィールド
    説明
    protected Object
    source
    Eventが最初に発生したオブジェクト。

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

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

    クラスで宣言されたメソッド ComponentEvent

    getComponent
    修飾子と型
    メソッド
    説明
    Component
    getComponent()
    イベントの発生元を返します。

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

    consume, getID, isConsumed, setSource, toString
    修飾子と型
    メソッド
    説明
    protected void
    consume()
    このイベントを消費できる場合は消費します。
    int
    getID()
    イベント・タイプを返します。
    protected boolean
    isConsumed()
    このイベントが消費されたかどうかを返します。
    void
    setSource(Object newSource)
    イベントを新しいソースにターゲット変更します。
    String
    toString()
    このオブジェクトの文字列表現を返します。

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

    getSource
    修飾子と型
    メソッド
    説明
    Object
    getSource()
    Eventが最初に発生したオブジェクト。

    クラスオブジェクトで宣言されたメソッド

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
    修飾子と型
    メソッド
    説明
    protected Object
    clone()
    このオブジェクトのコピーを作成して、返します。
    boolean
    equals(Object obj)
    このオブジェクトと他のオブジェクトが等しいかどうかを示します。
    protected void
    finalize()
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    最終決定は非推奨であり、将来のリリースで削除される可能性があります。
    final Class<?>
    getClass()
    このObjectの実行時クラスを返します。
    int
    hashCode()
    このオブジェクトに対するハッシュ・コード値を返します。
    final void
    notify()
    このオブジェクトのモニターで待機中のスレッドを1つ再開します。
    final void
    notifyAll()
    このオブジェクトのモニターで待機中のすべてのスレッドを再開します。
    final void
    wait()
    現在のスレッドが目覚めるまで待機します。通常、notifiedまたはinterruptedです。
    final void
    wait(long timeoutMillis)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
    final void
    wait(long timeoutMillis, int nanos)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

  • フィールド詳細

    • 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
      関連項目:

    • 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
      関連項目:

    • FocusEvent

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

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

      パラメータ:
      source - イベントを発生させたComponent
      id - イベントのタイプを示す整数。 許容される値については、FocusEventのクラスの説明を参照してください。
      temporary - フォーカス変更がテンポラリの場合はtrue、そうでない場合はfalse
      スロー:
      IllegalArgumentException - sourceがnullの場合
      関連項目:

    • FocusEvent

      public FocusEvent(Component source, int id)
      FocusEventオブジェクトを構築し、フォーカスのパーマネント変更として識別します。

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

      パラメータ:
      source - イベントを発生させたComponent
      id - イベントのタイプを示す整数。 許容される値については、FocusEventのクラスの説明を参照してください。
      スロー:
      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()
      このイベントを特定するパラメータ文字列を返します。 このメソッドは、イベント・ログの作成およびデバッグに便利です。
      オーバーライド:
      paramString、クラスComponentEvent
      戻り値:
      イベントを特定する文字列とその属性

    • getCause

      public final FocusEvent.Cause getCause()
      イベントの原因を返します。
      戻り値:
      FocusEvent.Cause値の1つ
      導入されたバージョン:
      9