Partager via


GetUnicodeRanges, fonction (recapis.h)

Retourne les plages de points Unicode pris en charge par le module de reconnaissance.

Syntaxe

HRESULT GetUnicodeRanges(
  HRECOGNIZER     hrec,
  ULONG           *pcRanges,
  CHARACTER_RANGE *pcr
);

Paramètres

hrec

Gérez le module de reconnaissance.

pcRanges

Lors de l’entrée, le nombre de plages que la mémoire tampon de pcr peut contenir. En sortie, le nombre de plages que contient la mémoire tampon de pcr .

pcr

Tableau de structures CHARACTER_RANGE . Chaque structure contient une plage de points Unicode pris en charge par le module de reconnaissance. L’ordre du tableau est arbitraire. Pour déterminer la taille requise de la mémoire tampon, affectez la valeur NULL à l’élément pcr ; utilisez le nombre de plages pour allouer la mémoire tampon de pcr.

Valeur retournée

Cette fonction peut retourner l’une de ces valeurs.

Code de retour Descriptif
S_OK
Opération réussie.
E_POINTER
L’un des paramètres est un pointeur non valide.
TPC_E_INSUFFICIENT_BUFFER
La mémoire tampon de pcr est trop petite.
E_FAIL
Une erreur non spécifiée s’est produite.
E_INVALIDARG
Un argument non valide a été reçu.
E_OUTOFMEMORY
Mémoire insuffisante.

Remarques

Cette fonction est facultative.

Certains modules de reconnaissance ne prennent pas en charge cette fonctionnalité, mais peuvent toujours inclure la fonction GetUnicodeRanges Function . Pour ces modules de reconnaissance, la fonction GetUnicodeRanges retourne E_NOTIMPL.

Pour contrôler les plages Unicode utilisées par un contexte de module de reconnaissance spécifique, utilisez les fonctions GetEnabledUnicodeRanges et SetEnabledUnicodeRanges . Ces plages sont contraintes d’être un sous-ensemble des plages retournées par GetUnicodeRanges.

Les modules de reconnaissance de mouvements Microsoft utilisent des caractères Unicode de 0xF000 pour 0xF0FF. Chaque valeur Unicode unique de cette plage représente un seul mouvement. Pour obtenir la liste complète des valeurs Unicode pour les mouvements, consultez Valeurs de plage Unicode des mouvements.

Spécifications

Requirement Valeur
Client minimum requis Windows XP Tablet PC Edition [applications de bureau | Applications UWP]
Serveur minimal pris en charge Aucun pris en charge
plateforme cible Fenêtres
Header recapis.h
Library inkobjcore.lib
DLL inkobjcore.dll

Voir aussi

GetEnabledUnicodeRanges, fonction

SetEnabledUnicodeRanges, fonction