GestureRecognizer.Recognize(StrokeCollection) Méthode

Définition

Espace de noms:

System.Windows.Ink

Assembly:

PresentationCore.dll

Recherche les mouvements dans le fichier spécifié StrokeCollection.

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

Recherche StrokeCollection de mouvements.

Retours

ReadOnlyCollection<GestureRecognitionResult>

Tableau de type GestureRecognitionResult qui contient des mouvements d’application reconnus GestureRecognizer .

Exemples

L’exemple suivant montre comment déterminer s’il s’agit d’un StrokeScratchOut 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 les GestureRecognizer reconnaîtres qu’il est très probable qu’il Stroke s’agit d’une coche, relativement probable que l’in Stroke n’est pas un geste, et pas du tout que le Stroke ciselé est un curlicue ou un double curlicue.

Note

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