TextMetrics QML Type
Liefert Metriken für eine bestimmte Schriftart und einen bestimmten Text. Mehr...
| Import Statement: | import QtQuick |
Eigenschaften
- 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
Ausführliche Beschreibung
TextMetrics berechnet verschiedene Eigenschaften einer gegebenen Textzeichenkette für eine bestimmte Schriftart.
Es bietet eine deklarative API für die Funktionen in QFontMetricsF, die Argumente annehmen.
TextMetrics {
id: textMetrics
font.family: "Arial"
elide: Text.ElideMiddle
elideWidth: 100
text: "Hello World"
}
MyItem {
text: textMetrics.elidedText
}Siehe auch QFontMetricsF und FontMetrics.
Dokumentation der Eigenschaften
advanceWidth : real [read-only]
Diese Eigenschaft enthält den Abstand in Pixeln der Zeichen in text. Dies ist der Abstand zwischen der Position der Zeichenfolge und der Stelle, an der die nächste Zeichenfolge gezeichnet werden soll.
Siehe auch QFontMetricsF::horizontalAdvance().
boundingRect : rect [read-only]
Diese Eigenschaft enthält das Begrenzungsrechteck der Zeichen in der durch text angegebenen Zeichenkette.
Siehe auch QFontMetricsF::boundingRect() und tightBoundingRect.
elide : enumeration
Diese Eigenschaft enthält den Elide-Modus des Textes. Sie bestimmt die Position, an der die Zeichenfolge ausgelassen wird. Die möglichen Werte sind:
| Konstant | Beschreibung |
|---|---|
Qt::ElideNone | Keine Auslassung; dies ist der Standardwert. |
Qt::ElideLeft | Zum Beispiel: "...Welt" |
Qt::ElideMiddle | zum Beispiel: "He...ld" |
Qt::ElideRight | Beispiel: "Hallo..." |
Siehe auch elideWidth und QFontMetrics::elidedText.
elideWidth : real
Diese Eigenschaft enthält die größte Breite, die der Text haben kann (in Pixeln), bevor eine Auslassung erfolgt.
Siehe auch elide und QFontMetrics::elidedText.
elidedText : string [read-only]
Diese Eigenschaft enthält eine elidierte Version der Zeichenkette (d.h. eine Zeichenkette mit "..." darin), wenn die Zeichenkette text breiter ist als elideWidth. Wenn der Text nicht breiter ist als elideWidth oder elide auf Qt::ElideNone gesetzt ist, entspricht diese Eigenschaft der ursprünglichen Zeichenkette.
Siehe auch QFontMetricsF::elidedText().
font : font
Diese Eigenschaft enthält die Schriftart, die für die Berechnungen der Metriken verwendet wird.
height : real [read-only]
Diese Eigenschaft enthält die Höhe des Begrenzungsrechtecks der Zeichen in der durch text angegebenen Zeichenkette. Sie ist äquivalent zu:
textMetrics.boundingRect.height
Siehe auch boundingRect.
renderType : enumeration [since 6.3]
Überschreiben Sie den Standard-Rendering-Typ für diese Komponente.
Unterstützte Rendertypen sind:
| Konstant | Beschreibung |
|---|---|
TextEdit.QtRendering | Text wird mit einem skalierbaren Abstandsfeld für jede Glyphe gerendert. |
TextEdit.NativeRendering | Text wird mit einer plattformspezifischen Technik gerendert. |
Dies sollte mit der beabsichtigten renderType übereinstimmen, wo Sie den Text zeichnen.
Diese Eigenschaft wurde in Qt 6.3 eingeführt.
Siehe auch Text.renderType.
text : string
Diese Eigenschaft enthält den für die Berechnungen der Metrik verwendeten Text.
tightBoundingRect : rect [read-only]
Mit dieser Eigenschaft wird ein enges Begrenzungsrechteck um die Zeichen in der durch text angegebenen Zeichenkette gezogen.
Siehe auch QFontMetricsF::tightBoundingRect() und boundingRect.
width : real [read-only]
Diese Eigenschaft enthält die Breite des begrenzenden Rechtecks der Zeichen in der durch text angegebenen Zeichenkette. Sie ist äquivalent zu:
textMetrics.boundingRect.width
Siehe auch boundingRect.
© 2026 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.