TextMetrics QML Type

Fournit des mesures pour une police et un texte donnés. Plus d'informations...

• 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é contient 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 de délimitation des caractères de la chaîne spécifiée par text.

Voir aussi QFontMetricsF::boundingRect() et tightBoundingRect.

elide : enumeration

Cette propriété définit le mode d'élide du texte. Elle détermine la position dans laquelle la chaîne est élidée. Les valeurs possibles sont les suivantes

Voir aussi elideWidth et QFontMetrics::elidedText.

elideWidth : real

Cette propriété indique la plus grande largeur que le texte peut avoir (en pixels) avant que l'élidage ne se produise.

Voir également elide et QFontMetrics::elidedText.

elidedText : string [read-only]

Cette propriété contient une version élidée de la chaîne (c'est-à-dire une chaîne contenant "...") si la chaîne text est plus large que elideWidth. Si le texte n'est pas plus large 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é 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 du rectangle de délimitation des caractères de la chaîne spécifiée par text. Elle est équivalente à :

textMetrics.boundingRect.height

Voir aussi boundingRect.

renderType : enumeration [since 6.3]

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

Les types de rendu pris en charge sont les suivants

Cela devrait correspondre à l'adresse renderType 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 métriques.

tightBoundingRect : rect [read-only]

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

Voir aussi QFontMetricsF::tightBoundingRect() et boundingRect.

width : real [read-only]

Cette propriété indique la largeur du rectangle de délimitation des caractères de la chaîne spécifiée par text. Elle est équivalente à :

textMetrics.boundingRect.width

Voir aussi boundingRect.