GetCharABCWidthsI, fonction (wingdi.h)

Article
08/27/2023

La fonction GetCharABCWidthsI récupère les largeurs, en unités logiques, des index de glyphes consécutifs dans une plage spécifiée à partir de la police TrueType actuelle. Cette fonction réussit uniquement avec les polices TrueType.

Syntaxe

BOOL GetCharABCWidthsI(
  [in]  HDC    hdc,
  [in]  UINT   giFirst,
  [in]  UINT   cgi,
  [in]  LPWORD pgi,
  [out] LPABC  pabc
);

Paramètres

[in] hdc

Handle pour le contexte de l’appareil.

[in] giFirst

Premier index de glyphe dans le groupe d’index de glyphes consécutifs de la police actuelle. Ce paramètre est utilisé uniquement si le paramètre pgi a la valeur NULL.

[in] cgi

Nombre d’index de glyphes.

[in] pgi

Pointeur vers un tableau qui contient des index de glyphes. Si ce paramètre a la valeur NULL, le paramètre giFirst est utilisé à la place. Le paramètre cgi spécifie le nombre d’index de glyphes dans ce tableau.

[out] pabc

Pointeur vers un tableau de structures ABC qui reçoit les largeurs de caractères, en unités logiques. Ce tableau doit contenir au moins autant de structures ABC que d’index de glyphes spécifiés par le paramètre cgi .

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro.

Remarques

Le rastériseur TrueType fournit un espacement des caractères ABC une fois qu’une taille de point spécifique a été sélectionnée. Un espacement est la distance ajoutée à la position actuelle avant de placer le glyphe. L’espacement B est la largeur de la partie noire du glyphe. L’espacement C est la distance ajoutée à la position actuelle pour fournir un espace blanc à droite du glyphe. La largeur avancée totale est spécifiée par A+B+C.

Lorsque la fonction GetCharABCWidthsI récupère des largeurs A ou C négatives pour un caractère, ce caractère inclut des sous-hauteurs ou des surplombs.

Pour convertir les largeurs ABC en unités de conception de police, une application doit utiliser la valeur stockée dans le membre otmEMSquare d’une structure OUTLINETEXTMETRIC . Cette valeur peut être récupérée en appelant la fonction GetOutlineTextMetrics .

Les largeurs ABC du caractère par défaut sont utilisées pour les caractères en dehors de la plage de la police actuellement sélectionnée.

Pour récupérer les largeurs des index de glyphes dans des polices non TrueType, les applications doivent utiliser la fonction GetCharWidthI .

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	wingdi.h (inclure Windows.h)
Bibliothèque	Gdi32.lib
DLL	Gdi32.dll