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