TextMetrics QML Type

Fournit des mesures pour une police et un texte donnés. En savoir plus…

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

Propriétés

• advanceWidth : real
• boundingRect : rect
• elide : enumeration
• elideWidth : real
• elidedText : string
• font : font
• height : real
• renderType : enumeration (since 6.3)
• text : string
• tightBoundingRect : rect
• width : real

Description détaillée

TextMetrics calcule diverses propriétés d'une chaîne de texte donnée pour une police particulière.

Il fournit une API déclarative pour les fonctions de QFontMetricsF qui prennent des arguments.

TextMetrics {
    id: textMetrics
    font.family: "Arial"
    elide: Text.ElideMiddle
    elideWidth: 100
    text: "Hello World"
}

MyItem {
    text: textMetrics.elidedText
}

Voir également QFontMetricsF et FontMetrics.

Documentation sur les propriétés

advanceWidth : real [read-only]

Cette propriété indique 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.

Voir également QFontMetricsF::horizontalAdvance().

boundingRect : rect [read-only]

Cette propriété contient le rectangle englobant les caractères de la chaîne spécifiée par text.

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

elide : enumeration

Cette propriété définit le mode d'élision du texte. Elle détermine la position à laquelle la chaîne est élidée. Les valeurs possibles sont :

Voir également elideWidth et QFontMetrics::elidedText.

elideWidth : real

Cette propriété définit la largeur maximale que peut atteindre le texte (en pixels) avant qu'une élision ne se produise.

Voir également elide et QFontMetrics::elidedText.

elidedText : string [read-only]

Cette propriété contient une version tronquée de la chaîne (c'est-à-dire une chaîne comportant « ... ») si la chaîne text est plus longue que elideWidth. Si le texte n'est pas plus long que elideWidth, ou si elide est défini sur Qt::ElideNone, cette propriété sera égale à la chaîne d'origine.

Voir également QFontMetricsF::elidedText().

font : font

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

height : real [read-only]

Cette propriété contient la hauteur du rectangle englobant les caractères de la chaîne spécifiée par text. Elle équivaut à :

textMetrics.boundingRect.height

Voir également boundingRect.

renderType : enumeration [since 6.3]

Remplacer le type de rendu par défaut de ce composant.

Les types de rendu pris en charge sont les suivants :

Cela doit correspondre à l'renderType s prévue où vous dessinez le texte.

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

Voir également Text.renderType.

text : string

Cette propriété contient le texte utilisé pour le calcul des indicateurs.

tightBoundingRect : rect [read-only]

Cette propriété définit un rectangle englobant serré autour des caractères de la chaîne spécifiée par text.

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

width : real [read-only]

Cette propriété contient la largeur du rectangle englobant les caractères de la chaîne spécifiée par text. Elle équivaut à :

textMetrics.boundingRect.width

Voir également boundingRect.