Partager via


IInkLineInfo::GetCandidate, méthode (msinkaut.h)

Retourne une autre reconnaissance de la liste des résultats de la reconnaissance.

Syntaxe

HRESULT GetCandidate(
  [in]  UINT   nCandidateNum,
  [out] LPWSTR pwcRecogWord,
  [out] UINT   *pcwcRecogWord,
  [in]  DWORD  dwFlags
);

Paramètres

[in] nCandidateNum

Index de base zéro de l’autre entrée de liste à récupérer.

[out] pwcRecogWord

Mémoire tampon dans laquelle stocker l’autre reconnaissance sélectionnée. Si pwcRecogWord a la valeur NULL, la méthode ne tente pas de récupérer l’autre mot de reconnaissance.

[out] pcwcRecogWord

Transmet la longueur de la mémoire tampon pwcRecogWord en caractères Unicode et retourne le nombre de caractères Unicode qui ont été copiés dans la mémoire tampon.

[in] dwFlags

Non utilisé.

Valeur retournée

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

Code de retour Description
S_OK
S_OK
E_FAIL
L’index nCandidateNum est supérieur au nombre d’alternatives de reconnaissance.
ERROR_MORE_DATA
La mémoire tampon pwcRecogWord n’est pas assez grande pour accepter l’autre reconnaissance.

Notes

Si le paramètre pwcRecogWord a la valeur Null, la méthode n’essaie pas de récupérer le mot de substitution de reconnaissance, mais définit uniquement pwcRecogWord sur le nombre de caractères dans l’alternative de reconnaissance.

Si la mémoire tampon pwcRecogWord n’est pas assez grande pour contenir l’alternative de reconnaissance, la mémoire tampon pwcRecogWord est remplie avec le premier nombre de caractères pwcRecogWord de l’alternative de reconnaissance.

Spécifications

   
Client minimal pris en charge Windows XP Édition Tablette 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

IInkLineInfo

SetCandidate, méthode