TouchFrameEventArgs Klasse

Definition

Namespace:

System.Windows.Input

Assembly:

PresentationCore.dll

Stellt Daten für das FrameReported-Ereignis bereit.

public ref class TouchFrameEventArgs sealed : EventArgs

public sealed class TouchFrameEventArgs : EventArgs

type TouchFrameEventArgs = class
    inherit EventArgs

Public NotInheritable Class TouchFrameEventArgs
Inherits EventArgs

Vererbung

Object

EventArgs

TouchFrameEventArgs

Beispiele

Im folgenden Beispiel wird das FrameReported Ereignis behandelt und auf die Fingereingabedaten in der TouchFrameEventArgsDatei zugegriffen. Wenn eine Toucheingabe auf dem CanvasFinger gedrückt wird, wird die TouchDevice Aufnahme in die Canvas. Wenn die Berührung angehoben wird, wird sie TouchDevice losgelassen. Wenn sich eine Berührung über die CanvasVerschiebung bewegt, wird die Id Option aktiviert. Wenn die Verschiebung von der ersten Berührung stammt, wird die 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.

Dieses Beispiel ist Teil eines größeren Beispiels, das in der Touch Klassenübersicht verfügbar ist.

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, ein UIElement, UIElement3Doder ContentElement.

Verwenden Sie die TouchFrameEventArgs Werte, die TouchPoint für das Touchereignis relevant sind. Aus dem TouchPoint, können Sie die Position Berührung abrufen und bestimmen, ob es TouchAction sich um eine Down, Moveoder Up eine Aktion handelt. Sie können auch die TouchPoint zum Abrufen der TouchDevice. Aus dem TouchDevice, können Sie das Gerät Id bestimmen und Informationen über das Element abrufen, das berührt wird.

Eigenschaften

Name	Beschreibung
Timestamp	Ruft den Zeitstempel für dieses Ereignis ab.

Methoden

Name	Beschreibung
GetPrimaryTouchPoint(IInputElement)	Gibt den aktuellen Touchpunkt des primären Touchgeräts relativ zum angegebenen Element zurück.
GetTouchPoints(IInputElement)	Gibt eine Auflistung zurück, die den aktuellen Touchpunkt für jedes aktive Touchgerät relativ zum angegebenen Element enthält.
SuspendMousePromotionUntilTouchUp()	Dieses Mitglied ist nicht implementiert.