RecognizerContext.EndInkInput, méthode

Article
11/05/2008

Mise à jour : November 2007

Termine l'entrée manuscrite dans l'objet RecognizerContext.

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

Syntaxe

'Déclaration
Public Sub EndInkInput
'Utilisation
Dim instance As RecognizerContext

instance.EndInkInput()

public void EndInkInput()

public:
void EndInkInput()

public void EndInkInput()

public function EndInkInput()

Notes

Après avoir appelé cette méthode, vous ne pouvez pas ajouter d'objets Stroke à l'objet RecognizerContext.

La reconnaissance partielle définit la capacité du module de reconnaissance à retourner des résultats même si l'application n'a pas appelé la méthode EndInkInput, qui signale à l'application que l'entrée manuscrite est terminée. La reconnaissance partielle ne s'effectue que si le module de reconnaissance peut déterminer que l'entrée manuscrite est entrée avant un appel à EndInkInput. Tous les modules de reconnaissance ne prennent pas en charge cette fonctionnalité. Les modules de reconnaissance qui ne prennent pas en charge la reconnaissance partielle ne retournent pas de résultats avant l'appel à EndInkInput.

La reconnaissance incrémentielle définit la capacité du module de reconnaissance à traiter uniquement une petite partie de l'entrée manuscrite passée et à retourner un résultat. Prenons l'exemple d'une application qui contient cinq lignes d'entrées manuscrites et qui utilise un module de reconnaissance du script latin. Le module de reconnaissance ne peut traiter qu'une seule ligne à la fois et retourner un résultat. Ce processus est utilisé dans la boucle inactive du thread de traitement d'arrière-plan.

Si le module de reconnaissance prend en charge la reconnaissance partielle, il peut retourner un résultat même si la méthode EndInkInput n'a pas été appelée.

Remarque :
Les résultats dérivés d'une reconnaissance partielle peuvent être différents des résultats obtenus en appelant EndInkInput. Avec la reconnaissance partielle, il n'est pas nécessaire que le module de reconnaissance retourne des résultats pour l'ensemble de l'entrée manuscrite. La perte du contexte d'une partie de l'entrée manuscrite peut avoir un impact négatif sur la reconnaissance.

Remarque :
Dans Windows Vista et les versions ultérieures, cette méthode est désapprouvée pour les modules de reconnaissance de langues occidentales.

Exemples

Cet exemple C# présente un gestionnaire d'événements pour un événement Click d'un contrôle bouton, buttonSubmit_Click, qui reconnaît l'écriture manuscrite valide dans la collection Strokes assignée au RecognizerContext, theRecognizerContext, (déclaré dans une portée) et l'affiche dans une zone de texte si aucune erreur n'est générée.

private void buttonSubmit_Click(object sender, System.EventArgs e)
{
    theRecognizerContext.EndInkInput();
    RecognitionStatus theRecognitionStatus;
    theRecognitionResult = theRecognizerContext.Recognize(out theRecognitionStatus);
    if (RecognitionStatus.NoError == theRecognitionStatus)
        theTextBox.Text = theRecognitionResult.TopString;
    else
        // Handle the error cases here...
        theTextBox.Text = "";
}

Cet exemple Microsoft Visual Basic® .NET présente un gestionnaire d'événements pour un événement Click d'un contrôle bouton, buttonSubmit_Click, qui reconnaît l'écriture manuscrite valide dans la collection Strokes assignée au RecognizerContext, theRecognizerContext, (déclaré dans une portée) et l'affiche dans une zone de texte si aucune erreur n'est générée.

Private Sub Button1_Click( _
ByVal sender As System.Object, _
ByVal e As System.EventArgs) Handles Button1.Click
    theRecognizerContext.EndInkInput()
    Dim theRecognitionStatus As RecognitionStatus
    theRecognitionResult = theRecognizerContext.Recognize(theRecognitionStatus)
    If RecognitionStatus.NoError = theRecognitionStatus Then
        RichTextBox1.Text = theRecognitionResult.TopString
    Else
        'Handle the error conditions here.
        RichTextBox1.Text = ""
    End If
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.

Informations de version

.NET Framework

Pris en charge dans : 3.0

Voir aussi

Référence

RecognizerContext, classe

Membres RecognizerContext

Microsoft.Ink, espace de noms

Partager via