TouchFrameEventArgs 类


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


下面的示例处理FrameReported事件并访问TouchFrameEventArgs中的触控数据。The following example handles the FrameReported event and accesses the touch data in the TouchFrameEventArgs. 在上Canvas按下触摸时TouchDevice , 会将捕获到CanvasWhen 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()
        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.

                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;

                else if (_touchPoint.Action == TouchAction.Up)
                    // If this touch is captured to the canvas, release it.
                    if (_touchPoint.TouchDevice.Captured == this.canvas1)
Class MainWindow
    ' Variables for tracking the position of two points.
    Private pt1, pt2 As Point

    Public Sub New()
        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.

                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
                    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
                    End If
                End If
        End If
    End Sub
End Class


FrameReportedWindows 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 兼容, 请在TouchDownUIElement3DContentElementUIElement使用触控事件, 例如和TouchMoveIf you do not have to ensure compatibility with Silverlight, use the touch events, such as TouchDown and TouchMove, on UIElement, UIElement3D, or ContentElement.

使用可以获取与 touch 事件相关的值。TouchPoint TouchFrameEventArgsUse the TouchFrameEventArgs to get the TouchPoint values that are relevant to the touch event. Down Move Up TouchAction从中Position , 你可以获取触控的, 并确定是、还是操作。 TouchPointFrom the TouchPoint, you can get the Position of the touch and determine whether the TouchAction was a Down, Move, or Up action. 你还可以使用TouchPointTouchDevice获取。You can also use the TouchPoint to get the TouchDevice. 从中Id , 你可以确定设备并获取有关所涉及元素的信息。 TouchDeviceFrom the TouchDevice, you can determine the device Id and get information about the element that is touched.



获取此事件的时间戳。Gets the time stamp for this event.



确定指定的对象是否等于当前对象。Determines whether the specified object is equal to the current object.

(继承自 Object)

用作默认哈希函数。Serves as the default hash function.

(继承自 Object)

返回主触摸设备相对于指定元素的当前触点。Returns the current touch point of the primary touch device relative to the specified element.


返回一个集合,其中包含每个活动触摸设备相对于指定元素的当前触点。Returns a collection that contains the current touch point for each active touch device relative to the specified element.


获取当前实例的 TypeGets the Type of the current instance.

(继承自 Object)

创建当前 Object 的浅表副本。Creates a shallow copy of the current Object.

(继承自 Object)

此成员未实现。This member is not implemented.


返回一个表示当前对象的 string。Returns a string that represents the current object.

(继承自 Object)