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使用觸控事件TouchMove, 例如和。If you do not have to ensure compatibility with Silverlight, use the touch events, such as TouchDown and TouchMove, on UIElement, UIElement3D, or ContentElement.

使用取得與觸控事件TouchPoint相關的值。 TouchFrameEventArgsUse the TouchFrameEventArgs to get the TouchPoint values that are relevant to the touch event. Position Move Up Down您可以從取得TouchAction觸控的, 並判斷是否為、或動作。 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.


傳回代表目前物件的字串。Returns a string that represents the current object.

(繼承來源 Object)