RecognizerContext.Recognize (Método)

Artículo
11/26/2008

Actualización: noviembre 2007

Devuelve un objeto RecognitionResult para una colección Strokes.

Espacio de nombres: Microsoft.Ink
Ensamblado: Microsoft.Ink (en Microsoft.Ink.dll)

Sintaxis

'Declaración
Public Function Recognize ( _
    <OutAttribute> ByRef recognitionStatus As RecognitionStatus _
) As RecognitionResult
'Uso
Dim instance As RecognizerContext
Dim recognitionStatus As RecognitionStatus
Dim returnValue As RecognitionResult

returnValue = instance.Recognize(recognitionStatus)

public RecognitionResult Recognize(
    out RecognitionStatus recognitionStatus
)

public:
RecognitionResult^ Recognize(
    [OutAttribute] RecognitionStatus% recognitionStatus
)

public RecognitionResult Recognize(
    /** @attribute OutAttribute */ /** @ref */RecognitionStatus recognitionStatus
)

public function Recognize(
    recognitionStatus : RecognitionStatus
) : RecognitionResult

Parámetros

recognitionStatus
Tipo: Microsoft.Ink.RecognitionStatus%
Un miembro de la enumeración RecognitionStatus que indica se produjo si un error durante el reconocimiento y, en ese caso, qué error se produjo.

Valor devuelto

Tipo: Microsoft.Ink.RecognitionResult
El objeto RecognitionResult de una colección Strokes reconocida.

Comentarios

Este método devuelve null (Nothing en .NET de Microsoft® Visual Basic®) si el reconocedor no puede calcular un resultado para la colección Strokes.

Nota

Debe usar un bloque try/catch cuando llame al método Recognize porque se produce una excepción cuando el objeto Ink no contiene ningún trazo.

Este método realiza el reconocimiento de forma sincrónica. Para iniciar el reconocimiento en segundo plano o asincrónico, llame a los métodos BackgroundRecognizeWithAlternates o BackgroundRecognize.

Ejemplos

En este ejemplo de C# se muestra un controlador del evento Click, buttonSubmit_Click de un control Button, que reconoce la entrada manuscrita de su objeto RecognizerContext, theRecognizerContext, declarada en un ámbito contenedor. A continuación, el ejemplo muestra el objeto RecognitionResult, theRecognitionResult en un control TextBox si no se produjo ningún error.

private void buttonSubmit_Click(object sender, System.EventArgs e)
{
    RecognitionStatus theRecognitionStatus;
    theRecognizerContext.EndInkInput();
    try
    {
      theRecognitionResult = theRecognizerContext.Recognize(out theRecognitionStatus);
      if (RecognitionStatus.NoError == theRecognitionStatus)
      {
        theTextBox.Text = theRecognitionResult.TopString;
      }
      else
      {
         theTextBox.Text = "";
      }
    }
    catch
    {
      // If Ink object in theRecognizerContext contains no strokes or only
      // deleted strokes, exception is thrown.
      theTextBox.Text = "";
    }
}

En este ejemplo de Microsoft® Visual Basic® .NET se muestra un controlador del evento Click, buttonSubmit_Click de un control Button, que reconoce la entrada manuscrita de su objeto RecognizerContext, theRecognizerContext, declarada en un ámbito contenedor. A continuación, el ejemplo muestra el objeto RecognitionResult, theRecognitionResult en un control TextBox si no se produjo ningún error.

Private Sub Button1_Click( ByVal sender As System.Object, _
  ByVal e As System.EventArgs) Handles Button1.Click
    theRecognizerContext.EndInkInput()
    Dim theRecognitionStatus As RecognitionStatus
    Try
        theRecognitionResult = theRecognizerContext.Recognize(theRecognitionStatus)
        If RecognitionStatus.NoError = theRecognitionStatus Then
            RichTextBox1.Text = theRecognitionResult.TopString
        Else
            'Handle the error conditions here.
            RichTextBox1.Text = ""
        End If
    Catch
        ' If Ink object in theRecognizerContext contains no strokes or only
        ' deleted strokes, exception is thrown.
        RichTextBox1.Text = ""
    End Try
End Sub

Plataformas

Windows Vista

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.