TouchDevice.Capture Method (IInputElement)

Captures a touch to the specified element by using the Element capture mode.

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

public bool Capture(
	IInputElement element
)

Parameters

element
Type: System.Windows.IInputElement

The element that captures the touch input.

Return Value

Type: System.Boolean
true if the element was able to capture the touch; otherwise, false.

ExceptionCondition
ArgumentException

element is not a UIElement, UIElement3D, or ContentElement.

A TouchDevice cannot be captured to an element if it is already captured to another element.

The following example handles the TouchDown events that occur on a Canvas. When a touch is pressed on the Canvas, the TouchDevice is captured to the Canvas.

This example is part of a larger example that is available in the TouchDevice class overview.

private void canvas_TouchDown(object sender, TouchEventArgs e)
{
    Canvas _canvas = (Canvas)sender as Canvas;
    if (_canvas != null)
    {
        _canvas.Children.Clear();
        e.TouchDevice.Capture(_canvas);

        // Record the ID of the first touch point if it hasn't been recorded. 
        if (firstTouchId == -1)
            firstTouchId = e.TouchDevice.Id;
    }
}

.NET Framework

Supported in: 4.6, 4.5, 4

.NET Framework Client Profile

Supported in: 4
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2015 Microsoft