Touch クラス


オペレーティング システムからのマルチタッチ入力を処理し、FrameReported イベントを生成するアプリケーション レベルのサービスを提供します。Provides an application-level service that processes multitouch input from the operating system and raises the FrameReported event.

public ref class Touch abstract sealed
public static class Touch
type Touch = class
Public Class Touch

次の例では、タッチスクリーン上で2本の指をドラッグして、Canvas に単純なパターンを作成できます。The following example enables you to create simple patterns on a Canvas by dragging two fingers across a touchscreen. 各タッチは、TouchDeviceによって表されます。このパターンは、触れることによって提供されるタッチポイント間に線を描画することによって作成されます。Each touch is represented by a TouchDevice.The pattern is created by drawing a line between the touch points provided by the touches. この例では、Windows タッチ互換画面が必要です。This example requires a Windows Touch-compatible screen.

次のマークアップは、Gridの中央にある Canvas で構成されるユーザーインターフェイスを作成します。The following markup creates the user interface, which consists of a Canvas that is centered in a Grid.

<Window x:Class="WpfTouchFrameSample.MainWindow"
        Title="MainWindow" Height="525" Width="525">
        <Canvas x:Name="canvas1"
                Width="500" Height="500"
                Background="Black" />     

次のコードは、FrameReported イベントを処理します。The following code handles the FrameReported event. Canvasでタッチを押すと、TouchDeviceCanvasにキャプチャされます。When a touch presses on the Canvas, the TouchDevice is captured to the Canvas. タッチが解除されると、TouchDevice が解放されます。When the touch is lifted, the TouchDevice is released. Canvas上でタッチが移動すると、Id が確認されます。When a touch moves across the Canvas, the Id is checked. 最初のタッチから移動した場合は、その場所が記録されます。If the move came from the first touch, its location is recorded. 2番目のタッチから移動した場合は、最初のタッチの位置から2番目のタッチの位置まで線が描画されます。If the move came from the second touch, a line is drawn from the position of the first touch to the position of the second touch.

using System;
using System.Windows;
using System.Windows.Input;
using System.Windows.Media;
using System.Windows.Shapes;

namespace WpfTouchFrameSample
    /// <summary>
    /// Interaction logic for MainWindow.xaml
    /// </summary>
    public partial class MainWindow : Window
        // Variables for tracking the position of two points.
        Point pt1, pt2 = new Point();
        public MainWindow()
            Touch.FrameReported += new TouchFrameEventHandler(Touch_FrameReported);

        void Touch_FrameReported(object sender, TouchFrameEventArgs e)
            if (this.canvas1 != null)
                foreach (TouchPoint _touchPoint in e.GetTouchPoints(this.canvas1))
                    if (_touchPoint.Action == TouchAction.Down)
                        // Clear the canvas and capture the touch to it.

                    else if (_touchPoint.Action == TouchAction.Move && e.GetPrimaryTouchPoint(this.canvas1) != null)
                        // This is the first (primary) touch point. Just record its position.
                        if (_touchPoint.TouchDevice.Id == e.GetPrimaryTouchPoint(this.canvas1).TouchDevice.Id)
                            pt1.X = _touchPoint.Position.X;
                            pt1.Y = _touchPoint.Position.Y;

                        // This is not the first touch point. Draw a line from the first point to this one.
                        else if (_touchPoint.TouchDevice.Id != e.GetPrimaryTouchPoint(this.canvas1).TouchDevice.Id)
                            pt2.X = _touchPoint.Position.X;
                            pt2.Y = _touchPoint.Position.Y;

                            Line _line = new Line();
                            _line.Stroke = new RadialGradientBrush(Colors.White, Colors.Black);
                            _line.X1 = pt1.X;
                            _line.X2 = pt2.X;
                            _line.Y1 = pt1.Y;
                            _line.Y2 = pt2.Y;
                            _line.StrokeThickness = 2;

                    else if (_touchPoint.Action == TouchAction.Up)
                        // If this touch is captured to the canvas, release it.
                        if (_touchPoint.TouchDevice.Captured == this.canvas1)
Class MainWindow
    ' Variables for tracking the position of two points.
    Private pt1, pt2 As Point

    Public Sub New()
        AddHandler Touch.FrameReported, AddressOf Touch_FrameReported
    End Sub

    Private Sub Touch_FrameReported(ByVal sender As System.Object, ByVal e As System.Windows.Input.TouchFrameEventArgs)
        If (canvas1 IsNot Nothing) Then
            For Each _touchPoint In e.GetTouchPoints(Me.canvas1)

                If _touchPoint.Action = TouchAction.Down Then
                    ' Clear the canvas and capture the touch to it.

                ElseIf _touchPoint.Action = TouchAction.Move Then
                    ' This is the first (primary) touch point. Just record its position.
                    If _touchPoint.TouchDevice.Id = e.GetPrimaryTouchPoint(Me.canvas1).TouchDevice.Id Then
                        pt1.X = _touchPoint.Position.X
                        pt1.Y = _touchPoint.Position.Y

                        ' This is not the first touch point; draw a line from the first point to this one.
                    ElseIf _touchPoint.TouchDevice.Id <> e.GetPrimaryTouchPoint(Me.canvas1).TouchDevice.Id Then
                        pt2.X = _touchPoint.Position.X
                        pt2.Y = _touchPoint.Position.Y

                        Dim _line As New Line()
                        _line.Stroke = New RadialGradientBrush(Colors.White, Colors.Black)
                        _line.X1 = pt1.X
                        _line.X2 = pt2.X
                        _line.Y1 = pt1.Y
                        _line.Y2 = pt2.Y

                        _line.StrokeThickness = 2
                    End If

                ElseIf _touchPoint.Action = TouchAction.Up Then
                    ' If this touch is captured to the canvas, release it.
                    If (_touchPoint.TouchDevice.Captured Is canvas1) Then
                    End If
                End If
        End If
    End Sub
End Class


FrameReported イベントは、Silverlight との互換性をサポートするために Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) に含まれています。The FrameReported event is included in Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) to support compatibility with Silverlight. Silverlight との互換性を確保する必要がない場合は、TouchDownTouchMoveなどのタッチイベントを UIElementUIElement3D、または ContentElementで使用します。If you do not have to ensure compatibility with Silverlight, use the touch events, such as TouchDown and TouchMove, on UIElement, UIElement3D, or ContentElement.

FrameReported イベントでは、TouchDownTouchMoveなどの他の WPF 入力イベントと同じイベントモデルは使用されません。The FrameReported event does not use the same event model as other WPF input events, such as TouchDown and TouchMove. FrameReported イベントは、UI のオブジェクトツリーを通じてルーティングされる可能性がある要素固有のイベントとして公開される代わりに、アプリケーションレベルで処理される1つのイベントです。Instead of being exposed as an element-specific event that potentially routes through the object tree of a UI, the FrameReported event is a single event that is handled at the application level. したがって、イベントハンドラーの sender パラメーターを使用して、どの要素にタッチされるかを判断することはできません。Therefore, you cannot use the sender parameter of the event handler to determine what element is touched.

タッチイベントに関連する TouchPoint 値を取得するには、TouchFrameEventArgs を使用します。Use the TouchFrameEventArgs to get the TouchPoint values that are relevant to the touch event. TouchPointから、タッチの Position を取得し、TouchActionDownMove、または Up アクションであるかどうかを判断できます。From the TouchPoint, you can get the Position of the touch and determine whether the TouchAction was a Down, Move, or Up action. また、TouchPoint を使用して TouchDeviceを取得することもできます。You can also use the TouchPoint to get the TouchDevice. TouchDeviceから、デバイス Id を確認し、タッチされた要素に関する情報を取得できます。From the TouchDevice, you can determine the device Id and get information about the element that is touched.



タッチ メッセージが送信されたときに発生します。Occurs when a touch message is sent.