GetCharABCWidthsA, fonction (wingdi.h)

Article
11/20/2024

La fonction GetCharABCWidths récupère les largeurs, en unités logiques, de caractères 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 GetCharABCWidthsA(
  [in]  HDC   hdc,
  [in]  UINT  wFirst,
  [in]  UINT  wLast,
  [out] LPABC lpABC
);

Paramètres

[in] hdc

Handle vers le contexte de l’appareil.

[in] wFirst

Premier caractère du groupe de caractères consécutifs de la police actuelle.

[in] wLast

Dernier caractère du groupe de caractères consécutifs de la police actuelle.

[out] lpABC

Pointeur vers un tableau de structures ABC qui reçoivent les largeurs de caractères, en unités logiques. Ce tableau doit contenir au moins autant de structures ABC qu’il existe des caractères dans la plage spécifiée par les paramètres uFirstChar et uLastChar.

Valeur de retour

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 de 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 GetCharABCWidths récupère des largeurs A ou C négatives pour un caractère, ce caractère inclut des sous-bords ou des surplombs.

Pour convertir les largeurs ABC en unités de conception de police, une application doit utiliser la valeur stockée dans l'otmEMSquare membre 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 de caractères dans les polices non TrueType, les applications doivent utiliser la fonction GetCharWidth.

Note

L’en-tête wingdi.h définit GetCharABCWidths comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	wingdi.h (include Windows.h)
bibliothèque	Gdi32.lib
DLL	Gdi32.dll