IInkRecognizerContext ::BackgroundRecognize, méthode (msinkaut.h)

Provoque la reconnaissance de l’objet IInkRecognizer pour reconnaître la collection de traits associés et déclencher un événement de reconnaissance lorsque la reconnaissance est 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 renvoyée

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

Code de retour Description
S_OK
Opération réussie.
E_OUTOFMEMORY
Impossible d’allouer de la mémoire pour terminer l’opération.
E_INK_NO_STROKES_TO_RECOGNIZE
Aucun trait n’existe.
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 façon synchrone, appelez la méthode Recognize .

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

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

Exigences

Prérequis Valeur
Client minimum requis Windows XP Tablet PC Edition [applications de bureau uniquement]
Serveur minimal pris en charge Aucun pris en charge
plateforme cible Windows
En-tête msinkaut.h

Voir également

BackgroundRecognizeWithAlternates, méthode

Data, propriété

IInkRecognitionAlternate, interface

IInkRecognizerContext

InkRecognizerContext, classe