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