TouchFrameEventArgs Klasa

Definicja

Udostępnia dane dla zdarzenia FrameReported.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
Dziedziczenie
TouchFrameEventArgs

Przykłady

Poniższy przykład obsługuje FrameReported zdarzenie i uzyskuje dostęp do danych dotykowych w TouchFrameEventArgs .The following example handles the FrameReported event and accesses the touch data in the TouchFrameEventArgs. Po naciśnięciu dotyku w programie Canvas jest on TouchDevice przechwytywany do Canvas .When a touch is pressed on the Canvas, the TouchDevice is captured to the Canvas. Gdy dotknięcie zostanie zniesione, TouchDevice zostanie wydane.When the touch is lifted, the TouchDevice is released. Gdy dotknięcie porusza się między Canvas , Id jest zaznaczone.When a touch moves across the Canvas, the Id is checked. Jeśli przeniesienie pochodzi od pierwszego dotknięcia, jego lokalizacja jest zarejestrowana.If the move came from the first touch, its location is recorded. Jeśli przeniesienie pochodzi od drugiego dotknięcia, linia jest rysowana od pozycji pierwszego dotknięcia do pozycji drugiego dotknięcia.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.

Ten przykład jest częścią większego przykładu, który jest dostępny w Touch przeglądzie klasy.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

Uwagi

To FrameReported zdarzenie jest zawarte w Windows Presentation Foundation (WPF) w celu zapewnienia zgodności z technologią Silverlight.The FrameReported event is included in Windows Presentation Foundation (WPF) to support compatibility with Silverlight. Jeśli nie ma potrzeby zapewnienia zgodności z technologią Silverlight, użyj zdarzeń dotykowych, takich jak TouchDown i TouchMove , w UIElement , UIElement3D lub 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.

Użyj, TouchFrameEventArgs Aby uzyskać TouchPoint wartości, które są istotne dla zdarzenia Touch.Use the TouchFrameEventArgs to get the TouchPoint values that are relevant to the touch event. W programie możesz TouchPoint uzyskać dostęp do Position dotyku i określić, czy jest to TouchAction Down Akcja, czy Move Up .From the TouchPoint, you can get the Position of the touch and determine whether the TouchAction was a Down, Move, or Up action. Możesz również użyć, TouchPoint Aby uzyskać TouchDevice .You can also use the TouchPoint to get the TouchDevice. Z poziomu programu TouchDevice można określić urządzenie Id i uzyskać informacje o elemencie, który jest dotknięciem.From the TouchDevice, you can determine the device Id and get information about the element that is touched.

Właściwości

Timestamp

Pobiera sygnaturę czasową dla tego zdarzenia.Gets the time stamp for this event.

Metody

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetPrimaryTouchPoint(IInputElement)

Zwraca bieżący punkt dotykowy podstawowego urządzenia dotykowego względem określonego elementu.Returns the current touch point of the primary touch device relative to the specified element.

GetTouchPoints(IInputElement)

Zwraca kolekcję zawierającą bieżący punkt dotykowy dla każdego aktywnego urządzenia dotykowego odnoszącego się do określonego elementu.Returns a collection that contains the current touch point for each active touch device relative to the specified element.

GetType()

Pobiera Type bieżące wystąpienie.Gets the Type of the current instance.

(Odziedziczone po Object)
MemberwiseClone()

Tworzy skróconą kopię bieżącego elementu Object .Creates a shallow copy of the current Object.

(Odziedziczone po Object)
SuspendMousePromotionUntilTouchUp()

Ten element członkowski nie jest zaimplementowany.This member is not implemented.

ToString()

Zwraca ciąg reprezentujący bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)

Dotyczy