大网数据广告活动
OpenHarmony 设备与应用开发

Interfaces (其他)

· 52CE 我爱测

表示字体特征。字体特征是字体内置的排版规则,用于控制字形的显示效果,具体包括连字、替代字形、上下标等功能。

Interfaces (其他)

说明:

  • 本模块首批接口从API version 11开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。

  • 本模块使用屏幕物理像素单位px。

  • 本模块为单线程模型策略,需要调用方自行管理线程安全和上下文状态的切换。

TextBlobRunBuffer

描述一行文字中具有相同属性的连续字形。

系统能力: SystemCapability.Graphics.Drawing

名称 类型 只读 可选 说明
glyph number 否 否 存储文字的索引,该参数为整数,传入浮点类型时向下取整。
positionX number 否 否 文本的起点x轴坐标,该参数为浮点数。单位为物理像素px。
positionY number 否 否 文本的起点y轴坐标,该参数为浮点数。单位为物理像素px。

FontMetrics

描述字形大小和布局的属性信息,同一种字体中的字符属性大致相同。

原子化服务API: 从API version 22开始,该接口支持在原子化服务中使用。

系统能力: SystemCapability.Graphics.Drawing

名称 类型 只读 可选 说明
flags12+ FontMetricsFlags 否 是 表明哪些字体度量标志有效。
top number 否 否 文字最高处到基线之间的最大距离,浮点数。单位为物理像素px。
ascent number 否 否 文字最高处到基线之间的距离,浮点数。单位为物理像素px。
descent number 否 否 基线到文字最低处之间的距离,浮点数。单位为物理像素px。
bottom number 否 否 基线到文字最低处之间的最大距离,浮点数。单位为物理像素px。
leading number 否 否 行间距,从上一行文字descent到下一行文字ascent之间的距离,浮点数。单位为物理像素px。
avgCharWidth12+ number 否 是 平均字符宽度。单位为物理像素px。
maxCharWidth12+ number 否 是 最大字符宽度。单位为物理像素px。
xMin12+ number 否 是 字体中任意字形边界框最左边沿到原点的水平距离,这个值往往小于零,意味着字形在水平方向上的最小边界。单位为物理像素px。
xMax12+ number 否 是 字体中任意字形边界框最右边沿到原点的水平距离,此值多为正数,指示了字形在水平方向上的最大延伸范围。单位为物理像素px。
xHeight12+ number 否 是 小写字母x的高度,通常为负值。单位为物理像素px。
capHeight12+ number 否 是 大写字母的高度,通常为负值。单位为物理像素px。
underlineThickness12+ number 否 是 下划线的厚度。单位为物理像素px。
underlinePosition12+ number 否 是 文本基线到下划线顶部的垂直距离,通常是正数。单位为物理像素px。
strikethroughThickness12+ number 否 是 文本删除线的厚度,即贯穿文本字符的水平线的宽度。单位为物理像素px。
strikethroughPosition12+ number 否 是 文本基线到底部删除线的垂直距离,通常为负值。单位为物理像素px。

FontFeature20+

表示字体特征。字体特征是字体内置的排版规则,用于控制字形的显示效果,具体包括连字、替代字形、上下标等功能。

原子化服务API: 从API version 22开始,该接口支持在原子化服务中使用。

系统能力: SystemCapability.Graphics.Drawing

名称 类型 只读 可选 说明
name string 否 否 字体特征的名称。常见的字体特征名称包含liga、frac、case等,需要对应的ttf文件支持才能生效。
value number 否 否 字体特征的数值,浮点数。建议通过字体查看工具或查阅字体文档,确定具体的有效取值范围。

本文来自 OpenHarmony 文档贡献者,按 CC BY 4.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
OpenHarmony 文档贡献者
适用范围
master 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。