FontMetrics QML Type
Stellt Metriken für eine bestimmte Schriftart bereit. Mehr...
| Import Statement: | import QtQuick |
Eigenschaften
- ascent : real
- averageCharacterWidth : real
- capitalHeight : real
(since 6.9) - descent : real
- font : font
- height : real
- leading : real
- lineSpacing : real
- lineWidth : real
- maximumCharacterWidth : real
- minimumLeftBearing : real
- minimumRightBearing : real
- overlinePosition : real
- strikeOutPosition : real
- underlinePosition : real
- xHeight : real
Methoden
- real advanceWidth(string text)
- rect boundingRect(string text)
- string elidedText(string text, enumeration mode, real width, int flags)
- rect tightBoundingRect(string text)
Ausführliche Beschreibung
FontMetrics berechnet die Größe von Zeichen und Zeichenfolgen für eine bestimmte Schriftart.
Es stellt eine Teilmenge der C++- QFontMetricsF -API bereit und bietet zusätzlich die Möglichkeit, die für die Berechnungen verwendete Schriftart über die Eigenschaft „ font “ zu ändern.
FontMetrics {
id: fontMetrics
font.family: "Arial"
}
Rectangle {
width: fontMetrics.height * 4
height: fontMetrics.height * 2
}Siehe auch „ QFontMetricsF “ und „ TextMetrics “.
Dokumentation zu den Eigenschaften
ascent : real [read-only]
Diese Eigenschaft gibt den Versatz der Schriftart an.
Siehe auch QFontMetricsF::ascent(), descent und height.
averageCharacterWidth : real [read-only]
Diese Eigenschaft gibt die durchschnittliche Breite der Glyphen in der Schriftart an.
Siehe auch „ QFontMetricsF::averageCharWidth()“.
capitalHeight : real [read-only, since 6.9]
Gibt die von der Schriftart festgelegte Großbuchstabenhöhe zurück.
Die Großbuchstabenhöhe einer Schriftart ist definiert als die Höhe eines Großbuchstabens über der Grundlinie. Sie bezieht sich speziell auf die Höhe von flachen Großbuchstaben – wie H oder I – im Gegensatz zu runden Buchstaben wie O oder spitzen Buchstaben wie A, bei denen es zu einem Überlauf kommen kann.
Diese Eigenschaft wurde in Qt 6.9 eingeführt.
Siehe auch QFontMetricsF::capHeight, ascent, descent, height und xHeight.
descent : real [read-only]
Diese Eigenschaft gibt den Versatz der Schriftart an.
Siehe auch „ QFontMetricsF::descent()“, „ ascent “ und „ height “.
font : font
Diese Eigenschaft enthält die Schriftart, die für die Metrikberechnungen verwendet wird.
height : real [read-only]
Diese Eigenschaft gibt die Höhe der Schriftart an.
Siehe auch „ QFontMetricsF::height()“.
leading : real [read-only]
Diese Eigenschaft legt den Zeichenabstand der Schriftart fest.
Siehe auch „ QFontMetricsF::leading()“.
lineSpacing : real [read-only]
Diese Eigenschaft gibt den Abstand zwischen zwei Basislinien an.
Siehe auch „ QFontMetricsF::lineSpacing()“.
lineWidth : real [read-only]
Diese Eigenschaft gibt die Breite der Unterstreichungs- und Durchstreichungslinien an, angepasst an die Schriftgröße.
Siehe auch „ QFontMetricsF::lineWidth()“.
maximumCharacterWidth : real [read-only]
Diese Eigenschaft gibt die Breite des breitesten Zeichens in der Schriftart an.
Siehe auch „ QFontMetricsF::maxWidth()“.
minimumLeftBearing : real [read-only]
Diese Eigenschaft gibt die minimale linke Ausrichtung der Schriftart an.
Siehe auch „ QFontMetricsF::minLeftBearing()“.
minimumRightBearing : real [read-only]
Diese Eigenschaft gibt den minimalen rechten Versatz der Schriftart an.
Siehe auch „ QFontMetricsF::minRightBearing“ ().
overlinePosition : real [read-only]
Diese Eigenschaft gibt den Abstand von der Grundlinie zu der Stelle an, an der ein Oberstrich gezeichnet werden soll.
Siehe auch QFontMetricsF::overlinePos(), underlinePosition und strikeOutPosition.
strikeOutPosition : real [read-only]
Diese Eigenschaft gibt den Abstand von der Grundlinie zu der Stelle an, an der die Durchstreichungslinie gezogen werden soll.
Siehe auch „ QFontMetricsF::strikeOutPos()“, „ overlinePosition “ und „ underlinePosition “.
underlinePosition : real [read-only]
Diese Eigenschaft gibt den Abstand von der Grundlinie bis zu der Stelle an, an der ein Unterstrich gezeichnet werden soll.
Siehe auch „ QFontMetricsF::underlinePos()“, „ overlinePosition “ und „ strikeOutPosition “.
xHeight : real [read-only]
Diese Eigenschaft gibt die „x“-Höhe der Schriftart an.
Siehe auch QFontMetricsF::xHeight().
Methodendokumentation
real advanceWidth(string text)
Diese Methode gibt den Versatz der Zeichen in „ text “ in Pixeln zurück. Dies ist der Abstand zwischen der Position der Zeichenfolge und der Stelle, an der die nächste Zeichenfolge gezeichnet werden soll.
Diese Methode wird als imperativische Alternative zur Eigenschaft ` advanceWidth ` von ` TextMetrics` angeboten.
Siehe auch „ QFontMetricsF::horizontalAdvance()“ und „ QFontMetricsF::height()“.
rect boundingRect(string text)
Diese Methode gibt das Begrenzungsrechteck der Zeichen in der durch ` text` angegebenen Zeichenkette zurück.
Diese Methode wird als imperative Alternative zur Eigenschaft „ boundingRect “ von „ TextMetrics “ angeboten.
Siehe auch ` QFontMetricsF::boundingRect()` und ` tightBoundingRect()`.
string elidedText(string text, enumeration mode, real width, int flags)
Diese Methode gibt eine gekürzte Version der Zeichenkette zurück (d. h. eine Zeichenkette, die „...“ enthält), wenn die Zeichenkette text breiter ist als width. Andernfalls wird die ursprüngliche Zeichenkette zurückgegeben.
Das Argument „ mode “ legt den Text-Elidierungsmodus fest, d. h., wo die Auslassungspunkte erscheinen sollen, wenn Text angezeigt wird, der nicht vollständig passt.
Das Argument „ flags “ ist optional und unterstützt derzeit nur „ Qt::TextShowMnemonic “.
Diese Methode wird als imperative Alternative zur Eigenschaft „ elidedText “ von „ TextMetrics “ angeboten.
Siehe auch „ Qt::TextElideMode “ und „ QFontMetricsF::elidedText()“.
rect tightBoundingRect(string text)
Diese Methode gibt ein eng anliegendes Begrenzungsrechteck um die Zeichen in der durch „ text “ angegebenen Zeichenkette zurück.
Diese Methode wird als imperative Alternative zur Eigenschaft „ tightBoundingRect “ von „ TextMetrics “ angeboten.
Siehe auch „ QFontMetricsF::tightBoundingRect()“ und „ 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.