TouchFrameEventArgs Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt Daten für das FrameReported-Ereignis bereit.
public ref class TouchFrameEventArgs sealed : EventArgspublic sealed class TouchFrameEventArgs : EventArgstype TouchFrameEventArgs = class
inherit EventArgsPublic NotInheritable Class TouchFrameEventArgs
Inherits EventArgs- Vererbung
Beispiele
Im folgenden Beispiel wird das FrameReported Ereignis behandelt und auf die Touchdaten in der TouchFrameEventArgs. Wenn eine Toucheingabe auf den CanvasDrücker gedrückt wird, wird die TouchDevice Aufnahme an die Canvas. Wenn die Toucheingabe aufgehoben wird, wird die TouchDevice Veröffentlichung freigegeben. Wenn sich eine Toucheingabe über die Verschiebung bewegt, wird dies CanvasId überprüft. Wenn der Wechsel von der ersten Toucheingabe stammt, wird seine Position aufgezeichnet. Wenn die Bewegung von der zweiten Toucheingabe stammt, wird eine Linie aus der Position der ersten Berührung auf die Position der zweiten Toucheingabe gezeichnet.
In diesem Beispiel handelt es sich um ein größeres Beispiel, 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 keine Kompatibilität mit Silverlight sicherstellen müssen, verwenden Sie die Touchereignisse wie TouchDown z. B. und TouchMove, auf UIElement3DUIElement, oder ContentElement.
Verwenden Sie die TouchFrameEventArgs Werte, die TouchPoint für das Touchereignis relevant sind. Aus dem TouchPoint, können Sie die Position Toucheingabe abrufen und bestimmen, ob es TouchAction sich um eine Down, MoveUp oder eine Aktion handelte. 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
| Timestamp |
Ruft den Zeitstempel für dieses Ereignis ab. |
Methoden
| Equals(Object) |
Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object) |
| GetHashCode() |
Fungiert als Standardhashfunktion. (Geerbt von Object) |
| GetPrimaryTouchPoint(IInputElement) |
Gibt den aktuellen Berührungspunkt des primären Fingereingabegeräts relativ zum angegebenen Element zurück. |
| GetTouchPoints(IInputElement) |
Gibt eine Auflistung zurück, die den aktuellen Berührungspunkt für jedes aktive Fingereingabegerät relativ zum angegebenen Element enthält. |
| GetType() |
Ruft den Type der aktuellen Instanz ab. (Geerbt von Object) |
| MemberwiseClone() |
Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object) |
| SuspendMousePromotionUntilTouchUp() |
Dieser Member ist nicht implementiert. |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |