UIElement.MouseEnter イベント


マウス ポインターがこの要素の境界内に入ったときに発生します。Occurs when the mouse pointer enters the bounds of this element.

 virtual event System::Windows::Input::MouseEventHandler ^ MouseEnter;
public event System.Windows.Input.MouseEventHandler MouseEnter;
member this.MouseEnter : System.Windows.Input.MouseEventHandler 
Public Custom Event MouseEnter As MouseEventHandler 



MouseEnter は、ダイレクトイベント処理ルーティング戦略を使用するルーティングイベントです。MouseEnter is a routed event that uses the direct event handling routing strategy. ルートに沿って直接ルーティングイベントは発生しません。代わりに、それらが発生した要素で処理されます。Direct routed events are not raised along a route; instead, they are handled in the same element where they are raised. ただし、スタイルのイベントトリガーなど、ルーティングイベントの動作の他の側面が有効になります。However, they do enable other aspects of routed event behavior, such as event triggers in styles.

MouseEnter はマウスポインターが要素の境界内に入ったことを追跡しますが、このイベントはさらに、IsMouseOver プロパティ値が false からこの要素の true に変更されたことを報告します。Although MouseEnter tracks when the mouse pointer enters the bounds of an element, this event more literally reports that the IsMouseOver property value has changed from false to true on this element.

このイベントは、このクラスの Mouse.MouseEnter 添付イベントのエイリアスを作成し、UIElement が基本要素として継承されている場合に、MouseEnter がクラスメンバーリストの一部になるようにします。This event creates an alias for the Mouse.MouseEnter attached event for this class, so that MouseEnter is part of the class members list when UIElement is inherited as a base element. MouseEnter イベントにアタッチされるイベントハンドラーは、基になる Mouse.MouseEnter アタッチされるイベントにアタッチされ、同じイベントデータインスタンスを受け取ります。Event handlers that are attached to the MouseEnter event are attached to the underlying Mouse.MouseEnter attached event and receive the same event data instance.

Button (または任意の ButtonBase 派生クラス) は、ボタンにフォーカスがあるときに KeyDown イベントをネイティブに処理し、押されたキーがスペースバーになります。A Button (or any ButtonBase derived class) has native handling for a KeyDown event when the button has focus, and the pressed key is the space bar. ネイティブ処理では、ソースとしてボタンを使用して Click イベントが発生し、マウスポインターが移動しないように見えてもマウスがキャプチャされます。The native handling raises the Click event with the button as the source, and also captures the mouse, even though the mouse pointer does not appear to move. マウスキャプチャの結果として、ソースとしてボタンを使用して MouseEnter イベントも発生します。As a result of the mouse capture, a MouseEnter event is also raised with the button as the source. 一般に、要素がマウスをキャプチャすると、MouseEnter が発生し、他のコントロール固有のイベントも GotMouseCapture ます。In general, if an element captures the mouse, then MouseEnter is raised, as well as GotMouseCapture and possibly other control-specific events.

ルーティングされたイベント情報Routed Event Information

識別子フィールドIdentifier field MouseEnterEvent
ルーティング方法Routing strategy 直接Direct
DelegateDelegate MouseEventHandler
  • 派生クラスでこのイベントのクラス処理を実装するには、OnMouseEnter をオーバーライドします。Override OnMouseEnter to implement class handling for this event in derived classes.