Skip to main content
.NET Framework Class Library
UIElementGotMouseCapture Event

Occurs when this element captures the mouse.

Namespace:   System.Windows
Assembly:  PresentationCore (in PresentationCore.dll)
XMLNS for XAML: http://schemas.microsoft.com/winfx/2006/xaml/presentation, http://schemas.microsoft.com/netfx/2007/xaml/presentation
Syntax
Public Event GotMouseCapture As [%$TOPIC/ms596647_en-us_VS_110_1_0_0_0_0%]
public event [%$TOPIC/ms596647_en-us_VS_110_1_0_1_0_0%] GotMouseCapture
public:
virtual   event [%$TOPIC/ms596647_en-us_VS_110_1_0_2_0_0%]^ GotMouseCapture {
	void add ([%$TOPIC/ms596647_en-us_VS_110_1_0_2_0_1%]^ value);
	void remove ([%$TOPIC/ms596647_en-us_VS_110_1_0_2_0_2%]^ value);
}
abstract GotMouseCapture : IEvent<[%$TOPIC/ms596647_en-us_VS_110_1_0_3_0_0%],
    [%$TOPIC/ms596647_en-us_VS_110_1_0_3_0_1%]>
override GotMouseCapture : IEvent<[%$TOPIC/ms596647_en-us_VS_110_1_0_3_0_2%],
    [%$TOPIC/ms596647_en-us_VS_110_1_0_3_0_3%]>
<object GotMouseCapture="[%$TOPIC/ms596647_en-us_VS_110_1_0_4_0_0%]" .../>

Implements

IInputElementGotMouseCapture
Routed Event Information

Identifier field

GotMouseCaptureEvent

Routing strategy

Bubbling

Delegate

MouseEventHandler

  • There is no defined corresponding tunneling event.

  • Override OnGotMouseCapture to implement class handling for this event in derived classes.

Remarks

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. Check the Source in the event data to determine the actual element that has mouse capture.

This event creates an alias for the MouseGotMouseCapture attached event for this class so that GotMouseCapture is part of the class members list when UIElement is inherited as a base element. Event handlers that are attached to the GotMouseCapture event are attached to the underlying MouseGotMouseCapture attached event and receive the same event data instance.

Version Information

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1
Platforms

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.