• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
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```