QFont 类

成员函数文档

QFont::QFont()

构造一个使用应用程序默认字体的字体对象。

参见 QGuiApplication::setFont() 和 QGuiApplication::font。

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

使用指定的family、pointSize、weight 和 italic 设置构造一个字体对象。

如果 pointSize 是零或负数，则字体的大小将设置为系统依赖的默认值。通常，这是12点。

family 名称可能还包含字库名称，例如 "Helvetica [Cronyx]"。如果来自多个字库，并且没有指定字库，则随机选择一个字库。如果字体族不可用，将使用字体匹配算法设置字体族。

此操作将在家谱字符串上拆分逗号，并使用结果列表调用setFamilies()。为了保留使用逗号命名的字体，请使用接受QStringList的构造函数。

另请参阅Weight、setFamily()、setPointSize()、setWeight()、setItalic()、setStyleHint()、setFamilies和QGuiApplication::font。

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

使用指定的families、pointSize、weight和italic设置构造字体对象。

如果 pointSize 是零或负数，则字体的大小将设置为系统依赖的默认值。通常，这是12点。

families中的每个家族名称条目可以选择包含一个厂商名称，例如“Helvetica [Cronyx]”。如果家族从多个厂商可用且未指定厂商，则选择任意厂商。如果家族不可用，将使用字体匹配算法设置家族。

另请参阅Weight、setPointSize()、setWeight()、setItalic()、setStyleHint()、setFamilies和QGuiApplication::font。

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

在画布设备pd上使用font构造一个字体。

QFont::QFont(const QFont &font)

构造一个与font相同的字体。

[noexcept] QFont::~QFont()

销毁字体对象并释放所有分配的资源。

bool QFont::bold() const

如果weight()的值大于QFont::Medium，则返回true；否则返回false。

另请参阅weight()、setBold()和QFontInfo::bold。

QFont::Capitalization QFont::capitalization() const

返回字体的当前大小写类型。

另请参阅setCapitalization。

[since 6.7] void QFont::clearFeatures()

清除之前在QFont中设置的任何功能。

有关字体功能的更多详细信息，请参阅setFeature()。

此功能是在Qt 6.7中引入的。

另请参阅QFont::Tag、setFeature()、unsetFeature()、featureTags和featureValue。

[since 6.7] void QFont::clearVariableAxes()

清除QFont上的之前设置的变量轴值。

有关变量轴的更多详细信息，请参阅setVariableAxis()。

此功能是在Qt 6.7中引入的。

另请参阅QFont::Tag、setVariableAxis()、unsetVariableAxis()、isVariableAxisSet()以及variableAxisValue。

QString QFont::defaultFamily() const

返回与当前样式提示相对应的家族名称。

另请参阅StyleHint、styleHint和setStyleHint。

bool QFont::exactMatch() const

如果可用的窗口系统字体与此字体设置精确匹配，则返回true。

另请参阅QFontInfo。

QStringList QFont::families() const

返回请求的字体家族名称，即最后在setFamilies()调用中设置或通过构造函数设置的名称。否则返回空列表。

另请参阅setFamily、setFamilies、family、substitutes和substitute。

QString QFont::family() const

返回请求的字体家族名称。这将始终与families()调用中的第一个条目相同。

另请参阅setFamily、substitutes、substitute、setFamilies和families。

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

返回设置在这个QFont上的所有字体特征的标签列表。

有关字体功能的更多详细信息，请参阅setFeature()。

此功能是在Qt 6.7中引入的。

另请参阅QFont::Tag、setFeature、unsetFeature、isFeatureSet和clearFeatures。

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

返回特定特性tag所设置的值。如果没有设置此标签，则返回0。

有关字体功能的更多详细信息，请参阅setFeature()。

此功能是在Qt 6.7中引入的。

另请参阅QFont::Tag、setFeature、unsetFeature、featureTags和isFeatureSet。

bool QFont::fixedPitch() const

如果已设置固定间距，则返回true；否则返回false。

另请参阅setFixedPitch和QFontInfo::fixedPitch。

bool QFont::fromString(const QString &descrip)

将当前字体设置为与描述符descrip相匹配。描述符是字体的属性列表，以逗号分隔，由toString()函数返回。

另请参阅toString()。

QFont::HintingPreference QFont::hintingPreference() const

返回当前对此字体渲染的符号的首选光栅化级别。

另请参阅setHintingPreference()。

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

将substituteName插入到家族familyName的替换表中。

替代字体后，销毁并重新创建所有的QFont对象，以触发字体的更新。

另请参阅insertSubstitutions()、removeSubstitutions()、substitutions()、substitute()和substitutes()。

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

将家族列表substituteNames插入到familyName的替换列表中。

替代字体后，销毁并重新创建所有的QFont对象，以触发字体的更新。

另请参阅insertSubstitution()、removeSubstitutions()、substitutions()和substitute()。

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

如果此字体和f是彼此的副本，则返回true（即其中一个被创建为另一个的副本，并且自那以后都没有被修改过）。这比等价性严格得多。

另请参阅operator=()和operator==()。

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

如果已经为QFont设置了由tag指定的功能值，则返回true，否则返回false。

有关字体功能的更多详细信息，请参阅setFeature()。

此功能是在Qt 6.7中引入的。

另请参阅QFont::Tag、setFeature()、unsetFeature()、featureTags和featureValue。

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

如果已设置由tag指定的变量轴的值，则返回true，否则返回false。

有关字体变量轴的更多信息，请参阅setVariableAxis()。

此功能是在Qt 6.7中引入的。

另请参阅QFont::Tag、setVariableAxis、unsetVariableAxis、variableAxisValue和clearVariableAxes。

bool QFont::italic() const

如果字体样式 style() 不是 QFont::StyleNormal，则返回 true

另见 setItalic() 和 style()。

bool QFont::kerning() const

如果使用此字体绘制文本需要使用字符间距，则返回 true。

另见 setKerning()。

QString QFont::key() const

返回字体的键，它是字体的文本表示形式。通常用作字体缓存或字典的键。

另见 QMap。

qreal QFont::letterSpacing() const

返回字体的字母间距。

另见 setLetterSpacing()，letterSpacingType() 和 setWordSpacing()。

QFont::SpacingType QFont::letterSpacingType() const

返回用于字母间距的间距类型。

另见 letterSpacing，setLetterSpacing 和 setWordSpacing。

bool QFont::overline() const

如果设置了上划线，则返回 true；否则返回 false。

另见 setOverline。

int QFont::pixelSize() const

如果字体是用 setPixelSize() 设置的，则返回字体的像素大小。如果大小是用 setPointSize() 或 setPointSizeF() 设置的，则返回 -1。

另见 setPixelSize，pointSize，QFontInfo::pointSize 和 QFontInfo::pixelSize。

int QFont::pointSize() const

返回字体的大小（以点为单位）。如果字体大小是以像素指定的，则返回 -1。

另见 setPointSize 和 pointSizeF。

qreal QFont::pointSizeF() const

返回字体的大小（以点为单位）。如果字体大小是以像素指定的，则返回 -1。

另见 pointSize，setPointSizeF，pixelSize，QFontInfo::pointSize 和 QFontInfo::pixelSize。

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

删除所有对 familyName 的替换。

另见 insertSubstitutions，insertSubstitution，substitutions 和 substitute。

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

返回一个新的具有从other中复制的未在此字体上预先设置的属性QFont。

void QFont::setBold(bool enable)

如果enable为真，则将字体权重设置为QFont::Bold；否则设置为QFont::Normal。

使用setWeight()进行更精细的加粗控制。

另请参阅：bold()和setWeight()。

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

将此字体中文本的格式化设置为caps。

字体的格式化会使文本以选定的格式化模式显示。

另请参阅：capitalization()。

void QFont::setFamilies(const QStringList &families)

设置字体的家族名称列表。名称不区分大小写，可能包含制作者名称。在families中的第一个家族将被设置为字体的主家族。

families中的每个家族名称条目可以选择包含一个厂商名称，例如“Helvetica [Cronyx]”。如果家族从多个厂商可用且未指定厂商，则选择任意厂商。如果家族不可用，将使用字体匹配算法设置家族。

另请参阅：family()，families()，setFamily()，setStyleHint()和QFontInfo()。

void QFont::setFamily(const QString &family)

设置字体的家族名称。名称不区分大小写，可能包含制作者名称。

family 名称可能还包含字库名称，例如 "Helvetica [Cronyx]"。如果来自多个字库，并且没有指定字库，则随机选择一个字库。如果字体族不可用，将使用字体匹配算法设置字体族。

另请参阅：family()，setStyleHint()，setFamilies()，families()和QFontInfo()。

[自6.7以来] void QFont::setFeature(QFont::Tag tag, quint32 value)

这是一个重载函数。

在形成文本时，对由tag指定的印刷特征应用整数值。这提供了对字体造型过程的更高级访问，并可用于支持API中未涵盖的字体特性。

该特征由一个tag指定，该tag通常是从字体特性映射中的四个字符特性名称编码而来的。

在这种情况下，传递给tag的整数value表示一个布尔值：值为零表示禁用特性，非零值表示启用。但对于某些字体特征，它可能有其他解释。例如，当应用于salt特性时，它的值是一个指定要使用哪种风格选择的索引。

例如，frac字体特性将用不同的表示方式转换用斜杠分开的对角线分数（如1/2）。这通常涉及将整个分数作为一个单独的字符宽度烘焙（如½）。

如果字体支持 frac 功能，则可以在形状器中通过在字体特征映射中设置 features["frac"] = 1 来启用它。

此功能是在Qt 6.7中引入的。

另请参阅：QFont::Tag、clearFeatures()、setFeature()、unsetFeature() 和 featureTags()。

void QFont::setFixedPitch(bool enable)

如果 enable 为 true，则设置固定间距开启；否则设置为关闭。

另请参阅：fixedPitch() 和 QFontInfo。

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

将符号的提示级别偏好设置为 hintingPreference。这为底层字体渲染系统提供一个提示，使用一定级别的提示，并且跨平台支持各不相同。有关详细信息，请参阅 QFont::HintingPreference 的文档中的表格。

默认提示偏好是 QFont::PreferDefaultHinting。

另请参阅：hintingPreference。

void QFont::setItalic(bool enable)

如果 enable 为 true，将字体样式设置为 style() 的 QFont::StyleItalic；否则将样式设置为 QFont::StyleNormal。

另请参阅：italic() 和 QFontInfo。

void QFont::setKerning(bool enable)

如果 enable 为 true，则为该字体启用字距调整；否则禁用。默认情况下，启用字距调整。

当启用字距调整时，即使对于拉丁文本，符号度量也不再累加。也就是说，字符'a'的宽度 + 字符'b'的宽度不一定等于 "ab" 的宽度。

另请参阅：kerning() 和 QFontMetrics。

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

设置字体字母间距为 间距 和间距类型为 类型。

字母间距可以改变字体中单个字母之间的默认间距，间距可以是字符宽度的百分比或像素，具体取决于选择的间距类型，可以是更小或更大的间距。

另见 letterSpacing()，letterSpacingType() 和 setWordSpacing()。

void QFont::setOverline(bool enable)

如果 enable 为 true，则开启上划线；否则关闭上划线。

另见 overline() 和 QFontInfo。

void QFont::setPixelSize(int pixelSize)

将字体大小设置为 pixelSize 像素，最大尺寸为无符号 16 位整数的大小。

使用此函数使得字体与设备相关。请使用 setPointSize() 或 setPointSizeF() 来以设备无关的方式设置字体的大小。

另见 pixelSize。

void QFont::setPointSize(int pointSize)

设置为 pointSize 点的大小。点大小必须大于零。

另见 pointSize() 和 setPointSizeF。

void QFont::setPointSizeF(qreal pointSize)

设置为 pointSize 点的大小。点大小必须大于零。在所有平台上可能无法实现所需的精度。

另见 pointSizeF，setPointSize 和 setPixelSize。

void QFont::setStretch(int factor)

设置字体的拉伸因子。

拉伸因子匹配字体的瘦体或胖体版本，或者应用拉伸变换，通过 factor 百分比改变字体内所有字符的宽度。例如，将 factor 设置为 150，则字体中所有字符都会变为 1.5 倍宽（即 150%）。最小拉伸因子为 1，最大拉伸因子为 4000。默认拉伸因子为 AnyStretch，它将接受任何拉伸因子且不对字体应用任何变换。

拉伸因子仅适用于轮廓字体。对于位图字体，拉伸因子将被忽略。

另见 stretch() 和 QFont::Stretch。

void QFont::setStrikeOut(bool enable)

如果 enable 为 true，则开启删除线；否则关闭删除线。

另见 strikeOut() 和 QFontInfo。

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

设置字体的风格为 style。

另请参阅 style()，italic()，以及QFontInfo。

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

设置样式提示和策略分别为hint和strategy。

如果没有显式设置，样式提示将默认为AnyStyle，样式策略默认为PreferDefault。

Qt不支持在X11上使用样式提示，因为窗口系统不提供这些信息。

另请参阅 StyleHint，styleHint，StyleStrategy，styleStrategy，以及QFontInfo。

void QFont::setStyleName(const QString &styleName)

设置字体的样式名为styleName。设置后，用于字体匹配的其他样式属性（如style()和weight()）将被忽略，尽管如果平台字体引擎支持，它们也可能随后被模拟。

由于人工模拟样式的质量较低，并且缺乏全面的跨平台支持，不建议将按样式名称匹配与按样式属性匹配一起使用。

另请参阅 styleName。

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

将字体的样式策略设置为s。

另请参阅 styleStrategy()和QFont::StyleStrategy。

void QFont::setUnderline(bool enable)

如果enable为true，则设置下划线开启；否则关闭下划线。

另请参阅 underline()和QFontInfo。

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

将对应于tag的变量轴应用value。

变量字体提供了一种在同一个字体文件中存储多个变体（具有不同的重量、宽度或样式）的方法。这些变体以预定参数集合的浮点值给出，称为“变量轴”。具体的实例通常由字体设计师命名，在Qt中，这些可以通过类似于传统子族的setStyleName()来选择。

有时，也为不同的轴提供任意值也是有用的。例如，如果一种字体具有Regular和Bold子族，您可能需要一个介于这两个子族之间的重量。您可以通过为字体中的“wght”轴提供自定义值来手动请求。

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

如果“wght”轴被字体支持，并且给定的值在其定义的范围内，则将提供重量为550.0的字体。

许多字体提供了几个标准轴，例如 "wght"（粗细），"wdth"（宽度），"ital"（斜体）和 "opsz"（光学大小）。它们在字体本身中都有各自的定义范围。例如，"wght" 可从 100 到 900（从 QFont::Thin 到 QFont::Black），而 "ital" 可从 0 到 1（从非斜体到全斜体）。

字体还可以选择定义自定义轴；唯一限制是名称必须符合 QFont::Tag（四个拉丁-1字符序列）的要求。

默认情况下，没有设置可变轴。

此功能是在Qt 6.7中引入的。

另请参阅：unsetVariableAxis。

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

将字体的粗细设置为 weight，使用由 QFont::Weight 枚举定义的缩放比例。

另请参阅：weight() 和 QFontInfo。

void QFont::setWordSpacing(qreal spacing)

将字体的单词间距设置为 spacing。

单词间距改变默认的单词间距。正值会增加单词间距的像素数，而负值会相应地减少单词间的间距。

单词间距不适用于将单词用空白字符分隔的书写系统。

另请参阅：wordSpacing() 和 setLetterSpacing。

int QFont::stretch() const

返回字体的拉伸因子。

另请参阅：setStretch。

bool QFont::strikeOut() const

如果设置了删除线，则返回 true；否则返回 false。

另请参阅：setStrikeOut。

QFont::Style QFont::style() const

返回字体的样式。

另请参阅：setStyle。

QFont::StyleHint QFont::styleHint() const

返回 StyleHint。

样式提示影响 字体匹配算法。有关可用提示的列表，请参阅 QFont::StyleHint。

另请参阅：setStyleHint、QFont::StyleStrategy 和 QFontInfo::styleHint。

QString QFont::styleName() const

返回请求的字体样式名称。这可以用来匹配不规则样式（在其他样式属性中不能被归一化的样式）。

另请参阅：setStyleName、setFamily 和 setStyle。

QFont::StyleStrategy QFont::styleStrategy() const

返回 StyleStrategy。

样式策略会影响字体匹配算法。有关可用策略的列表，请参阅 QFont::StyleStrategy。

另请参阅 setStyleStrategy()，setStyleHint()，以及 QFont::StyleHint。

[静态] QString QFont::substitute(const QString &familyName)

返回在指定 familyName 时将使用的第一个家族名称。搜索不区分大小写。

如果没有为 familyName 提供替代品，则返回 familyName。

要获取替代品列表，请使用 substitutes。

另请参阅 setFamily()，insertSubstitutions()，insertSubstitution()，以及 removeSubstitutions。

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

返回在指定 familyName 时将使用的家族名称列表。搜索不区分大小写。

如果没有为 familyName 提供替代品，则返回空列表。

另请参阅 substitute()，insertSubstitutions()，insertSubstitution()，以及 removeSubstitutions。

[静态] QStringList QFont::substitutions()

返回替代家族名称的排序列表。

另请参阅 insertSubstitution()，removeSubstitutions()，以及 substitute。

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

与 other 交换此字体实例。此函数非常快且永远不会失败。

QString QFont::toString() const

返回字体描述。描述是属性逗号分隔列表，非常适合用于 QSettings，并包含以下内容

• 字体族
• 点大小
• 像素大小
• 样式提示
• 字体粗细
• 字体样式
• 下划线
• 删除线
• 固定间距
• 始终 0
• 大小写
• 字母间距
• 单词间距
• 伸展
• 样式策略
• 字体样式（不可用时不显示）

另请参阅 fromString。

bool QFont::underline() const

如果已设置下划线则返回 true；否则返回 false。

另请参阅 setUnderline。

[自 6.7 版起] void QFont::unsetFeature(QFont::Tag tag)

这是一个重载函数。

从显式启用/禁用特征的映射中取消设置 tag。

在 QFont 上取消现有功能将使行为恢复到默认值。

有关字体功能的更多详细信息，请参阅setFeature()。

此功能是在Qt 6.7中引入的。

另请参阅：QFont::Tag，clearFeatures，setFeature，featureTags 和 featureValue。

[自 6.7 版起] void QFont::unsetVariableAxis(QFont::Tag tag)

取消通过 tag 设置的之前设置的变量轴值。

此功能是在Qt 6.7中引入的。

另请参阅：setVariableAxis。

[自 6.7 版起] QList<QFont::Tag> QFont::variableAxisTags() const

返回此 QFont 上设置的所有变量轴的标签列表。

有关变量轴的更多详细信息，请参阅setVariableAxis()。

此功能是在Qt 6.7中引入的。

另请参阅：QFont::Tag，setVariableAxis，unsetVariableAxis，isVariableAxisSet 和 clearVariableAxes。

[自 6.7 版起] float QFont::variableAxisValue(QFont::Tag tag) const

返回特定变量轴 tag 设置的值。如果未设置该标签，则返回 0.0。

有关变量轴的更多详细信息，请参阅setVariableAxis()。

此功能是在Qt 6.7中引入的。

另请参阅：QFont::Tag，setVariableAxis，unsetVariableAxis，isVariableAxisSet 和 clearVariableAxes。

QFont::Weight QFont::weight() const

以与 QFont::Weight 枚举相同的比例返回字体的重量。

另请参阅：setWeight，Weight 和 QFontInfo。

qreal QFont::wordSpacing() const

返回字体的行距。

另请参阅：setWordSpacing 和 setLetterSpacing。

QVariant QFont::operator QVariant() const

将字体作为 QVariant 返回。

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

如果此字体与 f 不同，则返回 true；否则返回 false。

如果两个 QFonts 的字体属性不同，则认为它们是不同的。

另请参阅：operator==。

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

提供了一个任意比较此字体和字体 f 的函数。保证的是，如果两个字体相等，则算子返回 false，如果字体不相等，则 (f1 < f2) == !(f2 < f1)。

在某些情况下，此函数非常有用，例如，如果您想将 QFont 对象用作 QMap 中的键。

另请参阅operator==()、operator!=() 和 isCopyOf()。

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

将 font 赋值给当前字体并返回对它的引用。

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

将 other 移动赋值给此 QFont 实例。

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

如果此字体与 f 相等，则返回 true；否则返回 false。

如果两个 QFont 的字体属性相等，则认为它们相等。

另请参阅operator!=() 和 isCopyOf()。