TouchDevice.Capture 方法

定义

命名空间:: System.Windows.Input

程序集:: PresentationCore.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

捕获对指定元素的触摸。

重载

名称	说明
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

要使用的捕获策略。