QFontDatabase Class

QTreeWidget fontTree;
fontTree.setColumnCount(2);
fontTree.setHeaderLabels(QStringList() << "Font" << "Smooth Sizes");

const QStringList fontFamilies = QFontDatabase::families();
for (const QString &family : fontFamilies) {
    QTreeWidgetItem *familyItem = new QTreeWidgetItem(&fontTree);
    familyItem->setText(0, family);

    const QStringList fontStyles = QFontDatabase::styles(family);
    for (const QString &style : fontStyles) {
        QTreeWidgetItem *styleItem = new QTreeWidgetItem(familyItem);
        styleItem->setText(0, style);

        QString sizes;
        const QList<int> smoothSizes = QFontDatabase::smoothSizes(family, style);
        for (const auto &points : smoothSizes)
            sizes += QString::number(points) + ' ';

        styleItem->setText(1, sizes.trimmed());
    }
}

Dokumentation zu Mitgliedsfunktionen

[static, since 6.9] void QFontDatabase::addApplicationEmojiFontFamily(const QString &familyName)

Fügt „ familyName “ als anwendungsdefinierte Emoji-Schriftart hinzu.

Zur Darstellung mehrfarbiger Emojis oder Emoji-Sequenzen verwendet Qt standardmäßig die systemeigene Emoji-Schriftart. Manchmal möchte die Anwendung diese Standardeinstellung überschreiben, entweder um einen bestimmten visuellen Stil zu erzielen oder um Emojis anzuzeigen, die vom System nicht unterstützt werden.

Diese Funktion wurde in Qt 6.9 eingeführt.

Siehe auch „ removeApplicationEmojiFontFamily“ , „ setApplicationEmojiFontFamilies()“, „ applicationEmojiFontFamilies()“ und „ addApplicationFallbackFontFamily()“.

[static, since 6.8] void QFontDatabase::addApplicationFallbackFontFamily(QChar::Script script, const QString &familyName)

Fügt „ familyName “ als anwendungsdefinierte Ausweichschriftart für „ script “ hinzu.

Wenn Qt auf Zeichen stößt, die von der ausgewählten Schriftart nicht unterstützt werden, durchsucht es eine Liste von Ausweichschriftarten, um eine passende Schriftart zu finden. Dadurch wird sichergestellt, dass die Kombination mehrerer Schriftsysteme in einer einzigen Zeichenkette möglich ist, selbst wenn die Hauptschriftart diese nicht unterstützt.

Die Liste der Fallback-Schriftarten wird auf der Grundlage des Schriftsystems der Zeichenkette sowie weiterer Bedingungen, wie beispielsweise der Systemsprache, ausgewählt.

Zwar reicht die systemeigene Ausweichliste in der Regel aus, doch gibt es Fälle, in denen es sinnvoll ist, das Standardverhalten zu überschreiben. Ein solcher Fall ist die Verwendung von Anwendungsschriftarten als Ausweichschriftarten, um plattformübergreifende Konsistenz zu gewährleisten.

In einem anderen Fall könnte die Anwendung in einer Schrift geschrieben sein, die regionale Unterschiede aufweist, und man möchte sie in mehreren Regionen unübersetzt ausführen. In diesem Fall kann es sinnvoll sein, die Fallback-Schrift der lokalen Region durch eine zu überschreiben, die der Sprache der Anwendung entspricht.

Durch die Übergabe von „ familyName “ an „addApplicationFallbackFontFamily()“ wird diese zur bevorzugten Schriftfamilie, wenn fehlende Zeichen aus „ script “ abgeglichen werden. „ script “ muss ein gültiges Schriftsystem sein (QChar::Script_Latin oder höher). Beim Hinzufügen mehrerer Schriftarten für dasselbe Schriftsystem werden diese in umgekehrter Reihenfolge priorisiert, sodass die zuletzt hinzugefügte Schriftfamilie zuerst geprüft wird und so weiter.

Diese Funktion wurde in Qt 6.8 eingeführt.

Siehe auch setApplicationFallbackFontFamilies(), removeApplicationFallbackFontFamily() und applicationFallbackFontFamilies().

[static] int QFontDatabase::addApplicationFont(const QString &fileName)

Lädt die Schriftart aus der durch ` fileName ` angegebenen Datei und stellt sie der Anwendung zur Verfügung. Es wird eine ID zurückgegeben, mit der die Schriftart über ` removeApplicationFont()` wieder entfernt oder die Liste der in der Schriftart enthaltenen Familiennamen abgerufen werden kann.

Die Funktion gibt -1 zurück, wenn die Schriftart nicht geladen werden konnte.

Derzeit werden nur TrueType-Schriftarten, TrueType-Schriftensammlungen und OpenType-Schriftarten unterstützt.

Siehe auch ` addApplicationFontFromData()`, ` applicationFontFamilies()` und ` removeApplicationFont()`.

[static] int QFontDatabase::addApplicationFontFromData(const QByteArray &fontData)

Lädt die Schriftart aus den durch ` fontData ` angegebenen Binärdaten und stellt sie der Anwendung zur Verfügung. Es wird eine ID zurückgegeben, mit der die Schriftart über ` removeApplicationFont()` wieder entfernt oder die Liste der in der Schriftart enthaltenen Familiennamen abgerufen werden kann.

Die Funktion gibt -1 zurück, wenn die Schriftart nicht geladen werden konnte.

Derzeit werden nur TrueType-Schriftarten, TrueType-Schriftartensammlungen und OpenType-Schriftarten unterstützt.

Siehe auch ` addApplicationFont()`, ` applicationFontFamilies()` und ` removeApplicationFont()`.

[static, since 6.9] QStringList QFontDatabase::applicationEmojiFontFamilies()

Gibt die Liste der anwendungsdefinierten Emoji-Schriftfamilien zurück.

Diese Funktion wurde in Qt 6.9 eingeführt.

Siehe auch addApplicationEmojiFontFamily(), removeApplicationEmojiFontFamily(), setApplicationEmojiFontFamilies() und applicationFallbackFontFamilies().

[static, since 6.8] QStringList QFontDatabase::applicationFallbackFontFamilies(QChar::Script script)

Gibt die Liste der anwendungsdefinierten Fallback-Schriftfamilien zurück, die zuvor mit der Funktion „ addApplicationFallbackFontFamily()“ für „ script “ hinzugefügt wurden.

Diese Funktion wurde in Qt 6.8 eingeführt.

Siehe auch „ setApplicationFallbackFontFamilies()“, „ addApplicationFallbackFontFamily()“ und „ removeApplicationFallbackFontFamily()“.

[static] QStringList QFontDatabase::applicationFontFamilies(int id)

Gibt eine Liste der Schriftfamilien für die angegebene Anwendungsschriftart zurück, die durch id identifiziert wird.

Siehe auch addApplicationFont() und addApplicationFontFromData().

[static] bool QFontDatabase::bold(const QString &family, const QString &style)

Gibt „ true “ zurück, wenn die Schriftart mit der Familie „ family “ und dem Stil „ style “ fett ist; andernfalls wird „ false “ zurückgegeben.

Siehe auch italic() und weight().

[static] QStringList QFontDatabase::families(QFontDatabase::WritingSystem writingSystem = Any)

Gibt eine sortierte Liste der verfügbaren Schriftfamilien zurück, die das „ writingSystem “ unterstützen.

Wenn eine Schriftfamilie bei mehreren Schriftherstellern existiert, wird der Name dieser Schrift in der Form „Schriftfamilie [Schrift Hersteller]“ zurückgegeben. Beispiele: „Times [Adobe]“, „Times [Cronyx]“, „Palatino“.

Siehe auch writingSystems().

[static] QFont QFontDatabase::font(const QString &family, const QString &style, int pointSize)

Gibt ein „ QFont “-Objekt zurück, das die Schriftfamilie family, den Stil style und die Schriftgröße pointSize aufweist. Wenn keine passende Schriftart erstellt werden konnte, wird ein „ QFont “-Objekt zurückgegeben, das die Standardschriftart der Anwendung verwendet.

[static] bool QFontDatabase::isBitmapScalable(const QString &family, const QString &style = QString())

Gibt „ true “ zurück, wenn die Schriftart mit der Familie „ family “ und dem Stil „ style “ eine skalierbare Bitmap-Schriftart ist; andernfalls wird „ false “ zurückgegeben. Das Skalieren einer Bitmap-Schriftart führt in der Regel zu einem unansehnlichen, kaum lesbaren Ergebnis, da die Pixel der Schriftart dabei skaliert werden. Wenn Sie eine Bitmap-Schriftart skalieren müssen, ist es besser, sie auf eine der festen Größen zu skalieren, die von „ smoothSizes()“ zurückgegeben werden.

Siehe auch isScalable() und isSmoothlyScalable().

[static] bool QFontDatabase::isFixedPitch(const QString &family, const QString &style = QString())

Gibt „ true “ zurück, wenn die Schriftart mit der Familie „ family “ und dem Stil „ style “ eine Monospace-Schrift ist; andernfalls wird „ false “ zurückgegeben.

[static] bool QFontDatabase::isPrivateFamily(const QString &family)

Gibt „ true “ zurück, genau dann, wenn die Schriftfamilie „ family “ privat ist.

Dies ist beispielsweise unter macOS und iOS der Fall, wo die System-UI-Schriftarten für den Benutzer nicht zugänglich sind. Der Vollständigkeit halber gibt „ QFontDatabase::families()“ alle Schriftfamilien zurück, einschließlich der privaten. Sie sollten diese Funktion verwenden, wenn Sie ein Steuerelement zur Schriftartauswahl entwickeln, um private Schriftarten verborgen zu halten.

Siehe auch ` families()`.

[static] bool QFontDatabase::isScalable(const QString &family, const QString &style = QString())

Gibt „ true “ zurück, wenn die Schriftart mit der Familie „ family “ und dem Stil „ style “ skalierbar ist; andernfalls wird „ false “ zurückgegeben.

Siehe auch isBitmapScalable() und isSmoothlyScalable().

[static] bool QFontDatabase::isSmoothlyScalable(const QString &family, const QString &style = QString())

Gibt „ true “ zurück, wenn die Schriftart mit der Familie „ family “ und dem Stil „ style “ stufenlos skalierbar ist; andernfalls wird „ false “ zurückgegeben. Wenn diese Funktion „ true “ zurückgibt, kann diese Schriftart problemlos auf jede beliebige Größe skaliert werden, und das Ergebnis wird stets ansprechend aussehen.

Siehe auch isScalable() und isBitmapScalable().

[static] bool QFontDatabase::italic(const QString &family, const QString &style)

Gibt „ true “ zurück, wenn die Schriftart mit der Familie „ family “ und dem Stil „ style “ kursiv ist; andernfalls wird „ false “ zurückgegeben.

Siehe auch weight() und bold().

[static] QList<int> QFontDatabase::pointSizes(const QString &family, const QString &styleName = QString())

Gibt eine Liste der für die Schriftart mit der Familie family und dem Stil styleName verfügbaren Punktgrößen zurück. Die Liste kann leer sein.

Siehe auch smoothSizes() und standardSizes().

[static] bool QFontDatabase::removeAllApplicationFonts()

Entfernt alle anwendungsspezifischen Schriftarten, die zuvor mit den Funktionen „ addApplicationFont()“ und „ addApplicationFontFromData()“ hinzugefügt wurden.

Gibt „ true “ zurück, wenn das Entladen der Schriftarten erfolgreich war; andernfalls wird „ false “ zurückgegeben.

Siehe auch removeApplicationFont(), addApplicationFont() und addApplicationFontFromData().

[static, since 6.9] bool QFontDatabase::removeApplicationEmojiFontFamily(const QString &familyName)

Entfernt „ familyName “ aus der Liste der anwendungsdefinierten Emoji-Schriftarten, sofern diese zuvor mit „ addApplicationEmojiFontFamily()“ hinzugefügt wurde.

Gibt „true“ zurück, wenn der Familienname in der Liste enthalten war, und „false“, wenn dies nicht der Fall war.

Diese Funktion wurde in Qt 6.9 eingeführt.

Siehe auch „ addApplicationEmojiFontFamily()“, „ setApplicationEmojiFontFamilies()“, „ applicationEmojiFontFamilies()“ und „ removeApplicationFallbackFontFamily()“.

[static, since 6.8] bool QFontDatabase::removeApplicationFallbackFontFamily(QChar::Script script, const QString &familyName)

Entfernt „ familyName “ aus der Liste der anwendungsdefinierten Ersatzschriftarten für „ script “, vorausgesetzt, diese wurde zuvor mit „ addApplicationFallbackFontFamily()“ hinzugefügt.

Gibt „true“ zurück, wenn der Familienname in der Liste enthalten war, und „false“, wenn dies nicht der Fall war.

Diese Funktion wurde in Qt 6.8 eingeführt.

Siehe auch „ addApplicationFallbackFontFamily()“, „ setApplicationFallbackFontFamilies()“ und „ applicationFallbackFontFamilies()“.

[static] bool QFontDatabase::removeApplicationFont(int id)

Entfernt die zuvor geladene Anwendungsschriftart, die durch id identifiziert wird. Gibt true zurück, wenn das Entladen der Schriftart erfolgreich war; andernfalls wird false zurückgegeben.

Siehe auch removeAllApplicationFonts(), addApplicationFont() und addApplicationFontFromData().

[static, since 6.9] void QFontDatabase::setApplicationEmojiFontFamilies(const QStringList &familyNames)

Setzt die Liste der anwendungsdefinierten Emoji-Schriftarten auf „ familyNames “.

Diese Funktion wurde in Qt 6.9 eingeführt.

Siehe auch addApplicationEmojiFontFamily(), removeApplicationEmojiFontFamily(), applicationEmojiFontFamilies() und setApplicationFallbackFontFamilies().

[static, since 6.8] void QFontDatabase::setApplicationFallbackFontFamilies(QChar::Script script, const QStringList &familyNames)

Legt die Liste der anwendungsdefinierten Ausweichschriftarten für „ script “ auf „ familyNames “ fest.

Wenn Qt in „ script “ auf ein Zeichen stößt, das von der aktuellen Schriftart nicht unterstützt wird, überprüft es die Schriftfamilien in „ familyNames “ der Reihe nach von der ersten bis zur letzten, bis es eine Übereinstimmung findet. Weitere Details finden Sie unter „ addApplicationFallbackFontFamily()“.

Diese Funktion überschreibt die aktuelle Liste der anwendungsdefinierten Fallback-Schriftarten für script.

Diese Funktion wurde in Qt 6.8 eingeführt.

Siehe auch addApplicationFallbackFontFamily(), removeApplicationFallbackFontFamily() und applicationFallbackFontFamilies().

[static] QList<int> QFontDatabase::smoothSizes(const QString &family, const QString &styleName)

Gibt die Punktgrößen einer Schriftart zurück, die bei der Familie family und dem Stil styleName ansprechend aussieht. Die Liste kann leer sein. Bei nicht skalierbaren Schriftarten und bitmap-skalierbaren Schriftarten entspricht diese Funktion der Funktion pointSizes().

Siehe auch pointSizes() und standardSizes().

[static] QList<int> QFontDatabase::standardSizes()

Gibt eine Liste der Standardschriftgrößen zurück.

Siehe auch „ smoothSizes()“ und „ pointSizes()“.

[static] QString QFontDatabase::styleString(const QFont &font)

Gibt eine Zeichenkette zurück, die den Stil des „ font “ beschreibt. Zum Beispiel „Fett und kursiv“, „Fett“, „Kursiv“ oder „Normal“. Es kann auch eine leere Zeichenkette zurückgegeben werden.

[static] QString QFontDatabase::styleString(const QFontInfo &fontInfo)

Gibt eine Zeichenkette zurück, die den Stil des „ fontInfo “ beschreibt. Zum Beispiel „Fett und kursiv“, „Fett“, „Kursiv“ oder „Normal“. Es kann auch eine leere Zeichenkette zurückgegeben werden.

[static] QStringList QFontDatabase::styles(const QString &family)

Gibt eine Liste der für die Schriftfamilie „ family “ verfügbaren Schriftstile zurück. Einige Beispielstile: „Light“, „Light Italic“, „Bold“, „Oblique“, „Demi“. Die Liste kann leer sein.

Siehe auch families().

[static] QFont QFontDatabase::systemFont(QFontDatabase::SystemFont type)

Gibt die am besten geeignete Schriftart für einen bestimmten type -Fall zurück, um eine nahtlose Integration in das Erscheinungsbild des Systems zu gewährleisten.

Siehe auch QGuiApplication::font().

[static] int QFontDatabase::weight(const QString &family, const QString &style)

Gibt die Schriftstärke der Schriftart mit der Familie „ family “ und dem Stil „ style “ zurück. Wenn es keine solche Kombination aus Familie und Stil gibt, wird -1 zurückgegeben.

Siehe auch italic() und bold().

[static] QString QFontDatabase::writingSystemName(QFontDatabase::WritingSystem writingSystem)

Gibt die Namen der „ writingSystem “ zurück (z. B. zur Anzeige für den Benutzer in einem Dialogfeld).

[static] QString QFontDatabase::writingSystemSample(QFontDatabase::WritingSystem writingSystem)

Gibt eine Zeichenkette mit Beispielzeichen aus writingSystem zurück.

[static] QList<QFontDatabase::WritingSystem> QFontDatabase::writingSystems()

Gibt eine sortierte Liste der verfügbaren Schriftsysteme zurück. Diese Liste wird anhand der Informationen zu allen auf dem System installierten Schriftarten erstellt.

Siehe auch „ families“ ().

[static] QList<QFontDatabase::WritingSystem> QFontDatabase::writingSystems(const QString &family)

Gibt eine sortierte Liste der von einer bestimmten Schriftart unterstützten Schriftsysteme zurück family.

Siehe auch families().