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処理します。 でCanvasTouchDeviceタッチが押されると、 が に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は、既に別の要素にキャプチャされている場合は、要素にキャプチャできません。