PathText QML Type

设置字体权重是否为粗体。

设置文本的大小写。

PathText { text: "Hello"; font.capitalization: Font.AllLowercase }

如果所选字体不包含特定字符，Qt 会自动选择包含该字符的相似字体。默认情况下，这是在逐个字符的基础上进行的。

这意味着在某些不常见的情况下，即使是在同一个脚本中，也可能会使用多种不同的字体来表示一串文本。如果将contextFontMerging 设置为 true，就会尝试查找与输入字符串最大子集相匹配的后备字体。这对字形缺失的字符串来说代价较高，但可能会得到更一致的结果。默认情况下，contextFontMerging 是false 。

此属性在 Qt 6.8 中引入。

另请参阅 QFont::StyleStrategy 。

设置字体的族名。

族名不区分大小写，可选择包含代工厂名称，例如 "Helvetica [Cronyx]"。如果有一个以上的字体代工厂提供该族，但未指定代工厂，则会任意选择一个代工厂。如果没有可用的族，则将使用字体匹配算法设置一个族。

在根据features 中的内容塑造文本时，为特定 OpenType 特征应用整数值。这为字体整形过程提供了高级访问权限，可用于支持 API 未涵盖的字体特征。

字体特征由四字母标记到整数值的映射表示。在大多数情况下，与标签一起传递的整数值代表一个布尔值：零值表示禁用该功能，非零值表示启用该功能。但对于某些字体功能，它可能有其他解释。例如，当应用于salt 功能时，该值是一个索引，用于指定要使用的替代样式。

例如，frac 字体功能会将用斜线分隔的对角线分数（如1/2 ）转换为不同的表示方法。通常情况下，这需要将完整的分数转换为单个字符宽度（如½ ）。

如果字体支持frac 功能，则可以在整形器中启用该功能，如下代码所示：

Text {
    text: "One divided by two is 1/2"
    font.family: "MyFractionFont"
    font.features: { "frac": 1 }
}

可以在同一映射中为多个特征赋值。例如，如果您想同时禁用字体的内角，可以如下所示显式禁用该功能：

Text {
    text: "One divided by two is 1/2"
    font.family: "MyFractionFont"
    font.features: { "frac": 1, "kern": 0 }
}

您还可以在一个对象中收集字体属性：

Text {
    text: "One divided by two is 1/2"
    font: {
        family: "MyFractionFont"
        features: { "frac": 1, "kern": 0 }
    }
}

此属性在 Qt 6.6 中引入。

另请参阅 QFont::setFeature().

设置字体是否具有斜体样式。

在塑造文本时启用或禁用分隔 OpenType 功能。禁用该功能可提高创建或更改文本时的性能，但会牺牲一些外观特性。默认值为 true。

PathText { text: "OATS FLAVOUR WAY"; font.kerning: false }

设置字体的字母间距。

字母间距可更改字体中单个字母之间的默认间距。正值增加相应像素的字母间距，负值减小间距。

以像素为单位设置字体大小。

使用此功能会使字体取决于设备。使用pointSize 可以独立于设备设置字体大小。

以点为单位设置字体大小。点的大小必须大于零。

有时，字体会对一组字符应用复杂的规则，以正确显示这些字符。在某些书写系统（如婆罗门文字）中，为了使文字清晰易读，必须这样做，但在拉丁字母等文字中，这只是一种外观特征。将preferShaping 属性设置为 false 将在不需要时禁用所有此类功能，这将在大多数情况下提高性能。

默认值为 true。

PathText { text: "Some text"; font.preferShaping: false }

竞争垂直线度量集，提供字体的ascent 、descent 和leading 。这些指标通常被称为win（Windows）指标和typo（排版）指标。虽然规范建议使用typo 度量来确定行距，但许多应用程序更倾向于使用win 度量，除非在字体的fsSelection字段中设置了USE_TYPO_METRICS 标志。出于向后兼容的考虑，Qt 应用程序也是如此。对于设置USE_TYPO_METRICS 标志以表示typo 度量有效的字体，以及win 度量和typo 度量相匹配的字体，这并不是一个问题。不过，对于某些字体，win 指标可能大于理想行距，而USE_TYPO_METRICS 标志可能被错误地取消设置。对于这类字体，设置font.preferTypoLineMetrics 可能会得到更好的结果。

默认情况下，preferTypoLineMetrics 是false 。

该属性在 Qt 6.8 中引入。

另请参阅 QFont::StyleStrategy 。

设置字体是否具有删除线样式。

设置字体的样式名称。

样式名称不区分大小写。如果设置，字体将与样式名称匹配，而不是与字体属性font.weight,font.bold 和font.italic 匹配。

设置文本是否有下划线。

为可变字体中的可变轴应用浮点数值。

可变字体提供了一种在同一字体文件中存储多个变量（具有不同的重量、宽度或样式）的方法。这些变化以浮点数值的形式给出，用于一组预定义的参数，称为 "变量轴"。具体实例通常由字体设计者命名，在 Qt Designer 中，可以使用 setStyleName() 来选择这些实例，就像传统的子家族一样。

在某些情况下，为不同轴提供任意值也很有用。例如，如果一种字体有普通和粗体两个子字体，您可能需要一个介于这两种字体之间的权重。这时，您可以通过为字体中的 "wght "轴提供自定义值来手动实现这一要求。

Text {
    text: "Foobar"
    font.family: "MyVariableFont"
    font.variableAxes: { "wght": (Font.Normal + Font.Bold) / 2.0 }
}

如果字体支持 "wght "轴，且给定值在其定义范围内，则将提供与权重 550.0 相对应的字体。

许多字体都提供一些标准轴，如 "wght"（重量）、"wdth"（宽度）、"ital"（斜体）和 "opsz"（光学尺寸）。字体本身定义了它们各自的范围。例如，"wght "可以从 100 到 900（QFont::Thin 到QFont::Black ），而 "ital "可以从 0 到 1（从非斜体到完全斜体）。

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

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

此属性在 Qt 6.7 中引入。

另请参阅 QFont::setVariableAxis().

设置字体的权重。

权重可以是

PathText { text: "Hello"; font.weight: Font.DemiBold }

设置字体的字间距。

字间距更改单个字之间的默认间距。正值会相应增加字间距的像素数，负值会相应减少字间距。

PathText 的文本应包含轮廓。

PathText 的基线水平位置。

PathText 基线的垂直位置。