UIElement.GotMouseCapture イベント

定義

この要素がマウスをキャプチャしたときに発生します。Occurs when this element captures the mouse.

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

実装

注釈

要素がマウスをキャプチャすると、マウスポインターが境界の外側にある場合でもマウス入力を受け取ります。When an element captures the mouse, it receives mouse input even if the mouse pointer is outside its bounds. マウスは、通常、ドラッグアンドドロップ操作中にキャプチャされ、ドラッグアンドドロップ操作のドロップ操作が発生するまでキャプチャされたままになります。The mouse is typically captured only during drag-and-drop operations and remains captured until the drop action of the drag-and-drop operation occurs.

このイベントはバブルルーティングを使用するため、キャプチャを持つ要素は、イベントハンドラーが実際にアタッチされている要素ではなく、子要素である場合があります。Because this event uses bubbling routing, the element that has capture might be a child element instead of the element where the event handler is actually attached. イベントデータの Source を調べて、マウスキャプチャを持つ実際の要素を特定します。Check the Source in the event data to determine the actual element that has mouse capture.

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

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

識別子フィールドIdentifier field GotMouseCaptureEvent
ルーティング方法Routing strategy バブリングBubbling
DelegateDelegate MouseEventHandler
  • 定義された対応するトンネリングイベントがありません。There is no defined corresponding tunneling event.

  • 派生クラスでこのイベントのクラス処理を実装するには、OnGotMouseCapture をオーバーライドします。Override OnGotMouseCapture to implement class handling for this event in derived classes.

適用対象

こちらもご覧ください