TextMetrics QML Type

Liefert Metriken für eine bestimmte Schriftart und einen bestimmten Text. Mehr...

Import Statement: import QtQuick

Liste aller Mitglieder, einschließlich geerbter Mitglieder

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.

Eigenschaft Dokumentation

advanceWidth : real [read-only]

Diese Eigenschaft enthält den Abstand in Pixeln der Zeichen in text. Dies ist der Abstand von der Position der Zeichenfolge bis zu 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 Zeichenfolge.

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:

Konstante	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 "..."), wenn die Zeichenkette text breiter als elideWidth ist. Wenn der Text nicht breiter als elideWidth ist 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 Metrik verwendet wird.

height : real [read-only]

Diese Eigenschaft enthält die Höhe des begrenzenden Rechtecks 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 Text, der für die Berechnungen der Metrik verwendet wird.

tightBoundingRect : rect [read-only]

Diese Eigenschaft enthält ein eng begrenztes Rechteck um die Zeichen in der durch text angegebenen Zeichenkette.

Siehe auch QFontMetricsF::tightBoundingRect() und boundingRect.

width : real [read-only]

Diese Eigenschaft enthält die Breite des Begrenzungsrechtecks der Zeichen in der durch text angegebenen Zeichenfolge. Sie ist äquivalent zu:

textMetrics.boundingRect.width

Siehe auch 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.