1# Class (TypefaceArguments) 2 3<!--Kit: ArkGraphics 2D--> 4<!--Subsystem: Graphics--> 5<!--Owner: @hangmengxin--> 6<!--Designer: @wangyanglan--> 7<!--Tester: @nobuggers--> 8<!--Adviser: @ge-yafang--> 9 10> **说明:** 11> 12> - 本模块首批接口从API version 11开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 13> 14> - 本Class首批接口从API version 20开始支持。 15> 16> - 本模块使用屏幕物理像素单位px。 17> 18> - 本模块为单线程模型策略,需要调用方自行管理线程安全和上下文状态的切换。 19 20提供字体属性配置的结构体。 21 22## 导入模块 23 24```ts 25import { drawing } from '@kit.ArkGraphics2D'; 26``` 27 28## constructor<sup>20+</sup> 29 30constructor() 31 32字体属性的构造函数。 33 34**系统能力:** SystemCapability.Graphics.Drawing 35 36**示例:** 37 38```ts 39import { drawing } from '@kit.ArkGraphics2D'; 40let typeFaceArgument = new drawing.TypefaceArguments(); 41``` 42 43## addVariation<sup>20+</sup> 44 45addVariation(axis: string, value: number) 46 47给字体属性设置字重值。 48 49**系统能力:** SystemCapability.Graphics.Drawing 50 51**参数:** 52| 参数名 | 类型 | 必填 | 说明 | 53| ----------- | ---------------------------------------- | ---- | ------------------- | 54| axis | string | 是 | 字体属性对象可变维度字重的标签'wght'。具体是否支持的该标签取决于加载的字体文件。请打开对应的字体文件具体查看支持的属性。 | 55| value | number | 是 | 字体属性对象可变维度字重的标签'wght'对应的属性值,需要在字体文件支持的范围内,否则不会生效。如果属性值小于支持的最小值,则默认和最小值一致。如果属性值大于支持的最大值,则默认和最大值效果一致。请打开对应的字体文件具体查看支持的属性值。 | 56 57**错误码:** 58 59以下错误码的详细介绍请参见[图形绘制与显示错误码](../apis-arkgraphics2d/errorcode-drawing.md)。 60 61| 错误码ID | 错误信息 | 62| ------- | --------------------------------------------| 63| 25900001 | Parameter error.Possible causes: Incorrect parameter range. | 64 65**示例:** 66 67```ts 68import { drawing } from '@kit.ArkGraphics2D'; 69 70let typeFaceArgument = new drawing.TypefaceArguments(); 71typeFaceArgument.addVariation('wght', 10); 72```