Freigeben über


TouchDevice.Capture Methode

Definition

Erfasst eine Fingereingabe für das angegebene Element.

Überlädt

Capture(IInputElement)

Erfasst eine Fingereingabe für das angegebene Element mit dem Element-Erfassungsmodus.

Capture(IInputElement, CaptureMode)

Erfasst Fingereingaben für das angegebene Element mit dem angegebenen CaptureMode.

Capture(IInputElement)

Erfasst eine Fingereingabe für das angegebene Element mit dem Element-Erfassungsmodus.

public:
 bool Capture(System::Windows::IInputElement ^ element);
public bool Capture (System.Windows.IInputElement element);
member this.Capture : System.Windows.IInputElement -> bool
Public Function Capture (element As IInputElement) As Boolean

Parameter

element
IInputElement

Das Element, das die Fingereingabe aufzeichnet.

Gibt zurück

true, wenn die Fingereingabe vom Element erfasst werden konnte, andernfalls false.

Ausnahmen

Beispiele

Im folgenden Beispiel werden die Ereignisse behandelt, die TouchDown auf einem Canvasauftreten. Wenn eine Toucheingabe auf den Canvasgedrückt wird, wird der TouchDevice in Canvaserfasst.

Dieses Beispiel ist Teil eines größeren Beispiels, das in der TouchDevice Klassenübersicht verfügbar ist.

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;
    }
}
' Touch Down
Private Sub canvas_TouchDown(ByVal sender As System.Object, ByVal e As System.Windows.Input.TouchEventArgs)
    Dim _canvas As Canvas = CType(sender, Canvas)
    If (_canvas IsNot Nothing) Then
        _canvas.Children.Clear()
        e.TouchDevice.Capture(_canvas)

        ' Record the ID of the first touch point if it hasn't been recorded.
        If firstTouchId = -1 Then
            firstTouchId = e.TouchDevice.Id
        End If
    End If
End Sub

Hinweise

Ein TouchDevice kann nicht in einem Element erfasst werden, wenn es bereits in einem anderen Element erfasst wurde.

Gilt für:

Capture(IInputElement, CaptureMode)

Erfasst Fingereingaben für das angegebene Element mit dem angegebenen CaptureMode.

public:
 bool Capture(System::Windows::IInputElement ^ element, System::Windows::Input::CaptureMode captureMode);
public bool Capture (System.Windows.IInputElement element, System.Windows.Input.CaptureMode captureMode);
member this.Capture : System.Windows.IInputElement * System.Windows.Input.CaptureMode -> bool
Public Function Capture (element As IInputElement, captureMode As CaptureMode) As Boolean

Parameter

element
IInputElement

Das Element, das die Fingereingabe aufzeichnet.

captureMode
CaptureMode

Die zu verwendende Erfassungsrichtlinie.

Gibt zurück

true, wenn die Fingereingabe vom Element erfasst werden konnte, andernfalls false.

Ausnahmen

Hinweise

Ein TouchDevice kann nicht in einem Element erfasst werden, wenn es bereits in einem anderen Element erfasst wurde.

Gilt für: