Touch クラス

定義

名前空間:

System.Windows.Input

アセンブリ:

PresentationCore.dll

オペレーティング システムからのマルチタッチ入力を処理し、FrameReported イベントを生成するアプリケーション レベルのサービスを提供します。

public ref class Touch abstract sealed

public static class Touch

type Touch = class

Public Class Touch

継承

Object

Touch

例

次の例では、タッチスクリーン上で 2 本の指をドラッグして、 に Canvas 単純なパターンを作成できます。 各タッチは、 で TouchDevice表されます。 パターンは、タッチによって提供されるタッチ ポイント間の線を描画することによって作成されます。 この例では、Windows タッチ対応の画面が必要です。

次のマークアップは、 内の中央にある で Canvas 構成されるユーザー インターフェイスを Grid作成します。

<Window x:Class="WpfTouchFrameSample.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        Title="MainWindow" Height="525" Width="525">
    <Grid>
        <Canvas x:Name="canvas1"
                Width="500" Height="500"
                Background="Black" />     
    </Grid>
</Window>

次のコードは、 イベントを処理します FrameReported 。 タッチが をCanvasTouchDevice押すと、 が にCanvasキャプチャされます。 タッチが解除されると、 TouchDevice が解放されます。 タッチが を Canvas越えて移動すると、 Id がオンになります。 移動が最初のタッチから来た場合は、その場所が記録されます。 移動が 2 番目のタッチから来た場合、1 番目のタッチの位置から 2 番目のタッチの位置に線が描画されます。

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()
        {
            InitializeComponent();
            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.
                        this.canvas1.Children.Clear();
                        _touchPoint.TouchDevice.Capture(this.canvas1);
                    }

                    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;
                            this.canvas1.Children.Add(_line);
                        }
                    }

                    else if (_touchPoint.Action == TouchAction.Up)
                    {
                        // If this touch is captured to the canvas, release it.
                        if (_touchPoint.TouchDevice.Captured == this.canvas1)
                        {
                            this.canvas1.ReleaseTouchCapture(_touchPoint.TouchDevice);
                        }
                    }
                }                        
            }
        }
    }
}

Class MainWindow
    ' Variables for tracking the position of two points.
    Private pt1, pt2 As Point

    Public Sub New()
        InitializeComponent()
        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.
                    canvas1.Children.Clear()
                    _touchPoint.TouchDevice.Capture(canvas1)

                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
                        Me.canvas1.Children.Add(_line)
                    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
                        canvas1.ReleaseTouchCapture(_touchPoint.TouchDevice)
                    End If
                End If
            Next
        End If
    End Sub
End Class

注釈

イベントはFrameReported、Silverlight との互換性をサポートするために、Windows Presentation Foundation (WPF) に含まれています。 Silverlight との互換性を確保する必要がない場合は、 や などのTouchDownTouchMoveタッチ イベントを 、UIElement3D、または ContentElementでUIElement使用します。

イベントでは FrameReported 、 や など TouchDown 、他の WPF 入力イベントと TouchMove同じイベント モデルは使用されません。 UI のオブジェクト ツリーを介してルーティングされる可能性のある要素固有のイベントとして公開されるのではなく、 FrameReported イベントはアプリケーション レベルで処理される 1 つのイベントです。 そのため、イベント ハンドラーの パラメーターを sender 使用して、タッチされる要素を特定することはできません。

TouchFrameEventArgsタッチ イベントに関連する値をTouchPoint取得するには、 を使用します。 から、TouchPointタッチの をPosition取得し、 が 、Move、または Up アクションであるかどうかをTouchActionDown判断できます。 を使用 TouchPoint して を TouchDevice取得することもできます。 から、 TouchDeviceデバイス Id を決定し、タッチされた要素に関する情報を取得できます。

イベント

FrameReported

タッチ メッセージが送信されたときに発生します。