Cette fonction permet d'obtenir la ligne ascendante de la matrice de la FontFamily pour le style spécifié, dans les unités utilisées lors de la création de la FontFamily.
Le croquis suivant (documentation MS) montre ce que représente la ligne ascendante de la matrice (nommée Ascent sur la figure).
Le nombre retourné par cette fonction (paramètre CellAscent) est en unités qui sont celles utilisées lors de la création de la FontFamily, il est donc indépendant de la taille et unités d'une police particulière.
La fonction GdipGetCellDescent() permet de retrouver la ligne descendante de la matrice (nommée Descent sur la figure).
La fonction GdipGetLineSpacing() permet de retrouver l'interligne de la FontFamily (nommée Line spacing sur la figure).
La fonction GdipGetEmHeight() permet de retrouver l'interligne de la Font dans l'unité courante du graphique spécifié.
Microsoft donne la relation suivante entre les éléments :
Soit une police basée sur une FontFamily
'ARIAL' n'appartenant à aucune collection, ayant le style #FontStyleRegular
et une taille de 16 pixels.
les valeurs Ascent, Descent et l'interligne sont retrouvées en unités
d'origine.
La conversion en pixel est donnée comme ceci (exemple pour Ascent) :
Pour l'exemple cela donne (Font de 16 pixels) :
L'exemple du fichier affiche les valeurs Ascent, Descent, interligne et EmHeight pour la FontFamily Arial avec style régulier (#FontStyleRegular). Le code crée également une police (basée sur la FontFamily Arial) avec une taille de 16 pixels et affiche les mesures pour cette police particulière.
La chaîne affichée par la fonction GdipDrawDriverString() doit être au format unicode, quelque soit le mode du compilateur PureBasic.