TouchDevice.Capture 方法

定義

命名空間:

System.Windows.Input

組件:

PresentationCore.dll

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

多載

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

Capture(IInputElement)

使用 Element 擷取模式，擷取對指定之項目的觸控。

C#

public bool Capture (System.Windows.IInputElement element);

參數

element

IInputElement

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

傳回

Boolean

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

例外狀況

ArgumentException

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

範例

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

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

C#

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;
    }
}

備註

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

Capture(IInputElement, CaptureMode)

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

C#

public bool Capture (System.Windows.IInputElement element, System.Windows.Input.CaptureMode captureMode);

參數

element

IInputElement

用於擷取觸控的項目。

captureMode

CaptureMode

要使用的捕捉原則。

傳回

Boolean

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

例外狀況

ArgumentException

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

備註

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