Partager via


Méthode IInkRecognizerContext ::BackgroundRecognize (msinkaut.h)

Fait que l’objet IInkRecognizer reconnaît la collection de traits associée et déclenche un événement de reconnaissance une fois la reconnaissance terminée.

Syntaxe

HRESULT BackgroundRecognize(
  [in, optional] VARIANT CustomData
);

Paramètres

[in, optional] CustomData

Spécifie toutes les données définies par l’application qui sont disponibles pour l’application dans l’événement Reconnaissance . Ce paramètre peut être un VARIANT de type VT_EMPTY ou VT_NULL si aucune donnée ne doit être transmise. La valeur par défaut est NULL.

Pour plus d’informations sur la structure VARIANT, consultez Utilisation de la bibliothèque COM.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Code de retour Description
S_OK
Réussite.
E_OUTOFMEMORY
Impossible d’allouer de la mémoire pour terminer l’opération.
E_INK_NO_STROKES_TO_RECOGNIZE
Il n’existe aucun trait.
E_INK_EXCEPTION
Une exception s’est produite à l’intérieur de la méthode.

Remarques

Cette méthode spécifie que la reconnaissance manuscrite est effectuée de manière asynchrone. Pour reconnaître l’encre de manière synchrone, appelez la méthode Recognize .

Cette méthode reconnaît uniquement la meilleure chaîne de résultat. Les alternatives ne sont pas créées. Pour effectuer une reconnaissance qui crée une liste d’alternatives disponibles, appelez la méthode BackgroundRecognizeWithAlternates .

L’événement Reconnaissance n’est pas déclenché si le module de reconnaissance ne reconnaît rien.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP Édition Tablet PC [applications de bureau uniquement]
Serveur minimal pris en charge Aucun pris en charge
Plateforme cible Windows
En-tête msinkaut.h
Bibliothèque InkObj.dll

Voir aussi

BackgroundRecognizeWithAlternates, méthode

Data, propriété

IInkRecognitionAlternate, interface

IInkRecognizerContext

InkRecognizerContext, classe