Fonction GetEnabledUnicodeRanges (recapis.h)

Récupère une liste de plages de points Unicode activées sur le contexte. Si vous n’appelez pas la fonction SetEnabledUnicodeRanges pour spécifier les plages activées, cette fonction retourne les plages de points Unicode par défaut du module de reconnaissance.

Syntaxe

HRESULT GetEnabledUnicodeRanges(
  HRECOCONTEXT    hrc,
  ULONG           *pcRanges,
  CHARACTER_RANGE *pcr
);

Paramètres

hrc

Handle du contexte de l’outil de reconnaissance.

pcRanges

En entrée, le nombre de structures CHARACTER_RANGE que la mémoire tampon pcr peut contenir. Sur la sortie, le nombre de plages que contient la mémoire tampon pcr .

pcr

Tableau de structures CHARACTER_RANGE. Chaque structure contient une plage de points Unicode activés sur le contexte. L’ordre du tableau est arbitraire. Pour déterminer la taille de la mémoire tampon, définissez pcr sur NULL ; utilisez le nombre de plages pour allouer la mémoire tampon pcr .

Valeur retournée

Cette fonction peut retourner l’une de ces valeurs.

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

Remarques

Cette fonction est facultative.

Certains éléments de reconnaissance ne prennent pas en charge l’activation et la désactivation de points Unicode spécifiques, mais peuvent toujours inclure la fonction GetEnabledUnicodeRanges . Pour ces modules de reconnaissance, la fonction GetEnabledUnicodeRanges retourne les mêmes plages que la fonction GetUnicodeRanges .

Les reconnaissances de mouvements Microsoft utilisent des caractères Unicode de 0xF000 à 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.

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	recapis.h
DLL	inkobjcore.dll

Voir aussi

CHARACTER_RANGE Structure

GetUnicodeRanges, fonction

Fonction SetEnabledUnicodeRanges