Interface IInkRecognitionResult (msinkaut.h)

Article
02/29/2024

Représente le résultat de la reconnaissance. Les résultats de la reconnaissance de l’entrée manuscrite sont retournés dans un objet IInkRecognitionResult .

Héritage

L’interface IInkRecognitionResult hérite de l’interface IUnknown . IInkRecognitionResult possède également les types de membres suivants :

Méthodes

L’interface IInkRecognitionResult possède ces méthodes.


IInkRecognitionResult ::get_Strokes Obtient la collection de traits contenus dans un objet ou utilisés pour créer un objet. (IInkRecognitionResult.get_Strokes)
IInkRecognitionResult ::get_TopAlternate Obtient l’alternative supérieure du résultat de reconnaissance. (IInkRecognitionResult.get_TopAlternate)
IInkRecognitionResult ::get_TopConfidence Obtient l’alternative supérieure du résultat de reconnaissance. (IInkRecognitionResult.get_TopConfidence)
IInkRecognitionResult ::get_TopString Obtient le texte de résultat de la propriété TopAlternate.
IInkRecognitionResult ::ModifyTopAlternate Modifie l’alternative supérieure d’un résultat de reconnaissance à l’aide de l’alternative spécifiée.
IInkRecognitionResult ::SetResultOnStrokes Affecte les résultats de reconnaissance aux traits qui ont été utilisés pour créer les résultats.

Remarques

Les objets IInkRecognitionAlternate , ou autres, sont créés à partir du résultat. La meilleure alternative, ou supérieure, est celle qui est utilisée par défaut dans le résultat. Toutefois, vous pouvez utiliser les méthodes de l’objet IInkRecognitionResult pour spécifier les alternatives à utiliser dans le résultat.

Les performances système peuvent être affectées si les résultats de la reconnaissance sont automatiquement attribués à chaque collection de traits. Par conséquent, par défaut, les résultats ne sont pas attachés à une collection de traits. Vous devez appeler la méthode SetResultOnStrokes pour affecter des résultats à une collection de traits.

La seule façon de conserver les résultats de la reconnaissance consiste à appeler SetResultOnStrokes , puis à ajouter cette collection de traits à la collection CustomStrokes sur l’objet InkDisp .

Tous les éléments de reconnaissance ne définissent pas la propriété TopConfidence . Lorsqu’une application tente d’accéder à une propriété qui n’est pas définie par le module de reconnaissance, une exception d’argument est levée.

Si vous définissez une classe qui implémente cette interface, la nouvelle classe n’interagira pas correctement avec les API de programmation d’application Tablet PC.

Note Les différents éléments de reconnaissance d’écriture manuscrite expédiés par Microsoft en caractères latins et en langues d’Asie de l’Est peuvent parfois produire la valeur Unicode 0xFFFF comme résultat de reconnaissance. Cela se produit lorsque le module de reconnaissance ne parvient pas à faire correspondre un morceau d’encre avec un caractère valide. Le point de code 0xFFFF est valide UCS-2, mais n’est pas autorisé dans UTF-8. Une application qui convertit les résultats de reconnaissance en UTF-8 doit remplacer 0xFFFF par un autre point de code, par exemple, 0xFFFD.

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