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 null 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
Available since 3.0
Return to top
Show: