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觸控數據。 按下 觸控 Canvas時，會 TouchDevice 擷取至 Canvas。 當觸控隨即解除時，會 TouchDevice 放開 。 當觸控在 之間 Canvas移動時， Id 會檢查 。 如果移動來自第一次觸控，則會記錄其位置。 如果移動來自第二個觸控，則會從第一個觸控的位置繪製線條到第二個觸控的位置。

此範例是類別概觀中提供之較大範例的 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包含在 WPF Windows Presentation Foundation () ，以支援 Silverlight 的相容性。 如果您不需要確保與 Silverlight 相容，請使用觸控事件，例如 TouchDown 、 或ContentElement上的UIElementUIElement3D與 TouchMove。

TouchFrameEventArgs使用取得TouchPoint與觸控事件相關的值。 TouchPoint您可以從 取得Position觸控的 ，並判斷 是否TouchAction為Down、 Move或 Up 動作。 您也可以使用 TouchPoint 取得 。 TouchDevice TouchDevice從 中，您可以判斷裝置Id，並取得所觸碰專案的相關信息。

屬性

Timestamp

取得此事件的時間戳記。

方法

Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetPrimaryTouchPoint(IInputElement)	傳回主要觸控裝置目前相對於指定之項目的觸控點。
GetTouchPoints(IInputElement)	傳回集合，其中包含每個作用中觸控裝置目前相對於指定之項目的觸控點。
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
SuspendMousePromotionUntilTouchUp()	這個成員尚未實作。
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)