TextMetrics QML Type
Fournit des mesures pour une police et un texte donnés. Plus d'informations...
| Import Statement: | import QtQuick |
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 de la propriété
advanceWidth : real |
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 |
Cette propriété contient le rectangle de délimitation des caractères de la chaîne spécifiée par text.
Voir également QFontMetricsF::boundingRect() et tightBoundingRect.
elide : enumeration |
Cette propriété contient 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
| Constante | Description |
|---|---|
Qt::ElideNone | Pas d'élide ; c'est la valeur par défaut. |
Qt::ElideLeft | C'est la valeur par défaut : "...Monde" |
Qt::ElideMiddle | Par exemple : "...Monde" : "Il...ld" |
Qt::ElideRight | Par exemple : "Hello..." : "Hello..." |
Voir également 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 |
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 |
Cette propriété indique la hauteur du rectangle délimitant les caractères de la chaîne spécifiée par text. Elle est équivalente à :
textMetrics.boundingRect.height
Voir aussi boundingRect.
renderType : enumeration |
Remplacer le type de rendu par défaut pour ce composant.
Les types de rendu pris en charge sont les suivants
| Constante | Description |
|---|---|
TextEdit.QtRendering | Le texte est rendu à l'aide d'un champ de distance modulable pour chaque glyphe. |
TextEdit.NativeRendering | Le texte est rendu à l'aide d'une technique spécifique à la plate-forme. |
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 les calculs de métriques.
tightBoundingRect : rect |
Cette propriété contient un rectangle de délimitation serré autour des caractères de la chaîne spécifiée par text.
Voir également QFontMetricsF::tightBoundingRect() et boundingRect.
width : real |
Cette propriété contient 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.
© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.