TextMetrics QML Type

Stellt Kennzahlen für eine bestimmte Schriftart und einen bestimmten Text bereit. Mehr...

• 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 vorgegebenen Textzeichenfolge für eine bestimmte Schriftart.

Es bietet eine deklarative API für die Funktionen in QFontMetricsF, die Argumente entgegennehmen.

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

MyItem {
    text: textMetrics.elidedText
}

Siehe auch QFontMetricsF und FontMetrics.

Dokumentation zu den Eigenschaften

advanceWidth : real [read-only]

Diese Eigenschaft gibt den Versatz der Zeichen in „ text “ in Pixeln an. 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 Zeichenkette, die durch „ text “ angegeben wird.

Siehe auch „ QFontMetricsF::boundingRect()“ und „ tightBoundingRect “.

elide : enumeration

Diese Eigenschaft legt den Elidierungsmodus des Textes fest. Dadurch wird bestimmt, an welcher Stelle die Zeichenfolge elidiert wird. Mögliche Werte sind:

Siehe auch elideWidth und QFontMetrics::elidedText.

elideWidth : real

Diese Eigenschaft legt die maximale Breite fest, die der Text (in Pixeln) haben darf, bevor eine Kürzung erfolgt.

Siehe auch elide und QFontMetrics::elidedText.

elidedText : string [read-only]

Diese Eigenschaft enthält eine gekürzte Version der Zeichenfolge (d. h. eine Zeichenfolge, die „...“ enthält), wenn die Zeichenfolge text breiter ist als elideWidth. Ist der Text nicht breiter als elideWidth oder ist elide auf Qt::ElideNone gesetzt, entspricht diese Eigenschaft der ursprünglichen Zeichenfolge.

Siehe auch „ QFontMetricsF::elidedText()“.

font : font

Diese Eigenschaft enthält die Schriftart, die für die Metrikberechnungen verwendet wird.

height : real [read-only]

Diese Eigenschaft enthält die Höhe des Begrenzungsrechtecks der Zeichen in der durch „ text “ angegebenen Zeichenkette. Dies entspricht:

textMetrics.boundingRect.height

Siehe auch boundingRect.

renderType : enumeration [since 6.3]

Den Standard-Rendering-Typ für diese Komponente überschreiben.

Unterstützte Darstellungsarten sind:

Dies sollte mit der beabsichtigten „ renderType “ übereinstimmen, in der 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 Berechnung der Kennzahlen verwendet wird.

tightBoundingRect : rect [read-only]

Diese Eigenschaft legt ein enges Begrenzungsrechteck um die Zeichen in der Zeichenkette fest, die durch „ text “ angegeben wird.

Siehe auch „ QFontMetricsF::tightBoundingRect()“ und „ boundingRect “.

width : real [read-only]

Diese Eigenschaft enthält die Breite des Begrenzungsrechtecks der Zeichen in der Zeichenkette, die durch ` text` angegeben wird. Dies entspricht:

textMetrics.boundingRect.width

Siehe auch boundingRect.