Touch Klasa

Definicja

Udostępnia usługę na poziomie aplikacji, która przetwarza dane wejściowe wielodotykowe z systemu operacyjnego i zgłasza FrameReported zdarzenie.

public ref class Touch abstract sealed
public static class Touch
type Touch = class
Public Class Touch
Dziedziczenie
Touch

Przykłady

Poniższy przykład umożliwia tworzenie prostych wzorów na obiekcie Canvas przez przeciąganie dwóch palców po ekranie dotykowym. Każde dotknięcie jest reprezentowane przez element TouchDevice. Wzorzec jest tworzony przez rysowanie linii między punktami dotykowymi dostarczonymi przez dotyk. Ten przykład wymaga Windows ekranu zgodnego z obsługą dotykową.

Poniższy znacznik tworzy interfejs użytkownika, który składa się z obiektu Canvas wyśrodkowanego w obiekcie 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>

Poniższy kod obsługuje FrameReported zdarzenie. Gdy naciśnięcie naciśnie Canvaselement , TouchDevice element zostanie przechwycony do elementu Canvas. Po podniesieniu dotyku TouchDevice zostaje zwolniony. Gdy dotknięcie przechodzi przez Canvaselement , Id jest zaznaczone. Jeśli przeniesienie pochodzi z pierwszego dotyku, jego lokalizacja jest rejestrowana. Jeśli ruch pochodzi z drugiego dotyku, linia jest rysowana z pozycji pierwszego dotyku do pozycji drugiego dotyku.

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

Uwagi

Zdarzenie FrameReported jest uwzględniane w Windows Presentation Foundation (WPF), aby zapewnić zgodność z programem Silverlight. Jeśli nie musisz zapewnić zgodności z programem Silverlight, użyj zdarzeń dotykowych, takich jak TouchDown i TouchMove, na UIElement, UIElement3Dlub ContentElement.

Zdarzenie FrameReported nie używa tego samego modelu zdarzeń co inne zdarzenia wejściowe WPF, takie jak TouchDown i TouchMove. Zamiast być uwidaczniane jako zdarzenie specyficzne dla elementu, które potencjalnie kieruje przez drzewo obiektów interfejsu użytkownika, FrameReported zdarzenie jest pojedynczym zdarzeniem, które jest obsługiwane na poziomie aplikacji. W związku z tym nie można użyć sender parametru programu obsługi zdarzeń, aby określić, który element jest dotykany.

Użyj elementu , TouchFrameEventArgs aby uzyskać TouchPoint wartości, które są istotne dla zdarzenia dotykowego. Z poziomu elementu TouchPointmożesz uzyskać Position wartość dotyku i określić, czy TouchAction element był akcją Down, Movelub Up . Możesz również użyć polecenia , TouchPoint aby pobrać element TouchDevice. Z poziomu programu TouchDevicemożna określić urządzenie Id i uzyskać informacje o elemecie, który jest dotykany.

Zdarzenia

FrameReported

Występuje po wysłaniu wiadomości dotykowej.

Dotyczy