FontMetrics QML Type

Fournit des métriques pour une police donnée. En savoir plus…

• 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 modifier 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é définit la hauteur de la police.

Voir également QFontMetricsF::ascent(), descent et height.

averageCharacterWidth : real [read-only]

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

Voir également QFontMetricsF::averageCharWidth().

capitalHeight : real [read-only, since 6.9]

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

La hauteur des majuscules d’une police est définie comme la hauteur d’une lettre majuscule au-dessus de la ligne de base. Elle fait spécifiquement référence à la hauteur des lettres majuscules plates – telles que H ou I – par opposition aux lettres arrondies comme O, ou aux lettres pointues comme A, qui peuvent toutes deux présenter un dépassement.

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

Voir également QFontMetricsF::capHeight, ascent, descent, height et xHeight.

descent : real [read-only]

Cette propriété définit la descente de la police.

Voir également QFontMetricsF::descent(), ascent et height.

font : font

Cette propriété contient la police utilisée pour les calculs métriques.

height : real [read-only]

Cette propriété définit la hauteur de la police.

Voir également QFontMetricsF::height().

leading : real [read-only]

Cette propriété définit l'espacement entre les caractères de la police.

Voir également QFontMetricsF::leading().

lineSpacing : real [read-only]

Cette propriété représente la distance entre deux lignes de base consécutives.

Voir également QFontMetricsF::lineSpacing().

lineWidth : real [read-only]

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

Voir également QFontMetricsF::lineWidth().

maximumCharacterWidth : real [read-only]

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

Voir également la fonction ` QFontMetricsF::maxWidth()`.

minimumLeftBearing : real [read-only]

Cette propriété définit la position minimale à gauche de la police.

Voir également QFontMetricsF::minLeftBearing().

minimumRightBearing : real [read-only]

Cette propriété définit l'angle minimal de déviation vers la droite de la police.

Voir également QFontMetricsF::minRightBearing().

overlinePosition : real [read-only]

Cette propriété définit la distance entre la ligne de base et l'emplacement où une barre supérieure doit être tracée.

Voir également QFontMetricsF::overlinePos(), underlinePosition et strikeOutPosition.

strikeOutPosition : real [read-only]

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

Voir également QFontMetricsF::strikeOutPos(), overlinePosition et underlinePosition.

underlinePosition : real [read-only]

Cette propriété définit la distance entre la ligne de base et l'emplacement où un trait de soulignement doit être tracé.

Voir également QFontMetricsF::underlinePos(), overlinePosition et strikeOutPosition.

xHeight : real [read-only]

Cette propriété définit la hauteur « x » de la police.

Voir également QFontMetricsF::xHeight().

Documentation de la méthode

real advanceWidth(string text)

Cette méthode renvoie l'avance en pixels des caractères de 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 proposée comme 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 englobant les caractères de la chaîne spécifiée par ` text`.

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

Voir également QFontMetricsF::boundingRect() et tightBoundingRect().

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

Cette méthode renvoie une version tronquée de la chaîne (c'est-à-dire une chaîne contenant « ... ») si la longueur de la chaîne text est supérieure à width. Dans le cas contraire, elle renvoie la chaîne d'origine.

L'argument ` mode ` spécifie le mode de troncature du texte ; c'est-à-dire l'endroit où les points de suspension doivent apparaître lors de l'affichage d'un texte qui ne tient pas dans l'espace disponible.

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

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

Voir également Qt::TextElideMode et QFontMetricsF::elidedText().

rect tightBoundingRect(string text)

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

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

Voir également QFontMetricsF::tightBoundingRect() et boundingRect().