TouchFrameEventArgs Klasse

Definition

Stellt Daten für das FrameReported-Ereignis bereit.Provides data for the FrameReported event.

public ref class TouchFrameEventArgs sealed : EventArgs
public sealed class TouchFrameEventArgs : EventArgs
type TouchFrameEventArgs = class
    inherit EventArgs
Public NotInheritable Class TouchFrameEventArgs
Inherits EventArgs
Vererbung
TouchFrameEventArgs

Beispiele

Im folgenden Beispiel wird das FrameReported -Ereignis behandelt, und es wird auf TouchFrameEventArgsdie Berührungs Daten in der zugegriffen.The following example handles the FrameReported event and accesses the touch data in the TouchFrameEventArgs. Wenn eine Fingereingabe auf dem Canvasgedrückt wird, wird der TouchDevice in der Canvasaufgezeichnet.When a touch is pressed on the Canvas, the TouchDevice is captured to the Canvas. Wenn die Fingereingabe angehoben wird, TouchDevice wird die freigegeben.When the touch is lifted, the TouchDevice is released. Wenn eine Fingereingabe über den Canvasbewegt wird Id , wird das aktiviert.When a touch moves across the Canvas, the Id is checked. Wenn die Verschiebung von der ersten Fingereingabe stammt, wird der Speicherort aufgezeichnet.If the move came from the first touch, its location is recorded. Wenn der Verschiebe Vorgang von der zweiten Berührung stammt, wird eine Linie von der Position der ersten Fingereingabe bis zur Position des zweiten Zieh Punkts gezeichnet.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.

Dieses Beispiel ist Teil eines größeren Beispiels, das in der Übersicht über Touch die-Klasse verfügbar ist.This example is part of a larger example that is available in the Touch class overview.

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)Windows Presentation Foundation (WPF) enthalten, um die Kompatibilität mit Silverlight zu unterstützen.The FrameReported event is included in Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) to support compatibility with Silverlight. Wenn Sie keine Kompatibilität mit Silverlight sicherstellen müssen TouchDown , verwenden Sie die Berührungs Ereignisse wie und TouchMove, für UIElement, UIElement3Doder 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.

TouchPoint Verwenden Sie TouchFrameEventArgs , um die für das Berührungs Ereignis relevanten Werte zu erhalten.Use the TouchFrameEventArgs to get the TouchPoint values that are relevant to the touch event. Down TouchAction Move Up Im können Sie die Position der Fingereingabe erhalten und ermitteln, ob es sich um eine-,-oder-Aktion handelt. TouchPointFrom the TouchPoint, you can get the Position of the touch and determine whether the TouchAction was a Down, Move, or Up action. Sie können auch das TouchPoint verwenden, um die TouchDevicezu erhalten.You can also use the TouchPoint to get the TouchDevice. Im können Sie das Gerät Id ermitteln und Informationen über das Element erhalten, das berührt wird. TouchDeviceFrom the TouchDevice, you can determine the device Id and get information about the element that is touched.

Eigenschaften

Timestamp

Ruft den Zeitstempel für dieses Ereignis ab.Gets the time stamp for this event.

Methoden

Equals(Object)

Ermittelt, ob das angegebene Objekt und das aktuelle Objekt gleich sind.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
GetHashCode()

Dient als die Standard-HashfunktionServes as the default hash function.

(Geerbt von Object)
GetPrimaryTouchPoint(IInputElement)

Gibt den aktuellen Berührungspunkt des primären Fingereingabegeräts relativ zum angegebenen Element zurück.Returns the current touch point of the primary touch device relative to the specified element.

GetTouchPoints(IInputElement)

Gibt eine Auflistung zurück, die den aktuellen Berührungspunkt für jedes aktive Fingereingabegerät relativ zum angegebenen Element enthält.Returns a collection that contains the current touch point for each active touch device relative to the specified element.

GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
SuspendMousePromotionUntilTouchUp()

Dieser Member ist nicht implementiert.This member is not implemented.

ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Geerbt von Object)

Gilt für: