GestureRecognizer.Recognize(StrokeCollection) Método

Definición

Espacio de nombres:

System.Windows.Ink

Ensamblado:

PresentationCore.dll

Busca gestos en la colección StrokeCollection especificada.

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)

Parámetros

strokes

StrokeCollection

StrokeCollection en la que se van a buscar gestos.

Devoluciones

ReadOnlyCollection<GestureRecognitionResult>

Matriz de tipo GestureRecognitionResult que contiene los gestos de la aplicación que GestureRecognizer reconoció.

Ejemplos

En el ejemplo siguiente se muestra cómo determinar si un Stroke es un ScratchOut gesto.

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

Comentarios

La matriz devuelta por el Recognize método se ordena por la GestureRecognitionResult.RecognitionConfidence propiedad . Por ejemplo, Recognize puede devolver una GestureRecognitionResult matriz con los siguientes valores:

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

Esto significa que GestureRecognizer reconoce que es muy probable que Stroke sea una marca de verificación, relativamente probable que el Stroke elemento no sea un gesto y no es probable que Stroke sea una curlicue o una curlicue doble.

Nota

El Recognize método puede devolver una matriz con NoGesture en un valor superior RecognitionConfidence a otros gestos de aplicación. Esto significa que es más probable que no Stroke sea un gesto, en lugar de un gesto que tenga un valor inferior RecognitionConfidence.