Fonction GetCharABCWidthsFloatW (wingdi.h)

Article
08/27/2023

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

Syntaxe

BOOL GetCharABCWidthsFloatW(
  [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 du groupe de caractères consécutifs où les largeurs ABC sont recherchées.

[in] iLast

Spécifie le point de code du dernier caractère du groupe de caractères consécutifs où les largeurs ABC sont recherchées. 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 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

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

Si la transformation monde-appareil actuelle n’est pas identifiée, les largeurs retournées peuvent être des valeurs non entrantes, 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 correspond à 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.

Notes

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

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