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

Obtient ou définit la liste de mots utilisée dans le processus de reconnaissance pour améliorer les résultats de la reconnaissance.

Cette propriété est en lecture/écriture.

Syntaxe

HRESULT get_WordList(
  IInkWordList **WordList
);

Paramètres

WordList

Valeur de retour

None

Remarques

La définition de cette propriété réussit uniquement si la propriété Strokes a la valeur NULL. Vous devez définir la propriété WordList avant d’attacher une collection InkStrokes à la propriété Strokes de inkRecognizerContext ou vous devez définir la propriété Strokes sur NULL , puis définir la propriété WordList (et éventuellement rattacher la collection InkStrokes).

Pour supprimer la liste de mots actuelle et utiliser le dictionnaire utilisateur, définissez cette propriété sur NULL. Toute modification ultérieure de l’objet InkWordList ne modifie pas le résultat de la reconnaissance. Si vous souhaitez modifier la liste de mots, définissez d’abord cette propriété sur NULL, modifiez inkWordList, puis attachez-la à nouveau à InkRecognizerContext en l’affectant à la propriété WordList .

Utilisez la propriété Factoid pour limiter la recherche à la liste de mots associée au contexte. Vous devrez peut-être également définir la propriété RecognitionFlags pour améliorer les résultats.

Wordlist ne peut pas être défini après la définition d’un factoid. Cela empêche un factoid de faire référence à une liste de mots potentiellement inexistante. Si vous tentez de le faire, une valeur HRESULT E_FAIL est E_FAIL.

Si une chaîne est ajoutée à une liste de mots, ses versions en majuscules sont également implicitement ajoutées. Pour instance, l’ajout de « hello » ajoute implicitement « Hello » et « HELLO ».

L’utilisation de mots de plus de 256 caractères entraîne une exception E_POINTER lors de l’affectation de la propriété WordList à InkRecognizerContext.

Configuration requise

Voir aussi

IInkRecognizerContext

InkRecognizerContext, classe

Classe InkWordList