Metodo RecognizerContext.Recognize

Articolo
10/29/2008

Aggiornamento: novembre 2007

Restituisce un oggetto RecognitionResult per un insieme Strokes.

Spazio dei nomi: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Sintassi

'Dichiarazione
Public Function Recognize ( _
    <OutAttribute> ByRef recognitionStatus As RecognitionStatus _
) As RecognitionResult
'Utilizzo
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

Parametri

recognitionStatus
Tipo: Microsoft.Ink.RecognitionStatus%
Membro dell'enumerazione RecognitionStatus che indica se si è verificato un errore durante il riconoscimento e, in tal caso, di quale errore si tratta.

Valore restituito

Tipo: Microsoft.Ink.RecognitionResult
Oggetto RecognitionResult per un insieme Strokes riconosciuto.

Note

Questo metodo restituisce null (Nothing in Microsoft® Visual Basic® .NET) se il sistema di riconoscimento non può calcolare un risultato per l'insieme Strokes.

Nota

È necessario utilizzare un blocco try/catch in caso di chiamata al metodo Recognize poiché se l'oggetto Ink non contiene tratti, viene generata un'eccezione.

Questo metodo esegue il riconoscimento in modo sincrono. Per avviare il riconoscimento in background, o asincrono, chiamare i metodi BackgroundRecognize o BackgroundRecognizeWithAlternates.

Esempi

In questo esempio di C# viene mostrato un gestore eventi per l'evento Click di un controllo Button, buttonSubmit_Click, che riconosce l'input penna nell'oggetto RecognizerContext, theRecognizerContext, dichiarato in un ambito contenitore. Nell'esempio viene quindi visualizzato l'oggetto RecognitionResult, theRecognitionResult in un controllo TextBox se non si verificano errori.

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 = "";
    }
}

In questo esempio di Microsoft® Visual Basic® .NET viene mostrato un gestore eventi per l'evento Click di un controllo Button, buttonSubmit_Click, che riconosce l'input penna nell'oggetto RecognizerContext, theRecognizerContext, dichiarato in un ambito contenitore. Nell'esempio viene quindi visualizzato l'oggetto RecognitionResult, theRecognitionResult in un controllo TextBox se non si verificano errori.

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

Piattaforme

Windows Vista

.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.