RecognizerContext.Recognize, méthode

Article
11/05/2008

Mise à jour : November 2007

Retourne un objet RecognitionResult pour une collection Strokes.

Espace de noms : Microsoft.Ink
Assembly : Microsoft.Ink (dans Microsoft.Ink.dll)

Syntaxe

'Déclaration
Public Function Recognize ( _
    <OutAttribute> ByRef recognitionStatus As RecognitionStatus _
) As RecognitionResult
'Utilisation
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

Paramètres

recognitionStatus
Type : Microsoft.Ink.RecognitionStatus%
Membre de l'énumération RecognitionStatus qui indique si une erreur s'est produite pendant la reconnaissance et, le cas échéant, de quelle erreur il s'agit.

Valeur de retour

Type : Microsoft.Ink.RecognitionResult
Objet RecognitionResult pour une collection Strokes reconnue.

Notes

Cette méthode retourne null (Nothing dans Microsoft® Visual Basic® .NET) si le module de reconnaissance ne peut pas calculer de résultat pour la collection Strokes.

Remarque :
Vous devez utiliser un bloc try/catch lors de l'appel à la méthode Recognize car une exception est levée lorsque l'objet Ink ne contient pas de traits.

Cette méthode exécute la reconnaissance de façon synchrone. Pour démarrer la reconnaissance d'arrière-plan (ou asynchrone), appelez la méthode BackgroundRecognize ou BackgroundRecognizeWithAlternates.

Exemples

Cet exemple C# présente un gestionnaire d'événements pour un événement Click (page pouvant être en anglais) d'un contrôle Button (page pouvant être en anglais), buttonSubmit_Click, qui reconnaît l'écriture manuscrite dans son objet RecognizerContext, theRecognizerContext, déclaré dans une portée. L'exemple affiche ensuite l'objet RecognitionResult, theRecognitionResult dans un contrôle TextBox si aucune erreur ne s'est produite.

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

Cet exemple Microsoft® Visual Basic® .NET présente un gestionnaire d'événements pour un événement Click (page pouvant être en anglais) d'un contrôle Button (page pouvant être en anglais), buttonSubmit_Click, qui reconnaît l'écriture manuscrite dans son objet RecognizerContext, theRecognizerContext, déclaré dans une portée. L'exemple affiche ensuite l'objet RecognitionResult, theRecognitionResult dans un contrôle TextBox si aucune erreur ne s'est produite.

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

Plateformes

Windows Vista

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.