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() | |
| 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 字体后端，则不支持可变轴。
成员函数文档
QFontVariableAxis::QFontVariableAxis(const QFontVariableAxis &axis)
创建一个 QFontVariableAxis 对象，该对象是给定axis 的副本。
另请参阅 operator=().
[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
返回坐标轴的最小值。不支持将坐标轴设置为小于此值的值。
注： 属性 minimumValue 的获取函数。
另请参阅 setMinimumValue()、maximumValue() 和defaultValue()。
QString QFontVariableAxis::name() const
如果字体提供了轴的名称，则返回轴的名称。
注： 属性名称的获取函数。
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"（宽度），但任何四个拉丁-1 字符的序列都是有效的标记。按照惯例，非标准/自定义轴用大写字母标记。
另请参见 setTag()、QFont::setVariableAxis() 和name()。
QFontVariableAxis &QFontVariableAxis::operator=(const QFontVariableAxis &axis)
将给定的axis 分配给此QFontVariableAxis 。
另请参阅 QFontVariableAxis() 。
© 2025 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.
