PointerEnter

オブジェクト g のグラフィカルな子孫ではないオブジェクトから、g にポインタが入る際に発生するイベント。

説明

PointerEnter イベントは、ポイントが Visual に入るたびに Visual で発生します。ポインタが Visual を離れると、その Visual で PointerLeave イベントが発生します。PointerEnter および PointerLeave イベントはペアで発生するので、たとえば、オブジェクトの PointerEnter ハンドラでビットを設定し、PointerLeave ハンドラでこれをクリアするように設定すると、ポインタがオブジェクトまたはそのグラフィカルな子の上にある場合のみビットが設定されます。

PointerEnter/PointerLeave は PointerLeafEnter/PointerLeafLeave と比較することができます。non-leaf イベントは、ポインタが g と g の子孫でないオブジェクトの間を移動する際に、オブジェクト g でのみ発生します。リーフイベントは、ポインタが g とその他の任意のオブジェクト (g のグラフィカルな子孫も含む) の間を移動する際に、オブジェクト g でのみ発生します。実際には、ほとんどの場合はリーフイベントより non-leaf イベントのモニタリングの方が適切です。

PointerEnter イベントのスタティックイベントハンドラは on-pointer-enter です。

PointerEnter および PointerLeave イベントの詳細については、『Curl 開発者ガイド』の「ポインタイベント」のセクションを参照してください。

注意事項

現在の実装では、ポインタがオブジェクトに入り、ドラッグを開始し、ドラッグの間にオブジェクトを離れると、上記で説明された PointerEnter および PointerLeave イベントのネスティングは保持されません。ポインタがオブジェクトに入っている間は PointerEnter イベントが発生しますが、ポインタがオブジェクトを離れている間は PointerLeave ではなく DragLeave イベントが発生します。ドラッグがオブジェクトに入り、そのオブジェクト内で終了し、結果としてポインタがオブジェクトを離れると、同様のネスティングの失敗が発生します。この非対称性は、Curl 言語の将来のバージョンで排除する予定です。

この 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 言語のスタティックイベントハンドラ呼び出し順位の規則 (最も用途の特定されたものから最も一般的な用途のもの) に従って順序付ける必要があります。