TouchFrameEventArgs TouchFrameEventArgs TouchFrameEventArgs TouchFrameEventArgs Class

Определение

Предоставляет данные для события 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
Наследование
TouchFrameEventArgsTouchFrameEventArgsTouchFrameEventArgsTouchFrameEventArgs

Примеры

В следующем примере показана обработка FrameReported событий и обращается к данным сенсорного ввода в TouchFrameEventArgs.The following example handles the FrameReported event and accesses the touch data in the TouchFrameEventArgs. При сенсорном нажатии Canvas, TouchDevice захвачена Canvas.When a touch is pressed on the Canvas, the TouchDevice is captured to the Canvas. Когда удаляется сенсорное устройство, TouchDevice освобождается.When the touch is lifted, the TouchDevice is released. При перемещении касания между Canvas, Id проверяется.When a touch moves across the Canvas, the Id is checked. Если перемещение пришло из первого касания, его расположение записывается.If the move came from the first touch, its location is recorded. Если перемещение пришло из второго касания, проводится линия от позиции первого касания в позицию второго касания.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.

Этот пример является частью большего примера, который доступен в Touch Общие сведения о классе.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

Комментарии

FrameReported Событие включается в Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) для поддержки совместимости с Silverlight.The FrameReported event is included in Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) to support compatibility with Silverlight. Если у вас нет для обеспечения совместимости с Silverlight, используйте события касания, такие как TouchDown и TouchMoveна UIElement, UIElement3D, или 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.

Используйте TouchFrameEventArgs для получения TouchPoint значения, относящиеся к событие сенсорного ввода.Use the TouchFrameEventArgs to get the TouchPoint values that are relevant to the touch event. Из TouchPoint, вы можете получить Position точки касания и определить ли TouchAction был Down, 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. Можно также использовать TouchPoint для получения TouchDevice.You can also use the TouchPoint to get the TouchDevice. Из TouchDevice, можно определить устройство Id и получения сведений об элементе, который был затронут.From the TouchDevice, you can determine the device Id and get information about the element that is touched.

Свойства

Timestamp Timestamp Timestamp Timestamp

Получает отметку времени данного события.Gets the time stamp for this event.

Методы

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Inherited from Object)
GetPrimaryTouchPoint(IInputElement) GetPrimaryTouchPoint(IInputElement) GetPrimaryTouchPoint(IInputElement) GetPrimaryTouchPoint(IInputElement)

Возвращает текущую сенсорную точку основного сенсорного устройства относительно заданного элемента.Returns the current touch point of the primary touch device relative to the specified element.

GetTouchPoints(IInputElement) GetTouchPoints(IInputElement) GetTouchPoints(IInputElement) GetTouchPoints(IInputElement)

Возвращает коллекцию, которая содержит текущую сенсорную точку для каждого активного сенсорного устройства, имеющего отношение к заданному элементу.Returns a collection that contains the current touch point for each active touch device relative to the specified element.

GetType() GetType() GetType() GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Inherited from Object)
SuspendMousePromotionUntilTouchUp() SuspendMousePromotionUntilTouchUp() SuspendMousePromotionUntilTouchUp() SuspendMousePromotionUntilTouchUp()

Этот член не реализован.This member is not implemented.

ToString() ToString() ToString() ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Inherited from Object)

Применяется к