GuiEvent

すべてのグラフィカルおよびタイマーイベントの基本クラス。

説明

GuiEventTarget で発生するイベントはすべて GuiEvent のサブクラスです。GuiEvent クラス階層の主なものには次が含まれます。

FocusEvent と KeyEvent ：すべてのキーボード関連イベントを処理します。
PointerEvent と PointerCrossing ：すべてのポインタイベントを処理します。
Action ：CommandButton およびその他のユーザーインターフェイスコンポーネントによって発生します。
TimerEvent ：非同期タイマーによって発生します。

GuiEvent の詳細については、『Curl 開発者ガイド』の「GUI とウィンドウイベント」のセクションを参照してください。

このイベント型のインスタンスを作成します。

説明

引数を持たないクラスコンストラクタを使用することで、Event サブクラスのインスタンスが作成されます。

例

Action イベントを作成するには、単に {Action} 式または {new Action} 式を使用します。

イベントを処理する機会があったハンドラによってイベントが消費されたかどうかを示す bool。

注意事項

このフィールドは、新しく作成されたイベント内で false に初期設定され、GuiEventTarget.handle-event 内で false に設定されます。したがって、イベントを発生したときには通常 false になるはずです。このフィールドは、GuiEvent.consume によって true に設定され、イベントが消費されているかどうかを調べるためにいつでもクエリできます。一般に、すでに消費された GuiEvent が与えられた場合、イベントハンドラでは何も行なわれないようにします。

このメソッドは GuiEvent オブジェクトの状態をクリアするために gui-toolkit で呼び出されます。

注意事項

既定の実装では GuiEvent.consumed? フィールドを false に設定します。

オーバーライド

サブクラスでは、追加されるすべての状態がクリアされるようこのメソッドをオーバーライドしてください。また、基本クラスでクリアすべきすべての状態がクリアされるように、スーパー実装を呼び出す必要もあります。

このメソッドは Event を消費し、その GuiEvent.consumed? プロパティを true に設定します。

説明

GuiEvent.consume は、このイベントのハンドラがすでに特定のアクションを行っていることを通知します。このシグナルは、後で呼び出されるイベントハンドラに与えられます。

Curl, Inc. が定義した一部のイベントを消費するアクションには、特定の意味が割り当てられています。たとえば、PointerEvent の消費により、現在のターゲットオブジェクトのグラフィックの祖先でイベントが発生するのを防ぎます。

オーバーライド

通常はオーバーライドされません。

この Event のスタティックイベントハンドラを起動します。

target: この Event を処理する GuiEventTarget。

プログラミング注意事項

このメソッドは、この Event のスタティックイベントハンドラを呼び出すときに、GuiEventTarget.handle-event によって呼び出されます。このメソッドは、適切なスタティックイベントハンドラがすべて呼び出された後に返します。

オーバーライド

このメソッドは、それ自身のスタティックイベントハンドラに関連付けられた Event のすべてのサブクラスでオーバーライドされます。E クラスで定義されたオーバーライドメソッドは、次のテンプレートに従う必要があります。

{method protected {fire-methods target:GuiEventTarget}:void {target.on-E self} {super.fire-methods target} }

ここで、on-E は E クラスに関連付けられたスタティックイベントハンドラ名です。fire-methods 内のメソッド呼び出しは、Curl 言語のスタティックイベントハンドラ呼び出し順位の規則 (最も用途の特定されたものから最も一般的な用途のもの) に従って順序付ける必要があります。