Mouse.Capture Method
 Note |
|---|
The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience. |
Captures mouse input to the specified element.
Assembly: PresentationCore (in PresentationCore.dll)
| Name | Description | |
|---|---|---|
  | Capture(IInputElement) | Captures mouse input to the specified element. |
| Capture(IInputElement, CaptureMode) | Captures mouse input to the specified element using the specified CaptureMode. |
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.