IDWriteFontFace::GetGlyphIndices, méthode (dwrite.h)

  • Article

Retourne le mappage nominal des points de code Unicode UCS4 aux index de glyphes tels que définis par la table de police « CMAP ».

Syntaxe

HRESULT GetGlyphIndices(
  [in]  UINT32 const *codePoints,
        UINT32       codePointCount,
  [out] UINT16       *glyphIndices
);

Paramètres

[in] codePoints

Type : const UINT32*

Tableau de points de code USC4 à partir desquels obtenir des indices de glyphes nominaux. Le tableau doit être alloué et être en mesure de contenir le nombre d’éléments spécifié par codePointCount.

codePointCount

Type : UINT32

Nombre d’éléments dans le tableau codePoints .

[out] glyphIndices

Type : UINT16*

Lorsque cette méthode retourne, contient un pointeur vers un tableau d’index de glyphes nominaux remplis par cette fonction.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Notes

Notez que ce mappage est principalement fourni pour les moteurs de disposition de ligne basés sur l’API de police physique. En raison de la substitution de glyphe OpenType et de la substitution de caractères de disposition de ligne, la conversion nominale ne correspond pas toujours à la façon dont une chaîne Unicode est mappées aux index de glyphes lors du rendu à l’aide d’une police particulière. Notez également que les sélecteurs de variantes Unicode fournissent d’autres mappages de caractères à glyphes. Cet appel retourne toujours la variante par défaut.

Lorsque les caractères ne sont pas présents dans la police, cette méthode retourne l’index 0, qui est le glyphe non défini ou le glyphe « .notdef ». Si un caractère n’est pas dans une police, IDWriteFont::HasCharacter retourne false et GetUnicodeRanges ne le renvoie pas dans la plage.

Spécifications

   
Client minimal pris en charge Windows 7, Windows Vista avec SP2 et Mise à jour de plateforme pour Windows Vista [applications de bureau | Applications UWP]
Serveur minimal pris en charge Windows Server 2008 R2, Windows Server 2008 avec SP2 et Platform Update pour Windows Server 2008 [applications de bureau | Applications UWP]
Plateforme cible Windows
En-tête dwrite.h
Bibliothèque Dwrite.lib
DLL Dwrite.dll

Voir aussi

IDWriteFontFace