TouchDevice.Capture Método

Definição

Namespace:

System.Windows.Input

Assembly:

PresentationCore.dll

Captura um toque para o elemento especificado.

Sobrecargas

Capture(IInputElement)	Captura um toque para o elemento especificado usando o modo de captura Element.
Capture(IInputElement, CaptureMode)	Captura um toque para o elemento especificado usando o CaptureMode especificado.

Capture(IInputElement)

Captura um toque para o elemento especificado usando o modo de captura 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

Parâmetros

element

IInputElement

O elemento que captura o entrada por toque.

Retornos

Boolean

true se o elemento tiver conseguido capturar o toque; caso contrário, false.

Exceções

ArgumentException

element não é um UIElement, UIElement3D nem ContentElement.

Exemplos

O exemplo a seguir manipula os TouchDown eventos que ocorrem em um Canvas. Quando um toque é pressionado no Canvas, o TouchDevice é capturado no Canvas.

Este exemplo faz parte de um exemplo maior que está disponível na visão geral da TouchDevice classe.

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

Comentários

Um TouchDevice não poderá ser capturado em um elemento se ele já estiver capturado em outro elemento.

Capture(IInputElement, CaptureMode)

Captura um toque para o elemento especificado usando o CaptureMode especificado.

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

Parâmetros

element

IInputElement

O elemento que captura o toque.

captureMode

CaptureMode

A política de captura a ser usada.

Retornos

Boolean

true se o elemento tiver conseguido capturar o toque; caso contrário, false.

Exceções

ArgumentException

element não é um UIElement, UIElement3D nem ContentElement.

Comentários

Um TouchDevice não poderá ser capturado em um elemento se ele já estiver capturado em outro elemento.