GestureRecognizer.Recognize(StrokeCollection) Méthode

Définition

Espace de noms:

System.Windows.Ink

Assembly:

PresentationCore.dll

Recherche des gestes dans la StrokeCollection spécifiée.

public:
 System::Collections::ObjectModel::ReadOnlyCollection<System::Windows::Ink::GestureRecognitionResult ^> ^ Recognize(System::Windows::Ink::StrokeCollection ^ strokes);

public System.Collections.ObjectModel.ReadOnlyCollection<System.Windows.Ink.GestureRecognitionResult> Recognize (System.Windows.Ink.StrokeCollection strokes);

member this.Recognize : System.Windows.Ink.StrokeCollection -> System.Collections.ObjectModel.ReadOnlyCollection<System.Windows.Ink.GestureRecognitionResult>

Public Function Recognize (strokes As StrokeCollection) As ReadOnlyCollection(Of GestureRecognitionResult)

Paramètres

strokes

StrokeCollection

StrokeCollection pour rechercher les mouvements.

Retours

ReadOnlyCollection<GestureRecognitionResult>

Un tableau de type GestureRecognitionResult qui contient les mouvements d'application reconnus par GestureRecognizer.

Exemples

L’exemple suivant montre comment déterminer si un Stroke est un ScratchOut mouvement.

private bool InterpretScratchoutGesture(Stroke stroke)
{
    // Attempt to instantiate a recognizer for scratchout gestures.
    ApplicationGesture[] gestures = { ApplicationGesture.ScratchOut };
    GestureRecognizer recognizer = new GestureRecognizer(gestures);

    if (!recognizer.IsRecognizerAvailable)
        return false;

    // Determine if the stroke was a scratchout gesture.
    StrokeCollection gestureStrokes = new StrokeCollection();
    gestureStrokes.Add(stroke);

    ReadOnlyCollection<GestureRecognitionResult> results = recognizer.Recognize(gestureStrokes);

    if (results.Count == 0)
        return false;

    // Results are returned sorted in order strongest-to-weakest; 
    // we need only analyze the first (strongest) result.
    if (results[0].ApplicationGesture == ApplicationGesture.ScratchOut &&
          results[0].RecognitionConfidence == RecognitionConfidence.Strong)
    {
        // Use the scratchout stroke to perform hit-testing and 
        // erase existing strokes, as necessary.
        return true;
    }
    else
    {
        // Not a gesture: display the stroke normally.
        return false;
    }
}

Private Function InterpretScratchoutGesture(ByVal stroke As Stroke) As Boolean
    ' Attempt to instantiate a recognizer for scratchout gestures.
    Dim gestures() As ApplicationGesture = {ApplicationGesture.ScratchOut}

    Dim recognizer As New GestureRecognizer(gestures)

    If Not recognizer.IsRecognizerAvailable Then
        Return False
    End If

    ' Determine if the stroke was a scratchout gesture.
    Dim gestureStrokes As StrokeCollection = New StrokeCollection()
    gestureStrokes.Add(stroke)

    Dim results As ReadOnlyCollection(Of GestureRecognitionResult)
    results = recognizer.Recognize(gestureStrokes)

    If results.Count = 0 Then
        Return False
    End If

    ' Results are returned sorted in order strongest-to-weakest; 
    ' we need only analyze the first (strongest) result.
    If (results(0).ApplicationGesture = ApplicationGesture.ScratchOut) Then

        ' Use the scratchout stroke to perform hit-testing and 
        ' erase existing strokes, as necessary.
        Return True
    Else
        ' Not a gesture: display the stroke normally.
        Return False
    End If
End Function

Remarques

Le tableau retourné par la Recognize méthode est trié par la GestureRecognitionResult.RecognitionConfidence propriété . Par exemple, Recognize peut retourner un GestureRecognitionResult tableau avec les valeurs suivantes :

Index	ApplicationGesture	RecognitionConfidence
0	Check	Strong
1	NoGesture	Intermediate
2	Curlicue	Poor
3	DoubleCurlicue	Poor

Cela signifie que le GestureRecognizer reconnaît qu’il est très probable que est Stroke une coche, relativement probable que le Stroke n’est pas un mouvement, et pas du tout probable que le Stroke soit un curlicue ou un double curlicue.

Notes

La Recognize méthode peut retourner un tableau avec NoGesture à une valeur supérieure RecognitionConfidence à d’autres mouvements d’application. Cela signifie qu’il est plus probable que le n’est pas un mouvement, par opposition à un mouvement dont la Stroke valeur est inférieure RecognitionConfidence.