Fonction ScriptApplyLogicalWidth (usp10.h)

Article
03/03/2024

Prend un tableau de largeurs avancées pour une exécution et génère un tableau de largeurs de glyphes avancées ajustées.

Syntaxe

HRESULT ScriptApplyLogicalWidth(
  [in]                const int             *piDx,
  [in]                int                   cChars,
  [in]                int                   cGlyphs,
  [in]                const WORD            *pwLogClust,
  [in]                const SCRIPT_VISATTR  *psva,
  [in]                const int             *piAdvance,
  [in]                const SCRIPT_ANALYSIS *psa,
  [in, out, optional] ABC                   *pABC,
  [out]               int                   *piJustify
);

Paramètres

[in] piDx

Pointeur vers un tableau de largeurs avancées dans l’ordre logique, une par point de code.

[in] cChars

Nombre de points de code logique dans l’exécution.

[in] cGlyphs

Nombre de glyphes.

[in] pwLogClust

Pointeur vers un tableau de clusters logiques de ScriptShape.

[in] psva

Pointeur vers une structure SCRIPT_VISATTR à partir de ScriptShape et mise à jour par ScriptPlace.

[in] piAdvance

Pointeur vers un tableau de largeurs d’avance de glyphes à partir de ScriptPlace.

[in] psa

Pointeur vers une structure SCRIPT_ANALYSIS à partir de ScriptItemize et mise à jour par ScriptShape et ScriptPlace.

[in, out, optional] pABC

Pointeur vers la largeur ABC globale d’une exécution. En entrée, le paramètre doit contenir les largeurs ABC d’exécution récupérées par ScriptPlace. Sur la sortie, le paramètre indique la largeur ABC mise à jour pour correspondre aux nouvelles largeurs.

[out] piJustify

Pointeur vers un tableau dans lequel la fonction récupère les largeurs d’avance du glyphe. Ce tableau convient pour passer au paramètre piJustify de ScriptTextOut.

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 .

Remarques

Cette fonction peut être utilisée pour réappliquer des largeurs logiques obtenues avec ScriptGetLogicalWidths. Il peut être utile dans des situations telles que le métafilage, pour lequel les informations préalables sur la largeur doivent être enregistrées et réappliquées de manière indépendante de la police, indépendamment des substitutions de glyphes, telles que la ligaturisation.

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

Condition requise	Valeur
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
Composant redistribuable	Internet Explorer 5 ou version ultérieure sur Windows Me/98/95