Mouse.Captured Property

Definition

Namespace:

System.Windows.Input

Assembly:

PresentationCore.dll

Gets the element that has captured the mouse.

public:
 static property System::Windows::IInputElement ^ Captured { System::Windows::IInputElement ^ get(); };

public static System.Windows.IInputElement Captured { get; }

static member Captured : System.Windows.IInputElement

Public Shared ReadOnly Property Captured As IInputElement

Property Value

IInputElement

The element captured by the mouse.

Examples

The follow example shows how to obtain the element that has mouse capture.

// Mouse.Capture returns an IInputElement.
IInputElement captureElement;

captureElement = Mouse.Captured;

// Update the Label that displays the element with mouse capture.
lblHasMouseCapture.Content = captureElement.ToString();

' Mouse.Capture returns an IInputElement.
Dim captureElement As IInputElement

captureElement = Mouse.Captured

' Update the Label that displays the element with mouse capture.
lblHasMouseCapture.Content = CType(captureElement, Object).ToString()

Remarks

When an element captures the mouse, it receives mouse input whether or not the cursor is within its borders. The mouse is typically captured in this manner only during drag-and-drop operations, and retains capture until the drop action of the drag-and-drop operation occurs.