Fonction ScriptGetFontLanguageTags (usp10.h)

Article
08/26/2023

Récupère une liste de balises de langue disponibles pour l’élément spécifié et prises en charge par une balise de script spécifiée pour le traitement OpenType. Les balises qui composent la liste sont récupérées à partir de la police dans le cache ou le contexte d’appareil spécifié.

Syntaxe

HRESULT ScriptGetFontLanguageTags(
  [in, optional] HDC             hdc,
  [in, out]      SCRIPT_CACHE    *psc,
  [in, optional] SCRIPT_ANALYSIS *psa,
  [in]           OPENTYPE_TAG    tagScript,
  [in]           int             cMaxTags,
  [out]          OPENTYPE_TAG    *pLangsysTags,
  [out]          int             *pcTags
);

Paramètres

[in, optional] hdc

Gérez le contexte de l’appareil. Pour plus d’informations, consultez Mise en cache.

[in, out] psc

Pointeur vers une structure SCRIPT_CACHE identifiant le cache de script.

[in, optional] psa

Pointeur vers une structure SCRIPT_ANALYSIS obtenue à partir d’un appel précédent à ScriptItemizeOpenType. Ce paramètre identifie le moteur de mise en forme, afin que les balises de langue de police pour la police et les scripts appropriés puissent être récupérées.

L’application peut également définir ce paramètre sur NULL pour récupérer des résultats non filtrés.

[in] tagScript

Structure OPENTYPE_TAG définissant la balise de script pour laquelle la liste des balises de langue associées est demandée.

[in] cMaxTags

Longueur du tableau spécifiée par pLangSysTags.

[out] pLangsysTags

Pointeur vers une mémoire tampon dans laquelle cette fonction récupère un tableau de structures OPENTYPE_TAG identifiant les balises de langage correspondant aux critères d’entrée.

[out] pcTags

Pointeur vers le nombre d’éléments dans le tableau de balises de langage.

Valeur retournée

Retourne 0 en cas de réussite. La fonction retourne une valeur HRESULT différente de zéro si elle ne réussit pas. L’application peut tester la valeur de retour avec les macros SUCCEEDED et FAILED .

Si le nombre de balises correspondantes dépasse cMaxTags, la fonction échoue avec E_OUTOFMEMORY. L’application peut réessayer d’appeler avec des mémoires tampons plus volumineuses.

Remarques

Bien qu’elle soit formellement déclarée en tant que type ULONG, la structure OPENTYPE_TAG contient un tableau de 4 octets qui contient quatre valeurs ASCII 8 bits d’espace, A-Z ou a-z. Par exemple, les balises de langue pour le roumain, l’ourdou et le persan sont respectivement « ROM », « URD » et « FAR ». Notez que chaque balise se termine par un espace.

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 Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	usp10.h
Bibliothèque	Usp10.lib
DLL	Usp10.dll
Composant redistribuable	Usp10.dll version 1.600 ou ultérieure sur Windows XP