イベント処理

ユーザが、たとえばクリックしたり改行キーを押すなどして、あるコンポーネントに対して何らかの行動を起こすと、Event オブジェクトが作成される。 AWT のイベント処理システムは、Event をコンポーネント階層の上方向に渡していき、ウィンドウシステムがそのイベントを完全に処理する前に各コンポーネントがイベントに反応することができる。各コンポーネントのイベントハンドラは、イベントを無視することもあるし、以下のどれかの方法で反応することもできる。

Event インスタンスを変更した後で、さらに上の階層へ渡す -- たとえば、すべての文字を大文字で表示するような TextField サブクラスで小文字表示のキー操作に対して大文字に変更をするように Event を変更する。

イベントに何か別の方法で反応する -- たとえば、テキストフィールドのコンテンツを処理するメソッドを呼び出すことによって、TextField サブクラス (または TextField の Container) が改行キーの押下に反応できるようにする。

イベントのそれ以上の処理を停止する -- たとえば、無効な文字がテキストフィールドに入力された場合、イベントハンドラはその Event がそれ以上処理されないよう停止することができる。

コンポーネントから見ると、AWT のイベント処理システムはイベントフィルタ システムに近い。ウィンドウシステム依存コードがあるイベントを生成しても、ウィンドウシステム依存コードがそのイベントを完全に処理するより先に、それを変更したり、反応したり、破棄したりする機会がコンポーネントに与えられる。 [チェック -- これは適切かつ正しい言い方か？] 次の [存在しない] 図に、プログラム例の TextField イベントのイベント処理のチェーンを示す。

注: 現在のリリースでは、マウスイベントは、ウィンドウシステム依存コードが完全に処理した後で、コンポーネントに転送される。このため、現在のリリースではコンポーネントはキーボード のイベントをすべて捕らえることになっているが、マウス イベントについては捕らえることができない。

イベントオブジェクト

それぞれのイベントによってEvent オブジェクトが生成される。 Event オブジェクトには以下の情報が含まれている。

イベントのタイプ -- たとえば、キー押下やマウスクリック、または抽象度の高い "action" やウィンドウのアイコン化など。

イベントの "target" となったオブジェクト -- たとえば、ユーザがクリックしたスクリーン上のボタンに対応する Button オブジェクト、ユーザが入力したテキストフィールドに対応する TextField オブジェクトなど。

イベントがいつ発生したかを示す時刻表示。

イベントが発生した位置 (x,y)。

押されたキー (キーボードイベントの場合)。

その Event に関連した任意の引数 (コンポーネント上に表示する文字列など)。

イベントが発生したときの修飾キーの状態。

イベントハンドラの実装方法
コンポーネントはhandleEvent() メソッドを実装するか、またはイベントタイプに特有のメソッドを実装することによって、イベントに反応できるようになる。後者の方法が機能するのは、handleEvent() メソッドのデフォルトの (コンポーネントの) 定義がそのイベントタイプに特有のメソッドを呼び出すようになっているからである。このようなイベント特有のメソッドには、mous eEnter()、 mouseExit()、mouse Move()、mouseUp ()、mouse Down()、mouse Drag()、keyDown ()、action() がある。

重要: すべてのイベントハンドラメソッドは高速に実行されなければならない！そうしないと、プログラムの目で見える性能が大きく損なわれる。イベントの結果として何か時間のかかる操作を実行する必要がある場合は、別のスレッドを始動して (または別のスレッドへ要求を送信して) その操作を実行すべきである。スレッドの使用法については、スレッドのコントロールを参照する。

プログラム例では、すべてのイベント処理は ConversionPanel で実行されている。これらはテキストフィールド (TextField) とポップアップリスト (Choice) で発生したイベントの捕捉には action() を使用し、スライダ (Scrollbar) で発生したイベントの捕捉にはhandleEvent() メソッドを使用している。

次に、action() およびhandleEvent() メソッドの ConversionPanel での実装を示す。
/** 制御盤でのユーザ動作に反応する */
public boolean action(Event e, Object arg) {
    if (e.target instanceof TextField) {
        setSliderValue(getValue());
        controller.convert(this);
        return true;
    }
    if (e.target instanceof Choice) {
        controller.convert(this);
        return true;
    }
    return false;
}

/** スライダーに反応する */
public boolean handleEvent(Event e) {
    if (e.target instanceof Scrollbar) {
        textField.setText(String.valueOf(slider.getValue()));
        controller.convert(this);
    }
    return super.handleEvent(e);
}
このメソッドは、 ConversionPanel のスライダとテキストフィールドがどちらも同じ値を示すようにし、その後、Converter オブジェクトに他の ConversionPanel を更新するよう要求しているだけである。action() メソッドは、イベントを処理したのであれば true を返し、そうでなければ false を返す。このようにして、コンポーネント階層の上位にあるものもイベントの発生したオブジェクトの様子を知ることができるのである。handleEvent() メソッドは、すべてのイベントが完全に処理されるように、常に super.handleEvent() を返す。

注:handleEvent() が (そのスーパークラスの実装を呼び出す代わりに)true か false を返したら、action() メソッドは決して呼び出されない ことになってしまう。どうしても必要なとき以外は handleEvent() を実装しないよう推奨するのは、このようなリスクがあることも理由の 1 つである。
Java UI の概説