FontMetrics QML Type

Fournit des mesures pour une police donnée. Plus d'informations...

• Liste de tous les membres, y compris les membres hérités

Propriétés

• ascent : real
• averageCharacterWidth : real
• capitalHeight : real (since 6.9)
• descent : real
• font : font
• height : real
• leading : real
• lineSpacing : real
• lineWidth : real
• maximumCharacterWidth : real
• minimumLeftBearing : real
• minimumRightBearing : real
• overlinePosition : real
• strikeOutPosition : real
• underlinePosition : real
• xHeight : real

Méthodes

• real advanceWidth(string text)
• rect boundingRect(string text)
• string elidedText(string text, enumeration mode, real width, int flags)
• rect tightBoundingRect(string text)

Description détaillée

FontMetrics calcule la taille des caractères et des chaînes de caractères pour une police donnée.

Il fournit un sous-ensemble de l'API C++ QFontMetricsF, avec la possibilité supplémentaire de changer la police utilisée pour les calculs via la propriété font.

FontMetrics {
    id: fontMetrics
    font.family: "Arial"
}

Rectangle {
    width: fontMetrics.height * 4
    height: fontMetrics.height * 2
}

Voir également QFontMetricsF et TextMetrics.

Documentation sur les propriétés

ascent : real [read-only]

Cette propriété contient l'ascension de la police.

Voir aussi QFontMetricsF::ascent(), descent, et height.

averageCharacterWidth : real [read-only]

Cette propriété indique la largeur moyenne des glyphes de la police.

Voir également QFontMetricsF::averageCharWidth().

capitalHeight : real [read-only, since 6.9]

Renvoie la hauteur des capitales telle que spécifiée par la police.

La hauteur des capitales d'une police est définie comme la hauteur d'une lettre majuscule au-dessus de la ligne de base. Elle se réfère spécifiquement à la hauteur des lettres capitales qui sont plates - telles que H ou I - par opposition aux lettres rondes telles que O, ou aux lettres pointues telles que A, qui peuvent toutes deux afficher un dépassement.

Cette propriété a été introduite dans Qt 6.9.

Voir aussi QFontMetricsF::capHeight, ascent, descent, height, et xHeight.

descent : real [read-only]

Cette propriété contient la descente de la police.

Voir aussi QFontMetricsF::descent(), ascent, et height.

font : font

Cette propriété définit la police de caractères utilisée pour les calculs de métriques.

height : real [read-only]

Cette propriété indique la hauteur de la police.

Voir aussi QFontMetricsF::height().

leading : real [read-only]

Cette propriété contient l'amorce de la police.

Voir également QFontMetricsF::leading().

lineSpacing : real [read-only]

Cette propriété contient la distance entre une ligne de base et la suivante.

Voir également QFontMetricsF::lineSpacing().

lineWidth : real [read-only]

Cette propriété définit la largeur des lignes de soulignement et de biffage, ajustée en fonction de la taille de la police.

Voir aussi QFontMetricsF::lineWidth().

maximumCharacterWidth : real [read-only]

Cette propriété indique la largeur du caractère le plus large de la police.

Voir également QFontMetricsF::maxWidth().

minimumLeftBearing : real [read-only]

Cette propriété indique l'orientation minimale à gauche de la police.

Voir également QFontMetricsF::minLeftBearing().

minimumRightBearing : real [read-only]

Cette propriété définit l'orientation minimale à droite de la police.

Voir également QFontMetricsF::minRightBearing().

overlinePosition : real [read-only]

Cette propriété indique la distance entre la ligne de base et l'endroit où une surligne doit être dessinée.

Voir aussi QFontMetricsF::overlinePos(), underlinePosition, et strikeOutPosition.

strikeOutPosition : real [read-only]

Cette propriété indique la distance entre la ligne de base et l'endroit où la ligne de strikeout doit être tracée.

Voir aussi QFontMetricsF::strikeOutPos(), overlinePosition, et underlinePosition.

underlinePosition : real [read-only]

Cette propriété indique la distance entre la ligne de base et l'endroit où un trait de soulignement doit être dessiné.

Voir aussi QFontMetricsF::underlinePos(), overlinePosition, et strikeOutPosition.

xHeight : real [read-only]

Cette propriété indique la hauteur "x" de la police.

Voir aussi QFontMetricsF::xHeight().

Documentation de la méthode

real advanceWidth(string text)

Cette méthode renvoie l'avance en pixels des caractères dans text. Il s'agit de la distance entre la position de la chaîne et l'endroit où la chaîne suivante doit être dessinée.

Cette méthode est une alternative impérative à la propriété advanceWidth de TextMetrics.

Voir également QFontMetricsF::horizontalAdvance() et QFontMetricsF::height().

rect boundingRect(string text)

Cette méthode renvoie le rectangle de délimitation des caractères de la chaîne spécifiée par text.

Cette méthode est proposée comme une alternative impérative à la propriété boundingRect de TextMetrics.

Voir aussi QFontMetricsF::boundingRect() et tightBoundingRect().

string elidedText(string text, enumeration mode, real width, int flags)

Cette méthode renvoie une version élidée de la chaîne (c'est-à-dire une chaîne contenant "...") si la chaîne text est plus large que width. Sinon, elle renvoie la chaîne originale.

L'argument mode spécifie le mode d'élusion du texte, c'est-à-dire l'endroit où l'ellipse doit apparaître lors de l'affichage d'un texte qui ne tient pas en place.

L'argument flags est facultatif et ne prend actuellement en charge que Qt::TextShowMnemonic.

Cette méthode est proposée comme une alternative impérative à la propriété elidedText de TextMetrics.

Voir aussi Qt::TextElideMode et QFontMetricsF::elidedText().

rect tightBoundingRect(string text)

Cette méthode renvoie un rectangle de délimitation serré autour des caractères de la chaîne spécifiée par text.

Cette méthode est proposée comme une alternative impérative à la propriété tightBoundingRect de TextMetrics.

Voir aussi QFontMetricsF::tightBoundingRect() et boundingRect().