FontMetrics QML Type
Liefert Metriken für eine bestimmte Schriftart. 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)
Detaillierte Beschreibung
FontMetrics berechnet die Größe von Zeichen und Zeichenketten für eine bestimmte Schriftart.
Es bietet eine Teilmenge der C++ QFontMetricsF API, mit der zusätzlichen Möglichkeit, die Schriftart zu ändern, die für die Berechnungen über die font Eigenschaft verwendet wird.
FontMetrics {
id: fontMetrics
font.family: "Arial"
}
Rectangle {
width: fontMetrics.height * 4
height: fontMetrics.height * 2
}Siehe auch QFontMetricsF und TextMetrics.
Dokumentation der Eigenschaft
ascent : real [read-only]
Diese Eigenschaft enthält die Steigung der Schrift.
Siehe auch QFontMetricsF::ascent(), descent, und height.
averageCharacterWidth : real [read-only]
Diese Eigenschaft enthält die durchschnittliche Breite der Glyphen in der Schriftart.
Siehe auch QFontMetricsF::averageCharWidth().
capitalHeight : real [read-only, since 6.9]
Gibt die Höhe der Großbuchstaben zurück, wie sie in der Schriftart angegeben ist.
Die Versalhöhe einer Schriftart ist definiert als die Höhe eines Großbuchstabens über der Grundlinie. Sie bezieht sich speziell auf die Höhe von Großbuchstaben, die flach sind - wie H oder I - im Gegensatz zu runden Buchstaben wie O oder spitzen Buchstaben wie A, die beide Überhöhungen aufweisen können.
Diese Eigenschaft wurde in Qt 6.9 eingeführt.
Siehe auch QFontMetricsF::capHeight, ascent, descent, height, und xHeight.
descent : real [read-only]
Diese Eigenschaft enthält die Abstammung der Schriftart.
Siehe auch QFontMetricsF::descent(), ascent, und height.
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 der Schrift.
Siehe auch QFontMetricsF::height().
leading : real [read-only]
Diese Eigenschaft enthält den Vorspann der Schriftart.
Siehe auch QFontMetricsF::leading().
lineSpacing : real [read-only]
Diese Eigenschaft enthält den Abstand von einer Basislinie zur nächsten.
Siehe auch QFontMetricsF::lineSpacing().
lineWidth : real [read-only]
Diese Eigenschaft enthält die Breite der unterstrichenen und durchgestrichenen Linien, angepasst an die Punktgröße der Schriftart.
Siehe auch QFontMetricsF::lineWidth().
maximumCharacterWidth : real [read-only]
Diese Eigenschaft enthält die Breite des breitesten Zeichens in der Schriftart.
Siehe auch QFontMetricsF::maxWidth().
minimumLeftBearing : real [read-only]
Diese Eigenschaft enthält die minimale linke Ausrichtung der Schrift.
Siehe auch QFontMetricsF::minLeftBearing().
minimumRightBearing : real [read-only]
Diese Eigenschaft enthält die minimale rechte Ausrichtung der Schrift.
Siehe auch QFontMetricsF::minRightBearing().
overlinePosition : real [read-only]
Diese Eigenschaft gibt den Abstand von der Grundlinie zu der Stelle an, an der eine Überlinie 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 Ausstreichungslinie gezogen werden soll.
Siehe auch QFontMetricsF::strikeOutPos(), overlinePosition, und underlinePosition.
underlinePosition : real [read-only]
Diese Eigenschaft gibt den Abstand von der Grundlinie zu der Stelle an, an der ein Unterstrich gezeichnet werden soll.
Siehe auch QFontMetricsF::underlinePos(), overlinePosition, und strikeOutPosition.
xHeight : real [read-only]
Diese Eigenschaft enthält die 'x'-Höhe der Schrift.
Siehe auch QFontMetricsF::xHeight().
Dokumentation der Methode
real advanceWidth(string text)
Diese Methode gibt den Abstand in Pixeln der Zeichen in text 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 zwingende Alternative zur Eigenschaft advanceWidth von TextMetrics angeboten.
Siehe auch QFontMetricsF::horizontalAdvance() und QFontMetricsF::height().
rect boundingRect(string text)
Diese Methode gibt das begrenzende Rechteck 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 elidierte Version der Zeichenkette zurück (d.h. eine Zeichenkette mit "..." darin), wenn die Zeichenkette text breiter ist als width. Andernfalls wird die ursprüngliche Zeichenkette zurückgegeben.
Das Argument mode gibt den Modus für das Auslassen von Text an, d. h. wo die Ellipse erscheinen soll, wenn Text angezeigt wird, der nicht passt.
Das Argument flags ist optional und unterstützt derzeit nur Qt::TextShowMnemonic.
Diese Methode wird als zwingende Alternative zur Eigenschaft elidedText von TextMetrics angeboten.
Siehe auch Qt::TextElideMode und QFontMetricsF::elidedText().
rect tightBoundingRect(string text)
Diese Methode gibt ein eng begrenztes Rechteck um die Zeichen in der von 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.