TouchDevice.Capture メソッド

定義

指定した要素へのタッチをキャプチャします。Captures a touch to the specified element.

オーバーロード

Capture(IInputElement)

Element キャプチャ モードを使用して、指定した要素へのタッチをキャプチャします。Captures a touch to the specified element by using the Element capture mode.

Capture(IInputElement, CaptureMode)

指定した CaptureMode を使用して、指定した要素へのタッチをキャプチャします。Captures a touch to the specified element by using the specified CaptureMode.

Capture(IInputElement)

Element キャプチャ モードを使用して、指定した要素へのタッチをキャプチャします。Captures a touch to the specified element by using the Element capture mode.

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

タッチ入力をキャプチャする要素。The element that captures the touch input.

戻り値

要素がタッチをキャプチャできた場合は true。それ以外の場合は falsetrue if the element was able to capture the touch; otherwise, false.

例外

elementUIElementUIElement3D、または ContentElement ではありません。element is not a UIElement, UIElement3D, or ContentElement.

次の例では、Canvasで発生する TouchDown イベントを処理します。The following example handles the TouchDown events that occur on a Canvas. Canvasでタッチが押されると、TouchDeviceCanvasにキャプチャされます。When a touch is pressed on the Canvas, the TouchDevice is captured to the Canvas.

この例は、TouchDevice クラスの概要で使用できる大規模な例の一部です。This example is part of a larger example that is available in the TouchDevice class overview.

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 が別の要素に既にキャプチャされている場合、その要素にキャプチャすることはできません。A TouchDevice cannot be captured to an element if it is already captured to another element.

Capture(IInputElement, CaptureMode)

指定した CaptureMode を使用して、指定した要素へのタッチをキャプチャします。Captures a touch to the specified element by using the specified 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

パラメーター

element
IInputElement

タッチをキャプチャする要素。The element that captures the touch.

captureMode
CaptureMode

使用するキャプチャ ポリシー。The capture policy to use.

戻り値

要素がタッチをキャプチャできた場合は true。それ以外の場合は falsetrue if the element was able to capture the touch; otherwise, false.

例外

elementUIElementUIElement3D、または ContentElement ではありません。element is not a UIElement, UIElement3D, or ContentElement.

注釈

TouchDevice が別の要素に既にキャプチャされている場合、その要素にキャプチャすることはできません。A TouchDevice cannot be captured to an element if it is already captured to another element.

適用対象