TouchDevice.Capture Methode

Definition

Namespace:

System.Windows.Input

Assembly:

PresentationCore.dll

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

Boolean

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

Ausnahmen

ArgumentException

element ist kein UIElement, UIElement3D oder ContentElement.

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.

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

Boolean

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

Ausnahmen

ArgumentException

element ist kein UIElement, UIElement3D oder ContentElement.

Hinweise

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