Mouse::Capture Method (IInputElement^)
Captures mouse input to the specified element.
Assembly: PresentationCore (in PresentationCore.dll)
Parameters
- element
-
Type:
System.Windows::IInputElement^
The element to capture the mouse.
Return Value
Type: System::Booleantrue 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.
Available since 3.0