Fonction ScriptRecordDigitSubstitution (usp10.h)

Article
08/26/2023

Lit les paramètres de substitution de chiffres natifs et de chiffres NLS (National Language Support) et les enregistre dans une structure de SCRIPT_DIGITSUBSTITUTE . Pour plus d’informations, consultez Formes de chiffres.

Syntaxe

HRESULT ScriptRecordDigitSubstitution(
  [in]  LCID                   Locale,
  [out] SCRIPT_DIGITSUBSTITUTE *psds
);

Paramètres

[in] Locale

Identificateur des paramètres régionaux à interroger. En règle générale, l’application doit définir ce paramètre sur LOCALE_USER_DEFAULT. Le paramètre peut également indiquer des paramètres régionaux spécifiques associés à LOCALE_NOUSEROVERRIDE pour obtenir les paramètres par défaut.

[out] psds

Pointeur vers une structure SCRIPT_DIGITSUBSTITUTE . Cette structure peut être passée ultérieurement à ScriptApplyDigitSubstitution.

Valeur retournée

Retourne S_OK en cas de réussite. La fonction retourne une valeur HRESULT différente de zéro si elle ne réussit pas.

Les retours d’erreur incluent :

E_INVALIDARG. Le paramètre Paramètres régionaux indique des paramètres régionaux non valides ou non installés.
E_POINTER. Le paramètre psds est défini sur NULL.

Remarques

Consultez Affichage de texte avec uniscribe pour une présentation du contexte dans lequel cette fonction est normalement appelée.

Cette fonction prend en charge la substitution de chiffres de contexte uniquement pour les paramètres régionaux arabes et persans. Pour les autres paramètres régionaux, la substitution de chiffres de contexte n’est mappée à aucune substitution.

L’exemple suivant montre la façon classique d’appeler cette fonction.

SCRIPT_DIGITSUBSTITUTE sds;
ScriptRecordDigitSubstitution(LOCALE_USER_DEFAULT, &sds);

À chaque itemisation, l’application peut utiliser les résultats comme indiqué dans l’exemple suivant.

SCRIPT_CONTROL sc = {0};
SCRIPT_STATE   ss = {0};
ScriptApplyDigitSubstitution(&sds, &sc, &ss);

Pour des raisons de performances, votre application ne doit pas appeler fréquemment ScriptRecordDigitSubstitution . La fonction nécessite une surcharge considérable pour l’appeler chaque fois que ScriptItemize ou ScriptStringAnalyse est appelé. Au lieu de cela, l’application peut enregistrer la structure SCRIPT_DIGITSUBSTITUTE et la mettre à jour uniquement lorsqu’un message WM_SETTINGCHANGE est reçu. L’application peut également mettre à jour la structure lorsqu’un appel RegNotifyChangeKeyValue dans un thread dédié indique une modification dans le registre sous HKCU\Panneau de configuration\International.

Important À compter de Windows 8 : pour conserver la possibilité de s’exécuter sur Windows 7, un module qui utilise Uniscribe doit spécifier Usp10.lib avant gdi32.lib dans sa liste de bibliothèques.

Configuration requise


Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	usp10.h
Bibliothèque	Usp10.lib
DLL	Usp10.dll