TouchFrameEventArgs Класс

Определение

Пространство имен:

System.Windows.Input

Сборка:

PresentationCore.dll

Предоставляет данные для FrameReported события.

public ref class TouchFrameEventArgs sealed : EventArgs

public sealed class TouchFrameEventArgs : EventArgs

type TouchFrameEventArgs = class
    inherit EventArgs

Public NotInheritable Class TouchFrameEventArgs
Inherits EventArgs

Наследование

Object

EventArgs

TouchFrameEventArgs

Примеры

Следующий пример обрабатывает FrameReported событие и обращается к сенсорным данным в .TouchFrameEventArgs При нажатии CanvasTouchDevice сенсорного касания на нее фиксируетсяCanvas. При снятии TouchDevice касания освобождается. При перемещении CanvasId касания по всей области проверяется. Если перемещение произошло с первого касания, его расположение записывается. Если шаг пришел от второго касания, линия рисуется из позиции первого касания к позиции второго касания.

Этот пример является частью более крупного примера, который доступен в обзоре Touch класса.

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

Комментарии

Событие FrameReported включается в Windows Presentation Foundation (WPF) для поддержки совместимости с Silverlight. Если вам не нужно обеспечить совместимость с Silverlight, используйте события касания, такие как TouchDown и , вклTouchMoveUIElement. илиUIElement3DContentElement.

Используйте для TouchFrameEventArgs получения TouchPoint значений, относящихся к событию касания. TouchPointИз элемента можно получить Position касание и определить, было TouchActionли Down действие , Moveили Up действие. Вы также можете использовать TouchPoint его для получения TouchDevice. Из этого TouchDeviceэлемента можно определить устройство Id и получить сведения об элементе, который касается.

Свойства

Имя	Описание
Timestamp	Возвращает метку времени для этого события.

Методы

Имя	Описание
GetPrimaryTouchPoint(IInputElement)	Возвращает текущую точку касания основного сенсорного устройства относительно указанного элемента.
GetTouchPoints(IInputElement)	Возвращает коллекцию, содержащую текущую точку касания для каждого активного сенсорного устройства относительно указанного элемента.
SuspendMousePromotionUntilTouchUp()	Этот член не реализован.