ContentElement::CaptureTouch Method (TouchDevice^)

.NET Framework (current version)

The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Attempts to force capture of a touch to this element.

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

bool CaptureTouch(
	TouchDevice^ touchDevice


Type: System.Windows.Input::TouchDevice^

The device to capture.

Return Value

Type: System::Boolean

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

Exception Condition

touchDevice is null.

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.

.NET Framework
Available since 4.0
Return to top