Export (0) Print
Expand All

Mouse.Capture Method (IInputElement)

Captures mouse input to the specified element.

Namespace:  System.Windows.Input
Assembly:  PresentationCore (in PresentationCore.dll)

static member Capture : 
        element:IInputElement -> bool

Parameters

element
Type: System.Windows.IInputElement

The element to capture the mouse.

Return Value

Type: System.Boolean
true if the element was able to capture the mouse; otherwise, false.

When an element captures the mouse, it receives mouse input whether or not the cursor is within its borders.

If a CaptureMode is not specified, the default CaptureMode is Element.

To release mouse capture, call Capture passing a null reference (Nothing in Visual Basic) as the element to capture.

If the mouse is captured when a MouseDown or MouseUp event is raised and the input is not going to the element underneath the mouse, PreviewMouseDownOutsideCapturedElement and PreviewMouseUpOutsideCapturedElement are raised first. This enables the captured element a chance to release capture before the MouseDown and MouseUp events are routed.

The following example shows how to capture the mouse to a specific element by using the Capture method.

No code example is currently available or this language may not be supported.

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1
Show:
© 2015 Microsoft