QFontDatabase类

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());
    }
}

成员函数文档

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

加载由 fileName 指定的文件中的字体，并将其提供给应用程序。返回一个 ID，可用于通过 removeApplicationFont() 删除字体，或检索字体中包含的字体名称列表。

如果无法加载字体，函数返回 -1。

目前仅支持 TrueType 字体、TrueType 字体集合和 OpenType 字体。

另请参阅 addApplicationFontFromData()、applicationFontFamilies() 和 removeApplicationFont()。

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

从由 fontData 指定的二进制数据中加载字体，并将其提供给应用程序。返回一个 ID，可用于通过 removeApplicationFont() 再次删除字体或检索字体中包含的字体名称列表。

如果无法加载字体，函数返回 -1。

目前仅支持 TrueType 字体、TrueType 字体集合和 OpenType 字体。

另请参阅 addApplicationFont()、applicationFontFamilies() 和 removeApplicationFont()。

[静态] QStringList QFontDatabase::applicationFontFamilies(int id)

返回由 id 标识的应用程序字体的字体家族列表。

另请参阅 addApplicationFont() 和 addApplicationFontFromData()。

[静态] QString QFontDatabase::bold(const QString &family, const QString &style)

如果具有 family 家族和 style 风格的字体是粗体，则返回 true；否则返回 false。

另请参阅 italic() 和 weight()。

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

返回支持 writingSystem 的可用字体家族的排序列表。

如果某个家族存在于多个字体库中，返回的该字体名称将采用 "family [foundry]" 的形式。示例： "Times [Adobe]"、"Times [Cronyx]"、 "Palatino"。

另请参阅 writingSystems()。

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

返回一个具有字体族 family、样式 style 和点大小 pointSize 的 QFont 对象。如果无法创建匹配的字体，则返回一个使用应用程序默认字体的 QFont 对象。

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

如果具有字体族 family 和样式 style 的字体是可缩放位图字体，则返回 true；否则返回 false。缩放位图字体通常会产生难以阅读的结果，因为字体的像素被缩放。如果您需要缩放位图字体，最好将其缩放到 smoothSizes() 返回的固定尺寸之一。

参见 isScalable() 和 isSmoothlyScalable。

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

如果具有字体族 family 和样式 style 的字体是等宽字体，则返回 true；否则返回 false。

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

如果且仅当字体族 family 是私有字体时，返回 true。

例如，在 macOS 和 iOS 上，系统 UI 字体对用户不可用。为了完整性，QFontDatabase::families() 返回所有字体族，包括私有字体。如果您正在开发字体选择控件，则应使用此函数以隐藏私有字体。

参见 families。

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

如果具有字体族 family 和样式 style 的字体是可缩放字体，则返回 true；否则返回 false。

参见 isBitmapScalable() 和 isSmoothlyScalable。

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

如果具有字体族 family 和样式 style 的字体是平滑可缩放的，则返回 true；否则返回 false。如果此函数返回 true，则可以安全地将此字体缩放到任何大小，并且结果始终看起来很吸引人。

参见 isScalable() 和 isBitmapScalable。

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

如果具有family字体和style样式的字体是斜体，则返回true；否则返回false。

另请参阅weight()和bold。

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

返回适合具有family字体和styleName样式的字体的点大小列表。列表可能为空。

另请参阅smoothSizes()和standardSizes。

[静态] bool QFontDatabase::removeAllApplicationFonts()

删除之前使用addApplicationFont()和addApplicationFontFromData()添加的所有应用程序本地字体。

如果字体卸载成功，则返回true；否则返回false。

另请参阅removeApplicationFont、addApplicationFont和addApplicationFontFromData。

[静态] bool QFontDatabase::removeApplicationFont(int id)

删除通过id标识的先前加载的应用程序字体。如果字体卸载成功，则返回true；否则返回false。

另请参阅removeAllApplicationFonts、addApplicationFont和addApplicationFontFromData。

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

返回具有family字体和styleName样式的点大小，该点大小看起来很吸引人。列表可能为空。对于不可缩放字体和位图可缩放字体，此函数与pointSizes等效。

另请参阅pointSizes和standardSizes。

[静态] QList<int> QFontDatabase::standardSizes()

返回标准字体大小的列表。

另请参阅smoothSizes和pointSizes。

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

返回描述font样式的字符串。例如，“Bold Italic”、“Bold”、“Italic”或“Normal”。可能会返回空字符串。

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

返回描述fontInfo样式的字符串。例如，“加粗斜体”，“加粗”，“斜体”或“常规”。可能返回空字符串。

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

返回可用于字体族family的样式列表。一些示例样式：“轻”， “轻斜体”， “加粗”， “倾斜”， “半粗”。列表可能为空。

参见 families。

[静态] QFont QFontDatabase::systemFont(QFontDatabase::SystemFont type)

返回最适合给定type情况的字体，以便与系统的外观和感觉良好集成。

另请参阅QGuiApplication::font。

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

返回具有family和style样式的字体的重量。如果没有此类家族和样式组合，则返回-1。

另请参阅italic() 和 bold（）。

[静态] QString QFontDatabase::writingSystemName(QFontDatabase::WritingSystem writingSystem)

返回writingSystem的名称（例如，在对话框中显示给用户）。

[静态] QString QFontDatabase::writingSystemSample(QFontDatabase::WritingSystem writingSystem)

返回来自writingSystem的示例字符字符串。

[静态] QList<QFontDatabase::WritingSystem> QFontDatabase::writingSystems()

返回可用书写系统的有序列表。这是根据系统上安装的所有字体的信息生成的列表。

参见 families。

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

返回支持给定字体family的书写系统的有序列表。

参见 families。