Touch Klas

Definitie

Biedt een service op toepassingsniveau waarmee multitouch-invoer van het besturingssysteem wordt verwerkt en de FrameReported gebeurtenis wordt gegenereerd.

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

Voorbeelden

In het volgende voorbeeld kunt u eenvoudige patronen op een Canvas maken door twee vingers over een touchscreen te slepen. Elke aanraking wordt vertegenwoordigd door een TouchDevice. Het patroon wordt gemaakt door een lijn te tekenen tussen de aanraakpunten die door de aanrakingen worden geleverd. Voor dit voorbeeld is een Windows scherm met aanraakscherm vereist.

Met de volgende markeringen wordt de gebruikersinterface gemaakt, die bestaat uit een Canvas interface die is gecentreerd in een 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>

De volgende code verwerkt de FrameReported gebeurtenis. Wanneer een aanraking op de Canvastoets drukt, wordt het TouchDevice vastgelegd op de Canvas. Wanneer de aanraking wordt opgeheven, wordt de TouchDevice knop losgelaten. Wanneer een aanraking over het Canvasscherm beweegt, wordt de Id toets ingeschakeld. Als de verplaatsing afkomstig is van de eerste aanraking, wordt de locatie ervan vastgelegd. Als de beweging afkomstig is van de tweede aanraking, wordt een lijn getekend van de positie van de eerste aanraking tot de positie van de tweede aanraking.

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

Opmerkingen

De gebeurtenis FrameReported is opgenomen in Windows Presentation Foundation (WPF) ter ondersteuning van compatibiliteit met Silverlight. Als u geen compatibiliteit met Silverlight hoeft te garanderen, gebruikt u de aanraakevenementen, zoals TouchDown en TouchMove, aan UIElement, UIElement3Dof ContentElement.

De gebeurtenis FrameReported gebruikt niet hetzelfde gebeurtenismodel als andere WPF invoer gebeurtenissen, zoals TouchDown en TouchMove. In plaats van beschikbaar te worden gesteld als een elementspecifieke gebeurtenis die mogelijk door de objectstructuur van een gebruikersinterface wordt gerouteerd, is de FrameReported gebeurtenis één gebeurtenis die wordt verwerkt op toepassingsniveau. Daarom kunt u de sender parameter van de gebeurtenishandler niet gebruiken om te bepalen welk element wordt aangeraakt.

Gebruik de opdracht TouchFrameEventArgs om de TouchPoint waarden op te halen die relevant zijn voor de touch-gebeurtenis. Vanaf de TouchPoint, kunt u de Position aanraking krijgen en bepalen of het TouchAction een Down, Moveof Up actie was. U kunt ook de TouchPoint opdracht gebruiken om de TouchDevice. Op de TouchDevicepagina kunt u het apparaat Id bepalen en informatie ophalen over het element dat wordt aangeraakt.

gebeurtenis

Name Description
FrameReported

Treedt op wanneer een aanraakbericht wordt verzonden.

Van toepassing op