TouchDevice.Capture Metodo

Definizione

Acquisisce un tocco all'elemento specificato.Captures a touch to the specified element.

Overload

Capture(IInputElement)

Acquisisce un tocco nell'elemento specificato tramite la modalità di acquisizione Element.Captures a touch to the specified element by using the Element capture mode.

Capture(IInputElement, CaptureMode)

Acquisisce un tocco nell'elemento specificato utilizzando l'oggetto CaptureMode specificato.Captures a touch to the specified element by using the specified CaptureMode.

Capture(IInputElement)

Acquisisce un tocco nell'elemento specificato tramite la modalità di acquisizione Element.Captures a touch to the specified element by using the Element capture mode.

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

Parametri

element
IInputElement

Elemento che acquisisce l'input tocco.The element that captures the touch input.

Restituisce

true se l'elemento è stato in grado di acquisire il tocco. In caso contrario false.true if the element was able to capture the touch; otherwise, false.

Eccezioni

element non è un oggetto UIElement, UIElement3DContentElement.element is not a UIElement, UIElement3D, or ContentElement.

Esempi

Nell'esempio seguente vengono gestiti gli eventi TouchDown che si verificano in un Canvas.The following example handles the TouchDown events that occur on a Canvas. Quando si preme un tocco sulla Canvas, l'TouchDevice viene acquisita nella Canvas.When a touch is pressed on the Canvas, the TouchDevice is captured to the Canvas.

Questo esempio fa parte di un esempio più ampio disponibile nella panoramica della classe TouchDevice.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;
    }
}
' 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

Commenti

Impossibile acquisire un TouchDevice a un elemento se è già acquisito in un altro elemento.A TouchDevice cannot be captured to an element if it is already captured to another element.

Capture(IInputElement, CaptureMode)

Acquisisce un tocco nell'elemento specificato utilizzando l'oggetto CaptureMode specificato.Captures a touch to the specified element by using the specified 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

Parametri

element
IInputElement

Elemento che acquisisce il tocco.The element that captures the touch.

captureMode
CaptureMode

I criteri di acquisizione da usare.The capture policy to use.

Restituisce

true se l'elemento è stato in grado di acquisire il tocco. In caso contrario false.true if the element was able to capture the touch; otherwise, false.

Eccezioni

element non è un oggetto UIElement, UIElement3DContentElement.element is not a UIElement, UIElement3D, or ContentElement.

Commenti

Impossibile acquisire un TouchDevice a un elemento se è già acquisito in un altro elemento.A TouchDevice cannot be captured to an element if it is already captured to another element.

Si applica a