Partager via


Méthode IInkStrokes ::ToString (msinkaut.h)

[ToString n’est plus disponible à partir de Windows Vista. Au lieu de cela, consultez la propriété String pour obtenir l’équivalent de cette méthode pour l’objet IInkRecognitionAlternate . ]

Le module de reconnaissance par défaut effectue la reconnaissance sur la collection de traits et retourne la chaîne supérieure de l’alternative supérieure du résultat de reconnaissance.

Syntaxe

HRESULT ToString(
  [out, retval] BSTR *ToString
);

Paramètres

[out, retval] ToString

Chaîne supérieure de la propriété TopAlternate de l’objet IInkRecognitionResult , une fois que le module de reconnaissance par défaut effectue la reconnaissance sur la collection de traits.

Pour plus d’informations sur le type de données BSTR , 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_POINTER
Un paramètre contenait un pointeur non valide.
E_FAIL
Échec de l’opération.
E_OUTOFMEMORY
Mémoire insuffisante.
E_INK_EXCEPTION
Une exception s’est produite à l’intérieur de la méthode.
TPC_E_RECOGNIZER_NOT_REGISTERED
Aucun module de reconnaissance n’est installé, la clé de Registre des recognizers est endommagée ou votre environnement ne prend pas en charge la reconnaissance de l’écriture manuscrite.

Remarques

ToString ne doit pas être utilisé pour les applications de reconnaissance d’écriture manuscrite ; il peut être utilisé à des fins de débogage.

ToString retourne NULL si :

  • La collection InkStrokes est vide.
  • Impossible de créer un module de reconnaissance par défaut.
  • Le module de reconnaissance par défaut ne prend pas en charge l’entrée gratuite.

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

IInkRecognizer Interface

IInkStrokes

InkStrokes Collection