Fonction ScriptSubstituteSingleGlyph (usp10.h)

Article
03/03/2024

Permet la substitution d’un glyphe unique par une autre forme du même glyphe pour le traitement OpenType.

Syntaxe

HRESULT ScriptSubstituteSingleGlyph(
  [in, optional] HDC             hdc,
  [in, out]      SCRIPT_CACHE    *psc,
  [in, optional] SCRIPT_ANALYSIS *psa,
  [in]           OPENTYPE_TAG    tagScript,
  [in]           OPENTYPE_TAG    tagLangSys,
  [in]           OPENTYPE_TAG    tagFeature,
  [in]           LONG            lParameter,
  [in]           WORD            wGlyphId,
  [out]          WORD            *pwOutGlyphId
);

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 indiquant 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 le glyphe de remplacement approprié soit utilisé.

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 la mise en forme.

[in] tagLangSys

Structure OPENTYPE_TAG définissant la balise de langue pour la mise en forme.

[in] tagFeature

Structure OPENTYPE_TAG définissant la balise de fonctionnalité à utiliser pour la mise en forme du glyphe de remplacement.

[in] lParameter

Référence au glyphe de remplacement à remplacer. Cette référence est un index d’un tableau qui contient tous les glyphes alternatifs définis dans la fonctionnalité, comme illustré pour OPENTYPE_FEATURE_RECORD. Le tableau de glyphes alternatifs est l’un des éléments récupérés par ScriptGetFontAlternateGlyphes.

[in] wGlyphId

Identificateur du glyphe d’origine.

[out] pwOutGlyphId

Pointeur vers l’emplacement où cette fonction récupère l’identificateur du glyphe de remplacement.

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 utilise une substitution un-à-un dans laquelle l’application peut remplacer un glyphe par une autre forme. Le plus souvent, les applications utilisent cette fonction pour définir une puce ou un autre glyphe au début ou à la fin d’une ligne.

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 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