GdipGetEmHeight()



Syntaxe
Resultat.i = GdipGetEmHeight(*family, style.l, @EmHeight.i)
Paramètres
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.

EmHeight.i

[out] EmHeight recevra la valeur de la hauteur du carré cadratin de la FontFamily en unités de création.

Description

Cette fonction permet d'obtenir la taille em ou hauteur em de la FontFamily pour le style spécifié, dans les unités utilisées lors de la création de la FontFamily. La hauteur em est la hauteur du carré cadratin.

Le carré cadratin est un terme typographique qui fait référence au rectangle occupé par la lettre la plus large de la police, traditionnellement la lettre M.

Cette valeur permet de convertir dans l'unité d'une Font particulière, la valeur ascendante de la matrice (voir fonction GdipGetCellAscent()), la valeur descendante de la matrice (voir fonction GdipGetCellDescent()) et la valeur de l'interligne (voir fonction GdipGetLineSpacing()).

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.

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