QFontVariableAxis Class
QFontVariableAxis 类表示字体中的可变轴。更多内容...
| 头文件： | #include <QFontVariableAxis> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake： | QT += gui |
| 自： | Qt 6.9 |
- 所有成员列表（包括继承的成员）
- QFontVariableAxis 属于“隐式共享类”。
注意：该类中的所有函数均为可重入的。
属性
|
公共函数
| QFontVariableAxis(const QFontVariableAxis &axis) | |
| QFontVariableAxis(QFontVariableAxis &&other) | |
| ~QFontVariableAxis() | |
| qreal | defaultValue() const |
| qreal | maximumValue() const |
| qreal | minimumValue() const |
| QString | name() const |
| void | setDefaultValue(qreal defaultValue) |
| void | setMaximumValue(qreal maximumValue) |
| void | setMinimumValue(qreal minimumValue) |
| void | setName(const QString &name) |
| void | setTag(QFont::Tag tag) |
| QFont::Tag | tag() const |
| QFontVariableAxis & | operator=(const QFontVariableAxis &axis) |
详细说明
可变字体提供了一种在同一字体文件中存储多种变体（具有不同的字重、字宽或样式）的方法。这些变体以浮点数值的形式表示，对应于一组预定义的参数，称为“可变轴”。
可以通过QFont 中的属性选择特定的参数化方案（即字体中各轴的值集合），这与定义为独立字体文件的传统子字体家族类似。但在可变字体中，可以为每个轴提供任意值，从而对字体的外观进行精细定制。
QFontVariableAxis 包含一个轴的信息。使用QFontInfo::variableAxes() 可获取给定字体中定义的可变轴列表。通过使用QFont::setVariableAxis() 并传入tag()，可以为某个轴提供具体值。
注意：在 Windows系统上 ，如果使用可选的 GDI 字体后端，则不支持可变坐标轴。
属性文档
[read-only] defaultValue : const qreal
该属性存储了坐标轴的默认值
如果未在QFont 查询中提供该值，则轴将采用此值。
访问函数：
| qreal | defaultValue() const |
另请参阅 minimumValue() 和maximumValue()。
[read-only] maximumValue : const qreal
该属性存储了轴的最大值
不支持将坐标轴设置为高于此值的数值。
访问函数：
| qreal | maximumValue() const |
另请参阅 minimumValue() 和defaultValue()。
[read-only] minimumValue : const qreal
该属性存储该轴的最小值。
访问函数：
| qreal | minimumValue() const |
[read-only] name : const QString
如果字体提供了该属性，则该属性存储轴的名称
访问函数：
| QString | name() const |
另请参阅 tag()。
[read-only] tag : const QByteArray
该属性存储轴的标签
这是一个由四个字符组成的序列，用于标识该轴。某些标签具有标准化的含义，例如“wght”（权重）和“wdth”（宽度），但任何由四个 Latin-1 字符组成的序列都是有效的标签。按惯例，非标准/自定义轴的标签均采用全大写形式。
另请参阅 QFont::setVariableAxis() 和name()。
成员函数文档
QFontVariableAxis::QFontVariableAxis(const QFontVariableAxis &axis)
创建一个 QFontVariableAxis 对象，该对象是给定axis 的副本。
另请参阅 operator=()。
[constexpr noexcept default] QFontVariableAxis::QFontVariableAxis(QFontVariableAxis &&other)
通过 Move 构造一个 `QFontVariableAxis` 的实例。
[noexcept] QFontVariableAxis::~QFontVariableAxis()
销毁此QFontVariableAxis 对象。
qreal QFontVariableAxis::defaultValue() const
返回坐标的默认值。如果未在QFont 查询中指定坐标值，则该坐标将采用此默认值。
注意： 这是属性 defaultValue 的获取 函数。
另请参阅 setDefaultValue()、minimumValue() 和maximumValue()。
qreal QFontVariableAxis::maximumValue() const
返回该轴的最大值。不支持将该轴设置为高于此值的数值。
注意： 这是 maximumValue 属性的获取 函数。
另请参阅 setMaximumValue()、minimumValue()，以及defaultValue()。
qreal QFontVariableAxis::minimumValue() const
返回该轴的最小值。不支持将轴设置为小于该值的数值。
注意： 这是 property minimumValue的获取 函数。
另请参阅 setMinimumValue()、maximumValue()，以及defaultValue()。
QString QFontVariableAxis::name() const
返回轴的名称（如果字体提供了该名称）。
注意： 这是 property name 的获取 函数。
void QFontVariableAxis::setDefaultValue(qreal defaultValue)
将此QFontVariableAxis 的默认值设置为defaultValue 。
注意：通常 无需调用此函数，因为它不会影响字体本身，仅影响该字体的特定呈现形式。
另请参阅 defaultValue()。
void QFontVariableAxis::setMaximumValue(qreal maximumValue)
将此QFontVariableAxis 的最大值设置为maximumValue 。
注意：通常 无需调用此函数，因为它不会影响字体本身，仅影响该字体的特定呈现形式。
另请参阅 maximumValue()。
void QFontVariableAxis::setMinimumValue(qreal minimumValue)
将此QFontVariableAxis 的最小值设置为minimumValue 。
注意：通常 无需调用此函数，因为它不会影响字体本身，仅影响该字体的特定呈现形式。
另请参阅 minimumValue()。
void QFontVariableAxis::setName(const QString &name)
将此QFontVariableAxis 的名称设置为name 。
注意：通常 无需调用此函数，因为它不会影响字体本身，仅影响该字体的特定呈现形式。
另请参阅 name()。
void QFontVariableAxis::setTag(QFont::Tag tag)
将QFontVariableAxis 的标签设置为tag 。
注意：通常 无需调用此函数，因为它不会影响字体本身，仅影响该字体的特定呈现效果。
另请参阅 tag()。
QFont::Tag QFontVariableAxis::tag() const
返回坐标轴的标签。这是一个由四个字符组成的字符串，用于标识该坐标轴。 某些标签具有标准化的含义，例如“wght”（权重）和“wdth”（宽度），但任何由四个 Latin-1 字符组成的序列都是有效的标签。按惯例，非标准/自定义轴的标签均采用全大写形式。
另请参阅 setTag()、QFont::setVariableAxis() 和name()。
QFontVariableAxis &QFontVariableAxis::operator=(const QFontVariableAxis &axis)
将给定的axis 分配给此QFontVariableAxis 。
另请参阅 QFontVariableAxis()。
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
