GdipGetCellDescent()

Resultat.i = GdipGetCellDescent(*family, style.l, @CellDescent.i)

*family

[in] Pointeur sur un objet FontFamily existant.

style.l

[in] Nombre entier spécifie le style de la police de caractères. Cette valeur doit être un élément de l'énumération FontStyle ou bien être une combinaison (OU) de deux ou plus de ces éléments. Par exemple : #FontStyleBold | #FontStyleUnderline | #FontStyleStrikeout définit le style comme une combinaison des ces trois styles.

CellDescent.i

[out] CellDescent recevra la valeur de ligne descendante de la matrice de la FontFamily en unités de création.

Cette fonction permet d'obtenir la ligne descendante 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 descendante de la matrice (nommée Descent sur la figure).Le nombre retourné par cette fonction (paramètre CellDescent) 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 GdipGetCellAscent() permet de retrouver la ligne ascendante de la matrice (nommée Ascent 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 Descent) :

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.

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.

PureBasic v4.30 bêta 4 (Windows - x86)
Testé avec Windows Vista édition familiale Premium