QFont Class

Dokumentation zu Member-Funktionen

QFont::QFont()

Erstellt ein Schriftart-Objekt, das die Standardschriftart der Anwendung verwendet.

Siehe auch „ QGuiApplication::setFont()“ und „ QGuiApplication::font()“.

QFont::QFont(const QFont &font, const QPaintDevice *pd)

Erstellt eine Schriftart aus „ font “ zur Verwendung auf dem Zeichen-Device „ pd “.

QFont::QFont(const QString &family, int pointSize = -1, int weight = -1, bool italic = false)

Erstellt ein Schriftartobjekt mit den angegebenen Einstellungen für „ family “, „ pointSize “, „ weight “ und „ italic “.

Ist pointSize gleich Null oder negativ, wird die Punktgröße der Schriftart auf einen systemabhängigen Standardwert gesetzt. In der Regel beträgt dieser 12 Punkte.

Der Name „ family “ kann optional auch einen Herstellerangabe enthalten, z. B. „Helvetica [Cronyx]“. Wenn die Schriftart „ family “ von mehr als einem Hersteller verfügbar ist und kein Hersteller angegeben wurde, wird ein beliebiger Hersteller ausgewählt. Ist die Schriftfamilie nicht verfügbar, wird mithilfe des Algorithmus „ font matching “ eine Familie festgelegt.

Dabei wird die Familienzeichenfolge an einem Komma aufgeteilt und setFamilies() mit der resultierenden Liste aufgerufen. Um eine Schriftart zu erhalten, deren Name ein Komma enthält, verwenden Sie den Konstruktor, der eine QStringList akzeptiert.

Siehe auch Weight, setFamily(), setPointSize(), setWeight(), setItalic(), setStyleHint(), setFamilies() und QGuiApplication::font().

[explicit] QFont::QFont(const QStringList &families, int pointSize = -1, int weight = -1, bool italic = false)

Erstellt ein Schriftartobjekt mit den angegebenen Einstellungen für „ families “, „ pointSize “, „ weight “ und „ italic “.

Ist pointSize gleich Null oder negativ, wird die Punktgröße der Schriftart auf einen systemabhängigen Standardwert gesetzt. In der Regel beträgt dieser 12 Punkt.

Jeder Eintrag für einen Schriftfamiliennamen in „ families “ kann optional auch einen Herstellerangabe enthalten, z. B. „Helvetica [Cronyx]“. Wenn die Schriftfamilie von mehr als einem Hersteller angeboten wird und der Hersteller nicht angegeben ist, wird ein beliebiger Hersteller ausgewählt. Ist die Schriftfamilie nicht verfügbar, wird mithilfe des Algorithmus „ font matching “ eine Schriftfamilie festgelegt.

Siehe auch Weight, setPointSize(), setWeight(), setItalic(), setStyleHint(), setFamilies() und QGuiApplication::font().

QFont::QFont(const QFont &font)

Erstellt eine Schriftart, die eine Kopie von „ font “ ist.

[constexpr noexcept default] QFont::QFont(QFont &&)

Erzeugt eine Instanz von „ QFont “.

[noexcept] QFont::~QFont()

Löscht das Schriftart-Objekt und gibt alle zugewiesenen Ressourcen frei.

bool QFont::bold() const

Gibt „ true “ zurück, wenn „ weight()“ einen Wert größer als „ QFont::Medium “ hat; andernfalls wird „ false “ zurückgegeben.

Siehe auch weight(), setBold() und QFontInfo::bold().

QFont::Capitalization QFont::capitalization() const

Gibt den aktuellen Großschreibungsstil der Schriftart zurück.

Siehe auch „ setCapitalization()“.

[since 6.7] void QFont::clearFeatures()

Löscht alle zuvor festgelegten Schriftmerkmale auf der Seite „ QFont “.

Weitere Informationen zu Schriftart-Features finden Sie unter ` setFeature()`.

Diese Funktion wurde in Qt 6.7 eingeführt.

Siehe auch „ QFont::Tag“ , „ setFeature()“, „ unsetFeature()“, „ featureTags()“ und „ featureValue()“.

[since 6.7] void QFont::clearVariableAxes()

Löscht alle zuvor festgelegten Werte für variable Achsen auf dem „ QFont “.

Weitere Informationen zu variablen Achsen finden Sie unter „ setVariableAxis()“.

Diese Funktion wurde in Qt 6.7 eingeführt.

Siehe auch „ QFont::Tag“ , „ setVariableAxis()“, „ unsetVariableAxis()“, „ isVariableAxisSet()“ und „ variableAxisValue()“.

QString QFont::defaultFamily() const

Gibt den Namen der Schriftfamilie zurück, der dem aktuellen Stilhinweis entspricht.

Siehe auch „ StyleHint“ , „ styleHint()“ und „ setStyleHint()“.

bool QFont::exactMatch() const

Gibt „ true “ zurück, wenn eine Windows-Systemschriftart verfügbar ist, die genau den Einstellungen dieser Schriftart entspricht.

Siehe auch „ QFontInfo “.

QStringList QFont::families() const

Gibt die angeforderten Schriftfamiliennamen zurück, d. h. die Namen, die beim letzten Aufruf von setFamilies() oder über den Konstruktor festgelegt wurden. Andernfalls wird eine leere Liste zurückgegeben.

Siehe auch ` setFamily()`, ` setFamilies()`, ` family()`, ` substitutes()` und ` substitute()`.

QString QFont::family() const

Gibt den Namen der angeforderten Schriftfamilie zurück. Dieser entspricht immer dem ersten Eintrag im Aufruf von families().

Siehe auch setFamily(), substitutes(), substitute(), setFamilies() und families().

[since 6.7] QList<QFont::Tag> QFont::featureTags() const

Gibt eine Liste der Tags für alle derzeit für dieses „ QFont “ festgelegten Schriftmerkmale zurück.

Weitere Informationen zu Schriftartenmerkmalen finden Sie unter „ setFeature()“.

Diese Funktion wurde in Qt 6.7 eingeführt.

Siehe auch QFont::Tag, setFeature(), unsetFeature(), isFeatureSet() und clearFeatures().

[since 6.7] quint32 QFont::featureValue(QFont::Tag tag) const

Gibt den für ein bestimmtes Merkmal festgelegten Wert zurück tag. Wenn das Tag nicht gesetzt wurde, wird stattdessen 0 zurückgegeben.

Weitere Informationen zu Schriftartenfunktionen finden Sie unter ` setFeature()`.

Diese Funktion wurde in Qt 6.7 eingeführt.

Siehe auch QFont::Tag, setFeature(), unsetFeature(), featureTags() und isFeatureSet().

bool QFont::fixedPitch() const

Gibt „ true “ zurück, wenn eine feste Schrittweite festgelegt wurde; andernfalls wird „ false “ zurückgegeben.

Siehe auch setFixedPitch() und QFontInfo::fixedPitch().

bool QFont::fromString(const QString &descrip)

Stellt diese Schriftart so ein, dass sie der Beschreibung unter descrip entspricht. Die Beschreibung ist eine durch Kommas getrennte Liste der Schriftattribute, wie sie von toString() zurückgegeben wird.

Siehe auch toString().

QFont::HintingPreference QFont::hintingPreference() const

Gibt die derzeit bevorzugte Hinting-Stufe für Glyphen zurück, die mit dieser Schriftart gerendert werden.

Siehe auch „ setHintingPreference()“.

[static] void QFont::insertSubstitution(const QString &familyName, const QString &substituteName)

Fügt „ substituteName “ in die Ersetzungstabelle für die Familie „ familyName “ ein.

Lösen Sie nach dem Ersetzen einer Schriftart die Aktualisierung der Schriftart aus, indem Sie alle Objekte vom Typ „ QFont “ löschen und neu anlegen.

Siehe auch insertSubstitutions(), removeSubstitutions(), substitutions(), substitute() und substitutes().

[static] void QFont::insertSubstitutions(const QString &familyName, const QStringList &substituteNames)

Fügt die Liste der Familien „ substituteNames “ in die Ersetzungsliste für „ familyName “ ein.

Lösen Sie nach dem Ersetzen einer Schriftart die Aktualisierung der Schriftart aus, indem Sie alle Objekte vom Typ ` QFont ` löschen und neu erstellen.

Siehe auch insertSubstitution(), removeSubstitutions(), substitutions() und substitute().

bool QFont::isCopyOf(const QFont &f) const

Gibt „ true “ zurück, wenn diese Schriftart und „ f “ Kopien voneinander sind, d. h., wenn eine von beiden als Kopie der anderen erstellt wurde und seitdem keine der beiden geändert wurde. Dies ist wesentlich strenger als die Gleichheit.

Siehe auch operator=() und operator==().

[since 6.7] bool QFont::isFeatureSet(QFont::Tag tag) const

Gibt „true“ zurück, wenn für die durch „ tag “ angegebene Eigenschaft ein Wert in der „ QFont “ festgelegt wurde; andernfalls wird „false“ zurückgegeben.

Weitere Informationen zu Schriftmerkmalen finden Sie unter setFeature().

Diese Funktion wurde in Qt 6.7 eingeführt.

Siehe auch QFont::Tag, setFeature(), unsetFeature(), featureTags() und featureValue().

[since 6.7] bool QFont::isVariableAxisSet(QFont::Tag tag) const

Gibt „true“ zurück, wenn für die Variable „axis“, die durch tag angegeben wird, ein Wert in der QFont festgelegt wurde; andernfalls wird „false“ zurückgegeben.

Weitere Informationen zu den Achsen der Schriftartvariablen finden Sie unter „ setVariableAxis()“.

Diese Funktion wurde in Qt 6.7 eingeführt.

Siehe auch „ QFont::Tag“ , „ setVariableAxis()“, „ unsetVariableAxis()“, „ variableAxisValue()“ und „ clearVariableAxes()“.

bool QFont::italic() const

Gibt „ true “ zurück, wenn die Funktion „ style()“ der Schriftart nicht QFont::StyleNormal

Siehe auch setItalic() und style().

bool QFont::kerning() const

Gibt „ true “ zurück, wenn beim Zeichnen von Text mit dieser Schriftart Kerning verwendet werden soll.

Siehe auch setKerning().

QString QFont::key() const

Gibt den Schlüssel der Schriftart zurück, also eine textuelle Darstellung einer Schriftart. Er wird in der Regel als Schlüssel für einen Cache oder ein Verzeichnis von Schriftarten verwendet.

Siehe auch „ QMap “.

qreal QFont::letterSpacing() const

Gibt den Buchstabenabstand für die Schriftart zurück.

Siehe auch setLetterSpacing(), letterSpacingType() und setWordSpacing().

QFont::SpacingType QFont::letterSpacingType() const

Gibt den für den Buchstabenabstand verwendeten Abstandstyp zurück.

Siehe auch letterSpacing(), setLetterSpacing() und setWordSpacing().

bool QFont::overline() const

Gibt „ true “ zurück, wenn „overline“ gesetzt wurde; andernfalls wird „ false “ zurückgegeben.

Siehe auch ` setOverline()`.

int QFont::pixelSize() const

Gibt die Pixelgröße der Schriftart zurück, sofern diese mit „ setPixelSize()“ festgelegt wurde. Gibt -1 zurück, wenn die Größe mit „ setPointSize()“ oder „ setPointSizeF()“ festgelegt wurde.

Siehe auch setPixelSize(), pointSize(), QFontInfo::pointSize() und QFontInfo::pixelSize().

int QFont::pointSize() const

Gibt die Punktgröße der Schriftart zurück. Gibt -1 zurück, wenn die Schriftgröße in Pixeln angegeben wurde.

Siehe auch setPointSize() und pointSizeF().

qreal QFont::pointSizeF() const

Gibt die Punktgröße der Schriftart zurück. Gibt -1 zurück, wenn die Schriftgröße in Pixeln angegeben wurde.

Siehe auch pointSize(), setPointSizeF(), pixelSize(), QFontInfo::pointSize() und QFontInfo::pixelSize().

[static] void QFont::removeSubstitutions(const QString &familyName)

Entfernt alle Ersetzungen für „ familyName “.

Siehe auch „ insertSubstitutions()“, „ insertSubstitution()“, „ substitutions()“ und „ substitute()“.

QFont QFont::resolve(const QFont &other) const

Gibt ein neues ` QFont ` zurück, dessen Attribute aus ` other ` kopiert wurden und die zuvor für diese Schriftart noch nicht festgelegt wurden.

void QFont::setBold(bool enable)

Wenn „ enable “ wahr ist, wird die Schriftstärke auf „ QFont::Bold “ gesetzt; andernfalls wird die Schriftstärke auf „ QFont::Normal “ gesetzt.

Für eine feinere Steuerung der Fettstärke verwenden Sie „ setWeight()“.

Siehe auch bold() und setWeight().

void QFont::setCapitalization(QFont::Capitalization caps)

Legt die Großschreibung des Textes in dieser Schriftart auf „ caps “ fest.

Die Großschreibung einer Schriftart bewirkt, dass der Text im ausgewählten Großschreibungsmodus angezeigt wird.

Siehe auch „ capitalization()“.

void QFont::setFamilies(const QStringList &families)

Legt die Liste der Schriftfamiliennamen für die Schriftart fest. Bei den Namen wird die Groß-/Kleinschreibung nicht berücksichtigt, und sie können einen Namen des Schriftentwicklers enthalten. Die erste Familie unter families wird als Hauptfamilie für die Schriftart festgelegt.

Jeder Eintrag für einen Schriftfamiliennamen in „ families “ kann optional auch einen Namen des Schriftherstellers enthalten, z. B. „Helvetica [Cronyx]“. Wenn die Schriftfamilie von mehr als einem Hersteller angeboten wird und der Hersteller nicht angegeben ist, wird ein beliebiger Hersteller ausgewählt. Ist die Schriftfamilie nicht verfügbar, wird mithilfe des Algorithmus „ font matching “ eine Schriftfamilie festgelegt.

Siehe auch family(), families(), setFamily(), setStyleHint() und QFontInfo.

void QFont::setFamily(const QString &family)

Legt den Familiennamen der Schriftart fest. Bei der Schreibweise des Namens wird die Groß-/Kleinschreibung nicht berücksichtigt, und er kann einen Schriftgießereinamen enthalten.

Der Name „ family “ kann optional auch einen Hersteller-Namen enthalten, z. B. „Helvetica [Cronyx]“. Wenn die Schriftfamilie „ family “ von mehr als einem Hersteller verfügbar ist und der Hersteller nicht angegeben wird, wird ein beliebiger Hersteller ausgewählt. Ist die Schriftfamilie nicht verfügbar, wird mithilfe des Algorithmus „ font matching “ eine Schriftfamilie festgelegt.

Siehe auch „ family()“, „ setStyleHint()“, „ setFamilies()“, „ families()“ und „ QFontInfo “.

[since 6.7] void QFont::setFeature(QFont::Tag tag, quint32 value)

Wendet bei der Textgestaltung einen ganzzahligen Wert auf das durch „ tag “ angegebene typografische Merkmal an. Dies ermöglicht einen erweiterten Zugriff auf den Prozess der Schriftgestaltung und kann zur Unterstützung von Schriftmerkmalen genutzt werden, die ansonsten nicht von der API abgedeckt sind.

Das Merkmal wird durch ein „ tag “ angegeben, das in der Regel aus dem vierstelligen Merkmalsnamen in der Schriftart-Merkmalszuordnung kodiert wird.

Diese ganzzahlige „ value “, die in den meisten Fällen zusammen mit dem Tag übergeben wird, stellt einen booleschen Wert dar: Der Wert Null bedeutet, dass das Merkmal deaktiviert ist, und ein Wert ungleich Null bedeutet, dass es aktiviert ist. Bei bestimmten Schriftmerkmalen kann dies jedoch anders interpretiert werden. Bei Anwendung auf das Merkmal „ salt “ ist der Wert beispielsweise ein Index, der die zu verwendende stilistische Alternative angibt.

Die Schriftartfunktion „ frac “ wandelt beispielsweise diagonale Brüche, die durch einen Schrägstrich getrennt sind (wie z. B. „ 1/2 “), in eine andere Darstellung um. In der Regel wird dabei der gesamte Bruch in eine einzige Zeichenbreite „eingebacken“ (wie z. B. „ ½ “).

Wenn eine Schriftart die Funktion „ frac “ unterstützt, kann diese im Shaper aktiviert werden, indem in der Schriftart-Funktionszuordnung der Wert „ features["frac"] = 1 “ festgelegt wird.

Diese Funktion wurde in Qt 6.7 eingeführt.

Siehe auch „ QFont::Tag“ , „ clearFeatures()“, „ unsetFeature()“ und „ featureTags()“.

void QFont::setFixedPitch(bool enable)

Wenn „ enable “ wahr ist, wird die feste Tonhöhe aktiviert; andernfalls wird sie deaktiviert.

Siehe auch „ fixedPitch()“ und „ QFontInfo “.

void QFont::setHintingPreference(QFont::HintingPreference hintingPreference)

Stellen Sie die Einstellung für den Hinting-Grad der Glyphen auf „ hintingPreference “ ein. Dies ist ein Hinweis an das zugrunde liegende Schriftart-Rendering-System, einen bestimmten Hinting-Grad zu verwenden, und wird von den verschiedenen Plattformen unterschiedlich unterstützt. Weitere Informationen finden Sie in der Tabelle in der Dokumentation unter QFont::HintingPreference.

Die Standard-Hinting-Einstellung ist „ QFont::PreferDefaultHinting “.

Siehe auch hintingPreference().

void QFont::setItalic(bool enable)

Setzt die Eigenschaft „ style()“ der Schriftart auf „ QFont::StyleItalic “, wenn „ enable “ wahr ist; andernfalls wird der Stil auf „ QFont::StyleNormal “ gesetzt.

Siehe auch „ italic()“ und „ QFontInfo “.

void QFont::setKerning(bool enable)

Aktiviert das Kerning für diese Schriftart, wenn „ enable “ auf „true“ gesetzt ist; andernfalls wird es deaktiviert. Standardmäßig ist das Kerning aktiviert.

Wenn das Kerning aktiviert ist, addieren sich die Glyphenmaße nicht mehr, selbst bei lateinischem Text. Mit anderen Worten: Die Annahme, dass width('a') + width('b') gleich width("ab") ist, trifft nicht unbedingt zu.

Siehe auch „ kerning()“ und „ QFontMetrics “.

void QFont::setLetterSpacing(QFont::SpacingType type, qreal spacing)

Stellt den Buchstabenabstand für die Schriftart auf „ spacing “ und die Art des Abstands auf „ type “ ein.

Der Buchstabenabstand verändert den Standardabstand zwischen den einzelnen Buchstaben der Schriftart. Der Abstand zwischen den Buchstaben kann je nach ausgewähltem Abstandstyp sowohl verringert als auch vergrößert werden, entweder in Prozent der Zeichenbreite oder in Pixeln.

Siehe auch letterSpacing(), letterSpacingType() und setWordSpacing().

void QFont::setOverline(bool enable)

Wenn „ enable “ wahr ist, wird die Durchstreichung aktiviert; andernfalls wird sie deaktiviert.

Siehe auch „ overline()“ und „ QFontInfo “.

void QFont::setPixelSize(int pixelSize)

Stellt die Schriftgröße auf pixelSize Pixel ein, wobei die maximale Größe durch eine vorzeichenlose 16-Bit-Ganzzahl begrenzt ist.

Die Verwendung dieser Funktion macht die Schriftart geräteabhängig. Verwenden Sie „ setPointSize()“ oder „ setPointSizeF()“, um die Größe der Schriftart geräteunabhängig festzulegen.

Siehe auch ` pixelSize()`.

void QFont::setPointSize(int pointSize)

Stellt die Punktgröße auf „ pointSize “ ein. Die Punktgröße muss größer als Null sein.

Siehe auch „ pointSize()“ und „ setPointSizeF()“.

void QFont::setPointSizeF(qreal pointSize)

Stellt die Punktgröße auf pointSize ein. Die Punktgröße muss größer als Null sein. Die gewünschte Genauigkeit kann möglicherweise nicht auf allen Plattformen erreicht werden.

Siehe auch pointSizeF(), setPointSize() und setPixelSize().

void QFont::setStretch(int factor)

Legt den Stretch-Faktor für die Schriftart fest.

Der Stretch-Faktor entspricht einer komprimierten oder erweiterten Version der Schriftart oder wendet eine Stretch-Transformation an, die die Breite aller Zeichen in der Schriftart um factor Prozent verändert. Wenn Sie beispielsweise „ factor “ auf 150 setzen, werden alle Zeichen der Schriftart 1,5-mal (d. h. 150 %) breiter. Der minimale Dehnungsfaktor beträgt 1, der maximale Dehnungsfaktor 4000. Der Standard-Dehnungsfaktor ist „ AnyStretch “, wodurch jeder Dehnungsfaktor akzeptiert wird und keine Transformation auf die Schriftart angewendet wird.

Der Streckungsfaktor wird nur auf Kontur-Schriftarten angewendet. Bei Bitmap-Schriftarten wird der Streckungsfaktor ignoriert.

Siehe auch „ stretch()“ und „ QFont::Stretch “.

void QFont::setStrikeOut(bool enable)

Wenn „ enable “ wahr ist, wird „strikeout“ aktiviert; andernfalls wird „strikeout“ deaktiviert.

Siehe auch „ strikeOut()“ und „ QFontInfo “.

void QFont::setStyle(QFont::Style style)

Legt den Schriftstil auf „ style “ fest.

Siehe auch „ style()“, „ italic()“ und „ QFontInfo “.

void QFont::setStyleHint(QFont::StyleHint hint, QFont::StyleStrategy strategy = PreferDefault)

Legt den Stilhinweis und die Stilstrategie auf „ hint “ bzw. „ strategy “ fest.

Wenn diese nicht explizit festgelegt sind, wird der Stilhinweis standardmäßig auf „ AnyStyle “ und die Stilstrategie auf „ PreferDefault “ gesetzt.

Qt unterstützt keine Stilhinweise unter X11, da diese Informationen vom Fenstersystem nicht bereitgestellt werden.

Siehe auch StyleHint, styleHint(), StyleStrategy, styleStrategy() und QFontInfo.

void QFont::setStyleName(const QString &styleName)

Legt den Stilnamen der Schriftart auf „ styleName “ fest. Bei dieser Einstellung werden andere Stileigenschaften wie „ style()“ und „ weight()“ bei der Schriftartzuordnung ignoriert, können jedoch anschließend simuliert werden, sofern dies von der Schriftart-Engine der Plattform unterstützt wird.

Aufgrund der geringeren Qualität künstlich simulierter Stile und der fehlenden vollständigen plattformübergreifenden Unterstützung wird davon abgeraten, den Abgleich nach Stilnamen zusammen mit dem Abgleich nach Stileigenschaften zu verwenden

Siehe auch ` styleName()`.

void QFont::setStyleStrategy(QFont::StyleStrategy s)

Legt die Stilstrategie für die Schriftart auf „ s “ fest.

Siehe auch „ styleStrategy()“ und „ QFont::StyleStrategy “.

void QFont::setUnderline(bool enable)

Wenn „ enable “ wahr ist, wird die Unterstreichung aktiviert; andernfalls wird sie deaktiviert.

Siehe auch „ underline()“ und „ QFontInfo “.

[since 6.7] void QFont::setVariableAxis(QFont::Tag tag, float value)

Wendet eine „ value “ auf die variable Achse an, die „ tag “ entspricht.

Variable Schriftarten bieten die Möglichkeit, mehrere Varianten (mit unterschiedlichen Strichstärken, Breiten oder Stilen) in derselben Schriftartdatei zu speichern. Die Varianten werden als Gleitkommawerte für einen vordefinierten Satz von Parametern angegeben, die als „Variable Achsen“ bezeichnet werden. Bestimmte Instanzen werden in der Regel vom Schriftdesigner benannt, und in Qt können diese mithilfe von ` setStyleName()` genau wie herkömmliche Unterfamilien ausgewählt werden.

In einigen Fällen ist es auch sinnvoll, beliebige Werte für die verschiedenen Achsen anzugeben. Wenn eine Schriftart beispielsweise eine „Regular“- und eine „Bold“-Unterfamilie hat, möchten Sie vielleicht eine Strichstärke dazwischen. Dies könnten Sie dann manuell anfordern, indem Sie einen benutzerdefinierten Wert für die „wght“-Achse der Schriftart angeben.

QFont font;
font.setVariableAxis("wght", (QFont::Normal + QFont::Bold) / 2.0f);

Wenn die „wght“-Achse von der Schriftart unterstützt wird und der angegebene Wert innerhalb des definierten Bereichs liegt, wird eine Schriftart bereitgestellt, die der Strichstärke 550,0 entspricht.

Es gibt einige Standardachsen, die von vielen Schriftarten bereitgestellt werden, wie beispielsweise „wght“ (Strichstärke), „wdth“ (Breite), „ital“ (Kursiv) und „opsz“ (optische Größe). Für jede dieser Achsen sind in der Schriftart selbst individuelle Bereiche definiert. Beispielsweise kann „wght“ im Bereich von 100 bis 900 (QFont::Thin bis QFont::Black) liegen, während „ital“ im Bereich von 0 bis 1 (von nicht kursiv bis vollständig kursiv) liegen kann.

Eine Schriftart kann auch benutzerdefinierte Achsen festlegen; die einzige Einschränkung besteht darin, dass der Name den Anforderungen an eine „ QFont::Tag “ (eine Folge von vier Latin-1-Zeichen) entsprechen muss.

Standardmäßig sind keine variablen Achsen festgelegt.

Diese Funktion wurde in Qt 6.7 eingeführt.

Siehe auch „ unsetVariableAxis “.

void QFont::setWeight(QFont::Weight weight)

Legt die Schriftstärke auf „ weight “ fest und verwendet dabei die durch die Aufzählung „ QFont::Weight “ definierte Skalierung.

Siehe auch ` weight()` und ` QFontInfo`.

void QFont::setWordSpacing(qreal spacing)

Legt den Wortabstand für die Schriftart auf „ spacing “ fest.

Der Wortabstand verändert den Standardabstand zwischen einzelnen Wörtern. Ein positiver Wert vergrößert den Wortabstand um die entsprechende Anzahl an Pixeln, während ein negativer Wert den Wortabstand entsprechend verringert.

Der Wortabstand gilt nicht für Schriftsysteme, in denen einzelne Wörter nicht durch Leerzeichen getrennt sind.

Siehe auch „ wordSpacing “ () und „ setLetterSpacing “ ().

int QFont::stretch() const

Gibt den Stretch-Faktor für die Schriftart zurück.

Siehe auch „ setStretch()“.

bool QFont::strikeOut() const

Gibt „ true “ zurück, wenn „strikeout“ gesetzt wurde; andernfalls wird „ false “ zurückgegeben.

Siehe auch „ setStrikeOut()“.

QFont::Style QFont::style() const

Gibt den Stil der Schriftart zurück.

Siehe auch „ setStyle()“.

QFont::StyleHint QFont::styleHint() const

Gibt den „ StyleHint “ zurück.

Der Stilhinweis wirkt sich auf das ` font matching algorithm` aus. Eine Liste der verfügbaren Hinweise finden Sie unter QFont::StyleHint.

Siehe auch setStyleHint(), QFont::StyleStrategy und QFontInfo::styleHint().

QString QFont::styleName() const

Gibt den Namen des angeforderten Schriftstils zurück. Dies kann verwendet werden, um die Schriftart mit unregelmäßigen Stilen abzugleichen (die in anderen Stileigenschaften nicht normalisiert werden können).

Siehe auch setStyleName(), setFamily() und setStyle().

QFont::StyleStrategy QFont::styleStrategy() const

Gibt den Wert „ StyleStrategy “ zurück.

Die Stilstrategie wirkt sich auf den Algorithmus „ font matching “ aus. Eine Liste der verfügbaren Strategien finden Sie unter QFont::StyleStrategy.

Siehe auch setStyleStrategy(), setStyleHint() und QFont::StyleHint.

[static] QString QFont::substitute(const QString &familyName)

Gibt den ersten Familiennamen zurück, der verwendet wird, wenn „ familyName “ angegeben wird. Bei der Suche wird die Groß-/Kleinschreibung nicht berücksichtigt.

Wenn für ` familyName` keine Ersetzung vorhanden ist, wird ` familyName ` zurückgegeben.

Um eine Liste der Ersetzungen zu erhalten, verwenden Sie ` substitutes()`.

Siehe auch setFamily(), insertSubstitutions(), insertSubstitution() und removeSubstitutions().

[static] QStringList QFont::substitutes(const QString &familyName)

Gibt eine Liste von Familiennamen zurück, die verwendet werden soll, wenn „ familyName “ angegeben wird. Bei der Suche wird die Groß-/Kleinschreibung nicht berücksichtigt.

Wenn für ` familyName` keine Ersetzung vorhanden ist, wird eine leere Liste zurückgegeben.

Siehe auch „ substitute()“, „ insertSubstitutions()“, „ insertSubstitution()“ und „ removeSubstitutions()“.

[static] QStringList QFont::substitutions()

Gibt eine sortierte Liste der ersetzten Familiennamen zurück.

Siehe auch insertSubstitution(), removeSubstitutions() und substitute().

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

Ersetzt diese Schriftartinstanz durch „ other “. Dieser Vorgang ist sehr schnell und schlägt niemals fehl.

QString QFont::toString() const

Gibt eine Beschreibung der Schriftart zurück. Die Beschreibung ist eine durch Kommas getrennte Liste der Attribute, die sich ideal für die Verwendung in QSettings eignet und aus folgenden Elementen besteht:

• Schriftfamilie
• Schriftgröße
• Pixelgröße
• Stilhinweis
• Schriftstärke
• Schriftstil
• Unterstreichung
• Durchgestrichen
• Festbreite
• Immer 0
• Großschreibung
• Buchstabenabstand
• Wortabstand
• Dehnung
• Stilstrategie
• Schriftart
• Schriftmerkmale
• Variable Achsen

Siehe auch „ fromString“ ().

bool QFont::underline() const

Gibt „ true “ zurück, wenn „underline“ gesetzt wurde; andernfalls gibt es „ false “ zurück.

Siehe auch setUnderline().

[since 6.7] void QFont::unsetFeature(QFont::Tag tag)

Entfernt die „ tag “ aus der Zuordnung der explizit aktivierten bzw. deaktivierten Funktionen.

Das Aufheben eines bestehenden Merkmals in der „ QFont “ setzt das Verhalten auf die Standardeinstellung zurück.

Weitere Details zu Schriftartfunktionen finden Sie unter setFeature().

Diese Funktion wurde in Qt 6.7 eingeführt.

Siehe auch QFont::Tag, clearFeatures(), setFeature(), featureTags() und featureValue().

[since 6.7] void QFont::unsetVariableAxis(QFont::Tag tag)

Hebt einen zuvor festgelegten Wert für eine variable Achse auf, der durch „ tag “ angegeben wurde.

Diese Funktion wurde in Qt 6.7 eingeführt.

Siehe auch „ setVariableAxis “.

[since 6.7] QList<QFont::Tag> QFont::variableAxisTags() const

Gibt eine Liste der Tags für alle derzeit auf diesem „ QFont “ festgelegten variablen Achsen zurück.

Weitere Informationen zu variablen Achsen finden Sie unter ` setVariableAxis()`.

Diese Funktion wurde in Qt 6.7 eingeführt.

Siehe auch „ QFont::Tag“ , „ setVariableAxis()“, „ unsetVariableAxis()“, „ isVariableAxisSet()“ und „ clearVariableAxes()“.

[since 6.7] float QFont::variableAxisValue(QFont::Tag tag) const

Gibt den für eine bestimmte Variablenachse festgelegten Wert zurück: tag. Wenn das Tag nicht gesetzt wurde, wird stattdessen 0,0 zurückgegeben.

Weitere Informationen zu variablen Achsen finden Sie unter ` setVariableAxis()`.

Diese Funktion wurde in Qt 6.7 eingeführt.

Siehe auch QFont::Tag, setVariableAxis(), unsetVariableAxis(), isVariableAxisSet() und clearVariableAxes().

QFont::Weight QFont::weight() const

Gibt die Schriftstärke zurück, wobei dieselbe Skala wie bei der Aufzählung „ QFont::Weight “ verwendet wird.

Siehe auch setWeight(), Weight und QFontInfo.

qreal QFont::wordSpacing() const

Gibt den Wortabstand für die Schriftart zurück.

Siehe auch „ setWordSpacing()“ und „ setLetterSpacing()“.

QFont::operator QVariant() const

Gibt die Schriftart als QVariant

bool QFont::operator!=(const QFont &f) const

Gibt „ true “ zurück, wenn sich diese Schriftart von „ f “ unterscheidet; andernfalls wird „ false “ zurückgegeben.

Zwei QFonts gelten als unterschiedlich, wenn sich ihre Schriftattribute unterscheiden.

Siehe auch operator==().

bool QFont::operator<(const QFont &f) const

Bietet einen beliebigen Vergleich dieser Schriftart mit der Schriftart f. Es wird lediglich garantiert, dass der Operator false zurückgibt, wenn beide Schriftarten gleich sind, und dass (f1 < f2) == !(f2 < f1) gilt, wenn die Schriftarten nicht gleich sind.

Diese Funktion ist unter bestimmten Umständen nützlich, beispielsweise wenn Sie Objekte vom Typ „ QFont “ als Schlüssel in einem „ QMap “ verwenden möchten.

Siehe auch „ operator==()“, „ operator!=()“ und „ isCopyOf()“.

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

Weist „ other “ dieser „ QFont “-Instanz zu.

QFont &QFont::operator=(const QFont &font)

Weist dieser Schriftart „ font “ zu und gibt eine Referenz darauf zurück.

bool QFont::operator==(const QFont &f) const

Gibt „ true “ zurück, wenn diese Schriftart mit „ f “ übereinstimmt; andernfalls wird „false“ zurückgegeben.

Zwei QFonts gelten als gleich, wenn ihre Schriftartattribute identisch sind.

Siehe auch operator!=() und isCopyOf().