QFontMetricsF Class

QFont font("times", 24);
QFontMetricsF fm(font);
qreal pixelsWide = fm.horizontalAdvance("What's the advance width of this text?");
qreal pixelsHigh = fm.height();

Dokumentation der Mitgliedsfunktionen

[explicit] QFontMetricsF::QFontMetricsF(const QFont &font)

Konstruiert ein Font-Metrik-Objekt für font.

Die Schriftmetrik ist mit dem zur Erstellung von font verwendeten Malgerät kompatibel.

Das Fontmetrik-Objekt enthält die Informationen für den Font, die im Konstruktor zum Zeitpunkt der Erstellung übergeben werden, und wird nicht aktualisiert, wenn die Attribute des Fonts später geändert werden.

Verwenden Sie QFontMetricsF(const QFont &, QPaintDevice *), um die Schriftmetriken zu erhalten, die mit einem bestimmten Malgerät kompatibel sind.

QFontMetricsF::QFontMetricsF(const QFontMetrics &fontMetrics)

Konstruiert ein Fontmetrik-Objekt mit Fließkomma-Präzision aus dem angegebenen fontMetrics -Objekt.

QFontMetricsF::QFontMetricsF(const QFont &font, const QPaintDevice *paintdevice)

Konstruiert ein Font-Metrik-Objekt für font und paintdevice.

Die Schriftmetriken sind mit dem übergebenen Zeichengerät kompatibel. Wenn paintdevice nullptr ist, werden die Metriken bildschirmkompatibel sein, d.h. die Metriken, die Sie erhalten, wenn Sie die Schriftart zum Zeichnen von Text auf einem widgets oder pixmaps verwenden, nicht auf einem QPicture oder QPrinter.

Das Font-Metrik-Objekt enthält die Informationen für den Font, die im Konstruktor zum Zeitpunkt der Erstellung übergeben werden, und wird nicht aktualisiert, wenn die Attribute des Fonts später geändert werden.

QFontMetricsF::QFontMetricsF(const QFontMetricsF &fm)

Konstruiert eine Kopie von fm.

[noexcept] QFontMetricsF::~QFontMetricsF()

Zerstört das Schriftmetrikobjekt und gibt alle zugewiesenen Ressourcen frei.

qreal QFontMetricsF::ascent() const

Gibt die Steigung der Schriftart zurück.

Die Steigung einer Schriftart ist der Abstand von der Grundlinie bis zur höchsten Position, zu der die Zeichen reichen. In der Praxis brechen einige Schriftdesigner diese Regel, z. B. wenn sie mehr als einen Akzent auf ein Zeichen setzen oder um ein bestimmtes Zeichen unterzubringen, daher ist es möglich (wenn auch selten), dass dieser Wert zu klein ist.

Siehe auch descent().

qreal QFontMetricsF::averageCharWidth() const

Gibt die durchschnittliche Breite der Glyphen in der Schriftart zurück.

QRectF QFontMetricsF::boundingRect(QChar ch) const

Gibt das Begrenzungsrechteck des Zeichens ch relativ zum äußersten linken Punkt auf der Grundlinie zurück.

Beachten Sie, dass sich das Begrenzungsrechteck bis links von (0, 0) erstrecken kann, z. B. bei kursiven Schriftarten, und dass die Textausgabe alle Pixel im Begrenzungsrechteck abdecken kann.

Beachten Sie, dass sich das Rechteck in der Regel sowohl über als auch unter der Grundlinie erstreckt.

Siehe auch horizontalAdvance().

QRectF QFontMetricsF::boundingRect(const QString &text) const

Gibt das Begrenzungsrechteck der Zeichen in der durch text angegebenen Zeichenkette zurück. Das Begrenzungsrechteck umfasst immer mindestens die Menge der Pixel, die der Text abdecken würde, wenn er bei (0, 0) gezeichnet würde.

Beachten Sie, dass sich das Begrenzungsrechteck bis links von (0, 0) erstrecken kann, z. B. bei kursiven Schriftarten, und dass die Breite des zurückgegebenen Rechtecks von dem abweichen kann, was die Methode horizontalAdvance() zurückgibt.

Wenn Sie die voraussichtliche Breite der Zeichenkette wissen wollen (um eine Reihe von Zeichenketten nebeneinander anzuordnen), verwenden Sie stattdessen horizontalAdvance().

Newline-Zeichen werden als normale Zeichen verarbeitet, nicht als Zeilenumbrüche.

Die Höhe des Begrenzungsrechtecks ist mindestens so groß wie der Wert, den height() zurückgibt.

Siehe auch horizontalAdvance(), height(), und QPainter::boundingRect().

[since 6.3] QRectF QFontMetricsF::boundingRect(const QString &text, const QTextOption &option) const

Gibt das begrenzende Rechteck der Zeichen in der durch text angegebenen Zeichenkette zurück, das mit option angelegt wurde. Das Begrenzungsrechteck deckt immer mindestens die Menge der Pixel ab, die der Text abdecken würde, wenn er bei (0, 0) gezeichnet würde.

Beachten Sie, dass das begrenzende Rechteck auch links von (0, 0) liegen kann, z. B. bei kursiven Schriftarten, und dass die Breite des zurückgegebenen Rechtecks von dem abweichen kann, was die Methode horizontalAdvance() zurückgibt.

Wenn Sie die voraussichtliche Breite der Zeichenkette wissen wollen (um eine Reihe von Zeichenketten nebeneinander anzuordnen), verwenden Sie stattdessen horizontalAdvance().

Zeilenumbrüche werden als normale Zeichen verarbeitet, nicht als Zeilenumbrüche.

Die Höhe des begrenzenden Rechtecks ist mindestens so groß wie der Wert, den height() zurückgibt.

Diese Funktion wurde in Qt 6.3 eingeführt.

Siehe auch horizontalAdvance(), height(), und QPainter::boundingRect().

QRectF QFontMetricsF::boundingRect(const QRectF &rect, int flags, const QString &text, int tabStops = 0, int *tabArray = nullptr) const

Dies ist eine überladene Funktion.

Gibt das Begrenzungsrechteck der Zeichen in der angegebenen text zurück. Dies ist die Menge der Pixel, die der Text abdecken würde, wenn er auf das durch rect angegebene Begrenzungsrechteck beschränkt wäre. Wenn rect ein Verweis auf ein nullptr Objekt ist, z.B. bei der Übergabe eines standardmäßig konstruierten QRectF, wird das begrenzende Rechteck nicht auf die Größe beschränkt.

Das Argument flags ist das bitweise ODER der folgenden Flags:

• Qt::AlignLeft richtet sich am linken Rand aus, außer für Arabisch und Hebräisch, wo es sich am rechten Rand ausrichtet.
• Qt::AlignRight Richtet sich am rechten Rand aus, außer bei Arabisch und Hebräisch, wo es sich am linken Rand ausrichtet.
• Qt::AlignJustify erzeugt Blocksatz.
• Qt::AlignHCenter richtet sich horizontal zentriert aus.
• Qt::AlignTop richtet sich am oberen Rand aus.
• Qt::AlignBottom Richtet sich am unteren Rand aus.
• Qt::AlignVCenter richtet sich vertikal zentriert aus
• Qt::AlignCenter (== Qt::AlignHCenter | Qt::AlignVCenter)
• Qt::TextSingleLine ignoriert Zeilenumbrüche im Text.
• Qt::TextExpandTabs expandiert Tabulatoren (siehe unten)
• Qt::TextShowMnemonic interpretiert "&x" als x, d.h. unterstrichen.
• Qt::TextWordWrap bricht den Text so um, dass er in das Rechteck passt.

Qt::Horizontal Die Ausrichtung ist standardmäßig Qt::AlignLeft und die vertikale Ausrichtung ist standardmäßig Qt::AlignTop.

Wenn mehrere der Flags für die horizontale oder vertikale Ausrichtung gesetzt sind, ist die resultierende Ausrichtung undefiniert.

Diese Flags sind in Qt::AlignmentFlag definiert.

Wenn Qt::TextExpandTabs in flags gesetzt ist, werden die Tabulatorzeichen im Text wie folgt interpretiert:

• Wenn tabArray nicht Null ist, gibt es eine 0-terminierte Sequenz von Pixelpositionen für Tabulatoren im Text an.
• Wenn tabStops ungleich Null ist, wird dies als Tabulatorabstand (in Pixel) verwendet.

Beachten Sie, dass sich das Begrenzungsrechteck bis links von (0, 0) erstrecken kann, z. B. bei kursiven Schriftarten.

Newline-Zeichen werden als Zeilenumbrüche verarbeitet.

Trotz der unterschiedlichen tatsächlichen Zeichenhöhen sind die Höhen der Begrenzungsrechtecke von "Yes" und "yes" gleich groß.

Das von dieser Funktion zurückgegebene Begrenzungsrechteck ist etwas größer als das von der einfacheren Funktion boundingRect() berechnete. Diese Funktion verwendet die Schriftarten maximum left und right, da dies für die korrekte Ausrichtung von mehrzeiligem Text erforderlich ist. Außerdem werden fontHeight() und lineSpacing() verwendet, um die Höhe zu berechnen, und nicht die einzelnen Zeichenhöhen.

Siehe auch horizontalAdvance(), QPainter::boundingRect(), und Qt::Alignment.

qreal QFontMetricsF::capHeight() const

Gibt die Versalhöhe der Schriftart zurück.

Die Versalhöhe einer Schriftart ist die Höhe eines Großbuchstabens über der Grundlinie. Es handelt sich insbesondere um 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.

Siehe auch ascent().

qreal QFontMetricsF::descent() const

Gibt das Gefälle der Schrift zurück.

Das Gefälle ist der Abstand von der Grundlinie bis zum niedrigsten Punkt, bis zu dem die Zeichen reichen. (Beachten Sie, dass dies ein Unterschied zu X ist, das 1 Pixel addiert.) In der Praxis brechen einige Schriftdesigner diese Regel, z. B. um ein bestimmtes Zeichen unterzubringen, so dass es möglich (wenn auch selten) ist, dass dieser Wert zu klein ist.

Siehe auch ascent().

QString QFontMetricsF::elidedText(const QString &text, Qt::TextElideMode mode, qreal width, int flags = 0) const

Wenn die Zeichenkette text breiter als width ist, wird eine elidierte Version der Zeichenkette zurückgegeben (d. h. eine Zeichenkette mit "..." darin). Andernfalls wird die ursprüngliche Zeichenkette zurückgegeben.

Der Parameter mode gibt an, ob der Text auf der linken Seite (z. B. "...tech"), in der Mitte (z. B. "Tr...ch") oder auf der rechten Seite (z. B. "Trol...") weggelassen wird.

width wird in Pixeln und nicht in Zeichen angegeben.

Das Argument flags ist optional und unterstützt derzeit nur Qt::TextShowMnemonic als Wert.

Die Auslassungsmarkierung folgt auf layoutdirection. Bei Layouts von rechts nach links befindet sie sich beispielsweise auf der rechten Seite des Textes, wenn mode Qt::ElideLeft ist, und auf der linken Seite des Textes, wenn mode Qt::ElideRight ist.

qreal QFontMetricsF::fontDpi() const

Gibt den DPI-Wert der Schrift zurück.

qreal QFontMetricsF::height() const

Gibt die Höhe der Schrift zurück.

Dies ist immer gleich ascent()+descent().

Siehe auch leading() und lineSpacing().

[since 6.3] qreal QFontMetricsF::horizontalAdvance(const QString &text, const QTextOption &option) const

Gibt den horizontalen Abstand in Pixeln von text zurück, der mit option festgelegt wurde.

Der Vorsprung ist der Abstand, der für das Zeichnen eines nachfolgenden Zeichens nach text geeignet ist.

Diese Funktion wurde in Qt 6.3 eingeführt.

Siehe auch boundingRect().

qreal QFontMetricsF::horizontalAdvance(const QString &text, int length = -1) const

Gibt den horizontalen Abstand in Pixeln der ersten length Zeichen von text zurück. Wenn length negativ ist (Standard), wird die gesamte Zeichenfolge verwendet. Die gesamte Länge von text wird ausgewertet, auch wenn length wesentlich kürzer ist.

Der Vorlauf ist der Abstand, der für das Zeichnen eines nachfolgenden Zeichens nach text geeignet ist.

Siehe auch boundingRect().

qreal QFontMetricsF::horizontalAdvance(QChar ch) const

Dies ist eine überladene Funktion.

Gibt den horizontalen Abstand des Zeichens ch in Pixeln zurück. Dies ist ein Abstand, der für das Zeichnen eines nachfolgenden Zeichens nach ch geeignet ist.

Einige der Metriken sind in der Abbildung rechts beschrieben. Die mittleren dunklen Rechtecke decken den logischen horizontalen Vorsprung() jedes Zeichens ab. Die äußeren hellen Rechtecke decken die leftBearing() und rightBearing() der einzelnen Zeichen ab. Beachten Sie, dass die Ausrichtungen von "f" in dieser Schriftart beide negativ sind, während die Ausrichtungen von "o" beide positiv sind.

Siehe auch boundingRect().

bool QFontMetricsF::inFont(QChar ch) const

Gibt true zurück, wenn das Zeichen ch ein gültiges Zeichen in der Schriftart ist; andernfalls wird false zurückgegeben.

bool QFontMetricsF::inFontUcs4(uint ch) const

Gibt true zurück, wenn das durch ch angegebene Zeichen, kodiert in UCS-4/UTF-32, ein gültiges Zeichen in der Schriftart ist; andernfalls wird false zurückgegeben.

qreal QFontMetricsF::leading() const

Gibt den Zeilenabstand der Schrift zurück.

Dies ist der natürliche Abstand zwischen den Zeilen.

Siehe auch height() und lineSpacing().

qreal QFontMetricsF::leftBearing(QChar ch) const

Gibt die linke Ausrichtung des Zeichens ch in der Schriftart zurück.

Die linke Ausrichtung ist der Abstand des am weitesten links liegenden Pixels des Zeichens vom logischen Ursprung des Zeichens nach rechts. Dieser Wert ist negativ, wenn sich die Pixel des Zeichens nach links vom logischen Ursprung erstrecken.

Siehe horizontalAdvance() für eine grafische Beschreibung dieser Metrik.

Siehe auch rightBearing(), minLeftBearing(), und horizontalAdvance().

qreal QFontMetricsF::lineSpacing() const

Gibt den Abstand von einer Basislinie zur nächsten zurück.

Dieser Wert ist immer gleich leading()+height().

Siehe auch height() und leading().

qreal QFontMetricsF::lineWidth() const

Gibt die Breite der unterstrichenen und durchgestrichenen Zeilen zurück, angepasst an die Punktgröße der Schriftart.

Siehe auch underlinePos(), overlinePos(), und strikeOutPos().

qreal QFontMetricsF::maxWidth() const

Gibt die Breite des breitesten Zeichens in der Schriftart zurück.

qreal QFontMetricsF::minLeftBearing() const

Gibt die minimale linke Peilung der Schriftart zurück.

Dies ist die kleinste leftBearing(char) aller Zeichen in der Schriftart.

Beachten Sie, dass diese Funktion sehr langsam sein kann, wenn die Schriftart sehr groß ist.

Siehe auch minRightBearing() und leftBearing().

qreal QFontMetricsF::minRightBearing() const

Gibt die minimale rechte Ausrichtung der Schriftart zurück.

Dies ist die kleinste rightBearing(char) aller Zeichen in der Schriftart.

Beachten Sie, dass diese Funktion sehr langsam sein kann, wenn die Schriftart sehr groß ist.

Siehe auch minLeftBearing() und rightBearing().

qreal QFontMetricsF::overlinePos() const

Liefert den Abstand von der Basislinie zu der Stelle, an der eine Überlinie gezeichnet werden soll.

Siehe auch underlinePos(), strikeOutPos(), und lineWidth().

qreal QFontMetricsF::rightBearing(QChar ch) const

Gibt die rechte Ausrichtung des Zeichens ch in der Schriftart zurück.

Die rechte Ausrichtung ist der Abstand des äußersten rechten Pixels des Zeichens vom logischen Ursprung eines nachfolgenden Zeichens nach links. Dieser Wert ist negativ, wenn sich die Pixel des Zeichens nach rechts von horizontalAdvance() des Zeichens erstrecken.

Siehe horizontalAdvance() für eine grafische Beschreibung dieser Metrik.

Siehe auch leftBearing(), minRightBearing(), und horizontalAdvance().

QSizeF QFontMetricsF::size(int flags, const QString &text, int tabStops = 0, int *tabArray = nullptr) const

Gibt die Größe der Zeichen in der angegebenen text in Pixeln zurück.

Das Argument flags ist das bitweise ODER der folgenden Flags:

• Qt::TextSingleLine ignoriert Zeilenumbruchzeichen.
• Qt::TextExpandTabs expandiert Tabulatoren (siehe unten)
• Qt::TextShowMnemonic interpretiert "&x" als x, d.h. unterstrichen.
• Qt::TextWordWrap bricht den Text um, damit er in das Rechteck passt.

Diese Flags sind in der Aufzählung Qt::TextFlag definiert.

Wenn Qt::TextExpandTabs in flags gesetzt ist, wird das folgende Verhalten zur Interpretation von Tabulatorzeichen im Text verwendet:

• Wenn tabArray nicht null ist, gibt es eine 0-terminierte Sequenz von Pixelpositionen für Tabulatoren im Text an.
• Wenn tabStops ungleich Null ist, wird dieser Wert als Tabulatorabstand (in Pixeln) verwendet.

Newline-Zeichen werden als Zeilenumbrüche verarbeitet.

Hinweis: Trotz der unterschiedlichen tatsächlichen Zeichenhöhen sind die Höhen der Begrenzungsrechtecke von "Yes" und "yes" identisch.

Siehe auch boundingRect().

qreal QFontMetricsF::strikeOutPos() const

Liefert den Abstand von der Grundlinie zu der Stelle, an der die Strikeout-Linie gezogen werden soll.

Siehe auch underlinePos(), overlinePos(), und lineWidth().

[noexcept] void QFontMetricsF::swap(QFontMetricsF &other)

Tauscht diese Schriftmetrik-Instanz mit other aus. Dieser Vorgang ist sehr schnell und schlägt nie fehl.

QRectF QFontMetricsF::tightBoundingRect(const QString &text) const

Gibt ein eng begrenztes Rechteck um die Zeichen in der durch text angegebenen Zeichenkette zurück. Das Begrenzungsrechteck deckt immer mindestens die Menge der Pixel ab, die der Text abdecken würde, wenn er bei (0, 0) gezeichnet würde.

Beachten Sie, dass sich das begrenzende Rechteck auch links von (0, 0) erstrecken kann, z. B. bei kursiven Schriftarten, und dass die Breite des zurückgegebenen Rechtecks anders sein kann als das, was die Methode horizontalAdvance() zurückgibt.

Wenn Sie die voraussichtliche Breite der Zeichenkette wissen wollen (um eine Reihe von Zeichenketten nebeneinander anzuordnen), verwenden Sie stattdessen horizontalAdvance().

Newline-Zeichen werden als normale Zeichen verarbeitet, nicht als Zeilenumbrüche.

Siehe auch horizontalAdvance(), height(), und boundingRect().

[since 6.3] QRectF QFontMetricsF::tightBoundingRect(const QString &text, const QTextOption &option) const

Gibt ein eng begrenztes Rechteck um die Zeichen in der durch text angegebenen Zeichenkette zurück, das mit option angelegt wurde. Das Begrenzungsrechteck deckt immer mindestens die Menge der Pixel ab, die der Text abdecken würde, wenn er bei (0,0) gezeichnet würde.

Beachten Sie, dass sich das Begrenzungsrechteck links von (0, 0) erstrecken kann, z. B. bei kursiven Schriftarten, und dass die Breite des zurückgegebenen Rechtecks anders sein kann als das, was die Methode horizontalAdvance() zurückgibt.

Wenn Sie die voraussichtliche Breite der Zeichenkette wissen wollen (um eine Reihe von Zeichenketten nebeneinander anzuordnen), verwenden Sie stattdessen horizontalAdvance().

Newline-Zeichen werden als normale Zeichen verarbeitet, nicht als Zeilenumbrüche.

Diese Funktion wurde in Qt 6.3 eingeführt.

Siehe auch horizontalAdvance(), height(), und boundingRect().

qreal QFontMetricsF::underlinePos() const

Liefert den Abstand von der Grundlinie zu der Stelle, an der ein Unterstrich gezeichnet werden soll.

Siehe auch overlinePos(), strikeOutPos(), und lineWidth().

qreal QFontMetricsF::xHeight() const

Gibt die Höhe 'x' der Schrift zurück. Dies entspricht oft, aber nicht immer, der Höhe des Zeichens "x".

bool QFontMetricsF::operator!=(const QFontMetricsF &other) const

Dies ist eine überladene Funktion.

Gibt true zurück, wenn die Schriftmetrik nicht gleich der other Schriftmetrik ist; andernfalls gibt sie false zurück.

Siehe auch operator==().

[noexcept] QFontMetricsF &QFontMetricsF::operator=(QFontMetricsF &&other)

Verschieben - weist other dieser QFontMetricsF Instanz zu.

QFontMetricsF &QFontMetricsF::operator=(const QFontMetrics &other)

Weist diesem Objekt other zu.

QFontMetricsF &QFontMetricsF::operator=(const QFontMetricsF &fm)

Weist die Schriftmetrik fm diesem Schriftmetrikobjekt zu.

bool QFontMetricsF::operator==(const QFontMetricsF &other) const

Gibt true zurück, wenn die Schriftmetriken mit den other Schriftmetriken übereinstimmen; andernfalls wird false zurückgegeben.

Zwei Schriftmetriken gelten als gleich, wenn sie aus demselben QFont konstruiert wurden und die Zeichengeräte, für die sie konstruiert wurden, als kompatibel angesehen werden.