Touch.FrameReported Touch.FrameReported Touch.FrameReported Touch.FrameReported Event

定義

タッチ メッセージが送信されたときに発生します。Occurs when a touch message is sent.

public:
 static event System::Windows::Input::TouchFrameEventHandler ^ FrameReported;
public static event System.Windows.Input.TouchFrameEventHandler FrameReported;
member this.FrameReported : System.Windows.Input.TouchFrameEventHandler 
Public Shared Event FrameReported As TouchFrameEventHandler 

次の例のハンドル、FrameReportedイベント。The following example handles the FrameReported event. タッチで押されたときに、 CanvasTouchDeviceにキャプチャされて、Canvasします。When a touch presses on the Canvas, the TouchDevice is captured to the Canvas. タッチを無効になったときに、TouchDevice解放されます。When the touch is lifted, the TouchDevice is released. 間で、タッチが移動したときに、 CanvasIdがチェックされます。When a touch moves across the Canvas, the Id is checked. 最初のタッチの場合は、その場所が記録されます。If the move came from the first touch, its location is recorded. 2 つ目のタッチの場合は、行は最初のタッチの位置から 2 番目のタッチの位置に描画されます。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

注釈

フレームは、一連のマルチタッチ メッセージまたはタッチ ポイントのいずれかです。A frame is one in a series of multitouch messages or touch points. 処理することによって、タッチに応答すること、FrameReportedイベントとの詳細へのアクセス、TouchPointから、TouchFrameEventArgsイベント データ。You can respond to touches by handling the FrameReported event and accessing the details of the TouchPoint from the TouchFrameEventArgs event data.

FrameReportedイベントが他の同じイベント モデルを使用しないWPFWPFなどの入力イベント、TouchDownTouchMoveします。The FrameReported event does not use the same event model as other WPFWPF input events, such as TouchDown and TouchMove. 可能性のある、UI のオブジェクト ツリーを通じてルーティングする要素に固有のイベントとして公開されているのではなく、FrameReportedイベントは、アプリケーション レベルで処理される 1 つのイベント。Instead of being exposed as an element-specific event that potentially routes through the object tree of a UI, the FrameReported event is a single event that is handled at the application level. そのため、使用することはできません、senderタッチされる要素を判断するイベント ハンドラーのパラメーター。Therefore, you cannot use the sender parameter of the event handler to determine what element is touched.

適用対象