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
継承
TouchFrameEventArgs

次の例ではFrameReported 、イベントを処理し、のTouchFrameEventArgsタッチデータにアクセスします。The following example handles the FrameReported event and accesses the touch data in the TouchFrameEventArgs. CanvasタッチがCanvas押されると、がにキャプチャされます。TouchDeviceWhen 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. 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

注釈

このFrameReportedイベントは、Silverlight Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF)との互換性をサポートするためにに含まれています。The FrameReported event is included in Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) to support compatibility with Silverlight. Silverlight との互換性を確保する必要がない場合は、 TouchDownUIElement3D、またはContentElementUIElementようTouchMoveな touch イベントを使用します。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. Position Down Up から、TouchActionタッチのを取得し、が、 Move、またはのいずれのアクションであったかを判断できます。 TouchPointFrom 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. では、デバイスIdを特定し、タッチされた要素に関する情報を取得できます。 TouchDeviceFrom the TouchDevice, you can determine the device Id and get information about the element that is touched.

プロパティ

Timestamp

このイベントのタイム スタンプを取得します。Gets the time stamp for this event.

メソッド

Equals(Object)

指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判定します。Determines whether the specified object is equal to the current object.

(継承元 Object)
GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(継承元 Object)
GetPrimaryTouchPoint(IInputElement)

指定された要素に対する相対的なプライマリ タッチ デバイスの現在のタッチ点を返します。Returns the current touch point of the primary touch device relative to the specified element.

GetTouchPoints(IInputElement)

アクティブな各タッチ デバイスの、指定した要素を基準とする現在のタッチ点が格納されているコレクションを返します。Returns a collection that contains the current touch point for each active touch device relative to the specified element.

GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(継承元 Object)
MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(継承元 Object)
SuspendMousePromotionUntilTouchUp()

このメンバーは実装されていません。This member is not implemented.

ToString()

現在のオブジェクトを表す string を返します。Returns a string that represents the current object.

(継承元 Object)

適用対象