GetCharABCWidthsFloatA, fonction (wingdi.h)

Article
11/20/2024

La fonction GetCharABCWidthsFloat récupère les largeurs, en unités logiques, de caractères consécutifs dans une plage spécifiée à partir de la police actuelle.

Syntaxe

BOOL GetCharABCWidthsFloatA(
  [in]  HDC        hdc,
  [in]  UINT       iFirst,
  [in]  UINT       iLast,
  [out] LPABCFLOAT lpABC
);

Paramètres

[in] hdc

Gérez le contexte de l’appareil.

[in] iFirst

Spécifie le point de code du premier caractère dans le groupe de caractères consécutifs où les largeurs ABC sont recherchés.

[in] iLast

Spécifie le point de code du dernier caractère dans le groupe de caractères consécutifs où les largeurs ABC sont recherchés. Cette plage est inclusive. Une erreur est retournée si le dernier caractère spécifié précède le premier caractère spécifié.

[out] lpABC

Pointeur vers un tableau de structures ABCFLOAT qui reçoit les largeurs de caractères, en unités logiques.

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

Contrairement à la fonction GetCharABCWidths qui retourne des largeurs uniquement pour les polices TrueType, la fonction GetCharABCWidthsFloat récupère des largeurs pour n’importe quelle police. Les largeurs retournées par cette fonction sont au format à virgule flottante IEEE.

Si la transformation mondiale-à-appareil actuelle n’est pas identifiée, les largeurs retournées peuvent être des valeurs non-integer, même si les valeurs correspondantes dans l’espace de l’appareil sont des entiers.

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.

Les espaces ABC sont mesurés le long de la ligne de base de caractères de la police sélectionnée.

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.

Note

L’en-tête wingdi.h définit GetCharABCWidthsFloat 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