TouchDevice.Capture 方法

定義

命名空間:

System.Windows.Input

組件:

PresentationCore.dll

擷取對指定之項目的觸控。

多載

Capture(IInputElement)	使用 Element 擷取模式，擷取對指定之項目的觸控。
Capture(IInputElement, CaptureMode)	使用指定的 CaptureMode 擷取對指定之項目的觸控。

Capture(IInputElement)

使用 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

參數

element

IInputElement

用於擷取觸控輸入的項目。

傳回

Boolean

如果項目可以擷取觸控則為 true，否則為 false。

例外狀況

ArgumentException

element 不是 UIElement、UIElement3D，也不是 ContentElement。

範例

下列範例會處理 TouchDown 在上 Canvas發生的事件。 按下 觸控 Canvas時，會 TouchDevice 擷取至 Canvas。

此範例是類別概觀中提供之較大範例的 TouchDevice 一部分。

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

備註

TouchDevice如果已經擷取至另一個專案，則無法擷取至專案。

Capture(IInputElement, CaptureMode)

使用指定的 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

參數

element

IInputElement

用於擷取觸控的項目。

captureMode

CaptureMode

要使用的捕捉原則。

傳回

Boolean

如果項目可以擷取觸控則為 true，否則為 false。

例外狀況

ArgumentException

element 不是 UIElement、UIElement3D，也不是 ContentElement。

備註

TouchDevice如果已經擷取至另一個專案，則無法擷取至專案。