TouchDevice.Capture Methode

Definition

Namespace:: System.Windows.Input

Assembly:: PresentationCore.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Erfasst eine Toucheingabe für das angegebene Element.

Überlädt

Name	Beschreibung
Capture(IInputElement)	Erfasst mithilfe des Element Aufnahmemodus eine Toucheingabe für das angegebene Element.
Capture(IInputElement, CaptureMode)	Erfasst mithilfe des angegebenen CaptureModeElements eine Toucheingabe für das angegebene Element.

Capture(IInputElement)

Erfasst mithilfe des Element Aufnahmemodus eine Toucheingabe für das angegebene Element.

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 Toucheingabe erfasst.

Gibt zurück

Boolean

truewenn das Element die Toucheingabe erfassen konnte; andernfalls . false

Ausnahmen

ArgumentException

elementist kein UIElement, oder UIElement3D ContentElement.

Beispiele

Im folgenden Beispiel werden die Ereignisse behandelt, die TouchDown in einem Canvas. Wenn eine Toucheingabe auf dem CanvasFinger gedrückt wird, wird die TouchDevice Aufnahme in die Canvas.

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 Element TouchDevice kann nicht erfasst werden, wenn es bereits in einem anderen Element erfasst wird.

Gilt für:

Capture(IInputElement, CaptureMode)

Erfasst mithilfe des angegebenen CaptureModeElements eine Toucheingabe für das angegebene Element.

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