GdipGetFontHeight()



Syntaxe
Resultat.i = GdipGetFontHeight(*font, *graphics, @height.f)
Paramètres
*font

[in] Pointeur sur un objet Font.

*graphics

[in] Pointeur sur un objet graphics.

height.f

[out] height recevra la hauteur de la font dans l'unité courante du graphique spécifié.

Description

Cette fonction permet d'obtenir la taille de l'interligne de la police dans l'unité courante du graphique spécifié. L'interligne est la distance verticale entre les lignes de base de deux lignes consécutives de texte. L'interligne inclut l'espace vide entre les lignes avec la hauteur du caractère lui-même.

Le croquis suivant (documentation MS) montre ce que représente l'interligne (nommée Line spacing sur la figure).

Si l'unité de la police est différente du pixel (#UnitPixel), la hauteur en pixels est calculée en utilisant la résolution verticale du graphique indiqué.

Exemple :
Si l'unité de la police est en pouces (inches) et que la taille de la police est de 0,3. En supposant aussi que pour la famille de police correspondante, la hauteur Em est 2048 (GdipGetEmHeight()) et l'interligne est 2355 (GdipGetLineSpacing()).
Si l'unité du graphique est #UnitPixel et que la résolution verticale du graphique est de 96 points par pouce, la hauteur est calculée comme ceci :

2355*(0,3/2048)*96 = 33,1171875 pixels

Avec le même exemple, si l'unité du graphique est le millimètre (#UnitMillimeter, alors la hauteur en millimètres est calculée comme ceci (1 pouce = 25,4 millimètres) :

2355*(0,3/2048)*25,4 = 8,762256 millimètres

L'exemple reprend les valeurs précédentes et affiche les résultats sur l'écran.

Résultat de la fonction
Si la fonction réussit, elle retourne #Ok qui est une constante de l'énumération status.
Si la fonction échoue, elle retourne une des autres valeurs de l'énumération status.
PB - OS
PureBasic v4.30 bêta 4 (Windows - x86)
Testé avec Windows Vista édition familiale Premium