Fonction AdviseInkChange (recapis.h)

Empêche le module de reconnaissance de traiter l’entrée manuscrite, car un trait a été ajouté ou supprimé.

Syntaxe

HRESULT AdviseInkChange(
  HRECOCONTEXT hrc,
  BOOL         bNewStroke
);

Paramètres

hrc

Handle du contexte de l’outil de reconnaissance.

bNewStroke

TRUE si vous ajoutez un nouveau trait. Définissez la valeur FALSE si les traits ont été effacés, fractionnés, fusionnés, extraits ou supprimés de l’objet Ink.

Valeur retournée

Cette fonction peut retourner l’une de ces valeurs.

Remarques

La fonction AdviseInkChange signale qu’il y aura des appels supplémentaires à la fonction AddStroke . Cela permet à toute reconnaissance déjà en cours de s’arrêter à n’importe quel point pratique. L’achèvement de la reconnaissance étant l’un de ces points, AdviseInkChange ne peut rien faire en toute sécurité.

Par exemple, si vous avez deux threads, un thread peut utiliser AddStroke et Process avec d’autres fonctions pour obtenir des résultats. L’autre thread peut être la collecte de l’encre, son écho et la mise en file d’attente des tâches pour le premier thread. Le deuxième thread appelle AdviseInkChange pour informer le module de reconnaissance d’une modification à venir. Cela permet au premier thread de revenir à l’appelant plus tôt que sans l’appel à AdviseInkChange. Le premier thread peut ensuite appeler à nouveau le module de reconnaissance avec plus d’encre.

Si vous définissez le paramètre bNewStroke sur FALSE parce qu’un trait a été modifié ou supprimé, vous devez également appeler la fonction ResetContext , puis appeler la fonction AddStroke pour ajouter les traits de l’objet InkDisp au contexte de reconnaissance. Cette opération est effectuée automatiquement si vous attachez le contexte de reconnaissance à l’objet InkDisp .

Configuration requise