Touch Класс

Определение

Предоставляет службу уровня приложения, обрабатывающую мультисенсорный ввод из операционной системы и порождающую событие FrameReported.Provides an application-level service that processes multitouch input from the operating system and raises the FrameReported event.

public ref class Touch abstract sealed
public static class Touch
type Touch = class
Public Class Touch
Наследование
Touch

Примеры

Следующий пример позволяет создавать простые шаблоны на Canvas, перетаскивая два пальца по сенсорному экрану.The following example enables you to create simple patterns on a Canvas by dragging two fingers across a touchscreen. Каждое касание представлено TouchDevice. Шаблон создается путем рисования линии между сенсорными точками, предоставленными касаниями.Each touch is represented by a TouchDevice.The pattern is created by drawing a line between the touch points provided by the touches. Для этого примера требуется экран, совместимый с Windows Touch.This example requires a Windows Touch-compatible screen.

Следующая разметка создает пользовательский интерфейс, состоящий из Canvas, который выравнивается по центру Grid.The following markup creates the user interface, which consists of a Canvas that is centered in a Grid.

<Window x:Class="WpfTouchFrameSample.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        Title="MainWindow" Height="525" Width="525">
    <Grid>
        <Canvas x:Name="canvas1"
                Width="500" Height="500"
                Background="Black" />     
    </Grid>
</Window>

Следующий код обрабатывает событие FrameReported.The following code handles the FrameReported event. Когда касание нажимается на Canvas, TouchDevice записывается в 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. Когда касание перемещается по 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.

using System;
using System.Windows;
using System.Windows.Input;
using System.Windows.Media;
using System.Windows.Shapes;

namespace WpfTouchFrameSample
{
    /// <summary>
    /// Interaction logic for MainWindow.xaml
    /// </summary>
    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 включено в Windows 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, используйте события касания, такие как TouchDown и TouchMove, на UIElement, UIElement3Dили ContentElement.If you do not have to ensure compatibility with Silverlight, use the touch events, such as TouchDown and TouchMove, on UIElement, UIElement3D, or ContentElement.

Событие FrameReported не использует ту же модель событий, что и другие события ввода WPF, такие как TouchDown и TouchMove.The FrameReported event does not use the same event model as other WPF input events, such as TouchDown and TouchMove. Вместо того чтобы предоставляться как событие конкретного элемента, которое потенциально передается через дерево объектов пользовательского интерфейса, событие FrameReported является одним событием, которое обрабатывается на уровне приложения.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.

Используйте TouchFrameEventArgs для получения значений TouchPoint, относящихся к событию касания.Use the TouchFrameEventArgs to get the TouchPoint values that are relevant to the touch event. С TouchPointможно получить Position касания и определить, была ли TouchActionа Down, Moveили Up.From the TouchPoint, you can get the Position of the touch and determine whether the TouchAction was a Down, Move, or Up action. Для получения TouchDeviceтакже можно использовать TouchPoint.You can also use the TouchPoint to get the TouchDevice. На TouchDeviceможно определить Id устройства и получить сведения о затронутом элементе.From the TouchDevice, you can determine the device Id and get information about the element that is touched.

События

FrameReported

Происходит при отправлении сенсорного сообщения.Occurs when a touch message is sent.

Применяется к