Touch Klasse

Definition

Stellt einen Dienst auf Anwendungsebene bereit, der die Mehrfingereingabe vom Betriebssystem verarbeitet und das FrameReported-Ereignis auslöst.

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

Beispiele

Im folgenden Beispiel können Sie einfache Muster auf einem Canvas erstellen, indem Sie zwei Finger über einen Touchscreen ziehen. Jede Berührung wird durch eine TouchDevicedargestellt. Das Muster wird erstellt, indem eine Linie zwischen den berührungsspezifischen Berührungspunkten gezeichnet wird, die von den Toucheingaben bereitgestellt werden. Für dieses Beispiel ist ein Windows Touch-kompatibler Bildschirm erforderlich.

Das folgende Markup erstellt die Benutzeroberfläche, die aus einer Canvas besteht, die in einem Gridzentriert ist.

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

Der folgende Code behandelt das FrameReported Ereignis. Wenn eine Toucheingabe auf den Canvasdrückt, wird der TouchDevice mit Canvaserfasst. Wenn die Berührung aufgehoben wird, wird die TouchDevice losgelassen. Wenn eine Berührung über die Canvasbewegt wird, wird die Id aktiviert. Wenn die Verschiebung von der ersten Berührung stammt, wird ihre Position aufgezeichnet. Wenn die Bewegung von der zweiten Berührung stammt, wird eine Linie von der Position der ersten Berührung bis zur Position der zweiten Berührung gezeichnet.

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

Hinweise

Das FrameReported Ereignis ist in Windows Presentation Foundation (WPF) enthalten, um die Kompatibilität mit Silverlight zu unterstützen. Wenn Sie die Kompatibilität mit Silverlight nicht sicherstellen müssen, verwenden Sie die Touchereignisse, z TouchDown . B. und TouchMove, auf UIElement, UIElement3Doder ContentElement.

Das FrameReported Ereignis verwendet nicht dasselbe Ereignismodell wie andere WPF-Eingabeereignisse, z TouchDown . B. und TouchMove. Anstatt als elementspezifisches Ereignis verfügbar gemacht zu werden, das potenziell über die Objektstruktur einer Benutzeroberfläche geleitet wird, ist das FrameReported Ereignis ein einzelnes Ereignis, das auf Anwendungsebene behandelt wird. Daher können Sie den sender -Parameter des Ereignishandlers nicht verwenden, um zu bestimmen, welches Element berührt wird.

Verwenden Sie , TouchFrameEventArgs um die TouchPoint Werte abzurufen, die für das Touchereignis relevant sind. TouchPointÜber können Sie die Position der Toucheingabe abrufen und bestimmen, ob es sich um TouchAction eine Down- , Move- oder Up -Aktion handelt. Sie können auch verwenden TouchPoint , um die TouchDeviceabzurufen. TouchDeviceÜber können Sie das Gerät Id bestimmen und Informationen zu dem element abrufen, das berührt wird.

Ereignisse

FrameReported

Tritt auf, wenn eine Fingereingabenachricht gesendet wird.

Gilt für: