UIElement.CaptureTouch(TouchDevice) Method

Definition

Namespace:: System.Windows

Assembly:: PresentationCore.dll

Attempts to force capture of a touch to this element.

public:
 bool CaptureTouch(System::Windows::Input::TouchDevice ^ touchDevice);

public bool CaptureTouch (System.Windows.Input.TouchDevice touchDevice);

member this.CaptureTouch : System.Windows.Input.TouchDevice -> bool

Public Function CaptureTouch (touchDevice As TouchDevice) As Boolean

Parameters

touchDevice: TouchDevice

The device to capture.

Returns

Boolean

true if the specified touch is captured to this element; otherwise, false.

Exceptions

ArgumentNullException

touchDevice is null.

Remarks

CaptureTouch will return false if the TouchDevice is currently captured to another element.

If CaptureTouch returns true, then the GotTouchCapture event is raised.

To release capture of a single touch from this element, use the ReleaseTouchCapture method and specify the touch device to release. To release all touches from this element, use the ReleaseAllTouchCaptures method.