JavaTM 2 Platform
Std. Ed. v1.3

java.awt
クラス AWTEvent

java.lang.Object
  |
  +--java.util.EventObject
        |
        +--java.awt.AWTEvent
すべての実装インタフェース:
Serializable
直系の既知のサブクラス:
ActionEvent, AdjustmentEvent, AncestorEvent, ComponentEvent, HierarchyEvent, InputMethodEvent, InternalFrameEvent, InvocationEvent, ItemEvent, TextEvent

public abstract class AWTEvent
extends EventObject

すべての AWT イベント用のルートイベントクラスです。このクラスとサブクラスは、元の java.awt.Event クラスの代わりに使用されます。java.awt.event パッケージ外で定義されたこのルート AWTEvent クラスのサブクラスは、RESERVED_ID_MAX によって定義した値より大きいイベント ID 値を定義する必要があります。

このクラスで定義されたイベントマスクは、コンポーネントサブクラスに必要です。コンポーネントサブクラスでは、登録されたリスナーによって選択されないイベント型を選択するために Component.enableEvents() を使用しています。リスナーがコンポーネントに登録されている場合、対応するイベントマスクはそのコンポーネントによってすでに内部で設定されています。

マスクは、AWTEventListener がどちらの型のイベントに待機する必要があるかを指定するのにも使われます。マスクはビット単位の論理和で、Toolkit.addAWTEventListener に引き渡されます。

導入されたバージョン:
1.1
関連項目:
Component.enableEvents(long), Toolkit.addAWTEventListener(java.awt.event.AWTEventListener, long), ActionEvent, AdjustmentEvent, ComponentEvent, ContainerEvent, FocusEvent, InputMethodEvent, InvocationEvent, ItemEvent, HierarchyEvent, KeyEvent, MouseEvent, PaintEvent, TextEvent, WindowEvent, 直列化された形式

フィールドの概要
static long ACTION_EVENT_MASK
          アクションイベント選択用イベントマスクです。
static long ADJUSTMENT_EVENT_MASK
          調整イベント選択用イベントマスクです。
static long COMPONENT_EVENT_MASK
          コンポーネントイベント選択用イベントマスクです。
protected  boolean consumed
           
static long CONTAINER_EVENT_MASK
          コンテナイベント選択用イベントマスクです。
static long FOCUS_EVENT_MASK
          フォーカスイベント選択用イベントマスクです。
static long HIERARCHY_BOUNDS_EVENT_MASK
          階層境界イベント選択用のイベントマスクです。
static long HIERARCHY_EVENT_MASK
          階層イベント選択用のイベントマスクです。
protected  int id
           
static long INPUT_METHOD_EVENT_MASK
          インプットメソッドイベント選択用イベントマスクです。
static long INVOCATION_EVENT_MASK
          呼び出しイベント選択用のイベントマスクです。
static long ITEM_EVENT_MASK
          項目イベント選択用イベントマスクです。
static long KEY_EVENT_MASK
          キーイベント選択用イベントマスクです。
static long MOUSE_EVENT_MASK
          マウスイベント選択用イベントマスクです。
static long MOUSE_MOTION_EVENT_MASK
          マウスモーションイベント選択用イベントマスクです。
static long PAINT_EVENT_MASK
          ペイントイベント選択用のイベントマスクです。
static int RESERVED_ID_MAX
          予約済 AWT イベント ID の最大値です。
static long TEXT_EVENT_MASK
          テキストイベント選択用イベントマスクです。
static long WINDOW_EVENT_MASK
          ウィンドウイベント選択用イベントマスクです。
 
クラス java.util.EventObject から継承したフィールド
source
 
コンストラクタの概要
AWTEvent(Event event)
          1.0 形式のイベントのパラメータを使用して、AWTEvent オブジェクトを構築します。
AWTEvent(Object source, int id)
          指定されたソースオブジェクトと型を使用して、AWTEvent オブジェクトを構築します。
 
メソッドの概要
protected  void consume()
           
protected  void finalize()
          このオブジェクトへの参照はもうないとガーベージコレクションによって判断されたときに、ガーベージコレクタによって呼び出されます。
 int getID()
          イベントの型を返します。
protected  boolean isConsumed()
           
 String paramString()
          このイベントの状態を表す文字列を返します。
 String toString()
          この EventObject の String 表現を返します。
 
クラス java.util.EventObject から継承したメソッド
getSource
 
クラス java.lang.Object から継承したメソッド
clone, equals, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

フィールドの詳細

id

protected int id

consumed

protected boolean consumed

COMPONENT_EVENT_MASK

public static final long COMPONENT_EVENT_MASK
コンポーネントイベント選択用イベントマスクです。

CONTAINER_EVENT_MASK

public static final long CONTAINER_EVENT_MASK
コンテナイベント選択用イベントマスクです。

FOCUS_EVENT_MASK

public static final long FOCUS_EVENT_MASK
フォーカスイベント選択用イベントマスクです。

KEY_EVENT_MASK

public static final long KEY_EVENT_MASK
キーイベント選択用イベントマスクです。

MOUSE_EVENT_MASK

public static final long MOUSE_EVENT_MASK
マウスイベント選択用イベントマスクです。

MOUSE_MOTION_EVENT_MASK

public static final long MOUSE_MOTION_EVENT_MASK
マウスモーションイベント選択用イベントマスクです。

WINDOW_EVENT_MASK

public static final long WINDOW_EVENT_MASK
ウィンドウイベント選択用イベントマスクです。

ACTION_EVENT_MASK

public static final long ACTION_EVENT_MASK
アクションイベント選択用イベントマスクです。

ADJUSTMENT_EVENT_MASK

public static final long ADJUSTMENT_EVENT_MASK
調整イベント選択用イベントマスクです。

ITEM_EVENT_MASK

public static final long ITEM_EVENT_MASK
項目イベント選択用イベントマスクです。

TEXT_EVENT_MASK

public static final long TEXT_EVENT_MASK
テキストイベント選択用イベントマスクです。

INPUT_METHOD_EVENT_MASK

public static final long INPUT_METHOD_EVENT_MASK
インプットメソッドイベント選択用イベントマスクです。

PAINT_EVENT_MASK

public static final long PAINT_EVENT_MASK
ペイントイベント選択用のイベントマスクです。

INVOCATION_EVENT_MASK

public static final long INVOCATION_EVENT_MASK
呼び出しイベント選択用のイベントマスクです。

HIERARCHY_EVENT_MASK

public static final long HIERARCHY_EVENT_MASK
階層イベント選択用のイベントマスクです。

HIERARCHY_BOUNDS_EVENT_MASK

public static final long HIERARCHY_BOUNDS_EVENT_MASK
階層境界イベント選択用のイベントマスクです。

RESERVED_ID_MAX

public static final int RESERVED_ID_MAX
予約済 AWT イベント ID の最大値です。イベント ID を定義するプログラムは、この値より大きい ID を使用する必要があります。
コンストラクタの詳細

AWTEvent

public AWTEvent(Event event)
1.0 形式のイベントのパラメータを使用して、AWTEvent オブジェクトを構築します。
パラメータ:
event - 旧形式のイベント

AWTEvent

public AWTEvent(Object source,
                int id)
指定されたソースオブジェクトと型を使用して、AWTEvent オブジェクトを構築します。
パラメータ:
source - イベントの発生元オブジェクト
メソッドの詳細

getID

public int getID()
イベントの型を返します。

toString

public String toString()
クラス EventObject の記述:
この EventObject の String 表現を返します。
オーバーライド:
クラス EventObject 内の toString
クラス java.util.EventObject からコピーされたタグ:
戻り値:
この EventObject の String 表現

paramString

public String paramString()
このイベントの状態を表す文字列を返します。このメソッドは、デバッグ専用であり、返される文字列の内容および形式は実装によって異なります。返される文字列は空の場合がありますが、null にはなりません。
戻り値:
このイベントの文字列表現

consume

protected void consume()

isConsumed

protected boolean isConsumed()

finalize

protected void finalize()
                 throws Throwable
クラス Object の記述:
このオブジェクトへの参照はもうないとガーベージコレクションによって判断されたときに、ガーベージコレクタによって呼び出されます。サブクラスは finalize メソッドをオーバーライドして、システムリソースを破棄したり、その他のクリーンアップを行うことができます。

finalize の一般的な規約では、finalize の呼び出しは、まだ生存している任意のスレッドがこのオブジェクトにアクセスする方法はないと、JavaTM Virtual Machine が判断した場合に行われます。ただし、ファイナライズの準備が済んだ他のオブジェクトまたはクラスをファイナライズするための処理の結果そうなった場合を除きます。finalize メソッドは、このオブジェクトを別のスレッドで再び利用可能にすることも含めて、任意のアクションを行うことができます。しかし、finalize の通常の用途は、オブジェクトを再生不可能な形で破棄する前のクリーンアップを実行することです。たとえば、入出力の接続を表すオブジェクトの finalize メソッドは、オブジェクトが永久的に破棄される前に、接続を切断するための明示的な入出力処理を行います。

Object クラスの finalize メソッドは、特別な処理を行いません。通常は、何もしないで復帰します。Object のサブクラスは、この定義をオーバーライドすることができます。

Java プログラミング言語は、任意のオブジェクトについてどのスレッドが finalize メソッドを呼び出すかを保証しません。しかし、finalize を呼び出すスレッドが、ユーザに可視な同期ロックを finalize 呼び出しの時点では保持していないことについては保証されます。キャッチされない例外を finalize メソッドがスローした場合、例外は無視され、オブジェクトのファイナライズは終了します。

あるオブジェクトについて finalize メソッドが呼び出されたあとに次の処理が発生するのは、まだ生存している任意のスレッドがこのオブジェクトにアクセスできる方法はないと、Java Virtual Machine が再び判断したときです。これには、ファイナライズの準備ができている他のオブジェクトまたはクラスによって発生した処理も含まれ、その時点でこのオブジェクトは破棄されます。

任意のオブジェクトについて Java Virtual Machine が finalize メソッドを複数回呼び出すことはありません。

finalize メソッドによって例外がスローされると、finalize メソッドの処理は停止されます。そうでない場合は無視されます。

オーバーライド:
クラス Object 内の finalize
クラス java.lang.Object からコピーされたタグ:
例外:
Throwable - このメソッドで生じた Exception

JavaTM 2 Platform
Std. Ed. v1.3

バグや機能要求の報告
さらに詳しい API リファレンスおよび開発者ドキュメントについては、 Java 2 SDK SE Developer Documentation を参照してください。このドキュメントには、概念、用語の定義、回避策、 実用的なコード例など、開発者を対象にした詳細な解説が掲載されています。

Java、Java 2D、JDBC は、米国およびその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2000 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.